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	`cat /etc/debian_version`

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:

su -

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	`apt update`

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

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)
Klient SCP (v systéme Windows možno použiť nástroje WinSCP alebo FileZilla)

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:

apt install --no-install-recommends screen

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

1	`screen -S <ID>`

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	`screen -S cye-upgrade`

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

1	`screen -r <ID>`

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	`screen -r cye-upgrade`

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):

apt update
apt upgrade -y
apt autoremove -y

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):

mkdir -p /opt/systancia/repository
rm -rf /opt/systancia/repository/*
tar xvzf /tmp/*.tgz -C /opt/systancia/repository/

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:

echo -e 'deb http://security.debian.org/debian-security/ bookworm-security main contrib non-free non-free-firmware\ndeb http://ftp.fr.debian.org/debian bookworm main contrib non-free non-free-firmware\ndeb http://ftp.fr.debian.org/debian bookworm-updates main contrib non-free non-free-firmware' > /etc/apt/sources.list
echo "deb file:///opt/systancia/repository/ bookworm ipdiva" > /etc/apt/sources.list.d/systancia.list

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	`mv /tmp/systancia.gpg /etc/apt/trusted.gpg.d/`

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:

echo -e 'APT::Install-Recommends false;\nAPT::Install-Suggests false;' > /etc/apt/apt.conf.d/99norecommends

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

1	`apt update`

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.

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:

systemctl stop collectd 
systemctl disable collectd

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

1	`apt dist-upgrade -y`

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:

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

systemctl start collectd
systemctl enable collectd
apt autoremove -y
reboot

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.