Nadgradnja komponente Edge Gateway med delovanjem

Pomembno

Dokumentacija za nadgradnjo komponente Edge Gateway med delovanjem je namenjena vsem komponentam Edge Gateway, ki se izvajajo v sistemu Debian 11. Različico sistema Debian lahko preverite z naslednjim ukazom (izvedite ga prek SSH ali dostopa do konzole):

cat /etc/debian_version

Informacije

Opomnimo, da je treba na računalnikih Debian preklop na root izvesti z naslednjim ukazom:

su -

Načrtovanje in priprava

Odpiranje omrežnih tokov

Pri nadgradnji izdelka je treba zaradi prehoda z različice Debian 11 na 12 prenesti številne pakete iz skladišč sistema Debian. Odprt mora biti dostop TCP 80 do security.debian.org in ftp.fr.debian.org.

Če želite preizkusiti, ali so tokovi v računalniku odprti, lahko zaženete sinhronizacijo skladišč sistema Debian. Če se prikažejo sporočila o napakah pri dostopu do skladišč sistema Debian, omrežni tok ni odprt in ga verjetno blokira požarni zid podjetja. Sinhronizacijo skladišč lahko zaženete z naslednjim ukazom:

apt update

Prenos zrcala in potrebnih orodij

Zrcalo CyberElements Cleanroom 4.6 lahko prenesete s te povezave (zahteva ustvarjanje računa stranke): Systancia Marketplace

Ključ systancia.gpg, s katerim se preverja pristnost skladišča CyberElements Bastion, je treba prav tako prenesti s Systancia Marketplace.

Poleg zrcala boste za postopek nadgradnje potrebovali orodja drugih ponudnikov:

• Odjemalec SSH (v sistemu Windows lahko uporabite orodje PuTTY)
• Odjemalec SCP (v sistemu Windows lahko uporabite orodji WinSCP ali FileZilla)

Namestitev in uporaba orodja screen

Orodje screen omogoča odpiranje več terminalov lupine v eni konzoli. To orodje je nujno uporabiti pri nadgradnji različice CyberElements Bastion, da odpravite odvisnost od stabilnosti omrežne povezljivosti. Brez orodja screen bi se namestitev namreč ustavila ob prekinitvi povezljivosti SSH s strežniki CyberElements Bastion.

Z orodjem screen lahko ob ponovni povezavi s konzolo lupine opreme CyberElements Bastion znova pridobite terminal, v katerem se je izvajal postopek posodobitve.

Paket screen namestite z naslednjo ukazno vrstico:

apt install --no-install-recommends screen

Če želite odpreti nov terminal screen, izvedite naslednji ukaz:

screen -S <ID>

Zamenjajte <ID> z imenom, ki identificira sejo.

Primer

Pri nadgradnjah različice CyberElements je identifikator cye-upgrade lahko prepoznaven. Ukaz bi bil torej naslednji:

screen -S cye-upgrade

Če želite znova pridobiti terminal, ki ga je odprlo orodje screen, preprosto izvedite naslednji ukaz:

screen -r <ID>

Zamenjajte <ID> z imenom, določenim ob odpiranju seje.

Primer

Terminal, ki je bil prej odprt z identifikatorjem cye-upgrade, lahko znova pridobite z naslednjim ukazom:

screen -r cye-upgrade

Če želite terminal zapreti po končani nadgradnji, v terminalu vnesite ukaz exit ali uporabite bližnjico na tipkovnici ctrl+d.

S tem se vrnete v konzolo. Sporočilo „screen is terminating“ potrjuje, da je bil terminal zaprt.

Nadgradnja

Posodabljanje paketov sistema Debian

Ker nadgradnja CyberElements Bastion zahteva nadgradnjo sistema Debian, je priporočljivo, da pred prehodom na Debian 12 ustrezno posodobite pakete Debian 11. To storite tako, da kot root zaženete naslednje ukaze (posodobitev sistema in nato odstranitev nepotrebnih paketov):

apt update
apt upgrade -y
apt autoremove -y

Prikažejo se lahko sporočila, ki vas pozivajo k spremembi konfiguracije več konfiguracijskih datotek. V teh primerih izberite možnost, da ohranite trenutno konfiguracijo.

Priprava zrcala CyberElements Cleanroom 4.6

