Versions Compared

Old Version 44

changes.mady.by.user Sebastian Koch

Saved on

compared with

New Version Current

changes.mady.by.user Marcos Moreno

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: changed some versions

Table of Contents

...

Version
Date
Comment
Current Version (v. 35)Ago 44)Aug 29, 2014 11:22

Sebastian Koch:

Added note about new support of check_azetiplugin_email_loop for 5.1.2a

v. 42Aug 05, 2014 14:4045

Marcos Moreno:

removed references to specific version 5.1.1a and 5.1.1b and referring 5.1.x to avoid client confusion.

v.34Jul 10, 2014 16:09Sebastian Koch:
Added note about fixed check_azetiplugin_netapp3, Added end of life for check_azetiplugin_kyocera_toner. Added not about check_radius_adv fix. Added Known Issues Table
v. 32Jul 09, 2014 10:25Sebastian Koch: 
Enhanced backup creation instructions
v. 29Jul 08, 2014 18:15Sebastian Koch: 
Added extra steps to disable notifications, flushing the mail queue and fixed minor typos
v. 25Jul 08, 2014 12:11Sebastian Koch: 
Extended list of incompatible plugins and known issues for EOL packages
v. 21Jul 01, 2014 15:31Sebastian Koch: 
Added Known Issues for Upgrade section regarding plugin update package
v. 18Jun 26, 2014 16:01Sebastian Koch: 
Fixed minor typos in portal paths, Added section about Plugin Download for azeti NG

...

IssueDescriptionSolution
1Plugin installation errors can appear in seldom circumstanceslatest plugin-updates package (plugin-updates-003xxx_v4.2.0b_to_v5.1.x.tar)
2Monitor process is restarted repeatedly because of missing status.loglatest plugin-updates package (plugin-updates-003xxx_v4.2.0b_to_v5.1.x.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-003xxx_v4.2.0b_to_v5.1.x.tar)

 

4SMS for contactgroup works only for first contact in listwill be fixed with SP 5.1.2
5Message in watchdog "watchdog failed to reanimate smsd" when no modem attachedsolved in patch 3 for 5.1.2 (e.g. update-5.1.22a-std-xxx)

Plugin and Extension Upgrade

...

Plugin NameDescriptionStatus
check_azetiplugin_email_loop.azspPlugin for checking the whole e-mail delivery loop

incompatible

Fixed with SONARPLEX v5.1.2a, plugin-updates-001_v4.2.0b_to_v5.1.2a (September 2014)

HTTP-XML-Interface.azse

HTTP POST XML Interface for integration of external data and systems Accepts HTTP POST Requests and receives a XML file and parameters.
It will then try to match the content of the XML file to the mandatory sonarplex variables like service name, hostname, freshness and plugin output.

Several variables can be conducted out of mutliple xml fields, e.g. the service name.

incompatible
check_radiusBuilt in radius checkexecution problem, please use check_radius_adv.azsp instead, see Compatible Plugins and Extensions

check_azetiplugin_netapp3

SNMP based check for NetAPP storage systems

Installation issues in 5.1.1a, will be fixed shortly 

Fixed with plugin-updates-003_v42.0b_to_v5.1.1b

check_modbus_drycontact

check_modbus_drycontact2

Standalone plugin to read dry contacts via MODBUSEnd of life. Replaced by check_modbus_fast_drycontact3 and the required modbus_fastd Daemon. Requires manual upgrade work, please contact support@azeti.net for further information.

check_modbus_poll

check_modbus_read

check_modbus_read2

Standalone plugin for reading values via MODBUSEnd of life. Replaced by check_modbus_fast_read3 and the required modbus_fastd Daemon. Requires manual upgrade work, please contact support@azeti.net for further information.
check_modbus_accessMODBUS based access control pluginEnd of life. Replaced by check_modbus_access_m2m-wtsc and the required modbus_fastd Daemon. Requires manual upgrade work, please contact support@azeti.net for further information.
check-modbus-device-aliveHost check plugin based on MODBUSEnd of life.

check_modbus_write

check_modbus_write2

Plugins for writing registers via MODBUSEnd of life. Replaced by check_modbus_fast_write4 or the MODBUS action and the required modbus_fastd Daemon. Requires manual upgrade work, please contact support@azeti.net for further information.
check_azetiplugin_kyocera_tonerChecks toner resource via SNMPEnd of life. Unsupported for SONARPLEX 5. Monitoring toner should be configured via SNMP Traps from the printer to the SONARPLEX.

...

Info

Download the package at azeti Portal > Downloads > SONARPLEX Generation 5 > Upgrade from 4.2.x to 5.1.x > Upgrade_Package_v1.3vxxx_from_SONARPLEX_4.2.x_to_5.1.x.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>.

...

PackageFilenameDescriptionDownload

SONARPLEX 4.2 patch level 7

update-4.2.0b-base-7.tarenables upgrade from SONARPLEX 4.2.0b to 5.1.xazeti 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.xazeti Portal > My Appliances > <SONARPLEX SysId>
SONARPLEX 5.1.x plugin updates

plugin-updates-003xxx_v4.2.0b_to_v5.1.x.tar

Package containing all necessary plugin updates for automatic installationazeti Portal > Downloads > SONARPLEX Generation 5 > Updates
SONARMANAGER 2.7.3.24SonarManager_2.7.3.24.zipSONARMANAGER compatible to SONARPLEX 5.x.xazeti Portal > Downloads > SONARPLEX Generation 5 > SONARMANAGER

System Backup

Anchor
system-backup
system-backup

 

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:

  1. Insert excerpt
    _OpenAdminWeb
    _OpenAdminWeb
    nopaneltrue
     > System > Backup

  2. 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)

  3. 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.
  4. 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:

  1. Insert excerpt
    _OpenAdminWeb
    _OpenAdminWeb
    nopaneltrue
     > Configuration > System > Load Configuration
  2. 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
_UserWebDisableNotificationsGlobally
_UserWebDisableNotificationsGlobally
nopaneltrue

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:

  1. Insert excerpt
    _OpenAdminWeb
    _OpenAdminWeb
    nopaneltrue
     > Update
  2. Choose Manual Update and Browse to select the SONARPLEX version 4.2.0 image file (extension .aup) you downloaded previously
  3. 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.

  1. Insert excerpt
    _OpenAdminWeb
    _OpenAdminWeb
    nopaneltrue
     > Configuration > System > Load Configuration
  2. 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

Insert excerpt
_AdminWeb
_AdminWeb
nopaneltrue
 > 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. 

Insert excerpt
_AdminWebDeleteRetention
_AdminWebDeleteRetention
nopaneltrue

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:

  1. Insert excerpt
    _OpenAdminWeb
    _OpenAdminWeb
    nopaneltrue
     > System > Email Queue
  2. 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
_UserWebEnableNotificationsGlobally
_UserWebEnableNotificationsGlobally
nopaneltrue

 

...