Page History

Восстановление пароля

Если вы забыли забыт пароль администратора системы (пользователя admin), его можно сбросить в значение по умолчанию ("admin") путём прямой модификации записи в базе данныхБД.   Для этого на сервере системы WNAM от пользователя root выполните необходимо выполнить команды:

mongo wnam_db

db.webinterfaceusers.update( { _id: "admin"} , { $set : { "password" : "d2abaa37a7c3db1137d385e1d8c15fd2"} } )

...

Уменьшение размера базы лог-событий

Поскольку по умолчанию все объекты в базе данных mongdb БД MongDB хранятся неограниченное время, в нагруженной системе возможна генерация очень большого числа событий, которые занимают место в коллекции логов (cmdServiceLogs). СУБД Mongodb обладает способностью автоматически удалять объекты из коллекции, если превышено время их жизни. Для установки времени жизни сообщений в логах =14 дней создайте , равное 14 дням (14 дней - это 60*60*24*14 = 1209600 секунд), следует создать новый индекс:

...

mongo wnam_db

...

db.cmdServiceLogs.createIndex( { "time": 2 }, { expireAfterSeconds: 1209600 } );

14 дней - это 60*60*24*14 = 1209600 секунд.

Резервное копирование

Для выполнения резервного копирования создайте необходимо создать скрипт , и вызывайте вызывать его раз в сутки (предпочтительнее ночью):

rm -rf /backup/wnam_db
mongodump -d wnam_db -o /backup
mv /backup/wnam_db /backup/wnam_db_`date +"%d-%m-%Y"`

ЖелательноКрайне желательно, чтобы раздел /backup/ находился на физически другом жёстком диске.

Используемые TCP/IP порты

Для работы системой WNAM используются следующие порты и протоколы, которые необходимо настроить на межсетевом экране вашего используемого сервера , или промежуточных межсетевых экранах:. Описание портов представлено в таблице.

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

Обновление системы (переход на новую версию)

...

Обновление операционной системы (для всех версии)

При обновлении ОС сервера следует обратить внимание на обновление СУБД MongoDB. Эта СУБД не поддерживает обновление "перескоком" через несколько версий (например с 3.6 до 4.4). Её можно обновить только последовательно (3.6-4.0-4.2-4.4), поэтому гораздо проще сделать полный дамп (mongodump -d wnam_db) всей БД, а потом произвести её переустановку с удалением файлов базы в /var/lib/mongodb/. После установки последней версии необходимо сделать восстановление базы (mongorestore -d wnam_db dump).

Внимание! Обновление MongoDB до версий 5, 6, 7 и т.п. требует применения процессоров с поддержкой инструкции AVX. На очень старых процессорах MongoDB версии выше 4.4.х работать не будет. Проверьте ваш сервер через grep avx /proc/cpuinfo

Обновление системы (с версии 1.6 на новый релиз 1.6)

Подробное описание обновления системы WNAM представлено в соответствующем разделе настоящей документации (обновление системы).

Обновление системы (до версии 1.6)

Если требуется обновление с версии 1.5, следует обратить внимание, что freeradius больше не поддерживается, и его надо отключить. Если после обновления слетит лицензия и все настройки в "Конфигурация" → "Общие настройки", следует выполнить их ручное восстановление через консоль сервера БД командами:

mongo wnam_db

db.settings.remove({"_id" : "settingsid"})

doc=db.settings.find()

doc._id = "settingsid"

db.settings.insert(doc)

После восстановления настроек требуется перезапустить систему WNAM.

Обновление системы (версия 1.5)

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

cd /home/wnam

cp wnam.war wnam.war.prev

В интерфейсе администратора системы WNAM в разделе "Конфигурация" → "Общие настройки" следует скопировать лицензионный ключ. Затем необходимо перейти на сайт https://www.netams.com/download/ , ввести ключ и получить ссылку для скачивания дистрибутива.

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

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

Остановите WNAM:

systemctl stop wnam

Далее следует проверить, что сервер остановлен, используя команду:

ps ax | grep wnam

Затем необходимо перенести дистрибутив:

mv /tmp/wnam.war /home/wnam
chmod +x /home/wnam/wnam.war
chown wnam:wnam /home/wnam/wnam.war

А затем обновить конфигурацию сервисов:

systemctl daemon-reload

И запустить систему WNAM:

systemctl start wnam

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

tail -f /home/wnam/logs/console.log /home/wnam/logs/wnam.log 

После выполненных действий следует проверить работу веб-интерфейса, а затем - авторизацию абонентов.

Обновление системы (версии с 1.2 до 1.4)

...

...

Для обновления java до версии 8 в Debian Jessie необходим репозиторий backports. Добавьте строкуДалее следует добавить строку в конец файла /etc/apt/sources.list: 

...

deb http://http.debian.net/debian jessie-backports main

в конец файла /etc/apt/sources.list и выполните:

...

 и выполнить:

apt-get update

...

apt-get install openjdk-8-jre-headless openjdk-8-jdk

...

update-java-alternatives -s java-1.8.0-openjdk-amd64

При обновлении версии java убедитесьнеобходимо убедиться, что старая версия 7 не используется по умолчанию. Подробнее смотрите в инструкции Подробная информация по установке ПО представлено в соответствующем разделе настоящей документации (инструкция по установке).

