Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

  • Оперативная память не менее 10Гб
  • CPU >= 2200MHz
  • Память жесткого диска >= 35Gb
  • Выход в Интернет
  • Операционная система Ubuntu Server 20.04 LTS / Ubuntu Server 22.04 LTS / Astra Linux Special Edition 1.7.4 (Воронеж) / РЕД ОС Муром  (7.3.1-7.3.3)/ Astra Linux Special Edition 1.7.5 (Воронеж) 

...

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

Блок кода
titleСоздание директории eltex-softwlc
tester@localhost:~$ mkdir eltex-softwlc

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

панель

/home/<имя пользователя>/eltex-softwlc

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

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

1) Перейдем в созданную директорию eltex-softwlc:

Блок кода
tester@localhost:~$ cd eltex-softwlc

2) Загрузим скрипт-установщик

панель
tester@localhost:
~$ wget 
~/eltex-softwlc$ wget http://archive.eltex-co.ru/wireless/help/softwlc-latest/eltex-softwlc-helper-docker-latest.sh
--2023-12-21 08:30:24-- http://archive.eltex-co.ru/wireless/help/softwlc-latest/eltex-softwlc-helper-docker-latest.sh
Resolving archive.eltex.org (archive.eltex-co.ru)... 172.16.0.68
Connecting to archive.eltex-co.ru (archive.eltex-co.ru)|172.16.0.68|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 25615 (25K) [text/x-sh]
Saving to: ‘eltex-softwlc-helper-docker-latest.sh’
eltex-softwlc-helper-docker
_1.29
-latest 100%[=====================================>] 25,01K --.-KB/s in 0,02s
2019-04-29 08:30:24 (1,61 MB/s) - ‘eltex-softwlc-helper-docker-latest.sh’ saved [25615/25615]

3) Необходимо перейти в созданную директорию и выдать права на исполнение файла eltex-softwlc-helper-docker-latest.sh

tester@localhost:~$ cd eltex-softwlc
панель
tester@localhost:~/eltex-softwlc$ chmod +x ./eltex-softwlc-helper-docker-latest.sh

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

...

1) Установить Docker и его зависимости с помоью ключа --install. В директории со скриптом запустите его следующим образом:

панель
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker
_1.29
-latest.sh --install

Дождаться завершения установки и надписи Install is complete

После установки для соблюдения требований информационной безопасности, доступ к командам docker выполняется только от пользователя root. При необходимости можно воспользоваться подробной инструкцией на официальном сайте docker. Краткая инструкция приведена ниже. Данные команды нужно выполнять от лица того пользователя, которому будет разрешено использование docker без sudo.

панель
tester@localhost:~/eltex-
softwlc$sudo
softwlc$ sudo groupadd docker
tester@localhost:~/eltex-
softwlc$sudo
softwlc$ sudo usermod -aG docker $USER
tester@localhost:~/eltex-
softwlc$newgrp
softwlc$ newgrp docker

2) Загрузить конфигурационные файлы. 

панель
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker
_1.29
-latest.sh -d


Предупреждение

При запуске ключа с параметром -d происходит очистка конфигурационных файлов env. Если вы решили выполнить эту операцию на рабочей системе, то необходимо сделать бэкап старых данных. Он выполняется с помощью ключа --backup, результатом является архив с копиями всех настроек, volume и.т.д, что находится в директории скрипта. Архив размещается в директории backup

...

Команда целиком выглядит следующим образом:

панель
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker
_1
-latest.
29.
sh --configure --emsip <IP адрес EMS> --serverip <IP адрес личного кабинета> --run

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

...

4) Систему необходимо конфигурировать только при первой установке. Для запуска уже установленной системы необходимо использовать ключ --run, для остановки --stop:

панель
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker
_1.29
-latest.sh --run
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker
_1
-latest.
29.
sh --stop

На данном этапе установка SoftWLC в докере завершена. Остальные возмоджности скрипта рассмотрены ниже.

...

панель

tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker_1-latest.29.sh --backup
Backup has been completed!
tester@localhost:~/eltex-softwlc$ ls
args-compose-tools.log backup data docker-compose.yml ./eltex-softwlc-helper-docker_1.29-latest.sh environment softwlc.tar volumes
tester@localhost:~/eltex-softwlc$ ls backup/
backup_20231221T100340.tar.gz

...

КлючЗначение

--backup 

Сохраняет резервную копию всех данных и конфигурационных файлов сервисов SoftWLC
--cleanУдаляет контейнеры и очищает все данные сервисов
--configure Запускается один раз при установке сервисов SoftWLC. Производит предварительную настройку БД.
--delete-containers Удаляет контейнеры
--download, -d Загружает установочный архив, содержащий конфигурационные файлы
--emsip <ADDRESS> Устанавливает адрес EMS в сети управления
--generate-keys Генерирует новые ключи для сервисов Eltex-doors и Eltex-wifi-cab
--help, -h Справка о ключах скрипта
--install Устанавливает docker, docker-compose
--pull, -p Загружает последние версии образов сервисов SoftWLC
--recreate-service <SERVICE>Пересобирает сервис после примененых изменений к нему
--serverip <ADDRESS> Устанавливает адрес личного кабинета и конструктора порталов в сети управления
--run, -r Запускает контейнеры
--show-containers Показывает актуальную информацию о запущенных контейнерах
--show-images Показывает актуальную информацию о загруженных образах
--stop Останавливает все контейнеры
--test-ports Запускает функционал проверки портов SoftWLC
--monitoring

Установка SoftWLC вместе с сервисом eltex-prometheus для функционала мониторинга сервисов SoftWLC в Личном кабинете Мониторинг сервисов SoftWLC


Сетевые настройки

Начиная с версии 1.30 для запуска всех контейнеров в Docker используется подсеть 172.30.0.0/16. В случае, если данные настройки конфиктуют с заранее запущенными контейнерами других приложений, данный параметр можно изменить в файле eltex-softwlc/docker-compose.yml

...