Оглавление

Подготовка к установке

Для установки 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 в домашней директории пользователя. Таким образом, полный путь будет выглядеть следующим образом

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

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

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

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

Начало работы

Для успешного запуска SoftWLC в docker необходимо выполнить следующие шаги:

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

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

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

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

3) Запустить конфигурацию системы. Это можно сделать, задав специальные ключи:

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

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

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

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

Создание резервной копии системы

При необходимости, резервную копию всех данных сервисов SoftWLC можно выполнить, используя ключ --backup. Все данные, содержащиеся в папке со скриптом-установщиком, помещаются в архив в директорию backup. Запуск происходит следующим образом:

Запуск апплета EMS

Перед запуском апплета EMS через приложение Java Web Start убедитесь, что на ПК установлен Oracle Java.

В строке браузера введите следующий адрес:

При этом в браузере появится предложение открыть или скачать файл с расширением jnlp. Откройте этот файл с помощью приложения Java Web Start.

Для создания ярлыка на рабочем столе для запуска апплета EMS в Java Control Panel должно быть включено хранение временных файлов.

После установки Вы можете изменить пароли в различных модулях SWLC:

v1.30_Смена паролей в 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 <название подсети>