| Примечание |
|---|
Начиная с версии 1.36 установка в Docker производится с помощью плейбуков Ansible. В случае наличия Docker версии SoftWLC, установленной с помощью скрипта установщика рекомендуется произвести обновление до Docker версии Ansible. |
| Примечание |
|---|
Перед обновлением необходимо выполнить обновление пакетов на серверах с помощью команд sudo apt update && sudo apt upgrade |
Обновление SoftWLC
Для обновления SoftWLC в Docker на новую версию необходимо следовать перечисленным ниже командам.
В операционной системе необходимо создать отдельную директорию, где будет находиться сам скрипт, конфигурационные файлы, данные и плейбуки для Ansible. В качестве примера будет создана директория ansible в домашней директории пользователя.
| Блок кода |
|---|
|
mkdir /home/<имя пользователя>/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. Адрес его установки будет запрошен самим скриптом далее. |
Далее необходимо скачать плейбуки Ansible запустив скрипт с ключом -d
| Блок кода |
|---|
|
sudo ./eltex-softwlc-helper-ansible-latest.sh -d |
После чего в директории ansible появится директория с плейбуками softwlc-ansible-1.37.
Следующим шагом необходимо изменить параметр softwlc_installation_path в all.yml на путь, куда ранее была установлена Docker версия 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 |
|
После чего запустить скрипт с ключом --default-install
| Блок кода |
|---|
|
sudo ./eltex-softwlc-helper-ansible-latest.sh --default-install |
| Предупреждение |
|---|
Обратите внимание, что в случае необходимости схемы резервирования/репликации рекомендуется установка с переносом базы данных на соответствующую ноду. В этом случае используются другие ключи, отличные от --default-install. |
В процессе установки будут запрошены адрес удалённого (локального) хоста и данные для входа по SSH для Ansible:
| Блок кода |
|---|
|
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): ****** |
| Примечание |
|---|
При повторном запуске в различных ситуациях могут потребоваться дополнительные действия от пользователя 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"): |
|
По завершении работы скрипта в терминале появятся данные для подключения:
| Блок кода |
|---|
|
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 рассмотрены здесь