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

# Upgrade komponentu Edge Gateway za chodu

> **Dôležité**
>
> Dokumentácia k upgradu komponentu Edge Gateway za chodu je určená pre každý komponent Edge Gateway so systémom Debian 11. Verziu systému Debian možno skontrolovať nasledujúcim príkazom (spustite cez SSH alebo prístup ku konzole):
>
> ```
> 1
> ```

> **Informácie**
>
> Pripomíname, že prepnutie na používateľa `root` na počítačoch so systémom Debian sa musí vykonať nasledujúcim príkazom:
>
> ```
> 1
> ```

## Plánovanie a príprava

### Otvorenie sieťových tokov

Pri upgrade produktu je potrebné stiahnuť z úložísk systému Debian mnoho balíkov, pretože dochádza k prechodu z verzie Debian 11 na verziu 12. Prístup cez `TCP 80` musí byť otvorený na `security.debian.org` a `ftp.fr.debian.org`.

Otvorenie tokov na počítači môžete otestovať spustením synchronizácie úložísk systému Debian. Ak sa zobrazia chybové hlásenia týkajúce sa prístupu k úložiskám systému Debian, sieťový tok nie je otvorený a pravdepodobne ho blokuje podniková brána firewall. Synchronizáciu úložísk možno spustiť nasledujúcim príkazom:

```
1
```

### Stiahnutie zrkadla a potrebných nástrojov

