Актуальная версия плейбуков: 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

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

wget http://archive.eltex.org/wireless/help/softwlc-latest/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.

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

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

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

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

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

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

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

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

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

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 повторно.

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

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): ******

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

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

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

# - 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)

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

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

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

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