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).

Обновление системы (с версии 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 в СУБД MongoDB предпочтительно использование хранилища данных типа WiredTiger вместо MMAP, которое применялось в ранних версиях. Если ваша база данных используемая БД (в каталоге /var/lib/mongodb/) выглядит как множество файлов типа  wnam wnam_db.0,  wnam wnam_db.1,  wnam wnam_db.2 и т.д., вам необходимо провести обновление "движка" БД. Для этого можно воспользоваться инструкцией:  https://docs.mongodb.com/v3.2/tutorial/change-standalone-wiredtiger/.

Фактически, обновление производится путём бэкапа базы данных БД в файлы, изменения типа "движка" БД в конфигурационном файле /etc/mongodb.conf (storageEngine=wiredTiger), восстановления бэкапа.