View Source

1. Обновление системы WNAM с предыдущих версий (1.3, 1.4)

При обновлении системы WNAM с версий 1.3 или 1.4 до версии 1.5 необходимо выполнить следующие действия:

сделать бэкап БД MongoDB (wnam_db):

mongodump -o /backup/wnam14_bkp -d wnam_db

остановить работающее приложение WNAM текущей версии:

service tomcat8 stop

отключить автоматический запуск сервера приложений Tomcat при старте системы:

update-rc.d tomcat8 disable

остановить сервис FreeRADIUS и отключить его автоматический запуск при старте ОС, если требуется использовать встроенный в систему WNAM RADIUS-сервер:

service freeradius stop

update-rc.d freeradius disable

2. Система WNAM версии 1.5

Система WNAM версии 1.5 работает с использованием встроенного контейнера сервлетов. Внутри дистрибутива системы WNAM содержится минимальная версия Tomcat. Дистрибутив, поставляемый в виде файла wnam.war, можно скачать с использованием действующего лицензионного ключа по ссылке: http://www.netams.com/cgi/download.cgi. Файл wnam.war содержит в себе стартап-скрипт, за которым следуем самораспаковывающийся архив с приложением WNAM. Самостоятельно данный файл распаковывать не нужно.

Приложение WNAM будет выполняться от имени Linux-пользователя (учётной записи) с именем wnam, которого необходимо создать командой:

useradd -m -U -s /bin/false wnam

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

wget -O wnam.war http://www.netams.com/cgi/download.cgi?token=zsmehgiuwsprehmbhxjprgvlqgcunjyg ! эту временную ссылку взять с сайта загрузки, при вводе лицензионного ключа 
mv wnam.war /home/wnam
chmod 700 /home/wnam/wnam.war
chown wnam:wnam /home/wnam/wnam.war

Если проводится обновление системы WNAM (если ранее уже был установлен wnam.war), то необходимо сообщить системе об изменении файла приложения:

systemctl daemon-reload

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

ln -s /home/wnam/wnam.war /etc/init.d/wnam
update-rc.d wnam defaults
update-rc.d wnam enable

После настройки автозапуска системы следует скачать конфигурационные файлы и поместить их в требуемые папки (в каталог /home/wnam). Несмотря на то, что в обычном режиме эксплуатации система WNAM настраивается через веб-интерфейс администратора, в системе присутствует три конфигурационных файла первоначальной настройки системы WNAM:

/home/wnam/wnam.conf;
/home/wnam/application.properties;
/home/wnam/wnam.properties.

Первый файл (/home/wnam/wnam.conf) определяет параметры использования оперативной памяти приложением WNAM. Он считывается первым при старте виртуальной Java-машины. Его типичное содержимое состоит из строки, определяющей объемы выделенной приложению памяти, и путей до лог-файлов:

export JAVA_OPTS="-Xms512m -Xmx4g -Djava.net.preferIPv4Stack=true"
export LOG_FOLDER="/home/wnam/logs"
export LOG_FILENAME="console.log"

Файл можно скачать по данной ссылке: http://www.netams.com/files/wnam/misc/wnam.conf. В параметре "-Xmx" указывается допустимый объём оперативной памяти в гигабайтах. Рекомендуемое значение - от половины до 2/3 полного объёма оперативной памяти используемого Linux-сервера.

Второй файл (/home/wnam/application.properties) определяет параметры фреймворка Spring Boot и параметры встроенного сервера приложений Tomcat. Он считывается при инициализации встроенного сервера приложений. Типичное содержимое файла приведено ниже (с комментариями):

spring.application.name=WNAM
spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp
server.use-forward-headers=true
server.tomcat.basedir=.
server.tomcat.accesslog.enabled=true
server.port=8080 
server.address=0.0.0.0

spring.data.mongodb.uri=mongodb://127.0.0.1:27017/wnam_db

# for cluster configuration, use:
# spring.data.mongodb.uri=mongodb://app1,app2,db1,db2/wnam_db

Файл можно скачать по данной ссылке: http://www.netams.com/files/wnam/misc/application.properties.

Третий файл (/home/wnam/wnam.properties) определяет параметры самого приложения WNAM. Его можно получить по ссылке http://www.netams.com/files/wnam/misc/wnam.properties. Детальное описание параметров, задаваемых в этом файле, приведено в соответствующем разделе настоящей документации ("Конфигурационный файл"). Ранее этот файл был расположен в каталоге /etc/, теперь система WNAM при старте просматривает оба пути (/etc/ и /home/wnam/) в поисках файла настроек. Расположение файла в /home/wnam/ является предпочтительным.

Все три конфигурационных файла редко изменяются. Любое изменение требует рестарта приложения WNAM командой:

service wnam restart

3. Использование встроенного в систему WNAM сервера RADIUS

При использовании встроенного в систему WNAM сервера RADIUS требуется убедиться, что его запуск разрешен в файле конфигурации /etc/wnam.properties. Для этого в файле конфигурации должны присутствовать следующие строки:

radiusd_enable=true
radiusd_networks=127.0.0.1,10.0.0.0/8
radiusd_secret=secret
radiusd_logdir=/home/wnam/radiuslog

4. Запуск системы WNAM

Запуск системы WNAM производится следующей командой:

service wnam restart

