...
| Предупреждение |
|---|
Миграция возможна начиная с версии версии deb установки 1.3033. Если установлена версия старее - необходимо обязательно произвести переходное обновление до версии 1.30 с последующим обновлением до 1.33. |
| Предупреждение |
|---|
ВАЖНО! 1) Если:
настоятельно рекомендуется воспользоваться следующей инструкцией: v1.37_Миграция решения из Deb в Docker с использованием Ansible 2) После проведения миграции согласно текущей инструкции, хост с Deb версией становится контрольной нодой с Ansible и его плейбуками. Удалять его нельзя. |
Схема миграции
Установка в Ansible позволяет провести миграцию из Deb установки в Docker с сохранением параметров конфигурации Deb.
...
2) Установка решения в Docker с использованием Ansible
3) Миграция базы данных
4) Перенос лицензий
Миграция параметров конфигурации
| Предупреждение |
|---|
Для проведения данной миграции на хосте с Deb версией SoftWLC необходим установленный Python версии не ниже 3.7 Также данная миграция возможна только при миграции: Однохостовое решение Deb → Однохостовое решение Docker-Ansible. При миграции многохостовго решения производится только перенос базы данных. |
| Предупреждение |
|---|
ВАЖНО! |
Шаги по переносу параметров конфигурации:
...
| Подсказка |
|---|
| Архив mysql_backup.zip будет создан в директории /tmp/mysql_backup.zip |
3)
...
| Блок кода | ||||
|---|---|---|---|---|
| ||||
scp /tmp/mysql_backup.zip <user_login>@<ip_address_ansible>:/home/<user_login>/ |
4) На хосте с Ansible перенести перенести архив базы в директорию Ansible командой:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
sudo mv /hometmp/<user_login>/mysql_backup.zip /home/<user_login>/ansible/softwlc-ansible-1.37/roles/migration_restore_db/files/ |
...
После данных шагов миграция баз данных на новую установку в Docker будет завершена
Перенос лицензий
В случае приобретения лицензий на SoftWLC их необходимо перенести на новую версию.
| Информация |
|---|
Лицензионный файл для пакета Eltex EMS license.xml содержит информацию количестве и типе устройств, с которыми может работать EMS. Данный файл предоставляется Коммерческими подразделениями компании Элтекс или ее партнерами. Лицензионный файл для пакета Eltex Wifi-Cab license.xml содержит количество пользователей, которые могут быть созданы в Личном кабинете и одновременно работать в WEB интерфейсе кабинета. Более подробно о лицензировании проекта 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 и ниже необходимо произвести миграцию шаблонов.
| Предупреждение |
|---|
Миграция шаблонов производится только после обновления SoftWLC на актуальную версию. |
Для миграции старых шаблонов предполагается использовать специальный скрипт миграции, представленный ниже:
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 и установка зависимостей, необходимых для запуска скрипта:
| Предупреждение |
|---|
Для запуска скрипта должен быть установлен python3 и pip3 (для ОС Astra Linux версия python 3.7) |
| Блок кода | ||||
|---|---|---|---|---|
| ||||
pip3 install --upgrade pip
pip3 install -r requirements.txt |
5) Запуск скрипта:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
python3 migrate_script.py |
| Примечание |
|---|
| Рекомендуется ручная перепроверка шаблонов перед использованием |