Introduction
The purpose of this document is to explain how to update the NCS software.
In the steps below, the assumption is made that the NCS software has been installed on the C drive. If this is not the case, please adapt all commands accordingly.
Backup the existing installation
C:\NixxisMaintenance\Update\[CurrentAmericanFormatDate]
2) Unblock the zip file :
a. Right
click on this one
b. “Properties”
c. “Unblock”
3)
Open
the event diagnostic’s page (http://[app_server_IP]:8088/eventserver) and check that no agent is
working.
4)
Stop
the “ContactRoute Application Server” services (net stop crappserver from an administrator command prompt)
5)
Backup
the old log files from C:\Nixxis\Logs
(if necessary).
6)
Backup
the Nixxis files a.
Copy
the existing Nixxis installation (C:\Nixxis
folder) to the folder “C:\NixxisMaintenance\Backup\[CurrentAmericanFormatDate]\
7) Backup
the Databases:
a.
Edit
the C:\Nixxis\Tools\Sql\NixxisSqlBackup.sql
file backup script on the SQL Server with “Sql
Server Management Studio”.
b.
Before
running the script, look for the line below and make sure the file PATH is
pointing to an existing place and that there is sufficient disk space available
set @cmd ='BACKUP
DATABASE [' + @name + '] TO DISK = N''D:\Backup\NixxisSQL.bak''
WITH NOFORMAT…
a.
Create
“C:\NixxisMaintenance\Backup\[CurrentAmericanFormatDate]\MediaServer”
b.
Backup
the following folders from the media server:
i
/usr/sbin
ii
/etc/asterisk
iii
/srv/www
iv
/var/lib/asterisk
to Backup\[CurrentAmericanFormatDate]\MediaServer
Install the Update
1)
Install
the update software by copying the new files into the existing Nixxis
directory, overwriting the old files.
2)
Start
the Nixxis services “ContactRoute Application Server” (net start crappserver from an administrator command prompt).
3) When the services are started for
the first time after an update it will take notably longer than usual. This is
normal, the application service is updating the database layout. The log
files will contain multiple errors.
4) Stop
the Nixxis services “ContactRoute Application Server”.
Check
the process list and wait until the services have disappeared. Delete
the logs.
5)
Use
an FTP client, transfer the files from Windows “C:\NixxisMaintenance\Update\[CurrentAmericanFormatDate]\MediaServer”
to their respective folders on the media
server
6)
Care: If you have custom configurations on the files
under /etc/asterisk (example nixxis.conf) you need to adapt the file files
consequently. Same applies for files under /etc/asterisk/nixxis you will need
to adapt the files if they are custom configurations that have been made.
7)
Do
an Asterisk reload after copying all the files on the media
8) Restart
the Nixxis services “ContactRoute Application Server”.
9)
The
services should start at normal speed and the errors should no longer be
present in the log file.
Test the update
You can now operate tests of the different modules: agent, supervision, reporting etc.