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

Teave

Meeldetuletuseks: Debiani arvutites tuleb kasutajale root lülituda järgmise käsuga:

su -

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

Peegli ja vajalike tööriistade allalaadimine¶

CyberElements Cleanroom 4.6 peegli saab alla laadida siit (nõuab kliendikonto loomist): Systancia Marketplace

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)
SCP-klient (Windowsis saab kasutada tööriistu WinSCP või FileZilla)

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:

apt install --no-install-recommends screen

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

1	`screen -S <ID>`

Asendage <ID> nimega, mis seansi tuvastab.

Näide

CyberElements versiooniuuenduste puhul on identifikaator cye-upgrade kergesti äratuntav. Käsk oleks seega järgmine:

1	`screen -S cye-upgrade`

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

1	`screen -r <ID>`

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

Näide

Varem identifikaatoriga cye-upgrade avatud terminali saab taastada järgmise käsuga:

1	`screen -r cye-upgrade`

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

apt update
apt upgrade -y
apt autoremove -y

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

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

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:

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

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

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:

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

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

1	`apt update`

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.

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:

systemctl stop collectd 
systemctl disable collectd

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

1	`apt dist-upgrade -y`

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:

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

systemctl start collectd
systemctl enable collectd
apt autoremove -y
reboot

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.