| Table of Contents |
|---|
...
| 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:
Open the Administration GUI
Choose Backup (left side menu) and ensure that all backup options are ticked as shown in the screenshot above
- Choose Create new backup including components. The backup creation starts immediately in the background. It will appear in the list of available backups later.
Download and store the created backup on an external drive. To download click on the disk icon in the row of the created backup.
| 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 should be created before updating to generation 5. |
Upgrade Installation
Prerequisites
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:
- Open the Admin GUI > Configuration > System > Load Configuration
- 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. |
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:
- Open Admin GUI > Update
- 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.
Upgrade to SONARPLEX version 5.1.x
Install the new SONARPLEX 5.1.x:
- Open Admin GUI > Update
- Choose Manual Update and Browse to select the SONARPLEX version 45.21.0 1a 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.
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
...