Схема миграции

Установка в Ansible позволяет провести миграцию параметров из Deb установки в Docker.

Существует два варианта миграции:

1) Миграция из Deb установки с одного хоста в Docker на другом хосте

2) Миграция из Deb установки с одного хоста в Docker на тот же хост

Схематическое представление двух вариантов:

Миграция производится в несколько этапов:

1) Миграция параметров конфигурации

2) Миграция базы данных

Миграция параметров конфигурации

Шаги по переносу параметров конфигурации:

1) Иметь установку deb версии SoftWLC.

2) Скачать скрипт-установщик на хост с Deb версией SoftWLC и запустить его с флагом --migrate-from-debs:

sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-from-debs

После этого шага в директории с параметрами конфигурации 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

После этих шагов необходимо перейти к переносу базы данных

Миграция базы данных

Миграцию баз данных можно произвести с помощью скрипта, либо вручную. Для больших эксплуатация (количество клиентов больше 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 будет завершена

Миграция базы данных через Ansible

Шаги по переносу базы данных:

1) Иметь установку deb версии SoftWLC.

2) Скачать скрипт-установщик и запустить его с флагом --migrate-db-backup для создания архива с данными из БД:

sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-backup

3) Запустить скрипт с флагом --migrate-db-restore для переноса архива с данными из БД и его восстановления:

sudo ./eltex-softwlc-helper-ansible-latest.sh --migrate-db-restore

После данных шагов миграция баз данных на новую установку в Docker будет завершена