1. Если вы производите обновление с WNAM предыдущих версий (1.3, 1.4), вам необходимо:
Сделать бэкап базы данных 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 содержится минимальная версия Tomcat. Дистрибутив, поставляемый в виде файла wnam.war, можно скачать с использованием действующего лицензионного ключа по ссылке: http://www.netams.com/cgi/download.cgi
Файл wnam.war содержит в себе стартап-скрипт, за которым следуем самораспаковывающийся архив с приложением WNAM. Самостоятельно war-файл распаковывать не нужно.
Приложение 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
Скачиваем конфигурационный файлы и помещаем их в требуемые папки. Несмотря на то, что в обычном режиме эксплуатации WNAM настраивается через административный веб-интерфейс, в системе присутствует три конфигурационных файла первоначальной настройки WNAM.
Первый файл, /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
Третий файл, /etc/wnam.properties, определяет параметры самого приложения WNAM. Его можно получить по ссылке http://www.netams.com/files/wnam/misc/wnam.properties
Детальное описание параметров, задаваемых в этом файле, приведено в отдельном документе.
Все три конфигурационных файла редко изменяются. Любое изменение требует рестарта приложения WNAM командой:
service wnam restart
3. При использовании встроенного в 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 производится командой
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
- Не запущенный предварительно сервер mongodb
- Запущенный на порту 8080 или 80 другой веб-сервер или приложение
- Запущенный на портах 1812, 1813 сервер FreeRADIUS при настроенном запуске встроенного RADIUS-сервера в составе WNAM
5. Работа через веб-интерфейс
При обращении к серверу через браузер (http://server/wnam/home) вы должны увидеть приглашение административного интерфейса WNAM:
По умолчанию логин admin и пароль admin
После первого входа обязательно смените пароль.
Переходите к базовой настройке через веб-интерфейс.