Надграждане на Edge Gateway по време на работа¶

Важно

Документацията за надграждане на Edge Gateway по време на работа е предназначена за всеки Edge Gateway, работещ с Debian 11. Версията на Debian може да се провери със следната команда (изпълнява се чрез SSH или достъп до конзолата):

1	`cat /etc/debian_version`

Информация

Като напомняне, превключването към root на компютри с Debian трябва да се извършва със следната команда:

su -

Планиране и подготовка¶

Отваряне на мрежовите потоци¶

При надграждане на продукта много пакети трябва да бъдат изтеглени от хранилищата на Debian поради прехода от Debian версия 11 към 12. Достъпът през TCP 80 до security.debian.org и ftp.fr.debian.org трябва да бъде отворен.

За да проверите отварянето на потоците на компютъра, може да стартирате синхронизиране на хранилищата на Debian. Ако се покажат съобщения за грешки относно достъпа до хранилищата на Debian, мрежовият поток не е отворен и вероятно е блокиран от корпоративната защитна стена. Синхронизирането на хранилищата може да се стартира със следната команда:

1	`apt update`

Изтегляне на огледалото и необходимите инструменти¶

Огледалото на CyberElements Cleanroom 4.6 може да бъде изтеглено от тази връзка (изисква създаване на клиентски акаунт): Systancia Marketplace

Ключът systancia.gpg, който удостоверява хранилището на CyberElements Bastion, също трябва да бъде изтеглен от Systancia Marketplace.

Освен огледалото, за процеса на надграждане ще са необходими инструменти на трети страни:

SSH клиент (в Windows може да се използва инструментът PuTTY)
SCP клиент (в Windows могат да се използват инструментите WinSCP или FileZilla)

Инсталиране и използване на инструмента screen¶

Инструментът screen ви позволява да отваряте няколко терминала на обвивката в една конзола. Използването на този инструмент е задължително за надграждането на версията на CyberElements Bastion, за да се премахне зависимостта от стабилността на мрежовата свързаност. Всъщност без инструмента screen инсталирането би било спряно при прекъсване на SSH връзката със сървърите на CyberElements Bastion.

Благодарение на инструмента screen, при повторно свързване към конзолата на обвивката на оборудването на CyberElements Bastion можете да възстановите терминала, в който е бил изпълнен процесът на актуализиране.

Пакетът screen трябва да се инсталира със следния команден ред:

apt install --no-install-recommends screen

За да отворите нов терминал screen, трябва да изпълните следната команда:

1	`screen -S <ID>`

Заменете <ID> с име, което идентифицира сесията.

Пример

При надграждане на версията на CyberElements идентификаторът cye-upgrade е лесно разпознаваем. Следователно командата би била следната:

1	`screen -S cye-upgrade`

За да възстановите терминал, отворен от screen, просто изпълнете следната команда:

1	`screen -r <ID>`

Заменете <ID> с името, зададено при отварянето на сесията.

Пример

Терминалът, отворен преди това с идентификатора cye-upgrade, може да бъде възстановен със следната команда:

1	`screen -r cye-upgrade`

За да затворите терминала след завършване на надграждането, въведете в терминала командата exit или клавишната комбинация ctrl+d.

Това ще ви върне в конзолата. Съобщението „screen is terminating“ потвърждава, че терминалът е затворен.

Надграждане¶

Актуализиране на пакетите на Debian¶

Тъй като надграждането на CyberElements Bastion изисква надграждане на Debian, препоръчително е да актуализирате правилно пакетите на Debian 11, преди да преминете към Debian 12. За да направите това, изпълнете следните команди като root (актуализиране на системата, след което премахване на ненужните пакети):

apt update
apt upgrade -y
apt autoremove -y

Може да се появят съобщения, които ви подканват да промените конфигурацията на няколко конфигурационни файла. В тези случаи изберете опцията за запазване на текущата конфигурация.

Подготовка на огледалото на CyberElements Cleanroom 4.6¶

