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

# Edge Gateway jaunināšana darbības laikā

> **Svarīgi**
>
> Dokumentācija par Edge Gateway jaunināšanu darbības laikā ir paredzēta jebkuram Edge Gateway, kurā darbojas Debian 11. Debian versiju var pārbaudīt ar šo komandu (jāizpilda, izmantojot SSH vai konsoles piekļuvi):
>
> ```
> 1
> ```

> **Informācija**
>
> Atgādinām, ka pārslēgšanās uz `root` Debian datoros jāveic ar šo komandu:
>
> ```
> 1
> ```

## Plānošana un sagatavošana

### Plūsmu atvēršana

Jauninot produktu, pārejas no Debian 11. versijas uz 12. versiju dēļ no Debian krātuvēm ir jālejupielādē daudzas pakotnes. Ir jāatver `TCP 80` piekļuve resursiem `security.debian.org` un `ftp.fr.debian.org`.

Lai pārbaudītu plūsmu atvēršanu datorā, var palaist Debian krātuvju sinhronizāciju. Ja tiek parādīti kļūdu ziņojumi par piekļuvi Debian krātuvēm, tīkla plūsma nav atvērta un, visticamāk, to bloķē uzņēmuma ugunsmūris. Krātuvju sinhronizāciju var sākt ar šādu komandu:

```
1
```

### Spoguļa un nepieciešamo rīku lejupielāde

CyberElements Cleanroom 4.6 spoguli var lejupielādēt, izmantojot šo saiti (nepieciešams izveidot klienta kontu): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

No Systancia Marketplace jālejupielādē arī atslēga `systancia.gpg`, kas autentificē CyberElements Bastion krātuvi.

Papildus spogulim jaunināšanas procesam būs nepieciešami trešo pušu rīki:

