Оглавление |
---|
Для установки SoftWLC в минимальной конфигурации нам понадобится сервер со следующими параметрами:
- Оперативная память не менее 10Гб
- CPU >= 2200MHz
- Память жесткого диска >= 35Gb
- Выход в Интернет
- Операционная система Ubuntu Server 20.04 LTS / Ubuntu Server 22.04 LTS / Astra Linux Special Edition 1.7.4 (Воронеж) / РЕД ОС Муром
Подробнее о требованиях к серверу смотрите здесь.
Рекомендуется устанавливать контроллер на чистую ОС.
Перед установкой необходимо выполнить обновление пакетов на сервере с помощью команд sudo apt update && sudo apt upgrade.
В комплекте с контроллером идет демо-лицензия.
Загрузка скрипта
В операционной системе необходимо создать отдельную директорию, где будет находиться сам скрипт, конфигурационные файлы, данные сервисов и логи. В качестве примера будет создана директория eltex-softwlc в домашней директории пользователя. Таким образом, полный путь будет выглядеть следующим образом
панель |
---|
/home/<имя пользователя>/eltex-softwlc |
Далее, необходимо загрузить скрипт установщик по ссылке из репозитория и разместить его в директории, созданной ранее.
Данную операцию также можно выполнить из терминала:
панель |
---|
tester@localhost:~$ wget http://archive.eltex-co.ru/wireless/help/softwlc-latest/eltex-softwlc-helper-docker-latest.sh |
Необходимо перейти в созданную директорию и выдать права на исполнение файла eltex-softwlc-helper-docker-latest.sh
панель |
---|
tester@localhost:~$ cd eltex-softwlc |
Все действия со скриптом необходимо проводить с использованием sudo
Начало работы
Для успешного запуска SoftWLC в docker необходимо выполнить следующие шаги:
1) Установить Docker и его зависимости с помоью ключа --install. В директории со скриптом запустите его следующим образом:
панель |
---|
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker_1.29.sh --install |
Дождаться завершения установки и надписи Install is complete
После установки для соблюдения требований информационной безопасности, доступ к командам docker выполняется только от пользователя root. При необходимости можно воспользоваться подробной инструкцией на официальном сайте docker. Краткая инструкция приведена ниже. Данные команды нужно выполнять от лица того пользователя, которому будет разрешено использование docker без sudo.
панель |
---|
tester@localhost:~/eltex-softwlc$sudo groupadd docker |
2) Загрузить конфигурационные файлы.
панель |
---|
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker_1.29.sh -d |
Предупреждение |
---|
При запуске ключа с параметром -d происходит очистка конфигурационных файлов env. Если вы решили выполнить эту операцию на рабочей системе, то необходимо сделать бэкап старых данных. Он выполняется с помощью ключа --backup, результатом является архив с копиями всех настроек, volume и.т.д, что находится в директории скрипта. Архив размещается в директории backup |
3) Запустить конфигурацию системы. Это можно сделать, задав специальные ключи:
Ключ | Значение |
---|---|
--configure | Настройка параметров SoftWLC |
--emsip | Адрес EMS из сети управления |
--serverip | Адрес личного кабинета и конструктора порталов из сети управления |
--run | Запуск контейнеров |
Команда целиком выглядит следующим образом:
панель |
---|
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker_1.29.sh --configure --emsip <IP адрес EMS> --serverip <IP адрес личного кабинета> --run |
По завершению работы скрипта в терминале появятся данные для подключения:
панель |
---|
Installation of Eltex SoftWLC finished successfully.
Eltex.EMS Server management (internal) IP: <адрес EMS> Eltex.EMS GUI: http://<адрес EMS>:8080/ems/jws Portal constructor: http://<Адрес конструктора порталов>:8080/epadmin Wi-Fi customer cabinet (B2B): http://<Адрес Личного кабинета>:8080/wifi-cab |
4) Систему необходимо конфигурировать только при первой установке. Для запуска уже установленной системы необходимо использовать ключ --run, для остановки --stop:
панель |
---|
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker_1.29.sh --run |
На данном этапе установка SoftWLC в докере завершена. Остальные возмоджности скрипта рассмотрены ниже.
Предупреждение |
---|
Начиная с версии 1.28 SoftWLC точки доступа realtek (WEP-200l,WEP/WOP-2L/30L, WEP-1L, WOP-30LS/30L-ex) необходимо обновить на версию 2.3.0 и выше, точки доступа wep-3ax на версию 1.11 и выше. |
Создание резервной копии системы
При необходимости, резервную копию всех данных сервисов SoftWLC можно выполнить, используя ключ --backup. Все данные, содержащиеся в папке со скриптом-установщиком, помещаются в архив в директорию backup. Запуск происходит следующим образом:
панель |
---|
tester@localhost:~/eltex-softwlc$ sudo ./eltex-softwlc-helper-docker_1.29.sh --backup |
Запуск апплета EMS
Перед запуском апплета EMS через приложение Java Web Start убедитесь, что на ПК установлен Oracle Java.
В строке браузера введите следующий адрес:
панель |
---|
http://<ip address SoftWLC>:8080/ems/jws/ |
При этом в браузере появится предложение открыть или скачать файл с расширением jnlp. Откройте этот файл с помощью приложения Java Web Start.
Примечание |
---|
Рекомендуем использовать Oracle Java 17. Инструкция по запуску апплета - v1.30_Запуск аплета EMS на Java 17 |
Для создания ярлыка на рабочем столе для запуска апплета EMS в Java Control Panel должно быть включено хранение временных файлов.
После установки Вы можете изменить пароли в различных модулях SWLC:
Ключи запуска скрипта
Ключ | Значение |
---|---|
--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 |
Сетевые настройки
Начиная с версии 1.30 для запуска всех контейнеров в Docker используется подсеть 172.30.0.0/16. В случае, если данные настройки конфиктуют с заранее запущенными контейнерами других приложений, данный параметр можно изменить в файле eltex-softwlc/docker-compose.yml
Блок кода | ||
---|---|---|
| ||
networks: swlc_innernet: driver: bridge ipam: driver: default config: - subnet: 172.30.0.0/16 <----- Изменить адрес на используемый вами |
Также, по умолчанию установлен адрес 172.30.0.101 для контейнера eltex-radius и 172.30.0.102 для контейнера eltex-ems-core- для корректного отображения статуса сертификата в EMS. При смене адресации необходимо изменить и его.
Блок кода | ||
---|---|---|
| ||
eltex-radius: container_name: eltex-radius image: ${ELTEX_HUB}/eltex-radius:${SWLC_VERSION} restart: unless-stopped deploy: resources: limits: memory: 128M networks: swlc_innernet: ipv4_address: 172.30.0.101 <----- Изменить адрес на используемый вами ... eltex-ems-core: container_name: eltex-ems-core image: ${ELTEX_HUB}/eltex-ems-core:${EMS_VERSION} restart: unless-stopped networks: swlc_innernet: ipv4_address: 172.30.0.102 <----- Изменить адрес на используемый вами |
После этого необходимо применить данные изменения с помощью команд:
Блок кода |
---|
sudo ./eltex-softwlc-helper-docker-latest.sh --stop sudo ./eltex-softwlc-helper-docker-latest.sh --run |
В случае конфликтов с другими подсетями Docker, их можно вывести с помощью команды sudo docker network ls и удалить необходимую с помощью команды sudo docker network rm <название подсети>