Zrcalo, pridobljeno v fazi priprave (datoteka s pripono tgz), je treba poslati na strežnik prek SCP. Postaviti ga je treba v imenik /tmp/.

Nato pripravite zrcalo tako, da kot root izvedete naslednje ukaze (preostale datoteke iz prejšnje nadgradnje različice bodo izbrisane):

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

Konfiguracija APT

Upravitelj paketov APT je konfiguriran za pridobivanje paketov Debian 11; znova ga je treba konfigurirati za pridobivanje paketov Debian 12. Posodobiti je treba tudi sklic na lokalno zrcalo CyberElements Bastion. To storite tako, da kot root zaženete naslednje ukaze:

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

Pristnost lokalnega zrcala se preverja s ključem systancia.gpg, prenesenim v fazi priprave. Prek protokola SCP ga pošljite na strežnik v imenik /tmp/ in ga nato kot root namestite z naslednjim ukazom:

mv /tmp/systancia.gpg /etc/apt/trusted.gpg.d/

Poleg konfiguracije novih skladišč močno priporočamo, da uporabite naslednjo nastavitev, s katero upravitelju APT naročite, naj ne namešča priporočenih odvisnosti, ki niso nujno potrebne, in tako zmanjšate število nameščenih komponent. Naslednji ukaz uporabi to nastavitev kot root:

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

Na koncu je treba posodobiti seznam paketov v skladiščih z naslednjim ukazom:

apt update

Sprožitev nadgradnje različice

Prek SSH dostopite do strežnika Edge Gateway in preklopite na root, nato odprite sejo screen, kot je navedeno zgoraj.

Pri nadgradnji komponente Edge Gateway s sistema Debian 11 na Debian 12 se paket collectd posodobi in postane nezdružljiv s konfiguracijsko datoteko, ki jo ustvari CyberElements Bastion (/etc/collectd/collectd.conf). To lahko med posodobitvijo povzroči napako.

Da se temu izognete, onemogočite collectd:

systemctl stop collectd 
systemctl disable collectd

Nato lahko nadgradnjo zaženete z naslednjim ukazom:

apt dist-upgrade -y

Med nadgradnjo boste dobili več vprašanj o tem, ali želite konfiguracijske datoteke ohraniti in jih posodobiti v skladu s standardno konfiguracijo sistema Debian 12 ali ohraniti obstoječo specifično konfiguracijo. Tukaj so naša priporočila za večino datotek, na katere lahko naletite:

Konfiguracijska datoteka	Priporočeno dejanje
/etc/issue	Za ohranitev odgovorite N
/etc/issue.net	Za ohranitev odgovorite N
/etc/security/limits.conf	Za ohranitev odgovorite N
/etc/login.defs	Za ohranitev odgovorite N
/etc/snmp/snmpd.conf	Uveljavite spremembe, odgovorite Y
/etc/ssh/sshd_config	Ohranite, odgovorite Keep the local version currently installed
/etc/pam.d/su	Ohranite, odgovorite N
/etc/sysctl.conf	Ohranite, odgovorite N
/etc/audit/rules.d/audit.rules	Ohranite, odgovorite N
/etc/ssh/ssh_config	Uveljavite spremembe, odgovorite Y
/usr/share/tomcat10/logrotate.template	Uveljavite spremembe, odgovorite Install the package maintainer's version

Sprejmite samodejni ponovni zagon storitev:

Ko je nadgradnja končana, zaženite naslednje ukaze, da znova aktivirate collectd, odstranite nepotrebne pakete in znova zaženete računalnik:

systemctl start collectd
systemctl enable collectd
apt autoremove -y
reboot

Preverjanje veljavnosti

Ko je nadgradnja končana, je pred vrnitvijo v produkcijo potrebna faza preverjanja veljavnosti, ki zagotovi, da infrastruktura CyberElements Bastion pravilno deluje. Če preverjanje ne uspe, razmislite o povrnitvi prejšnjega stanja z obnovitvijo varnostnih kopij strežnikov CyberElements Bastion.

Odprite skrbniški vmesnik in nato meni za upravljanje strežnikov Edge Gateway.

Posodobljeni strežniki Edge Gateway bi morali poročati različico 8.9, če so se uspešno znova povezali s storitvijo Mediation Controller.

Če so bili nadgrajeni vsi strežniki, lahko izvedete vse funkcionalne preizkuse, da potrdite celoten kontrolni seznam za prevzem.