Видеопособие SoftWLC

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

Для установки 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.

В комплекте с контроллером идет демо-лицензия.

Начиная с версии 1.28 SoftWLC точки доступа realtek (WEP-200l,WEP/WOP-2L/30L, WEP-1L, WOP-30LS/30L-ex) необходимо обновить на версию 2.3.0 и выше, точки доступа wep-3ax на версию 1.11 и выше.
Инструкция по обновлению: v1.31_Обновление ПО ТД через SoftWLC
Запросить данное ПО можно через Service Desk или через заявку на нашем официальном сайте.

Установка

При установке на операционные системы Ubuntu Server 20.04 LTS / Ubuntu Server 22.04 LTS

Скачать из архива скрипт-установщик eltex-softwlc-helper-latest.sh и положить в корневую директорию ОС.

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

ubuntu@ubuntu:~$ wget https://archive.eltex-co.ru/wireless/help/softwlc-latest/eltex-softwlc-helper-latest.sh
--2024-08-30 09:35:18-- https://archive.eltex-co.ru/wireless/help/softwlc-latest/eltex-softwlc-helper-latest.sh
Resolving archive.eltex-co.ru (archive.eltex-co.ru)... 92.125.152.58
Connecting to archive.eltex-co.ru (archive.eltex-co.ru)|92.125.152.58|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 70091 (68K) [application/octet-stream]
Saving to: ‘eltex-softwlc-helper-latest.sh’

eltex-softwlc-helper-latest.sh 100%[=======================================================================================================>] 68.45K --.-KB/s in 0.004s

2024-08-30 09:35:18 (18.4 MB/s) - ‘eltex-softwlc-helper-latest.sh’ saved [70091/70091]

Дать права на исполнение файла eltex-softwlc-helper-latest.sh :

vagrant@ubuntu-version:~$ chmod +x ./eltex-softwlc-helper-latest.sh

Запустить скрипт с правами суперпользователя и ожидать окончания работы:

vagrant@ubuntu-version:~$ sudo ./eltex-softwlc-helper-latest.sh

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

Installation of Eltex SoftWLC finished
URLs of SoftWLC components:
Eltex.EMS GUI: http://localhost:8080/ems/jws
login: admin
password: <empty>

Portal constructor: http://localhost:8080/epadmin
login: admin
password: password

Wi-Fi customer cabinet: http://localhost:8080/wifi-cab
login: admin
password: password

При возникновении ошибок обратитесь к документации.

При установке на Astra Linux Special Edition 1.7.4 (Воронеж)

Скачать скрипт-установщик и положить в корневую директорию ОС.

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

vagrant@astra-version:~$ wget https://archive.eltex-co.ru/wireless/help/softwlc-latest/eltex-softwlc-helper-astra-latest.sh
[sudo] password for tester:
--2023-03-14 16:37:43-- https://archive.eltex.org/wireless/help/softwlc-latest/eltex-softwlc-helper-astra-latest.sh
Resolving archive.eltex.org (archive.eltex.org)... 92.125.152.58
Connecting to archive.eltex.org (archive.eltex.org)|92.125.152.58|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 73208 (71K) [application/octet-stream]
Saving to: ‘eltex-softwlc-helper-astra-latest.sh’

eltex-softwlc-helper-astra-latest.sh 100%[======================================================================================================================================>] 71.49K 340KB/s in 0.2s

2023-03-14 16:37:43 (340 KB/s) - ‘eltex-softwlc-helper-astra-latest.sh’ saved [73208/73208]

Дать права на исполнение файла eltex-softwlc-helper-astra-latest.sh

vagrant@astra-version:~$ chmod +x ./eltex-softwlc-helper-astra-latest.sh

Запустить скрипт с правами суперпользователя и ожидать окончания работы:

vagrant@astra-version:~$ sudo ./eltex-softwlc-helper-astra-latest.sh
Installation started for softwlc-1.25, from https://archive.eltex-co.ru/wireless
Reading package lists... Done
Building dependency tree
Reading state information... Done
wget is already the newest version (1.20.1-1.1).
wget set to manually installed.
lsb-release is already the newest version (10.2019051400+ci202012021351+astra2).
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Platform : x86_64
OS distributer ID: astralinux
OS distrib code name: 1.7_x86-64
Repository: https://archive.eltex-co.ru/wireless
Java vendor: openjdk
Setting portal constructor and customer cabinet link addresses..
External IP address has been detected

.................................................................................

При возникновении ошибок обратитесь к документации.

После установки на сервере необходимо выполнить:

sudo sed -i 's/ProtectSystem=strict/ProtectSystem=off/g' /lib/systemd/system/tomcat9.service
sudo systemctl daemon-reload
sudo systemctl restart tomcat9

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

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

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

http://<ip address SoftWLC>:8080/ems/jws/

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

Рекомендуем использовать Oracle Java 17. Инструкция по запуску апплета - v1.31_Запуск аплета EMS на Java 17

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

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

v1.31_Смена паролей в SoftWLC

Добавление лицензии

Для базовой лицензии. Файл 'licence.xml'.
Нужно заменить файл 'licence.xml' в каталоге '/eltex-softwlc/data/eltex-ems/usr/lib/eltex-ems/conf/licence' и перезапустить сервис eltex-ems.

Для инкрементальной лицензии. Файл 'licence-2.xml', 'licence-3.xml' и т.д.
Нужно скопировать файл 'licence-2.xml' в каталог '/eltex-softwlc/data/eltex-ems/usr/lib/eltex-ems/conf/licence' и перезапустить сервис eltex-ems.

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

docker compose up -d --force-recreate eltex-ems-core

Ключи запуска скрипта

Ключ	Значение
--update-eltex-packages	Пропустить установку системных пакетов. только установка пакетов из репозитория eltex
--clickhouse	Добавить установку БД clickhouse и включить использование её дня работы с RADIUS accounting
-ott	Добавить установку сервисов OTT
--test-ports	Режим "только протестировать открытые порты Платформы SoftWLC", без установки пакетов. Может применяться совместно с модификаторами --ott, --clickhouse
--dhcp	Установить пакет 'isc-dhcp-server' в его дефолтной конфигурации
--force-old-conffiles	В этом режиме при обновлении dpkg будет автоматически принимать решение использовать старые conf файлы
--force-new-conffiles	В этом режиме dpkg при обновлении будет автоматически принимать решение использовать новые conf файлы
--monitoring	Установка SoftWLC вместе с сервисом eltex-prometheus для функционала мониторинга сервисов SoftWLC в Личном кабинете Мониторинг сервисов SoftWLC

Дерево страниц

v1.33_Пошаговая установка SoftWLC скриптом-установщиком