Оглавление

Предупреждение
Перед обновлением необходимо обязательно сделать резервную копию виртуальной машины на случай необходимости восстановления.

Обновление контроллера производится в следующем порядке v.1.5 → v.1.7 →v.1.8 → v.1.9 → v.1.11 (mongo update) → переход на Ubuntu 16 → v.1.18 → переход на Ubuntu 18 → миграция БД NGW → SWLC (latest).

Версия SoftWLC определяется версией подавляющего количества пакетов eltex, установленных на ВМ.

Версию пакетов можно узнать при помощи следующих команд:

Блок кода

theme	RDark

vagrant@xenial:~$ dpkg -l | grep eltex-

Если во время обновления что-то пойдет не так, а сервис нужно будет быстро восстановить, то запускаете клон рабочей ВМ.

Обратите внимание, что обновление контроллера рекомендуется проводить в нерабочее время, так как будет перерыв в работе сервисов.

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

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

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

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

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

Блок кода

theme	RDark

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

backup_mysql.sh

mongo_update.sh

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

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

Обновление SoftWLC 1.5 → SoftWLC 1.7

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Обновление производится с помощью скрипта:

Блок кода

theme	RDark

vagrant@trusty:~$ sudo chmod +x softwlc_1.7_upgrade.sh
vagrant@trusty:~$ sudo ./softwlc_1.7_upgrade.sh

softwlc_1.7_upgrade.sh

После обновления проверьте работоспособность сервисов и снова сделайте дамп БД/snapshot.

Обновление SoftWLC 1.7 → SoftWLC 1.8

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Обновление производится с помощью скрипта:

Блок кода

theme	RDark

vagrant@trusty:~$ sudo chmod +x softwlc_1.8_upgrade.sh
vagrant@trusty:~$ sudo ./softwlc_1.8_upgrade.sh

softwlc_1.8_upgrade.sh

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

Обновление SoftWLC 1.8 → SoftWLC 1.9

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Положите конфигурационный файл softwlc_1.9_nginx.conf в корневую директорию и запустите скрипт обновления.

Блок кода

theme	RDark

vagrant@trusty:~$ sudo chmod +x softwlc_1.9_upgrade.sh
vagrant@trusty:~$ sudo ./softwlc_1.9_upgrade.sh

softwlc_1.9_nginx.conf

softwlc_1.9_upgrade.sh

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

Обновление SoftWLC 1.9 → SoftWLC 1.11

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Обновление производится с помощью скрипта:

Блок кода

theme	RDark

vagrant@trusty:~$ sudo chmod +x eltex-softwlc-helper-mos_1.11.sh
vagrant@trusty:~$ sudo ./eltex-softwlc-helper-mos_1.11.sh

eltex-softwlc-helper-mos_1.11.sh

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

Обновление БД Mongo

Если версия mongodb ниже 2.6 то требуется обновить пакет скриптом mongo_update.sh .

Проверка версии:

Блок кода

theme	RDark

vagrant@trusty:~$ mongo --version

Отдельное обновление БД Mongo связано с тем, что последующие версии SoftWLC требуют новую версию Mongo.

Перед обновлением Вам следует подготовить и сконвертировать конфигурационный файл Mongo

Распакуйте архив mongo_converter.tar на сервере следующей командой:

Блок кода

theme	RDark

(Ubuntu 14.04)vagrant@trusty:~$ tar -xvf mongo_converter.tar.gz

Запустите на сервере скрипт, указав местоположение старого конфигурационного файла Mongo. Для запуска скрипта понадобится python3.

Блок кода

theme	RDark

vagrant@trusty:~$ python3 mongo-converter/mongo-converter/converter/converter_core.py /etc/mongodb.conf

Будет создан конвертированный конфигурационный файл mongod.conf для версии Mongo 4.

mongo_converter.tar.gz

mongo_update.sh

Приступаем к обновлению Mongo:

Запустите с опциями --backup --remove --install --restore-config - сохранит настройки, сделает резервное копирование баз, удалит любую существующую инсталяцию MongoDB, установит версию 4.0 из официального репозитория и установит настройки mongod.conf либо из папки где лежит сам скрипт, либо из резервной копии

Блок кода

theme	RDark

vagrant@trusty:~$ sudo chmod +x mongo_update.sh
vagrant@trusty:~$ sudo ./mongo_update.sh --backup --remove --install --restore-config

