Схема миграции

Установка в Ansible позволяет провести миграцию из Deb установки в Docker.

Миграция производится в несколько этапов:

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

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

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

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

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

sudo systemctl stop eltex-*.service
sudo systemctl stop nginx
sudo systemctl stop mysql
sudo systemctl disable eltex-*.service
sudo systemctl disable nginx
sudo systemctl disable mysql

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

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

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

Миграцию баз данных можно произвести с помощью скрипта, либо вручную. Для больших эксплуатация (количество точек больше 1000) рекомендуется производить восстановление базы данных вручную.

Миграция базы данных вручную

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

1) Иметь установку deb версии SoftWLC.

2) Подключиться по SSH на хост, с установленной Deb версией

ssh <user_login>@<ip_address_deb>

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 будет завершена

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

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

1) Иметь установку deb версии SoftWLC.

2) Создать архив базы данных на сервере с Deb установкой запустив на хосте с Ansible скрипт с ключом --migrate-db-backup

sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-backup

3) Подключиться к серверу с Deb установкой, ip которой был указан при создании архива и скопировать архив на сервер с установленным Ansible, выполнив команду:

scp /tmp/mysql_backup.zip <user_login>@<ip_address_ansible>:/home/<user_login>/

4) На хосте с Ansible перенести перенести архив базы в директорию Ansible командой:

sudo mv /home/<user_login>/mysql_backup.zip /home/<user_login>/ansible/softwlc-ansible-1.37/roles/migration_restore_db/files/

4) Из директории со скриптом (/home/<user_login>/ansible) запустить его с ключом --migrate-db-restore:

sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-restore

После данных шагов миграция баз данных на новую установку в 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

Миграция шаблонов

В версии 1.36 была проведена унификация шаблнов для ТД типа Fastpath WEP/WOP-2/12ac, WEP/WOP-xL, WEP-3ax и WOP-2ac-LR2/5

При обновлении с версии 1.35 и ниже необходимо произвести миграцию шаблонов.

Для миграции старых шаблонов предполагается использовать специальный скрипт миграции, представленный ниже:

templates_migration.zip

1) Скрипт необходимо загрузить на сервер или виртуальную машину, где расположен установленный SoftWLC

2) Необходимо разархивировать полученный архив следующей командой:

unzip templates_migration.zip

3) В конфигурационном файле необходимо настроить следующие параметры:

• mysql.host - адрес сервера, на котором установлена СУБД MariaDB
• mysql.port - порт сервера, на котором установлена СУБД MariaDB
• mysql.username - логин пользователя javauser СУБД MariaDB
• mysql.password - пароль пользователя javauser СУБД MariaDB
• docker.use_docker - режим работы скрипта
  • При использовании установки в deb-пакетах, установить параметр на false
  • При использовании установки в docker-контейнерах, установить параметр на true
• docker.docker_path - путь установки до папки eltex-ems. Необходимо сменить путь /home/tester/eltex-softwlc/ на актуальный для вас

4) Обновление pip и установка зависимостей, необходимых для запуска скрипта:

pip3 install --upgrade pip
pip3 install -r requirements.txt

5) Запуск скрипта:

python3 migrate_script.py

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

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

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

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

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