Проведите Далее необходимо произвести резервное копирование базы данных БД системы, как написано выше (при помощи mongodump).

Создайте Затем создать резервную копию приложения WNAM, которое у вас установлено в папке веб-приложений:

cp /var/lib/tomcat7/webapps/ROOT.war /root/ROOT.war.`date +"%d-%m-%Y"`

При этом копировать все папки самого развернутого приложения (/var/lib/tomcat7/webapps/ROOT/*) не требуется, так как вся информация, включая настройки и шаблоны страниц, хранится в базе данныхБД.

ПроверьтеДалее следует проверить, что все скрипты и базовые конфигурационные файлы, которые вы используетеиспользуются, соответствуют актуальным версиям, расположенным здесьпо адресу: http://www.netams.com/files/wnam/misc/ . Особое внимание уделите следует уделить скрипту-связке WNAM и FreeRADIUS: wnam-freeradius-bridge.pl. При необходимости , скопируйте следует скопировать его в /etc/freeeradius и перезапустите перезапустить сервис:

service freeradius restart

Остановите После перезапуска сервиса следует остановить веб-сервис tomcat:

service tomcat7 stop

Удалите и удалить старое приложение и старые лог-файлы:

rm -rf /var/lib/tomcat7/webapps/* /var/log/tomcat7/*

Перепишите Необходимо переписать новый дистрибутив системы WNAM из предварительно загруженного на сервер скаченного файла /root/ROOT.war в его целевое место:

cp /root/ROOT.war /var/lib/tomcat8/webapps/ROOT.war

Запустите и запустить веб-сервер:

service tomcat8 start

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

ПроверьтеДалее следует проверить, что приложение корректно запустилось, просмотрев в конец лог-файла /var/log/tomcat8/wnam.log, там должно появиться что-то аналогичноедолжны появиться подобные строки:

23:33:52.370 DEBUG [c.n.w.s.s.UserAuthenticationProvider:56] - UserAuthenticationProvider init at 26.10.2015 23:33:52
23:33:52.657 DEBUG [com.netams.wnam.services.OuiService:30] - OuiService start
23:33:53.025 DEBUG [com.netams.wnam.services.OuiService:70] - OUI cache load: 368 ms., size=20653
23:33:53.133 DEBUG [com.netams.wnam.services.SmsService:63] - gammu_path=
23:33:53.139 INFO [com.netams.wnam.services.SmsService:124] - SmsService started
23:33:53.141 DEBUG [c.netams.wnam.manager.LicenseManager:98] - LicenseManager start
23:33:53.146 DEBUG [c.netams.wnam.manager.LicenseManager:117] - License key: XXXX-XXXX-XXXX-XXXX
23:33:53.148 DEBUG [c.netams.wnam.manager.LicenseManager:177] - checkLicenseKeyOnServer key='XXXX-XXXX-XXXX-XXXX'
23:33:53.642 DEBUG [c.netams.wnam.manager.LicenseManager:225] - checkLicenseKeyOnServer returned license with key XXXX-XXXX-XXXX-XXXX
23:33:53.642 DEBUG [c.netams.wnam.manager.LicenseManager:136] - checkForLicensing: valid license key XXXX-XXXX-XXXX-XXXX
23:33:53.643 DEBUG [c.netams.wnam.manager.LicenseManager:159] - checkForLicensing: issued='Wed Sep 09 13:07:18 MSK 2015', expires='Tue Oct 01 13:06:07 MSK 2024', isTrialPeriodEnded=false
23:33:53.749 INFO [c.n.wnam.services.BluesocketService:56] - BluesocketService started
23:33:53.761 INFO [c.n.wnam.services.LinuxCPService:84] - LinuxCPService started
23:33:53.769 DEBUG [c.n.wnam.services.StatisticService:98] - StatisticService start
23:33:53.775 INFO [c.netams.wnam.services.UnifiService:69] - UnifiService started
23:33:53.782 DEBUG [c.n.wnam.services.WnamFlowService:62] - WnamFlowService start
23:33:53.800 DEBUG [c.n.wnam.services.WnamCmdService:124] - WnamCmdService start
23:33:53.818 DEBUG [c.n.wnam.services.NetFlowV5Service:66] - NetFlowV5Service start

Не В лог-файле не должно быть никаких сообщений со словами Exception. Если всё в порядке, и веб-интерфейс системы WNAM открывается, то работу по обновлению можно считать законченной. Рекомендуется проверить работу авторизации на одной из существующих площадок , и получить подтверждение от абонентов или сотрудников на месте.

Если вы переходите необходим переход со старой версии системы WNAM, необходимо также проверить и обновить страницы портала пользователя.

Обновление хранилища данных MongoDB

Начиная с версии 3.0 в mongodb предпочтительно использование хранилища данных типа WiredTiger вместо MMAP, которое применялось в ранних версиях. Если ваша база данных (в каталоге /var/lib/mongodb/) выглядит как множество файлов типа  wnam_db.0,  wnam_db.1,  wnam_db.2 и т.д., вам необходимо провести обновление движка БД. Для этого можно воспользоваться инструкцией:  https://docs.mongodb.com/v3.2/tutorial/change-standalone-wiredtiger/

...

...