Актуальная версия плейбуков: 1.37 от 28 октября 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 в домашней директории пользователя.
1) Переходим в директорию
cd /home/<имя пользователя>/ansible |
2) Далее, необходимо загрузить скрипт установщик по ссылке из репозитория и разместить его с заменой в созданной ранее директории.
Данную операцию также можно выполнить из терминала:
wget http://archive.eltex.org/wireless/help/softwlc-latest/eltex-softwlc-helper-ansible-latest.sh |
3) Следующим шагом необходимо выдать права на исполнение нового файла eltex-softwlc-helper-ansible-latest.sh, если таковых нет:
sudo chmod +x eltex-softwlc-helper-ansible-latest.sh |
Все действия со скриптом необходимо проводить с использованием sudo Не обязательно скачивать скрипт на тот же хост, куда будет устанавливаться SoftWLC. Адрес его установки будет запрошен самим скриптом далее. |
4) Следующим шагом необходимо удалить старый архив и переименовать старую директорию:
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. Переименовывать старую директорию в данном случае нет необходимости |
5) Далее необходимо скачать плейбуки Ansible новой версии запустив новый скрипт с ключом -d
sudo ./eltex-softwlc-helper-ansible-latest.sh -d |
Во время обновления появятся 3 запроса на обновление параметров и конфигураций: 1) Запрос на создание бэкапа конфигурации. При выборе Y, нажатии на Enter, создастся архив с файлами конфигурации Ansible. Выбор по умолчанию - Y. Выбрать во время обновления - Y.
2) Запрос на замену параметров в файлах директории softwlc-ansible/*. При выборе Y все файлы в директории softwlc-ansible (за исключением my_softwlc/*) будут заменены на дефолтные из архива. Выбор по умолчанию - N. Выбрать во время обновления - Y.
3) Запрос на замену параметров в файлах директории my_softwlc/*. При выборе Y все файлы в директории my_softwlc будут заменены на дефолтные из sample/*, удаляя все настройки пользователя, если таковые были. Выбор по умолчанию - N. Есть 2 способа обновить данный файл:
|
6) Следующим шагом необходимо изменить параметр текущей установки в all.yml.
Для этого необходимо изменить файл распологающийся по следующему пути: /home/<имя пользователя>/ansible/softwlc-ansible-1.37/inventory/my_softwlc/group_vars/all.yml
В нём необходимо указать напротив используемой установки флаг true, выбрав для остальных false относительно используемой установки:
# 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 на новую версию.
Актуальную версию SoftWLC можно узнать здесь: Stable_versions |
1) Первым шагом рекомендуется проверить параметр softwlc_installation_path в all.yml. Он должен содержать директорию, куда ранее был установлен SoftWLC.
Для этого необходимо посмотреть файл распологающийся по следующему пути: /home/<имя пользователя>/ansible/softwlc-ansible-1.37/inventory/my_softwlc/group_vars/all.yml
Необходимый в нём параметр:
# Путь установки SoftWLC softwlc_installation_path: "<путь куда ранее был установлен SoftWLC>" |
Следующим шагом рекомендуется сделать бэкап текущей установки, командой:
|
2) Далее необходимо остановить и удалить старые контейнеры, использовав флаг --delete
sudo ./eltex-softwlc-helper-ansible-latest.sh --delete |
3) Следующие шаги рассмотрены в зависимости от установки - в некоторых необходимы дополнительные действия:
При повторном запуске также будут запрошены аналогичные обновлению плейбуков вопросы. Здесь необходимо оставить все значения по умолчанию 1) Запрос на создание бэкапа конфигурации. При выборе Y, нажатии на Enter, создастся архив с файлами конфигурации Ansible. Выбор по умолчанию - Y.
2) Запрос на замену параметров в файлах директории softwlc-ansible/*. При выборе Y все файлы в директории softwlc-ansible (за исключением my_softwlc/*) будут заменены на дефолтные из архива. Выбор по умолчанию - N.
3) Запрос на замену параметров в файлах директории my_softwlc/*. При выборе Y все файлы в директории my_softwlc будут заменены на дефолтные из sample/*, удаляя все настройки пользователя, если таковые были. Выбор по умолчанию - N.
|
Обратите внимание, что после обновления плейбуков необходимо ввести данные доступа по SSH повторно. |
3.1.1) Запустить скрипт с флагом --default-install
sudo ./eltex-softwlc-helper-ansible-latest.sh --default-install |
3.1.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.1.3) Ожидать завершения установки
3.2.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 |
3.2.2) Запустить скрипт с флагом --reservation-install
sudo ./eltex-softwlc-helper-ansible-latest.sh --reservation-install |
3.2.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 |
3.2.4) Ожидать завершения установки
3.3.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) |
3.3.2) Запустить скрипт с флагом --replication-galera-install
sudo ./eltex-softwlc-helper-ansible-latest.sh --replication-galera-install |
3.3.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 |
3.3.4) Ожидать завершения установки
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 рассмотрены здесь