При этом должен появиться каталог /home/wnam/logs (и, возможно, /home/wnam/radiuslog), в котором должен присутствовать файл wnam.log, содержащий строки вида:

22:03:22.924 INFO [com.netams.wnam.WNAM:48] - Starting WNAM v1.5.1998 on debian64.k18.netams.com with PID 30757 (/home/wnam/wnam.war started by wnam in /home/wnam)
22:03:22.927 DEBUG [com.netams.wnam.WNAM:51] - Running with Spring Boot v1.5.16.RELEASE, Spring v4.3.19.RELEASE
22:03:22.928 INFO [com.netams.wnam.WNAM:593] - No active profile set, falling back to default profiles: default
22:03:28.997 INFO [c.n.wnam.services.MikrotikService:42] - MikrotikService started
22:03:29.018 INFO [com.netams.wnam.services.SmsService:286] - SmsService started
22:03:29.040 DEBUG [com.netams.wnam.services.OuiService:29] - OuiService start
22:03:29.255 DEBUG [com.netams.wnam.services.OuiService:69] - OUI cache load: 214 ms., size=24753
22:03:29.263 DEBUG [c.n.wnam.services.StatisticService:282] - Log file: /home/wnam/logs/wnam.log
22:03:29.264 DEBUG [c.n.wnam.services.StatisticService:134] - StatisticService start
22:03:29.266 DEBUG [c.n.wnam.services.StatisticService:138] - Session maximum life time is 21600 seconds
22:03:29.292 DEBUG [c.netams.wnam.manager.LicenseManager:158] - LicenseManager start
22:03:29.310 DEBUG [c.netams.wnam.manager.LicenseManager:188] - License key: XXXX-XXXX-XXXX-XXXX
22:03:29.352 INFO [c.n.wnam.services.LinuxCPService:115] - LinuxCPService started
22:03:29.363 INFO [c.n.w.services.ControllerApiService:117] - ControllerApiService started
22:03:29.489 DEBUG [c.n.wnam.manager.PhoneNumbersManager:212] - Phones countries cache load: 234
22:03:29.494 INFO [c.netams.wnam.services.UnifiService:68] - UnifiService started
22:03:29.526 DEBUG [com.netams.wnam.services.SormService:92] - Parameters 'sorm_upload_path' or 'sorm_file_name' are empty
22:03:29.529 INFO [com.netams.wnam.services.SormService:137] - SORM RADIUS targets: 0, API enabled: false
22:03:29.529 INFO [com.netams.wnam.services.SormService:117] - SormService started
22:03:29.563 DEBUG [c.n.wnam.services.WnamCmdService:167] - WnamCmdService start
22:03:29.566 DEBUG [c.n.wnam.services.WnamRadiusService:76] - WnamRadiusService start
22:03:29.604 DEBUG [c.n.wnam.services.WnamRadiusService:104] - RadiusService accepting requests
22:03:29.895 INFO [c.n.wnam.services.BluesocketService:46] - BluesocketService started
22:03:30.039 INFO [c.n.w.services.AdvertisementService:76] - AdvertisementService started
22:03:30.056 DEBUG [c.n.wnam.services.NetFlowService:79] - NetFlowService start
22:03:30.079 DEBUG [c.n.wnam.services.WnamApiService:100] - WnamApiService start
22:03:30.309 DEBUG [c.netams.wnam.manager.LicenseManager:306] - checkLicenseKeyOnServer key='XXXX-XXXX-XXXX-XXXX' at 06.01.2019 22:03:30
22:03:30.939 DEBUG [c.netams.wnam.manager.LicenseManager:362] - checkLicenseKeyOnServer 1 returned license with key XXXX-XXXX-XXXX-XXXX
22:03:30.940 DEBUG [c.netams.wnam.manager.LicenseManager:207] - checkForLicensing: valid license key XXXX-XXXX-XXXX-XXXX
22:03:31.132 DEBUG [com.netams.wnam.web.LoginController:111] - owning_logo=file:/home/wnam/wnam.war!/images/wnam_logo_owner.png not found
22:03:32.618 INFO [com.netams.wnam.WNAM:57] - Started WNAM in 9.98 seconds (JVM running for 10.446)
22:03:36.514 DEBUG [c.n.wnam.manager.PhoneNumbersManager:228] - Phone cache is loaded: 84 prefixes, 1044 operators

Основными проблемами, возникающими при запуске системы WNAM, являются:

некорректное выставленные прав на файлы или саму директорию /home/wnam, а также некорректная попытка запуска системы от имени пользователя с правами root (проверяется командой "ls -la");
не запущенный предварительно сервер СУБД MongoDB (проверяется через команду "mongo");
запущенные на порту 8080 и/или 80 другой веб-сервер или приложение (проверяется через команду "netstat -nap | grep 80");
запущенный на портах 1812 и/или 1813 сервер FreeRADIUS при настроенном запуске встроенного RADIUS-сервера в составе WNAM (проверяется через команду "netstat -nap | grep 1812").

5. Работа через веб-интерфейс

При обращении к серверу системы WNAM через браузер (http://server/wnam/home) должно отобразиться окно интерфейса администратора системы WNAM для ввода учетных данных.

Wireless Network Access Manager > Система WNAM версии 1.5 > loginwindow.gif

По умолчанию параметры учетной записи следующие: логин admin, пароль admin.

После первого входа следует обязательно смените пароль и уже затем переходить к базовой настройке системы через веб-интерфейс.