Начиная с версии 1.36 установка в Deb больше не поддерживается. В случае наличия Deb версии SoftWLC необходимо произвести миграцию в Docker версию. |
Более подробно про установку скриптом в Docker с помощью плейбуков Ansible можно посмотреть здесь: v1.36_Пошаговая установка SoftWLC в Docker через Ansible скриптом-установщиком |
Установка в Ansible позволяет провести миграцию параметров из Deb установки в Docker.
Существует два варианта миграции:
1) Миграция из Deb установки с одного хоста в Docker на другом хосте
2) Миграция из Deb установки с одного хоста в Docker на тот же хост
Схематическое представление двух вариантов:
Рекомендуется по возможности проводить миграцию между двумя виртуальными машинами/серверами - старое решение (deb) и новое (docker) - первый вариант миграции на схеме |
При миграции параметров конфигурации обязательным является установка плейбуков Ansible на тот же хост, где установлено Deb решение SoftWLC |
Миграция производится в несколько этапов:
1) Миграция параметров конфигурации
2) Миграция базы данных
Для проведения данной миграции на хосте с Deb версией SoftWLC необходим установленный Python версии не ниже 3.7 |
Шаги по переносу параметров конфигурации:
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.36/invemtory/my_softwlc/group_vars/ появятся новые файлы - eltex-*.yml, содержащие все перенесённые параметры.
3) При использовании 2 варианта миграции (установка 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 |
4) Запустить стандартную установку:
sudo ./eltex-softwlc-helper-ansible-latest.sh |
При запросе ввода ip адреса указать ip адрес хоста куда будет установлена Docker версия SoftWLC |
После этих шагов необходимо перейти к переносу базы данных
Миграцию баз данных можно произвести с помощью скрипта, либо вручную. Для больших эксплуатация (количество клиентов больше 1000) рекомендуется производить восстановление базы данных вручную.
Данный вариант является более предпочтительным в связи с возможностью отслеживания процесса архивирования и переноса дампа базы данных |
Шаги по переносу базы данных:
1) Иметь установку deb версии SoftWLC.
2) Пройти все шаги из переноса конфигурационных файлов (должна быть установлена Docker версия SoftWLC)
3) Подключиться по SSH на хост, с установленной Deb версией
ssh <user_login>@<ip_address_deb> |
4) Перейти в директорию /var/lib/mysql/
cd /var/lib/mysql/ |
5) Проверить установленный пакет
sudo apt update && sudo apt install zip |
6) Создать архив с файлами выбранной директории. Для удобства дальнейшего переноса файлов разместите его в домашней директории пользователя.
zip -r /home/<user_login>/mysql_backup.zip * |
7) Скопируйте данный архив на хост, где будет разворачиваться решение в Docker
scp /home/<user_login>/mysql_backup.zip <user_login>@<ip_address_docker>:/home/<user_login>/ |
8) Запустить скрипт с флагом --stop для остановки сервисов (указать ip адрес хоста с Docker)
sudo ./eltex-softwlc-helper-ansible-latest.sh --stop |
9) На хосте с Docker перенесем архив с БД с домашней директории в volume MariaDB
cd /<path_to_softwlc_docker>/volumes/mysql/datadir sudo mv ~/mysql_backup.zip . |
10) Проверить установленный пакет
# AstraLinux, Ubuntu sudo apt update && sudo apt install unzip # RedOS sudo dnf update && sudo dnf install unzip |
11) Разархивируем полученные данные с заменой старых данных
sudo unzip -o mysql_backup.zip |
12) На хосте с Deb запустим скрипт с ключом --reconfigure для замены значений localhost, которые по умолчанию остались при переносе БД из Deb в Docker
sudo ./eltex-softwlc-helper-ansible-latest.sh --reconfigure |
После данных шагов миграция баз данных на новую установку в Docker будет завершена
Шаги по переносу базы данных:
1) Иметь установку deb версии SoftWLC.
2) Скачать скрипт-установщик и запустить его с флагом --migrate-db-backup для создания архива с данными из БД:
sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-backup |
При запросе ввода ip адреса указать ip адрес хоста с установленной Deb версией SoftWLC |
3) Запустить скрипт с флагом --migrate-db-restore для переноса архива с данными из БД и его восстановления:
sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-restore |
При запросе ввода ip адреса указать ip адрес хоста куда будет установлена Docker версия SoftWLC |
После данных шагов миграция баз данных на новую установку в Docker будет завершена