Zrkadlo CyberElements Cleanroom 4.6 si môžete stiahnuť z tohto odkazu (vyžaduje vytvorenie zákazníckeho účtu): [Systancia Marketplace](https://www.systancia.com/en/my-systancia/marketplace/systancia-cleanroom/downloads-cleanroom/)

Kľúč `systancia.gpg`, ktorý overuje úložisko CyberElements Bastion, je tiež potrebné stiahnuť zo Systancia Marketplace.

Okrem zrkadla budú na proces upgradu potrebné nástroje tretích strán:

- Klient SSH (v systéme Windows možno použiť nástroj [PuTTY](https://putty.org/))
- Klient SCP (v systéme Windows možno použiť nástroje [WinSCP](https://winscp.net/eng/index.php) alebo [FileZilla](https://filezilla-project.org/))

### Inštalácia a používanie nástroja screen

Nástroj `screen` umožňuje otvoriť viacero terminálov shellu v jednej konzole. Na vykonanie upgradu verzie CyberElements Bastion je nevyhnutné použiť tento nástroj, aby sa odstránila závislosť od stability sieťového pripojenia. Bez použitia nástroja screen by sa totiž inštalácia v prípade prerušenia pripojenia SSH k serverom CyberElements Bastion zastavila.

Vďaka nástroju `screen` je pri opätovnom pripojení ku konzole shellu zariadení CyberElements Bastion možné obnoviť terminál, v ktorom bol spustený proces aktualizácie.

Balík screen je potrebné nainštalovať pomocou nasledujúceho príkazového riadka:

```
1
```

Ak chcete otvoriť nový terminál `screen`, je potrebné spustiť nasledujúci príkaz:

```
1
```

Nahraďte `<ID>` názvom, ktorý identifikuje reláciu.

> **Príklad**
>
> Pri upgrade verzie CyberElements je identifikátor `cye-upgrade` ľahko rozpoznateľný. Príkaz by teda vyzeral takto:
>
> ```
> 1
> ```

Ak chcete obnoviť terminál otvorený nástrojom `screen`, stačí spustiť nasledujúci príkaz:

```
1
```

Nahraďte `<ID>` názvom definovaným pri otvorení relácie.

> **Príklad**
>
> Terminál otvorený predtým s identifikátorom `cye-upgrade` možno obnoviť nasledujúcim príkazom:
>
> ```
> 1
> ```

Ak chcete terminál po dokončení upgradu zatvoriť, zadajte v termináli príkaz `exit` alebo klávesovú skratku ctrl+d.

Tým sa vrátite do konzoly. Hlásenie „screen is terminating“ potvrdzuje, že terminál bol zatvorený.

## Upgrade

### Aktualizácia balíkov systému Debian

Keďže upgrade CyberElements Bastion vyžaduje upgrade systému Debian, odporúča sa pred prechodom na Debian 12 riadne aktualizovať balíky Debian 11. Ak to chcete urobiť, spustite nasledujúce príkazy ako `root` (aktualizácia systému a potom odstránenie nepotrebných balíkov):

```
1
2
3
```

Môžu sa zobraziť hlásenia so žiadosťou o úpravu konfigurácie niekoľkých konfiguračných súborov. V takom prípade vyberte možnosť zachovať aktuálnu konfiguráciu.

### Príprava zrkadla CyberElements Cleanroom 4.6

Zrkadlo stiahnuté vo fáze prípravy (súbor s príponou tgz) je potrebné odoslať na server cez SCP. Treba ho umiestniť do adresára `/tmp/`.

Potom pripravte zrkadlo spustením nasledujúcich príkazov ako `root` (zvyškové súbory z predchádzajúceho upgradu verzie sa odstránia):

```
1
2
3
```

### Konfigurácia APT

Správca balíkov APT je nakonfigurovaný na načítavanie balíkov Debian 11; je potrebné ho prekonfigurovať na načítavanie balíkov Debian 12. Je tiež potrebné aktualizovať odkaz na lokálne zrkadlo CyberElements Bastion. Ak to chcete urobiť, spustite nasledujúce príkazy ako `root`:

```
1
2
```

Lokálne zrkadlo je overené kľúčom `systancia.gpg` stiahnutým počas fázy prípravy. Odošlite ho na server cez SCP do adresára `/tmp/` a potom ho nainštalujte nasledujúcim príkazom ako `root`:

```
1
```

Okrem konfigurácie nových úložísk dôrazne odporúčame použiť nasledujúce nastavenie, ktorým správcovi APT prikážete neinštalovať odporúčané závislosti, ktoré nie sú nevyhnutne potrebné, a znížiť tak počet inštalovaných komponentov. Nasledujúci príkaz použije toto nastavenie ako `root`:

```
1
```

Nakoniec je potrebné aktualizovať zoznam balíkov v úložiskách nasledujúcim príkazom:

```
1
```

### Spustenie upgradu verzie

Pripojte sa k serveru Edge Gateway cez SSH a prepnite sa na `root`, potom otvorte reláciu nástroja screen [podľa pokynov vyššie](#installing-and-using-the-screen-tool).

Pri prechode komponentu Edge Gateway zo systému Debian 11 na Debian 12 sa balík `collectd` aktualizuje a stane sa nekompatibilným s konfiguračným súborom, ktorý generuje CyberElements Bastion (`/etc/collectd/collectd.conf`). To môže počas aktualizácie spôsobiť chybu.

Aby ste tomu predišli, zakážte collectd:

```
1
2
```

Potom možno upgrade spustiť nasledujúcim príkazom:

```
1
```

Počas upgradu dostanete niekoľko otázok, či zachovať konfiguračné súbory a aktualizovať ich podľa štandardnej konfigurácie systému Debian 12, alebo ponechať existujúcu špecifickú konfiguráciu. Tu sú naše odporúčania pre väčšinu súborov, s ktorými sa môžete stretnúť:

| Konfiguračný súbor | Odporúčaná akcia |
|---|---|
| /etc/issue | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/issue.net | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/security/limits.conf | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/login.defs | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/snmp/snmpd.conf | Ak chcete použiť zmeny, odpovedzte `Y` |
| /etc/ssh/sshd_config | Ak chcete súbor zachovať, odpovedzte `Keep the local version currently installed` |
| /etc/pam.d/su | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/sysctl.conf | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/audit/rules.d/audit.rules | Ak chcete súbor zachovať, odpovedzte `N` |
| /etc/ssh/ssh_config | Použite zmeny, odpovedzte `Y` |
| /usr/share/tomcat10/logrotate.template | Použite zmeny, odpovedzte `Install the package maintainer's version` |

Prijmite automatický reštart služieb: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_MediationControllerUpgrade_RestartServices.png)

Po dokončení upgradu spustite nasledujúce príkazy, aby ste znova aktivovali `collectd`, odstránili nepotrebné balíky a reštartovali počítač:

```
1
2
3
4
```

## Validácia

Po dokončení operácie upgradu je pred návratom do produkčnej prevádzky potrebná fáza validácie, ktorá overí správne fungovanie infraštruktúry CyberElements Bastion. Ak validácia zlyhá, treba zvážiť vrátenie zmien obnovením záloh serverov CyberElements Bastion.

Prejdite do rozhrania správcu a potom do ponuky správy serverov Edge Gateway.

Aktualizované servery Edge Gateway by mali hlásiť verziu 8.9, ak sa úspešne znova pripojili k serveru Mediation Controller.

Ak bol vykonaný upgrade všetkých serverov, možno vykonať všetky funkčné testy a validovať celý kontrolný zoznam akceptácie.
