Подготовка

Если контроллер SoftWLC установлен на старой версии Ubuntu (меньше 22.04 LTS) то обновление до новых версий SoftWLC требует обновление ОС хоста до поддерживаемых.

В рамках данной инструкции будет рассмотренно обновление через создание нового хоста с поддерживаемой ОС и последующей миграцией данных на этот хост. Все действия будут производится с помощью инструментов Ansible.

Схема обновления

Обновление производится в несколько этапов:

1) Установка хоста с поддерживаемой ОС (не будет рассмотренно в рамках данной инструкции)

2) Установка решения в Docker с использованием Ansible

3) Миграция базы данных

4) Перенос лицензий

5) Смена виртуального ip адреса (только для многохостовой установки)

Установка решения в Docker с использованием Ansible

После создания хоста с поддерживаемой ОС на него необходимо установить новую версию SoftWLC.

Для установки можно воспользоваться инструкцией, соответствующей вашей требуемой версии:

Standalone version

v1.37_Пошаговая установка SoftWLC в Docker через Ansible скриптом-установщиком

Reservation 1+1 (Galera Cluster) version

v1.37_Настройка схемы резервирования SoftWLC 1+1 в Docker при помощи Ansible

Replication 1+1+3 Galera Database Nodes version

v1.37_Настройка схемы репликации SoftWLC 1+1+3 GaleraNodes в Docker при помощи Ansible

Миграция базы данных

Шаги по переносу базы данных:

1) Подключиться по SSH на хост, со старой версией ОС:

ssh <user_login>@<ip_address>

3) Перейти в директорию /var/lib/mysql/

cd /var/lib/mysql/

4) Проверить установленный пакет

sudo apt update && sudo apt install zip

5) Создать архив с файлами выбранной директории. Для удобства дальнейшего переноса файлов разместите его в домашней директории пользователя.

zip -r /home/<user_login>/mysql_backup.zip *

6) Скопировать данный архив на хост, где будет разворачиваться решение в Docker-Ansible, первая нода с базой данных:

softwlc_main для Standalone version

softwlc_reserv_1 для Reservation 1+1 (Galera Cluster) version

database_1 для Replication 1+1+3 Galera Database Nodes version

scp /home/<user_login>/mysql_backup.zip <user_login>@<ip_address_docker>:/home/<user_login>/

7) Запустить скрипт с флагом --stop для остановки сервисов (указать ip адреса хостов с Docker)

sudo ./eltex-softwlc-helper-ansible-latest.sh --stop

8) На новом хосте с Docker удалить существующие данные в volume MariaDB и перенести туда архив БД с домашней директории 

cd /<path_to_softwlc_docker>/volumes/mysql/datadir
sudo rm -rf *
sudo mv ~/mysql_backup.zip .

9) Проверить установленный пакет

# AstraLinux, Ubuntu
sudo apt update && sudo apt install unzip
# RedOS
sudo dnf update && sudo dnf install unzip

10) Разархивировать полученные данные с заменой старых данных

sudo unzip -o mysql_backup.zip

11) На новом хосте с Docker запустим скрипт с ключом --reconfigure для замены значений localhost, которые по умолчанию остались при переносе БД из Deb в Docker

sudo ./eltex-softwlc-helper-ansible-latest.sh --reconfigure

После данных шагов миграция баз данных на новую установку в Docker будет завершена

Перенос лицензий

В случае приобретения лицензий на SoftWLC их необходимо перенести на новую версию.

Чтобы это сделать, необходимо:

1) Скопировать файл/ы лицензии на хост с Ansible:

2) Переместить файл/ы лицензии в директорию

• Eltex EMS: в директорию ansible/softwlc-ansible-1.37/licences/ems-airtune/
• Eltex Wifi-Cab: в директорию ansible/softwlc-ansible-1.37/licences/wifi-cab/

3) На хосте с Ansible выполнить соответствующие команды:

• Eltex EMS:

sudo ./eltex-softwlc-helper-ansible-latest.sh --update-ems-licence

• Eltex Wifi-Cab:

sudo ./eltex-softwlc-helper-ansible-latest.sh --update-wifi-cab-licence

Смена виртуального адреса

В случае необходимости поменять VIP адрес для многохостовых установок необходимо запустить скрипт с ключом --reconfigure:

sudo ./eltex-softwlc-helper-ansible-latest.sh --reconfigure

При запросе Virtual IP указать необходимый виртуальный ip адрес. Если остальные параметры не изменялись вручную, то их можно пропустить нажатием Enter.

После чего скрипт выполнит смену VIP адреса.