Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Подсказка

Более подробно про установку скриптом в 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:

Блок кода
languagebash
themeRDark
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:

Блок кода
languagebash
themeRDark
sudo systemctl
sudo systemctl stop eltex-*.service
sudo systemctl
sudo systemctl stop nginx
sudo systemctl
sudo systemctl stop mysql
sudo systemctl disable eltex-*.service
sudo systemctl disable nginx
sudo systemctl disable mysql

...

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

...

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

...

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

...

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

...

После данных шагов миграция баз данных на новую установку в 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:
Блок кода
languagebash
themeRDark
sudo ./eltex-softwlc-helper-ansible-latest.sh --update-ems-licence
  • Eltex Wifi-Cab:
Блок кода
languagebash
themeRDark
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 на актуальную версию.

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

templates_migration.zip

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

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

Блок кода
languagebash
themeRDark
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)

Блок кода
languagebash
themeRDark
pip3 install --upgrade pip
pip3 install -r requirements.txt

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

Блок кода
languagebash
themeRDark
python3 migrate_script.py


Примечание
Рекомендуется ручная перепроверка шаблонов перед использованием

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

...