Nadogradnja komponente Edge Gateway tijekom rada¶

Važno

Dokumentacija za nadogradnju komponente Edge Gateway tijekom rada namijenjena je svakoj komponenti Edge Gateway koja radi na sustavu Debian 11. Verziju sustava Debian možete provjeriti sljedećom naredbom (izvršava se putem pristupa SSH ili konzoli):

1	`cat /etc/debian_version`

Informacije

Podsjetnik: prebacivanje na root na računalima sa sustavom Debian mora se izvršiti sljedećom naredbom:

su -

Planiranje i priprema¶

Otvaranje mrežnih tokova¶

Pri nadogradnji proizvoda mnogo se paketa mora preuzeti iz repozitorija sustava Debian zbog prijelaza s verzije Debian 11 na verziju 12. Pristup putem TCP 80 mora biti otvoren prema security.debian.org i ftp.fr.debian.org.

Da biste testirali otvorenost tokova na računalu, možete pokrenuti sinkronizaciju repozitorija sustava Debian. Ako se prikažu poruke o pogreškama u vezi s pristupom repozitorijima sustava Debian, mrežni tok nije otvoren, a vjerojatno ga blokira vatrozid tvrtke. Sinkronizaciju repozitorija možete pokrenuti sljedećom naredbom:

1	`apt update`

Preuzimanje zrcala i potrebnih alata¶

Zrcalo CyberElements Cleanroom 4.6 možete preuzeti s ove poveznice (potrebno je stvoriti račun klijenta): Systancia Marketplace

Ključ systancia.gpg, koji služi za provjeru autentičnosti repozitorija CyberElements Bastion, također se mora preuzeti sa servisa Systancia Marketplace.

Uz zrcalo, za postupak nadogradnje bit će potrebni alati trećih strana:

SSH klijent (u sustavu Windows možete upotrijebiti alat PuTTY)
SCP klijent (u sustavu Windows možete upotrijebiti alate WinSCP ili FileZilla)

Instalacija i korištenje alata screen¶

Alat screen omogućuje otvaranje više terminala ljuske u jednoj konzoli. Taj je alat nužno upotrijebiti za nadogradnju verzije rješenja CyberElements Bastion kako bi se uklonila ovisnost o stabilnosti mrežne povezivosti. Naime, bez alata screen instalacija bi se prekinula u slučaju prekida SSH povezivosti s poslužiteljima CyberElements Bastion.

Zahvaljujući alatu screen, pri ponovnom povezivanju s konzolom ljuske opreme CyberElements Bastion može se vratiti terminal u kojem se izvršavao postupak ažuriranja.

Paket screen treba instalirati sljedećim naredbenim retkom:

apt install --no-install-recommends screen

Da biste otvorili novi terminal screen, morate izvršiti sljedeću naredbu:

1	`screen -S <ID>`

Zamijenite <ID> nazivom koji identificira sesiju.

Primjer

Za nadogradnje verzije proizvoda CyberElements identifikator cye-upgrade lako je prepoznatljiv. Naredba bi stoga bila sljedeća:

1	`screen -S cye-upgrade`

Da biste vratili terminal otvoren pomoću alata screen, dovoljno je izvršiti sljedeću naredbu:

1	`screen -r <ID>`

Zamijenite <ID> nazivom definiranim pri otvaranju sesije.

Primjer

Terminal prethodno otvoren s identifikatorom cye-upgrade može se vratiti sljedećom naredbom:

1	`screen -r cye-upgrade`

Da biste zatvorili terminal nakon dovršetka nadogradnje, u terminal unesite naredbu exit ili tipkovnički prečac ctrl+d.

Time ćete se vratiti u konzolu. Poruka „screen is terminating“ potvrđuje da je terminal zatvoren.

Nadogradnja¶

Ažuriranje paketa sustava Debian¶

Budući da nadogradnja rješenja CyberElements Bastion zahtijeva nadogradnju sustava Debian, preporučuje se da prije prelaska na Debian 12 ispravno ažurirate pakete sustava Debian 11. Da biste to učinili, pokrenite sljedeće naredbe kao root (ažuriranje sustava, a zatim uklanjanje nepotrebnih paketa):

apt update
apt upgrade -y
apt autoremove -y

Mogu se pojaviti poruke koje od vas traže da izmijenite konfiguraciju nekoliko konfiguracijskih datoteka. U tim slučajevima odaberite mogućnost zadržavanja trenutačne konfiguracije.

Priprema zrcala CyberElements Cleanroom 4.6¶

