Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

Версия 1 Следующий »

Актуальная версия плейбуков: 1.37 от 17 октября 2025 года

ВАЖНО: Обращайте внимание на последние обновления плейбуков и, в случае их обновления, своевременно обновляйте их. Дата актуальной версии указана в начале данной документации.

Начиная с версии 1.36 установка в Docker производится с помощью плейбуков Ansible. В случае наличия Docker версии SoftWLC, установленной с помощью скрипта установщика рекомендуется произвести миграцию в Docker версию Ansible по иструкции:

v1.37_Миграция однохостовой установки из Docker в Docker Ansible

Установка в Deb не поддерживается с версии 1.36. В случае наличия Deb версии SoftWLC необходимо мигрировать в версию Docker Ansible по иструкции:

v1.37_Миграция решения из Deb в Docker с использованием Ansible

Данная инструкция предназначенна именно для обновления схемы SoftWLC Docker Ansible.

Более подробно про установку скриптом в Docker с помощью плейбуков Ansible можно посмотреть здесь:

v1.37_Пошаговая установка SoftWLC в Docker через Ansible скриптом-установщиком

Перед обновлением необходимо выполнить обновление пакетов на серверах с помощью команд sudo apt update && sudo apt upgrade

Обновление плейбуков

Для обновления SoftWLC в Docker Ansible на новую версию необходимо следовать перечисленным ниже командам.

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

Переходим в директорию

cd /home/<имя пользователя>/ansible

Далее, необходимо загрузить скрипт установщик по ссылке из репозитория и разместить его с заменой в созданной ранее директории.

Данную операцию также можно выполнить из терминала:

wget http://archive.eltex.org/wireless/help/softwlc-latest/eltex-softwlc-helper-ansible-latest.sh

Следующим шагом необходимо выдать права на исполнение нового файла eltex-softwlc-helper-ansible-latest.sh, если таковых нет:

sudo chmod +x eltex-softwlc-helper-ansible-latest.sh

Все действия со скриптом необходимо проводить с использованием sudo

Не обязательно скачивать скрипт на тот же хост, куда будет устанавливаться SoftWLC. Адрес его установки будет запрошен самим скриптом далее.

Следующим шагом необходимо удалить старый архив и переименовать старую директорию:

sudo rm softwlc-ansible-1.36.tar.gz
sudo mv softwlc-ansible-1.36 softwlc-ansible-1.37

В случае использования версии 1.37 файл архива называется softwlc-ansible-1.37.tar.gz.

Переименовывать старую директорию в данном случае нет необходимости

Далее необходимо скачать плейбуки Ansible новой версии запустив новый скрипт с ключом -d

sudo ./eltex-softwlc-helper-ansible-latest.sh -d

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

1) Запрос на создание бэкапа конфигурации. При выборе Y, нажатии на Enter, создастся архив с файлами конфигурации Ansible. Выбор по умолчанию - Y.

Выбрать во время обновления - Y.

Do you want to backup your configuration files ? [Y/n] (default="Y"): Y