БД и конфиг-файл сохранится в дирректорию /tmp/mongo/

Если была настроена репликация данных, то настройте ее на данном этапе.

Запустите с опцией --restore для восстановления баз:

Блок кода

theme	RDark

vagrant@trusty:~$ sudo ./mongo_update.sh --restore
Platform: x86_64
Ubuntu distrib code name: trusty
Restoring data...
2019-09-20T11:39:39.734+0700 preparing collections to restore from
2019-09-20T11:39:39.737+0700 reading metadata for wifi-customer-cab.eventlog from /tmp/mongo/dump/wifi-customer-cab/eventlog.metadata.json
2019-09-20T11:39:39.739+0700 reading metadata for pcrf.macs from /tmp/mongo/dump/pcrf/macs.metadata.json
...

Проверьте, что все восстановилось корректно;

Запустите с опцией --clean для очистки временных файлов и старых баз.

Блок кода

theme	RDark

vagrant@trusty:~$ sudo ./mongo_update.sh --clean

Обновление SoftWLC 1.11 → SoftWLC 1.18

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Если у Вас стоит версия контроллера SoftWLC 1.11 и Ubuntu Server 14.04, то Вам потребуется подготовить второй сервер и установить на него Ubuntu Server 16.04.

После установки на новый сервер Ubuntu Server 16.04 необходимо установить SoftWLC версии 1.11:

Блок кода

theme	RDark

vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-mos_1.11.sh
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-mos_1.11.sh

eltex-softwlc-helper-mos_1.11.sh

Скрипт можете использовать прикрепленный к мануалу или же напрямую скачать с архива ELTEX:

Блок кода

theme	RDark

vagrant@xenial:~$ wget http://archive.eltex.org/softwlc/help/eltex-softwlc-helper-mos_1.11.sh

Предупреждение

После установки SoftWLC 1.11 перенесите лицензии со старого сервера на новый сервер.

Лицензии и сертификаты в проекте SoftWLC

Восстановление БД перед обновлением

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

Перед восстановлением переместите содержимое директории /tmp/mongo/, дампы Mysql со старого сервера Ubuntu 14.04 на новый сервер с Ubuntu 16.04.

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

Блок кода

theme	RDark

sudo ./mongo_update.sh  --restore-config
sudo ./mongo_update.sh  --restore
sudo ./restore_mysql.sh root root

restore_mysql.sh

mongo_update.sh

После восстановления БД проверяем работу сервисов. Делаем новый snapshot и дамп БД.

Обновление до SoftWlC 1.18

Обновления производим с помощью скрипта.

Блок кода

theme	RDark

vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-mos_1.18.sh
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-mos_1.18.sh

Скрипт можно напрямую скачать с архива ELTEX:

Блок кода

theme	RDark

vagrant@xenial:~$ wget http://archive.eltex.org/wireless/help/softwlc-1.18/eltex-softwlc-helper-mos_1.18.sh

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

Обновление SoftWLC 1.18 (U16) → SoftWLC 1.19

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Если у Вас стоит версия контроллера SoftWLC 1.18 и Ubuntu Server 16.04, то Вам потребуется подготовить второй сервер и установить на него Ubuntu Server 18.04.

После установки на новый сервер Ubuntu Server 18.04 необходимо установить SoftWLC версии 1.18:

Блок кода

theme	RDark

vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-mos_1.18.sh
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-mos_1.18.sh

eltex-softwlc-helper-mos_1.18.sh

Скрипт можете использовать прикрепленный к мануалу или же напрямую скачать с архива ELTEX:

Блок кода

theme	RDark

vagrant@xenial:~$ wget http://archive.eltex.org/wireless/help/softwlc-1.18/eltex-softwlc-helper-mos_1.18.sh

Предупреждение

После установки SoftWLC 1.18 перенесите лицензии со старого сервера на новый сервер.

Лицензии и сертификаты в проекте SoftWLC

Восстановление БД перед обновлением

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

Перед восстановлением переместите содержимое директории /tmp/mongo/, дампы Mysql со старого сервера Ubuntu 16.04 на новый сервер с Ubuntu 18.04.

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

Блок кода

theme	RDark