Огледалото, изтеглено по време на фазата на подготовка (файл с разширение tgz), трябва да бъде изпратено на сървъра чрез SCP. То трябва да бъде поставено в директорията /tmp/.

След това подгответе огледалото, като изпълните следните команди като root (остатъчните файлове от предишно надграждане на версия ще бъдат изтрити):

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

Конфигурация на APT¶

Мениджърът на пакети APT е конфигуриран да изтегля пакети за Debian 11; той трябва да бъде преконфигуриран да изтегля пакети за Debian 12. Необходимо е също да се актуализира препратката към локалното огледално хранилище на CyberElements Bastion. За да направите това, изпълнете следните команди като 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

Локалното огледално хранилище се удостоверява с ключа systancia.gpg, изтеглен по време на фазата на подготовка. Изпратете го до сървъра чрез SCP в директорията /tmp/, след което го инсталирайте със следната команда като root:

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

Освен конфигурирането на новите хранилища, силно препоръчваме да приложите следната настройка, за да укажете на APT да не инсталира препоръчаните зависимости, които не са строго необходими, с цел да се намали броят на инсталираните компоненти. Следната команда прилага тази настройка като root:

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

Накрая е необходимо да актуализирате списъка с пакети в хранилищата със следната команда:

1	`apt update`

Задействане на надграждането на версията¶

Влезте в сървъра Edge Gateway чрез SSH и превключете към root, след което отворете сесия на screen както е посочено по-горе.

При надграждане на Edge Gateway от Debian 11 до Debian 12 пакетът collectd се актуализира и става несъвместим с конфигурационния файл, генериран от CyberElements Bastion (/etc/collectd/collectd.conf). Това може да предизвика грешка по време на актуализирането.

За да избегнете това, деактивирайте collectd:

systemctl stop collectd 
systemctl disable collectd

След това надграждането може да бъде стартирано със следната команда:

1	`apt dist-upgrade -y`

По време на надграждането ще ви бъдат зададени няколко въпроса дали да запазите конфигурационните файлове и да ги актуализирате според стандартната конфигурация на Debian 12, или да запазите текущата специфична конфигурация. Ето нашите препоръки за повечето файлове, които може да срещнете:

Конфигурационен файл	Препоръчително действие
/etc/issue	Запазете – отговорете `N`
/etc/issue.net	Запазете – отговорете `N`
/etc/security/limits.conf	Запазете – отговорете `N`
/etc/login.defs	Запазете – отговорете `N`
/etc/snmp/snmpd.conf	Приложете промените, отговорете `Y`
/etc/ssh/sshd_config	За да запазите, отговорете `Keep the local version currently installed`
/etc/pam.d/su	За да запазите, отговорете `N`
/etc/sysctl.conf	За да запазите, отговорете `N`
/etc/audit/rules.d/audit.rules	За да запазите, отговорете `N`
/etc/ssh/ssh_config	Приложете промените, отговорете `Y`
/usr/share/tomcat10/logrotate.template	Приложете промените, отговорете `Install the package maintainer's version`

Приемете автоматичното рестартиране на услугите:

След като надграждането завърши, изпълнете следните команди, за да активирате отново collectd, да премахнете ненужните пакети и да рестартирате компютъра:

systemctl start collectd
systemctl enable collectd
apt autoremove -y
reboot

Валидиране¶

След като операцията по надграждане приключи, преди връщането в производствена среда е необходима фаза на валидиране, която да гарантира, че инфраструктурата на CyberElements Bastion функционира правилно. Ако валидирането е неуспешно, трябва да се обмисли връщане към предишното състояние чрез възстановяване на резервните копия на сървърите на CyberElements Bastion.

Отворете административния интерфейс, след което менюто за управление на сървърите Edge Gateway.

Актуализираните сървъри Edge Gateway трябва да показват версия 8.9, ако успешно са се свързали отново със сървъра Mediation Controller.

Ако всички сървъри са надградени, могат да се извършат всички функционални тестове, за да се валидира целият контролен списък за приемане.