...
| Подсказка |
|---|
Более подробно про установку скриптом в Docker с помощью плейбуков Ansible можно посмотреть здесь: v1.37_Пошаговая установка SoftWLC в Docker через Ansible скриптом-установщиком |
| Предупреждение |
|---|
Миграция возможна начиная с версии deb установки 1.33. Если установлена версия старее - необходимо обязательно произвести переходное обновление до версии 1.30 с последующим обновлением до 1.33. |
Схема миграции
Установка в Ansible позволяет провести миграцию из Deb установки в Docker.
Миграция производится в несколько этапов:
1) Миграция параметров конфигурации (только для однохостовой установки)2) Установка решения в Docker с использованием Ansible
32) Миграция базы данных
3) Перенос лицензий
4) Смена виртуального ip адреса (только для многохостовой установки)
Миграция параметров конфигурации
| Предупреждение |
|---|
Для проведения данной миграции на хосте с Deb версией SoftWLC необходим установленный Python версии не ниже 3.7 Также данная миграция возможна только при миграции: Однохостовое решение Deb → Однохостовое решение Docker-Ansible. При миграции многохостовго решения производится только перенос базы данных. |
Шаги по переносу параметров конфигурации:
1) Иметь установку deb версии SoftWLC.
2) Скачать скрипт-установщик на хост с Deb версией SoftWLC и запустить его с флагом --migrate-from-debs:
| Блок кода | ||||
|---|---|---|---|---|
| ||||
sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-from-debs |
| Предупреждение |
|---|
При запросе ввода ip адреса указать ip адрес хоста с установленной Deb версией SoftWLC |
После этого шага в директории с параметрами конфигурации Ansible - softwlc-ansible-1.37/inventory/my_softwlc/group_vars/ появятся новые файлы - eltex-*.yml, содержащие все перенесённые параметры.
...
Установка решения в Docker с использованием Ansible
| Предупреждение | |||||||||
|---|---|---|---|---|---|---|---|---|---|
При установке SoftWLC в Docker на тот же хост, где расположен SoftWLC в Deb - остановить все сервисы eltex-*.service, nginx, mysql:
|
...
Для установки можно воспользоваться инструкцией, соответствующей вашей требуемой версии:
...
После данных шагов миграция баз данных на новую установку в 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 |
| Примечание |
|---|
| Рекомендуется ручная перепроверка шаблонов перед использованием |
Смена виртуального адреса
...