sudo ./mongo_update.sh  --restore-config
sudo ./mongo_update.sh  --restore
sudo ./restore_mysql.sh root root

restore_mysql.sh

mongo_update.sh

После восстановления БД проверяем работу сервисов. Делаем новый snapshot и дамп БД.

Обновление до SoftWlC 1.19

Обновления производим с помощью скрипта.

Блок кода

theme	RDark

vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-mos_1.19.sh
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-mos_1.19.sh

Скрипт можно напрямую скачать с архива ELTEX:

Блок кода

theme	RDark

vagrant@xenial:~$ wget wget http://archive.eltex.org/wireless/help/softwlc-1.19/eltex-softwlc-helper-mos_1.19.sh

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

Предупреждение
В версии 1.19 основное хранилище данных NGW изменено на mysql, в связи с чем необходимо выполнить миграцию данных NGW.

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

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

Блок кода

theme	RDark

sudo ./mongo_update.sh  --restore-config
sudo ./mongo_update.sh  --restore
sudo ./restore_mysql.sh root root

restore_mysql.sh

mongo_update.sh

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

Обновление SoftWLC 1.19 (и выше) → SoftWLC 1.ХХ

Перед обновлением контроллера крайне важно произвести подготовку к обновлению.

Предупреждение

Начиная с версии 1.28 SoftWLC точки доступа realtek (WEP-200l,WEP/WOP-2L/30L, WEP-1L, WOP-30LS/30L-ex) необходимо обновить на версию 2.3.0 и выше, точки доступа wep-3ax на версию 1.11 и выше.
Инструкция по обновлению: v1.28_Обновление ПО ТД через SoftWLC
Запросить данное ПО можно через Service Desk или через заявку на нашем официальном сайте

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

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

Блок кода

theme	RDark

vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-latest.sh
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-latest.sh

Если SoftWLC установлен на Ubuntu Server 18.04 LTS , то обновления производим с помощью скрипта с использованием ключа:

Блок кода

theme	RDark

vagrant@xenial:~$lsb_release -a
No LSB modules are available.
Distributor ID:	Ubuntu
Description:	Ubuntu 18.04.3 LTS
Release:	18.04
Codename:	bionic
vagrant@xenial:~$ sudo chmod +x eltex-softwlc-helper-latest.sh 
vagrant@xenial:~$ sudo ./eltex-softwlc-helper-latest.sh --update-eltex-packages

Скрипт можете напрямую скачать с архива ELTEX:

Блок кода

theme	RDark

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

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

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

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

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

Блок кода

theme	RDark

sudo ./mongo_update.sh  --restore-config
sudo ./mongo_update.sh  --restore
sudo chmod +x restore_mysql.sh
sudo ./restore_mysql.sh root root

restore_mysql.sh

mongo_update.sh

Дерево страниц

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

Старая версия 2

Новая версия 3

Ключ

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

Обновление SoftWLC 1.5 → SoftWLC 1.7

Обновление SoftWLC 1.7 → SoftWLC 1.8

Обновление SoftWLC 1.8 → SoftWLC 1.9

Обновление SoftWLC 1.9 → SoftWLC 1.11

Обновление БД Mongo

Обновление SoftWLC 1.11 → SoftWLC 1.18

Восстановление БД перед обновлением

Обновление до SoftWlC 1.18

Обновление SoftWLC 1.18 (U16) → SoftWLC 1.19

Восстановление БД перед обновлением

Обновление до SoftWlC 1.19

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

Обновление SoftWLC 1.19 (и выше) → SoftWLC 1.ХХ

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

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

Дерево страниц

История страницы

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

Старая версия 2

Новая версия 3

Ключ

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

Обновление SoftWLC 1.5 → SoftWLC 1.7

Обновление SoftWLC 1.7 → SoftWLC 1.8

Обновление SoftWLC 1.8 → SoftWLC 1.9

Обновление SoftWLC 1.9 → SoftWLC 1.11

Обновление БД Mongo

Обновление SoftWLC 1.11 → SoftWLC 1.18

Восстановление БД перед обновлением

Обновление до SoftWlC 1.18

Обновление SoftWLC 1.18 (U16) → SoftWLC 1.19

Восстановление БД перед обновлением

Обновление до SoftWlC 1.19

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

Обновление SoftWLC 1.19 (и выше) → SoftWLC 1.ХХ

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

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