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:
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"
Файл можно взять по данной ссылке: 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 # TCP-порт, на котором работает встроенный веб-сервер. Оставьте 8080, если хотите применять проксирующий nginx, или замените на 80
server.address=0.0.0.0 # локальные IP-адреса, на которых принимать входящие соединения;
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 примерно такого содержания:
При обращении к серверу через браузер (http://server/wnam/home) вы должны увидеть приглашение административного интерфейса WNAM:
По умолчанию логин admin и пароль admin
После первого входа обязательно смените пароль.