Versions Compared

Old Version 30

changes.mady.by.user Sebastian Koch

Saved on

compared with

New Version 31

changes.mady.by.user Sebastian Koch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Change History

 

Version
Date
Comment
Current Version (v.
22)Jul 01, 2014 15:45
30)Jul 08, 2014 18:29Sebastian Koch:
Small structure update for checking plugin compatability
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:

Added
 
Extended list of incompatible plugins and known issues for
plugins, see Known Issues and incompatibilities
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

Introduction

This guide is intended to help you through the migration process from SONARPLEX Version 4.1.x and 4.2.x to SONARPLEX release 5.1. SONARPLEX Generation 5 is a major release, and contains essential changes of the software especially for the plugins. This requires from the user additional steps in the upgrade procedure. 

...

 

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. Open Admin GUI > 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 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:

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

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. Open the Admin GUI > 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.

Enable notifications globally:

  1. Open the Web GUI > Status > Processes
  2. Choose  Enable notifications and press Commit in the next screen

 

...