Table of Contents
...
This guide is intended to help you through the migration process from SONARPLEX Version 4.1.x and 4.2.x to SONARPLEX release 5.1.x SONARPLEX Generation 5 is a major release, and contains essential changes of the software especially for the plugins. This requires from the user additional steps in the upgrade procedure.
...
| Note |
|---|
This guide assumes you want to upgrade from SONARPLEX release 4.1 to SONARPLEX release 5.1. .x. Substitute 5.1.x for your destination version. |
Known Issues for Upgrade
| Tip |
|---|
Make sure to download the latest plugin-update package form the azeti Portal as this is maintained and updated frequently and offers the latest bugfixes for the upgrade process. |
...
| Issue | Description | Solution |
|---|---|---|
| 1 | Plugin installation errors can appear in seldom circumstances | latest plugin-updates package (plugin-updates-003_v4.2.0b_to_v5.1.1ax.tar) |
| 2 | Monitor process is restarted repeatedly because of missing status.log | latest plugin-updates package (plugin-updates-003_v4.2.0b_to_v5.1.1ax.tar) |
| 3 | check_azetiplugin_akcptemperature, check_azetiplugin_akcphumidity and check_azetiplugin_akcpsmoke exit with error "... unexpectedly returned value 4" when remote host is not reachable | latest plugin-updates package (plugin-updates-003_v4.2.0b_to_v5.1.1ax.tar)
|
| 4 | SMS for contactgroup works only for first contact in list | will be fixed with SP 5.1.2 |
...
| Info |
|---|
Download the package at azeti Portal > Downloads > SONARPLEX Generation 5 > Upgrade from 4.2.x to 5.1.x > Upgrade_Package_v1.3_from_SONARPLEX_4.2.x_to_5.1.1x.zip Note that you still must download the image update file for your device (indentified by its SysId), see azeti Portal > My Appliances > <SONARPLEX SysId>. |
...
| Package | Filename | Description | Download |
|---|---|---|---|
SONARPLEX 4.2 patch level 7 | update-4.2.0b-base-7.tar | enables upgrade from SONARPLEX 4.2.0b to 5.1.x | azeti Portal > Downloads > SONARPLEX Generation 4 > Updates |
| SONARPLEX 5.1.1a x image | <SysID>-daaz1en-5.1.1ax.aup (e.g. 2m002421121f36-daaz1en-5.1.1a1b.aup) | Full Operating System image version 5.1.1ax | azeti Portal > My Appliances > <SONARPLEX SysId> |
| SONARPLEX 5.1.1a x plugin updates | plugin-updates-003_v4.2.0b_to_v5.1.1ax.tar | Package containing all necessary plugin updates for automatic installation | azeti Portal > Downloads > SONARPLEX Generation 5 > Updates |
| SONARMANAGER 2.7.3.24 | SonarManager_2.7.3.24.zip | SONARMANAGER compatible to SONARPLEX 5.x.x | azeti Portal > Downloads > SONARPLEX Generation 5 > SONARMANAGER |
...
Upgrade to SONARPLEX version 5.1.x
Install the new SONARPLEX 5.1.x:
> UpdateInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true - Choose Manual Update and Browse to select the SONARPLEX version 5.1.1a x image file (extension .aup) you downloaded previously
- Select the update icon
to start the update, the SONARPLEX will reboot which takes up to 10 minutes
...
After the SONARPLEX Upgrade
SONARPLEX 5 is a major release and thus some minor system configuration changes must be done right after the upgrade.
Updating the LOAD Configuration
The following step assures that the global LOAD Configuration is properly updated and is mandatory.
> Configuration > System > Load ConfigurationInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true - Choose
to save the current configuration and apply it with the following 
Configure the global Log Level
A whole new logging framework was introduced with the upgrade. See
> Configuration > System > Logging Configuration.Insert excerpt _AdminWeb _AdminWeb nopanel true
By default the Debug log level is set to OFF. We recommend turning it to INFO for all hardware types except the azeti NG.
| Note |
|---|
The azeti NG runs on SD flash storage and debug log levels can lead to decreased lifetime of the storage due to large amounts of write operations through logging. Therefore leave the Debug log level set to OFF. |
Flush the Retention File
To warrant a consistent status among the old and new plugins, delete the retention file.
Insert excerpt _AdminWebDeleteRetention _AdminWebDeleteRetention nopanel true
Flush the Mail Queue
It is possible that during the upgrade system messages are created and stored in the email queue. Those would be sent out whenever you enable the SMTP configuration and you can flush those if you don't want to receive such mails from the upgrade.
Flushing queued e-mails:
> System > Email QueueInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true - Choose
Delete all messages in queue and press OK
Re-Enable the Notifications
When all upgrade steps are done and the system behaves properly, it is save to enable the notifications again. Check that not too many service and host checks are in Non-OK states to avoid notification floods.
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Plugin Migration
| Info | ||||||||
|---|---|---|---|---|---|---|---|---|
Note that most of the plugins will show up Installation problems(s) (see screenshot above) in |
Follow one of the below described ways, automatic or manual, to update all plugins.
Installing the Plugin Update Package
As most of the plugins are not compatible between SONARPLEX 4.x.x and 5.x.x, these must be updated.
| Info |
|---|
We highly recommend to use the upgrade patch as it will upgrade the plugins automatically. You can find the plugin update, named plugin-updates-003_v4.2.0b_to_v5.1.1ax.tar in the azeti Portal > Downloads > SONARPLEX Generation 5 > Updates |
After the download you must install the plugin updates package:
> System > PatchInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true - Choose Browse to select the proper patch file and elect the apply icon to start the installation, the SONARPLEX will reboot which can take up to 10 minutes
| Tip |
|---|
| If you performed all necessary steps as noted in this guide you have successfully updated to SONARPLEX 5.1.1ax. |