При обновлении обязательной переходной версией считается версия 1.30. Инструкция по обновлению на версию 1.30

Подготовка к обновлению

Перед обновлением сделайте дамп БД и желательно сделать snapshot системы для возможного отката в случае неудачного обновления.

Выполните backUP БД и конфигурационных файлов.

Установите пакет pv перед сохранением БД и запуском скрипта.

На вход скрипта требуется подать login/password от БД.

vagrant@xenial:~$ sudo apt install pv
vagrant@xenial:~$ sudo chmod +x backup_mysql.sh
vagrant@xenial:~$ sudo ./backup_mysql.sh root root

backup_mysql.sh

BackUP базы данных работоспособен только для вашей текущей версии SoftWLC. Условно говоря, backup от SoftWLC версии 1 не подойдет к SoftWLC версии 2.

Во время обновления в консоли Вам будут предложены варианты действий с конфигурационными файлами и базами данных.

Обновление на SoftWlC 1.ХХ

Если SoftWLC установлен на Ubuntu Server 20.04 LTS / Ubuntu Server 22.04 LTS, то обновления производим с помощью скрипта.

vagrant@xenial:~$ wget http://archive.eltex.org/wireless/help/softwlc-latest/eltex-softwlc-helper-latest.sh
vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-latest.sh
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-latest.sh

Если SoftWLC установлен на Astra Linux Special Edition 1.7.4 (Воронеж), то обновления производим с помощью скрипта.

vagrant@astra-version:~$ wget http://archive.eltex.org/wireless/help/softwlc-latest/eltex-softwlc-helper-astra-latest.sh 
[sudo] password for tester:
--2023-03-14 16:37:43-- http://archive.eltex.org/wireless/help/softwlc-latest/eltex-softwlc-helper-astra-latest.sh
Resolving archive.eltex.org (archive.eltex.org)... 92.125.152.58
Connecting to archive.eltex.org (archive.eltex.org)|92.125.152.58|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 73208 (71K) [application/octet-stream]
Saving to: ‘eltex-softwlc-helper-astra_1.30.sh’

eltex-softwlc-helper-astra-latest.sh 100%[======================================================================================================================================>] 71.49K 340KB/s in 0.2s

2023-03-14 16:37:43 (340 KB/s) - ‘eltex-softwlc-helper-astra-latest.sh’ saved [73208/73208]

Проверяем работу сервисов. В случае неработоспособности сервисов делаем откат на предыдущий snapshot системы.

Начиная с версии 1.29 используется java 17, поэтому на клиентском устройстве, с которого запускается java апплет, требуется обновить java по инструкции.

Миграция шаблонов

В версии 1.36 была проведена унификация шаблнов для ТД типа Fastpath WEP/WOP-2/12ac, WEP/WOP-xL, WEP-3ax и WOP-2ac-LR2/5

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

templates_migration.zip

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

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) Для запуска скрипта должен быть установлен python3 и pip3 (для ОС Astra Linux версия python 3.7)

Обновление pip и установка зависимостей, необходимых для запуска скрипта:

pip3 install --upgrade pip
pip3 install -r requirements.txt

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

python3 mirgate_script.py

Если ранее в netconf шаблонах во вкладке "Радио интерфейсы" не изменялось поле "Режим", то необходимо перейти во вкладку Wireless - Шаблоны конфигурации и изменить значение этого поля на нужное вручную.

Восстановление БД в случае неудачного обновления

Восстанавливаем последний backup БД MariaDB и Mongo БД.

Конфигурационный файл mongod.conf положите в домашний каталог откуда будете запускать скрипт mongo_update.sh

sudo chmod +x restore_mysql.sh
sudo ./restore_mysql.sh root root

restore_mysql.sh