Table of Contents
...
| 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.x image | <SysID>-daaz1en-5.1.x.aup (e.g. 2m002421121f36-daaz1en-5.1.1b.aup) | Full Operating System image version 5.1.x | azeti Portal > My Appliances > <SONARPLEX SysId> |
| SONARPLEX 5.1.x plugin updates | plugin-updates-003_v4.2.0b_to_v5.1.x.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 |
System Backup
| Anchor | ||||
|---|---|---|---|---|
|
| Note |
|---|
Please remember to do backup first, before installing an update in case of any problems that may occur. To do backup please follow instructions below. |
Please perform the following steps to create a backup using the Web Interface:
> System > BackupInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true Choose all listed components (addon_data, logfiles, monitoring, performance_data, system) for the inclusion and tick persistent backup (backup is excluded for the regular rotation)
- Choose Create new backup including components. The backup creation starts immediately in the background. The new backup file will appear in the list of available backups after the creation is finalized.
- Download the created backup by choosing
and store the created backup on an external drive
| Info |
|---|
SONARPLEX generation 5 contains new features which aren´t available in SONARPLEX generation 4. This means that the SONARPLEX generation 5 does not support generation 4 backups anymore. In order to perform a rollback, a backup must be created before updating to generation 5. |
Enable Large Installation Tweaks
Please enable Use large installation tweaks before the upgrade, this option deactivates automatic backups upon startup. This is highly recommended as otherwise the upgrade can take a long time and most installations can easily rely on SONARBACKUP or the regular auto backups.
To enable the large installation tweaks:
> Configuration > System > Load ConfigurationInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true - Activate Use large installation tweaks
| Info |
|---|
| You can activate this option whenever you are doing maintenance tasks and want to avoid the automatic start up backup. Of course you can activate it afterwards again. |
Disable Notifications
Notifications should be disabled globally during the upgrade process to avoid any unnecessary notifications or even possible alert floods.
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
| Info |
|---|
This disables the notifications persistently, so even reboots and Monitor process restarts will keep the notification system disabled. Check Re-Enable the Notifications after the upgrade. |
Upgrade Installation
Upgrade to SONARPLEX version 4.2.x
| Info |
|---|
You must download the SONARPLEX image(s) for the following upgrades form the azeti Portal specifically for your device(s), see the previous section Individual File Download for details. |
To upgrade to 4.2.x do the following:
> UpdateInsert excerpt _OpenAdminWeb _OpenAdminWeb nopanel true - Choose Manual Update and Browse to select the SONARPLEX version 4.2.0 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
Install necessary updates for 4.2.x
To allow the upgrade to SONARPLEX Generation 5 you must install a patch.
| Info |
|---|
Minimum patch level for the upgrade from SONARPLEX 4.2 is base 7, named update-4.2.0b-base-7.tar. |
Even if you decide to stay with SONARPLEX release 4.2 the patch fixes some major bugs and it is recommended to be installed.
...
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 | ||||||
|---|---|---|---|---|---|---|
|
...