Начиная с версии 1.36 установка в Deb больше не поддерживается. В случае наличия Deb версии SoftWLC необходимо произвести миграцию в Docker версию. |
Более подробно про установку скриптом в Docker с помощью плейбуков Ansible можно посмотреть здесь: v1.37_Пошаговая установка SoftWLC в Docker через Ansible скриптом-установщиком |
Миграция возможна начиная с версии deb установки 1.30. Если установлена версия старее - необходимо произвести переходное обновление до версии 1.30. |
ВАЖНО! 1) Если:
настоятельно рекомендуется воспользоваться следующей инструкцией: v1.37_Миграция решения из Deb в Docker с использованием Ansible 2) После проведения миграции согласно текущей инструкции, хост с Deb версией становится контрольной нодой с Ansible и его плейбуками. Удалять его нельзя. |
Установка в Ansible позволяет провести миграцию из Deb установки в Docker с сохранением параметров конфигурации Deb.
Миграция производится в несколько этапов:
1) Миграция параметров конфигурации
2) Установка решения в Docker с использованием Ansible
3) Миграция базы данных
4) Перенос лицензий
Для проведения данной миграции на хосте с Deb версией SoftWLC необходим установленный Python версии не ниже 3.7 Также данная миграция возможна только при миграции: Однохостовое решение Deb → Однохостовое решение Docker-Ansible. |
Шаги по переносу параметров конфигурации:
1) Иметь установку deb версии SoftWLC.
2) Скачать скрипт-установщик на хост с Deb версией SoftWLC и запустить его с флагами -d --migrate-from-debs:
sudo ./eltex-softwlc-helper-ansible-latest.sh -d --migrate-from-debs |
При запросе ввода ip адреса указать ip адрес хоста с установленной Deb версией SoftWLC |
После этого шага в директории с параметрами конфигурации 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 |
Для установки можно воспользоваться следующей инструкцией:
v1.37_Пошаговая установка SoftWLC в Docker через Ansible скриптом-установщиком
При запросе ввода ip адресов указать ip адреса хостов, используемых для установки Docker версии SoftWLC |
Миграцию баз данных можно произвести с помощью скрипта, либо вручную. Для больших эксплуатация (количество точек больше 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 будет завершена
Шаги по переносу базы данных:
1) Иметь установку deb версии SoftWLC.
2) Создать архив базы данных на сервере с Deb установкой запустив на хосте с Ansible скрипт с ключом --migrate-db-backup
sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-backup |
При запросе ввода ip адреса указать ip адрес хоста с установленной Deb версией SoftWLC |
| Архив mysql_backup.zip будет создан в директории /tmp/mysql_backup.zip |
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 |
При запросе ввода ip адресов указать ip адреса хостов, куда ранее было установлена Docker версия SoftWLC |
После данных шагов миграция баз данных на новую установку в Docker будет завершена
В случае приобретения лицензий на SoftWLC их необходимо перенести на новую версию.
Лицензионный файл для пакета Eltex EMS license.xml содержит информацию количестве и типе устройств, с которыми может работать EMS. Данный файл предоставляется Коммерческими подразделениями компании Элтекс или ее партнерами. Лицензионный файл для пакета Eltex Wifi-Cab license.xml содержит количество пользователей, которые могут быть созданы в Личном кабинете и одновременно работать в WEB интерфейсе кабинета. Более подробно о лицензировании проекта SoftWLC здесь. |
Чтобы это сделать, необходимо:
1) Скопировать файл/ы лицензии на хост с Ansible:
2) Переместить файл/ы лицензии в директорию
3) На хосте с Ansible выполнить соответствующие команды:
sudo ./eltex-softwlc-helper-ansible-latest.sh --update-ems-licence |
sudo ./eltex-softwlc-helper-ansible-latest.sh --update-wifi-cab-licence |