Zrcalo preuzeto tijekom faze pripreme (datoteka s nastavkom tgz) mora se poslati na poslužitelj protokolom SCP. Treba ga smjestiti u direktorij /tmp/.

Zatim pripremite zrcalo izvršavanjem sljedećih naredbi kao root (preostale datoteke iz neke starije nadogradnje verzije bit će izbrisane):

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

Konfiguracija alata APT¶

Upravitelj paketa APT konfiguriran je za dohvaćanje paketa sustava Debian 11; mora se ponovno konfigurirati za dohvaćanje paketa sustava Debian 12. Također je potrebno ažurirati referencu na lokalno zrcalo rješenja CyberElements Bastion. Da biste to učinili, pokrenite sljedeće naredbe kao 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

Autentičnost lokalnog zrcala provjerava se ključem systancia.gpg preuzetim tijekom faze pripreme. Pošaljite ga na poslužitelj protokolom SCP, u direktorij /tmp/, a zatim ga instalirajte sljedećom naredbom kao root:

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

Uz konfiguraciju novih repozitorija, toplo preporučujemo da primijenite sljedeću postavku kojom se alatu APT nalaže da ne instalira preporučene ovisnosti koje nisu nužno potrebne, kako bi se smanjio broj instaliranih komponenti. Sljedeća naredba primjenjuje tu postavku kao root:

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

Na kraju je potrebno ažurirati popis paketa u repozitorijima sljedećom naredbom:

1	`apt update`

Pokretanje nadogradnje verzije¶

Pristupite poslužitelju Edge Gateway putem protokola SSH i prebacite se na root, a zatim otvorite sesiju alata screen kako je prethodno navedeno.

Pri nadogradnji komponente Edge Gateway sa sustava Debian 11 na Debian 12 paket collectd se ažurira i postaje nekompatibilan s konfiguracijskom datotekom koju generira CyberElements Bastion (/etc/collectd/collectd.conf). To može uzrokovati pogrešku tijekom ažuriranja.

Da biste to izbjegli, onemogućite collectd:

systemctl stop collectd 
systemctl disable collectd

Nakon toga nadogradnja se može pokrenuti sljedećom naredbom:

1	`apt dist-upgrade -y`

Tijekom nadogradnje bit će vam postavljeno nekoliko pitanja o tome želite li zadržati konfiguracijske datoteke i ažurirati ih prema standardnoj konfiguraciji sustava Debian 12 ili zadržati postojeću specifičnu konfiguraciju. Evo naših preporuka za većinu datoteka na koje možete naići:

Konfiguracijska datoteka	Preporučena radnja
/etc/issue	Za zadržavanje odgovorite `N`
/etc/issue.net	Za zadržavanje odgovorite `N`
/etc/security/limits.conf	Za zadržavanje odgovorite `N`
/etc/login.defs	Za zadržavanje odgovorite `N`
/etc/snmp/snmpd.conf	Primijenite promjene, odgovorite `Y`
/etc/ssh/sshd_config	Za zadržavanje odgovorite `Keep the local version currently installed`
/etc/pam.d/su	Za zadržavanje odgovorite `N`
/etc/sysctl.conf	Za zadržavanje odgovorite `N`
/etc/audit/rules.d/audit.rules	Za zadržavanje odgovorite `N`
/etc/ssh/ssh_config	Primijenite promjene, odgovorite `Y`
/usr/share/tomcat10/logrotate.template	Primijenite promjene, odgovorite `Install the package maintainer's version`

Prihvatite automatsko ponovno pokretanje usluga:

Kada je nadogradnja dovršena, pokrenite sljedeće naredbe da biste ponovno aktivirali collectd, uklonili nepotrebne pakete i ponovno pokrenuli računalo:

systemctl start collectd
systemctl enable collectd
apt autoremove -y
reboot

Provjera valjanosti¶

Nakon dovršetka nadogradnje, prije povratka u produkciju potrebna je faza provjere valjanosti kojom se osigurava ispravan rad infrastrukture CyberElements Bastion. Ako provjera valjanosti ne uspije, treba razmotriti vraćanje na prethodno stanje vraćanjem sigurnosnih kopija poslužitelja CyberElements Bastion.

Pristupite administratorskom sučelju, a zatim izborniku za upravljanje poslužiteljima Edge Gateway.

Ažurirani poslužitelji Edge Gateway trebali bi prikazivati verziju 8.9 ako su se uspješno ponovno povezali s uslugom Mediation Controller.

Ako su svi poslužitelji nadograđeni, mogu se provesti svi funkcionalni testovi radi provjere valjanosti cijelog kontrolnog popisa prihvaćanja.