> Source: https://docs.cyberelements.io/bastion/4.6/et/Upgrade/HotVersionUpgrade/EdgeGateway/

# Edge Gateway komponendi versiooniuuendus töö ajal

> **Oluline**
>
> Edge Gateway komponendi töö ajal tehtava versiooniuuenduse dokumentatsioon on mõeldud kõigile Edge Gateway komponentidele, mis töötavad süsteemis Debian 11. Debiani versiooni saab kontrollida järgmise käsuga (käivitada SSH- või konsoolijuurdepääsu kaudu):
>
> ```
> 1
> ```

> **Teave**
>
> Meeldetuletuseks: Debiani arvutites tuleb kasutajale `root` lülituda järgmise käsuga:
>
> ```
> 1
> ```

## Planeerimine ja ettevalmistus

### Võrguvoogude avamine

Toote versiooniuuendusel tuleb Debiani hoidlatest alla laadida palju pakette, kuna toimub üleminek Debiani versioonilt 11 versioonile 12. Aadressidele `security.debian.org` ja `ftp.fr.debian.org` tuleb avada juurdepääs `TCP 80` kaudu.

Voogude avatust saab arvutis testida, käivitades Debiani hoidlate sünkroonimise. Kui kuvatakse tõrketeateid Debiani hoidlatele juurdepääsu kohta, ei ole võrguvoog avatud ja tõenäoliselt blokeerib seda ettevõtte tulemüür. Hoidlate sünkroonimise saab käivitada järgmise käsuga:

```
1
```

### Peegli ja vajalike tööriistade allalaadimine

CyberElements Cleanroom 4.6 peegli saab alla laadida siit (nõuab kliendikonto loomist): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Systancia Marketplace'ist tuleb alla laadida ka võti `systancia.gpg`, mis autendib toote CyberElements Bastion hoidla.

Lisaks peeglile on versiooniuuenduse protsessiks vaja kolmanda osapoole tööriistu:

- SSH-klient (Windowsis saab kasutada tööriista [PuTTY](https://putty.org/))
- SCP-klient (Windowsis saab kasutada tööriistu [WinSCP](https://winscp.net/eng/index.php) või [FileZilla](https://filezilla-project.org/))

### Tööriista screen installimine ja kasutamine

Tööriist `screen` võimaldab avada ühes konsoolis mitu kestaterminali. Selle tööriista kasutamine on toote CyberElements Bastion versiooniuuenduse tegemiseks hädavajalik, et kõrvaldada sõltuvus võrguühenduse stabiilsusest. Ilma tööriista screen kasutamata katkestataks installimine, kui SSH-ühendus toote CyberElements Bastion serveritega katkeb.

Tööriista `screen` kasutamisel saab toote CyberElements Bastion seadmete kestakonsooliga uuesti ühenduse loomisel taastada terminali, milles värskendusprotsess käivitati.

Pakett screen tuleks installida järgmise käsureaga:

```
1
```

Uue `screen`-terminali avamiseks tuleb käivitada järgmine käsk:

```
1
```

Asendage `<ID>` nimega, mis seansi tuvastab.

> **Näide**
>
> CyberElements versiooniuuenduste puhul on identifikaator `cye-upgrade` kergesti äratuntav. Käsk oleks seega järgmine:
>
> ```
> 1
> ```

Tööriistaga `screen` avatud terminali taastamiseks käivitage lihtsalt järgmine käsk:

```
1
```

Asendage `<ID>` seansi avamisel määratud nimega.

> **Näide**
>
> Varem identifikaatoriga `cye-upgrade` avatud terminali saab taastada järgmise käsuga:
>
> ```
> 1
> ```

Terminali sulgemiseks pärast versiooniuuenduse lõppu sisestage terminalis käsk `exit` või vajutage kiirklahvi ctrl+d.

See viib teid tagasi konsooli. Teade „screen is terminating“ kinnitab, et terminal on suletud.

## Versiooniuuendus

### Debiani pakettide värskendamine

Kuna toote CyberElements Bastion versiooniuuendus nõuab Debiani versiooniuuendust, on soovitatav enne Debian 12-le üleminekut Debian 11 paketid korralikult värskendada. Selleks käivitage kasutajana `root` järgmised käsud (süsteemi värskendamine ja seejärel mittevajalike pakettide eemaldamine):

```
1
2
3
```

Võidakse kuvada teateid, mis paluvad teil muuta mitme konfiguratsioonifaili konfiguratsiooni. Sellisel juhul valige suvand, mis säilitab praeguse konfiguratsiooni.

### CyberElements Cleanroom 4.6 peegli ettevalmistamine

Ettevalmistusetapis hangitud peegel (tgz-laiendiga fail) tuleb saata serverisse SCP kaudu. See tuleks paigutada kataloogi `/tmp/`.

Seejärel valmistage peegel ette, käivitades kasutajana `root` järgmised käsud (varasemast versiooniuuendusest järelejäänud failid kustutatakse):

```
1
2
3
```

### APT konfigureerimine

Paketihaldur APT on konfigureeritud hankima Debian 11 pakette; see tuleb uuesti konfigureerida hankima Debian 12 pakette. Samuti tuleb värskendada viidet toote CyberElements Bastion kohalikule peeglile. Selleks käivitage kasutajana `root` järgmised käsud:

```
1
2
```

Kohalik peegel autenditakse ettevalmistusetapis alla laaditud võtmega `systancia.gpg`. Saatke see SCP kaudu serveri kataloogi `/tmp/` ja seejärel installige see kasutajana `root` järgmise käsuga:

```
1
```

Lisaks uute hoidlate konfigureerimisele soovitame tungivalt rakendada järgmist sätet, mis annab APT-le korralduse mitte installida soovitatud sõltuvusi, mis pole hädavajalikud, et vähendada installitavate komponentide arvu. Järgmine käsk rakendab selle sätte kasutajana `root`:

```
1
```

Lõpuks tuleb järgmise käsuga värskendada hoidlates olevate pakettide loendit:

```
1
```

### Versiooniuuenduse käivitamine

Looge SSH kaudu juurdepääs Edge Gateway serverile ja lülituge kasutajale `root`, seejärel avage screen-seanss [nagu eespool näidatud](#installing-and-using-the-screen-tool).

Edge Gateway komponendi versiooniuuendamisel Debian 11-lt Debian 12-le värskendatakse paketti `collectd` ja see muutub ühildumatuks CyberElements Bastion lahenduse genereeritud konfiguratsioonifailiga (`/etc/collectd/collectd.conf`). See võib värskendamise ajal tõrke põhjustada.

Selle vältimiseks lülitage collectd välja:

```
1
2
```

Pärast seda saab versiooniuuenduse algatada järgmise käsuga:

```
1
```

Versiooniuuenduse ajal esitatakse teile mitu küsimust selle kohta, kas säilitada konfiguratsioonifailid ja värskendada neid Debian 12 standardkonfiguratsiooni järgi või jätta kehtima spetsiifiline konfiguratsioon. Siin on meie soovitused enamiku failide kohta, millega võite kokku puutuda:

| Konfiguratsioonifail | Soovitatav toiming |
|---|---|
| /etc/issue | Säilitamiseks vastake `N` |
| /etc/issue.net | Säilitamiseks vastake `N` |
| /etc/security/limits.conf | Säilitamiseks vastake `N` |
| /etc/login.defs | Säilitamiseks vastake `N` |
| /etc/snmp/snmpd.conf | Rakendage muudatused, vastake `Y` |
| /etc/ssh/sshd_config | Säilitamiseks vastake `Keep the local version currently installed` |
| /etc/pam.d/su | Säilitamiseks vastake `N` |
| /etc/sysctl.conf | Säilitamiseks vastake `N` |
| /etc/audit/rules.d/audit.rules | Säilitamiseks vastake `N` |
| /etc/ssh/ssh_config | Rakendage muudatused, vastake `Y` |
| /usr/share/tomcat10/logrotate.template | Rakendage muudatused, vastake `Install the package maintainer's version` |

Nõustuge teenuste automaatse taaskäivitamisega: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Kui versiooniuuendus on lõpule viidud, käivitage järgmised käsud, et `collectd` uuesti aktiveerida, mittevajalikud paketid eemaldada ja arvuti taaskäivitada:

```
1
2
3
4
```

## Valideerimine

Kui versiooniuuendus on lõpule viidud, tuleb enne tootmisse naasmist läbida valideerimisetapp, et veenduda CyberElements Bastion taristu nõuetekohases toimimises. Kui valideerimine nurjub, tuleks kaaluda tagasipööramist CyberElements Bastion serverite varukoopiate taastamise teel.

Avage administraatoriliides ja seejärel Edge Gateway serverite haldusmenüü.

Uuendatud Edge Gateway serverid peaksid näitama versiooni 8.9, kui need on edukalt Mediation Controller serveriga uuesti ühenduse loonud.

Kui kõigi serverite versioon on uuendatud, saab kogu vastuvõtu kontroll-loendi valideerimiseks teha kõik funktsionaalsed testid.