2) Запрос на замену параметров в файлах директории softwlc-ansible/*. При выборе Y все файлы в директории softwlc-ansible (за исключением my_softwlc/*) будут заменены на дефолтные из архива. Выбор по умолчанию - N.

Выбрать во время обновления - Y.

You already have a softwlc-ansible configuration directory. Do you want to replace this configuration with default parameters from the archive? [y/N] (default="N"): Y

3) Запрос на замену параметров в файлах директории my_softwlc/*. При выборе Y все файлы в директории my_softwlc будут заменены на дефолтные из sample/*, удаляя все настройки пользователя, если таковые были. Выбор по умолчанию - N.

Выбрать во время обновления - Y.

You already have my_softwlс configurations. Do you want to replace this configuration with default parameters from inventory/sample ? [y/N] (default="N"): Y

После этого файл с пользовательскими наcтройками будет сохранён как all.yml.backup. Если ранее параметры были изменены пользователем - потребуется их восстановление из этого файла.

Следующим шагом необходимо изменить параметр текущей установки в all.yml.

Для этого необходимо изменить файл распологающийся по следующему пути: /home/<имя пользователя>/ansible/softwlc-ansible-1.37/inventory/my_softwlc/group_vars/all.yml

В нём необходимо указать напротив используемой установки флаг true, выбрав для остальных false:

Standalone version

# Standalone установка default
is_default_install: true
# Резервирование - GLOBAL
is_reservation_install: false
# Репликация Galera мультихост - GLOBAL
is_replication_galera_install: false

Reservation 1+1 (Galera Cluster) version

# Standalone установка default
is_default_install: false
# Резервирование - GLOBAL
is_reservation_install: true
# Репликация Galera мультихост - GLOBAL
is_replication_galera_install: false

Replication 1+1+3 Galera Database Nodes version

# Standalone установка default
is_default_install: false
# Резервирование - GLOBAL
is_reservation_install: false
# Репликация Galera мультихост - GLOBAL
is_replication_galera_install: true

На этом обновление плейбуков завершено. Следующим шагом рассмотренно обновление SoftWLC на новую версию.


Обновление SoftWLC

Актуальную версию SoftWLC можно узнать здесь: Stable_versions

Первым шагом рекомендуется проверить параметр softwlc_installation_path в all.yml. Он должен содержать директорию, куда ранее был установлен SoftWLC.

Для этого необходимо посмотреть файл распологающийся по следующему пути: /home/<имя пользователя>/ansible/softwlc-ansible-1.37/inventory/my_softwlc/group_vars/all.yml

Необходимый в нём параметр:

# Путь установки SoftWLC
softwlc_installation_path: "<путь куда ранее был установлен SoftWLC>"

Следующим шагом рекомендуется сделать бэкап текущей установки, командой:

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

Далее необходимо остановить и удалить старые контейнеры, использовав флаг --delete

sudo ./eltex-softwlc-helper-ansible-latest.sh --delete

Следующие шаги рассмотрены в зависимости от установки - в некоторых необходимы дополнительные действия:

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

1) Запрос на создание бэкапа конфигурации. При выборе Y, нажатии на Enter, создастся архив с файлами конфигурации Ansible. Выбор по умолчанию - Y.

Do you want to backup your configuration files ? [Y/n] (default="Y"):

2) Запрос на замену параметров в файлах директории softwlc-ansible/*. При выборе Y все файлы в директории softwlc-ansible (за исключением my_softwlc/*) будут заменены на дефолтные из архива. Выбор по умолчанию - N.

You already have a softwlc-ansible configuration directory. Do you want to replace this configuration with default parameters from the archive? [y/N] (default="N"):

3) Запрос на замену параметров в файлах директории my_softwlc/*. При выборе Y все файлы в директории my_softwlc будут заменены на дефолтные из sample/*, удаляя все настройки пользователя, если таковые были. Выбор по умолчанию - N.

You already have my_softwlс configurations. Do you want to replace this configuration with default parameters from inventory/sample ? [y/N] (default="N"):


Также обратите внимание, что после обновления плейбуков необходимо ввести данные доступа по SSH повторно.

Standalone version

1) Запустить скрипт с флагом --default-install

sudo ./eltex-softwlc-helper-ansible-latest.sh --default-install

2) Ввести данные для подключения

Setup HOSTS for default installation
List of prepared hosts:
softwlc_main
 
Information note
Ansible uses SSH with existing OS credentials to access machines.
Next, you will be asked to provide details for connecting via SSH to the hosts you specified.
In the future, it is recommended to add the generated ssh key and use it (via "private_key_file" in ansible.cfg for example) to increase the security of the connection.
More information (Official Ansible Web site): https://docs.ansible.com/ansible/latest/reference_appendices/config.html
 
Setup credentials for HOST: softwlc_main
Enter address for HOST: softwlc_main (blank for last used): 192.168.1.1
softwlc_main will be configured at the: 192.168.1.1
Enter SSH user login for HOST: softwlc_main (blank for last used): tester
Enter SSH user password for HOST: softwlc_main (blank for last used): ******
Enter sudo password for HOST: softwlc_main (blank for last used): ******

3) Ожидать завершения установки

Reservation 1+1 (Galera Cluster) version

1) Изменить файл softwlc_reservation_setup.yml, закоментировав в нём следующие строки:

# - name: Pre-start softwlc containers
#   hosts: one_plus_one_reservation
#   tags: install-softwlc-reservation
#   roles:
#     - run_databases
#     - configure_databases
#     - run_softwlc

2) Запустить скрипт с флагом --reservation-install

sudo ./eltex-softwlc-helper-ansible-latest.sh --reservation-install

3) Ввести данные для подключения

Setup HOSTS for reservation installation
Enter virtual IP address (blank for last used):
Vitual IP set to: 192.168.1.100
Enter gateway IP address (blank for last used):
Gateway IP set to: 192.168.1.1
List of prepared hosts:
softwlc_reserv_1
softwlc_reserv_2
 
Information note
Ansible uses SSH with existing OS credentials to access machines.
Next, you will be asked to provide details for connecting via SSH to the hosts you specified.
In the future, it is recommended to add the generated ssh key and use it (via "private_key_file" in ansible.cfg for example) to increase the security of the connection.
More information (Official Ansible Web site): https://docs.ansible.com/ansible/latest/reference_appendices/config.html
 
Setup credentials for HOST: softwlc_reserv_1
Enter address for HOST: softwlc_reserv_1 (blank for last used): 192.168.1.2
softwlc_reserv_1 will be configured at the: 192.168.1.2
Enter SSH user login for HOST: softwlc_reserv_1 (blank for last used): tester
Enter SSH user password for HOST: softwlc_reserv_1 (blank for last used): ******
Enter sudo password for HOST: softwlc_reserv_1 (blank for last used): ******
 
Setup credentials for HOST: softwlc_reserv_2
Enter address for HOST: softwlc_reserv_2 (blank for last used): 192.168.1.3
softwlc_reserv_2 will be configured at the: 192.168.1.3
Enter SSH user login for HOST: softwlc_reserv_2 (blank for last used): tester
Enter SSH user password for HOST: softwlc_reserv_2 (blank for last used): ******
Enter sudo password for HOST: softwlc_reserv_2 (blank for last used): ******
Starting Ansible docker container
SWLC_VERSION=1.37
CURR_FILE_VERSION_NAME=softwlc-ansible-1.37
ELTEX_HUB=hub.eltex-co.ru/softwlc

4) Ожидать завершения установки

Replication 1+1+3 Galera Database Nodes version

1) Изменить файл softwlc_replication_setup.yml, закоментировав в нём следующие строки:

# - name: Pre-start softwlc containers
#   hosts: galera_claster_replication
#   tags: install-softwlc-replication-galera
#   roles:
#     - run_databases # все хосты (updated via hosts)
#     - configure_databases # все хосты (updated via hosts)
#     - run_softwlc # все хосты (updated via hosts)

2) Запустить скрипт с флагом --replication-galera-install

sudo ./eltex-softwlc-helper-ansible-latest.sh --replication-galera-install

3) Ввести данные для подключения

Setup HOSTS for replication Galera installation
Enter virtual IP address (blank for last used):
Vitual IP set to: "192.168.1.100"
Enter gateway IP address (blank for last used):
Gateway IP set to: "192.168.1.1"
List of prepared hosts:
softwlc_1
softwlc_2
database_1
database_2
database_3
 
Information note
Ansible uses SSH with existing OS credentials to access machines.
Next, you will be asked to provide details for connecting via SSH to the hosts you specified.
In the future, it is recommended to add the generated ssh key and use it (via "private_key_file" in ansible.cfg for example) to increase the security of the connection.
More information (Official Ansible Web site): https://docs.ansible.com/ansible/latest/reference_appendices/config.html
 
Setup credentials for HOST: softwlc_1
Enter address for HOST: softwlc_1 (blank for last used): 192.168.1.2
softwlc_1 will be configured at the: 192.168.1.2
Enter SSH user login for HOST: softwlc_1 (blank for last used): tester
Enter SSH user password for HOST: softwlc_1 (blank for last used): ******
Enter sudo password for HOST: softwlc_1 (blank for last used): ******
 
Setup credentials for HOST: softwlc_2
Enter address for HOST: softwlc_2 (blank for last used): 192.168.1.3
softwlc_2 will be configured at the: 192.168.1.3
Enter SSH user login for HOST: softwlc_2 (blank for last used): tester
Enter SSH user password for HOST: softwlc_2 (blank for last used): ******
Enter sudo password for HOST: softwlc_2 (blank for last used): ******
 
Setup credentials for HOST: database_1
Enter address for HOST: database_1 (blank for last used): 192.168.1.4
database_1 will be configured at the: 192.168.1.4
Enter SSH user login for HOST: database_1 (blank for last used): tester
Enter SSH user password for HOST: database_1 (blank for last used): ******
Enter sudo password for HOST: database_1 (blank for last used): ******
 
Setup credentials for HOST: database_2
Enter address for HOST: database_2 (blank for last used): 192.168.1.5
database_2 will be configured at the: 192.168.1.5
Enter SSH user login for HOST: database_2 (blank for last used): tester
Enter SSH user password for HOST: database_2 (blank for last used): ******
Enter sudo password for HOST: database_2 (blank for last used): ******
 
Setup credentials for HOST: database_3
Enter address for HOST: database_3 (blank for last used): 192.168.1.6
database_3 will be configured at the: 192.168.1.6
Enter SSH user login for HOST: database_3 (blank for last used): tester
Enter SSH user password for HOST: database_3 (blank for last used): ******
Enter sudo password for HOST: database_3 (blank for last used): ******
Starting Ansible docker container
SWLC_VERSION=1.37
CURR_FILE_VERSION_NAME=softwlc-ansible-1.37
ELTEX_HUB=hub.eltex-co.ru/softwlc

4) Ожидать завершения установки


По завершении работы скрипта в терминале появятся данные для подключения:

Installation of Eltex SoftWLC finished successfully.
        
URLs of SoftWLC components:

Eltex.EMS Server management (internal) IP: {{ ems_ip }}
Eltex.EMS Server external IP: {{ server_ip }}

Eltex.EMS GUI: http://<адрес SoftWLC>:8080/ems/jws
     login: admin
     password: <empty>

Portal constructor: http://<адрес SoftWLC>:8080/epadmin
     login: admin
     password: password

Wi-Fi customer cabinet (B2B): http://<адрес SoftWLC>:8080/wifi-cab
     login: admin
     password: password

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

sudo ./eltex-softwlc-helper-ansible-latest.sh --run
sudo ./eltex-softwlc-helper-ansible-latest.sh --stop

Более подробные возможности работы через Ansible рассмотрены здесь

  • Нет меток