| Table of Contents |
|---|
...
Known Issues for Upgrade
| Warning | |||||
|---|---|---|---|---|---|
| |||||
There was is the possiblity possibility, in seldom circumstances, that plugin installation errors appear in combination with the intiial plugin update package plugin-updates-001_v4.2.0b_to_v5.1.1a.tar. This was released in the time of 25th june 2014 until 1st july 2014.
|
Status Update
The system configuration, performance data and event-log will be upgraded to the new version. Due to the major software change the status file will not take over to the new version. This means it will take a while until the status will be updated.
...
| 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 image | <SysID>-daaz1en-5.1.1a.aup (e.g. 2m002421121f36-daaz1en-5.1.1a.aup) | Full Operating System image version 5.1.1a | azeti Portal > My Appliances > <SONARPLEX SysId> |
| SONARPLEX 5.1.1a plugin updates |
plugin-updates-002_v4.2.0b_to_v5.1.1a.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 |
...
After the SONARPLEX Upgrade
SONARPLEX 5 is a major release and thus some minor system configuration changes must be done right after the upgrade.
Configure the global Log Level
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.
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-001002_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
| Tip |
|---|
| If you performed all necessary steps as noted in this guide you have successfully updated to SONARPLEX 5.1.1a. |