- SSH klients (operētājsistēmā Windows var izmantot rīku [PuTTY](https://putty.org/))
- SCP klients (operētājsistēmā Windows var izmantot rīkus [WinSCP](https://winscp.net/eng/index.php) vai [FileZilla](https://filezilla-project.org/))

### Rīka screen instalēšana un lietošana

Rīks `screen` ļauj atvērt vairākus čaulas termināļus vienā konsolē. Šis rīks noteikti jāizmanto CyberElements Bastion versijas jaunināšanai, lai novērstu atkarību no tīkla savienojamības stabilitātes. Proti, neizmantojot rīku screen, instalēšana tiktu apturēta, ja tiktu pārtraukts SSH savienojums ar CyberElements Bastion serveriem.

Izmantojot rīku `screen`, pēc atkārtotas savienojuma izveides ar CyberElements Bastion iekārtu čaulas konsoli var atgūt termināli, kurā tika izpildīts atjaunināšanas process.

Pakotne screen jāinstalē ar šādu komandrindu:

```
1
```

Lai atvērtu jaunu `screen` termināli, ir jāizpilda šāda komanda:

```
1
```

Aizstājiet `<ID>` ar nosaukumu, kas identificē sesiju.

> **Piemērs**
>
> CyberElements versiju jaunināšanai identifikators `cye-upgrade` ir viegli atpazīstams. Tāpēc komanda būtu šāda:
>
> ```
> 1
> ```

Lai atgūtu ar `screen` atvērtu termināli, vienkārši izpildiet šādu komandu:

```
1
```

Aizstājiet `<ID>` ar nosaukumu, kas tika definēts, atverot sesiju.

> **Piemērs**
>
> Iepriekš ar identifikatoru `cye-upgrade` atvērto termināli var atgūt ar šādu komandu:
>
> ```
> 1
> ```

Lai aizvērtu termināli pēc jaunināšanas pabeigšanas, terminālī ievadiet komandu `exit` vai nospiediet īsinājumtaustiņu ctrl+d.

Tādējādi jūs atgriezīsieties konsolē. Ziņojums „screen is terminating“ apstiprina, ka terminālis ir aizvērts.

## Jaunināšana

### Debian pakotņu atjaunināšana

Tā kā CyberElements Bastion jaunināšanai nepieciešama Debian jaunināšana, pirms pārejas uz Debian 12 ieteicams pienācīgi atjaunināt Debian 11 pakotnes. Lai to izdarītu, izpildiet šādas komandas kā `root` (sistēmas atjaunināšana un pēc tam nevajadzīgo pakotņu noņemšana):

```
1
2
3
```

Var tikt parādīti ziņojumi, kuros tiek lūgts modificēt vairāku konfigurācijas failu konfigurāciju. Šādos gadījumos atlasiet opciju, kas saglabā pašreizējo konfigurāciju.

### CyberElements Cleanroom 4.6 spoguļa sagatavošana

Sagatavošanas posmā iegūtais spogulis (fails ar paplašinājumu tgz) ir jānosūta uz serveri, izmantojot SCP. Tas jāievieto direktorijā `/tmp/`.

Pēc tam sagatavojiet spoguli, izpildot šādas komandas kā lietotājs `root` (tiks dzēsti atlikušie faili no iepriekšējās versijas jaunināšanas):

```
1
2
3
```

### APT konfigurācija

Pakotņu pārvaldnieks APT ir konfigurēts Debian 11 pakotņu iegūšanai; tas jāpārkonfigurē Debian 12 pakotņu iegūšanai. Jāatjaunina arī atsauce uz lokālo CyberElements Bastion spoguli. Lai to izdarītu, izpildiet šādas komandas kā `root`:

```
1
2
```

Lokālais spogulis tiek autentificēts ar sagatavošanas posmā lejupielādēto atslēgu `systancia.gpg`. Nosūtiet to uz serveri, izmantojot SCP, direktorijā `/tmp/` un pēc tam instalējiet to ar šādu komandu kā `root`:

```
1
```

Papildus jauno krātuvju konfigurēšanai stingri iesakām lietot šādu iestatījumu, kas liek APT neinstalēt ieteiktās atkarības, kuras nav absolūti nepieciešamas, tādējādi samazinot instalēto komponentu skaitu. Šī komanda lieto minēto iestatījumu kā lietotājs `root`:

```
1
```

Visbeidzot ir jāatjaunina krātuvēs esošo pakotņu saraksts ar šādu komandu:

```
1
```

### Versijas jaunināšanas aktivizēšana

Piekļūstiet Edge Gateway serverim, izmantojot SSH, pārslēdzieties uz `root` un pēc tam atveriet screen sesiju, [kā norādīts iepriekš](#installing-and-using-the-screen-tool).

Jauninot Edge Gateway no Debian 11 uz Debian 12, pakotne `collectd` tiek atjaunināta un kļūst nesaderīga ar CyberElements Bastion ģenerēto konfigurācijas failu (`/etc/collectd/collectd.conf`). Tas atjaunināšanas laikā var izraisīt kļūdu.

Lai no tā izvairītos, atspējojiet collectd:

```
1
2
```

Pēc tam jaunināšanu var sākt ar šo komandu:

```
1
```

Jaunināšanas laikā jums tiks uzdoti vairāki jautājumi par to, vai saglabāt konfigurācijas failus un atjaunināt tos atbilstoši standarta Debian 12 konfigurācijai, vai arī saglabāt esošo specifisko konfigurāciju. Tālāk sniegti mūsu ieteikumi lielākajai daļai failu, ar kuriem varat saskarties:

| Konfigurācijas fails | Ieteicamā darbība |
|---|---|
| /etc/issue | Lai saglabātu, atbildiet `N` |
| /etc/issue.net | Lai saglabātu, atbildiet `N` |
| /etc/security/limits.conf | Lai saglabātu, atbildiet `N` |
| /etc/login.defs | Lai saglabātu, atbildiet `N` |
| /etc/snmp/snmpd.conf | Lai lietotu izmaiņas, atbildiet `Y` |
| /etc/ssh/sshd_config | Lai paturētu, atbildiet `Keep the local version currently installed` |
| /etc/pam.d/su | Lai paturētu, atbildiet `N` |
| /etc/sysctl.conf | Lai paturētu, atbildiet `N` |
| /etc/audit/rules.d/audit.rules | Lai paturētu, atbildiet `N` |
| /etc/ssh/ssh_config | Lai lietotu izmaiņas, atbildiet `Y` |
| /usr/share/tomcat10/logrotate.template | Lai lietotu izmaiņas, atbildiet `Install the package maintainer's version` |

Akceptējiet pakalpojumu automātisku restartēšanu: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Kad jaunināšana ir pabeigta, izpildiet šādas komandas, lai atkārtoti aktivizētu `collectd`, noņemtu nevajadzīgās pakotnes un restartētu datoru:

```
1
2
3
4
```

## Validēšana

Kad jaunināšanas darbība ir pabeigta, pirms atgriešanās ražošanas vidē ir nepieciešams validēšanas posms, lai pārliecinātos, ka CyberElements Bastion infrastruktūra darbojas pareizi. Ja validēšana neizdodas, jāapsver atrite, atjaunojot CyberElements Bastion serveru dublējumus.

Atveriet administratora saskarni un pēc tam Edge Gateway serveru pārvaldības izvēlni.

Atjauninātajiem Edge Gateway serveriem ir jāuzrāda versija 8.9, ja tie ir veiksmīgi atkārtoti izveidojuši savienojumu ar Mediation Controller serveri.

Ja visi serveri ir jaunināti, var veikt visus funkcionālos testus, lai validētu visu pieņemšanas kontrolsarakstu.
