...
В операционной системе должна быть создана директория, где находится сам скрипт, конфигурационные файлы, данные и плейбуки для 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 Не обязательно скачивать скрипт на тот же хост, куда будет устанавливаться SoftWLC. Адрес его установки будет запрошен самим скриптом далее. |
4) Следующим шагом необходимо необходимо удалить старый архив и переименовать старую директорию:
...
| Примечание |
|---|
В случае использования версии 1.37 файл архива называется softwlc-ansible-1.37.tar.gz. Переименовывать старую директорию в данном случае нет необходимости |
5) Далее необходимо скачать плейбуки Ansible новой версии запустив новый скрипт с ключом -d
...
| Примечание | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
При наличии директории в различных ситуациях могут потребоваться дополнительные действия от пользователя 1) Запрос на создание бэкапа конфигурации. При выборе Y, нажатии на Enter, создастся архив с файлами конфигурации Ansible. Выбор по умолчанию - Y. Выбрать во время обновления - Y.
2) Запрос на замену параметров в файлах директории softwlc-ansible/*. При выборе Y все файлы в директории softwlc-ansible (за исключением my_softwlc/*) будут заменены на дефолтные из архива. Выбор по умолчанию - N. Выбрать во время обновления - Y.
3) Запрос на замену параметров в файлах директории my_softwlc/*. При выборе Y все файлы в директории my_softwlc будут заменены на дефолтные из sample/*, удаляя все настройки пользователя, если таковые были. Выбор по умолчанию - N. Выбрать во время обновления - Y.
|
6) Следующим шагом необходимо изменить параметр параметр текущей установки в 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 можно узнать здесь: Stable_versions |
1) Первым шагом рекомендуется проверить параметр параметр softwlc_installation_path в all.yml. Он должен содержать директорию, куда ранее был установлен 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 повторно. |
Standalone version
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) Ожидать завершения установки
Reservation 1+1 (Galera Cluster) version
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) Ожидать завершения установки
Replication 1+1+3 Galera Database Nodes version
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) По завершении работы скрипта в терминале появятся данные для подключения:
...