This document describes best procedures for upgrading to Presence 3.5.5 from an earlier version.
Presence 3.5.5 uses the Sun 1.6 JRE, where as previous versions used the 1.5 JRE. For this reason some extra care should be taken to ensure compatibility with JDBC drivers, etc.
1. Suspend Presence Tasks
Ensure that all Presence tasks on the live task queue are suspended. We do not want them to automatically resume when the server restarts.
Launch Task Manager and check that channelman.exe is not running - if it is, right click on the process and choose "End process tree".
2. Disable Presence
Stop the Presence Server, Database Server and HTTP Server (if running) via the Heartbeat Client. When these services have stopped, use the Windows Services controller to stop the Presence RPC Server service and the Presence Viii Heartbeat Server service:
3. Database Backup
Prior to any upgrade, a backup of the database should be taken. To do this, copy any files in the directory "res\database" ending in .wal or .dbn to a separate drive. Note that this can only be done if the database service is stopped (see above).
4. Run Installer
For instructions, refer to the Installation Guide.
When the installer is complete, you should be prompted to start the Presence components. Ignore this and exit the installer. Use the Windows Services manager to restart the Presence RPC Server and the Presence Viii Heartbeat Server services. This will cause the Database server, Presence server and HTTP Server (if used) to resume.
Once the various services have had time to start, you should be in a position where Presence is running but no Tasks run from the Live Task Queue:
5. Start Admin Client
At this point it is safe to start the Presence Admin Client via Start > Programs > Presence Viii > Administration > Presence Admin Console.
6. Test JDBC Drivers
Work through your Database Resources (see image below). Open each one and click the "Test" button.
If the test fails, this is likely to be due to a conflict of versions between the JRE and the JDBC driver. Consult the provider of the JDBC driver to obtain one that is compatible with the 1.6 JRE.
7. Resume Queued Processes
Once all of your database connections are verified, go ahead and resume the Queued Tasks that were suspended earlier. You can do this one by one or all at once by selecting multiple Tasks, depending on which makes you more comfortable.
If Tasks have one or more Schedule Nodes attached to them and "Catch up" is enabled they will run now if they were due to run while the Server was disabled. Otherwise they will be queued to run at the next run time. If no Schedule Node is attached the Task will run within 30-60 seconds.
Congratulations - the upgrade process is now complete.