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

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

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

1) Миграция параметров конфигурации

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

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

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

Миграция параметров конфигурации

Шаги по переносу параметров конфигурации:

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

2) Скачать скрипт-установщик на хост с Deb версией SoftWLC и запустить его с флагами -d --migrate-from-debs:

sudo ./eltex-softwlc-helper-ansible-latest.sh -d --migrate-from-debs

После этого шага в директории с параметрами конфигурации Ansible - softwlc-ansible-1.37/inventory/my_softwlc/group_vars/ появятся новые файлы - eltex-*.yml, содержащие все перенесённые параметры.

3) При установке SoftWLC в Docker на тот же хост, где расположен SoftWLC в Deb - остановить все сервисы eltex-*.service, nginx, mysql:

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

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

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

v1.37_Пошаговая установка SoftWLC в 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

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) На хосте с Ansible перенести перенести архив базы в директорию Ansible командой:

sudo mv /tmp/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

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

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