Table of Contents

Open Admin GUI > Summary
Check the proper version string in Your appliance is running which must show a 5.1.x version

Info
SONARPLEX 5 comes with a green web interface color scheme. Due to the caching of your Web Browser it might be necessary to manual reload of the SONARPLEX Web page to see the new scheme.

...

Image Added

After the SONARPLEX Upgrade

SONARPLEX 5 is a major release and thus some minor system configuration changes must be done right after the upgrade.

A whole new logging framework was introduced with the upgrade. See Admin GUI > Configuration > System > Logging Configuration.

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.

Info
Deleting the retention file leads to a flush of all status information, this will set every host and service object into state PENDING. This is expected and the objects will be checked during the normal check intervals and return into a non-PENDING state.

Deleting the retention file:

Open Admin GUI > Status > Monitor
Choose Delete state retention file (read online help before using), the Monitor process will be restarted automatically

Plugin Migration

Info
Note that most of the plugins will show up Installation problems(s) (see screenshot above) in Admin GUI > My Plugins, this is normal as you now must upgrade the plugins for compatibility.

Follow one of the below described ways, automatic or manual, to update all plugins.

As most of the plugins are not compatible between SONARPLEX 4.x.x and 5.x.x, these must be updated.

TODO: name here)

Info
We highly recommend to use the upgrade patch

(

as it will upgrade the plugins automatically.

Info
You can find the plugin update, named plugin-updates-001_v4.2.0b_to_v5.1.1a.tar in the azeti Portal > Downloads > SONARPLEX Generation 5 > Updates

After the download you must install the plugin updates package:

Choose Admin GUI > System > Patch
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

Info
When this is done you have successfully updated to SONARPLEX 5.1.1a.