Chat now with support
Chat with Support

Foglight 5.9.3 - Upgrade Guide

Understand product versions Best practices Upgrade the Foglight Management Server Upgrade the Foglight Agent Manager Upgrade the Application Monitoring cartridges Upgrade the Database cartridges Upgrade the End User Management cartridges Upgrading the Infrastructure Management cartridges Upgrade the Integration cartridges Upgrade the cartridges in a federated or High Availability (HA) environment Appendix: Deploying an agent package using the browser interface

Database changes

This section provides a list of the database changes from Foglight 5.6.2 through Foglight 5.9.x.

For new Management Server 5.7.6 (and later) installations, the embedded MySQL® database was replaced with an embedded PostgreSQL® database. Upgrades to Foglight Management Servers 5.7.6 with an existing embedded MySQL database are not affected. The existing database is retained during the upgrade.

An upgrade from version 5.6.5 of the Management Server to version 5.6.7 changes the database in the following ways:

 
Database Object Affected
Change
Database

Sequence SEQ_O*

Altered cache size to 10000

Oracle®

An upgrade from version 5.6.4 of the Management Server to version 5.6.5 changes the database in the following ways:

 
Tables Affected
Change
Database

PcmEncodedData

Table added

All

An upgrade from version 5.6.2 of the Management Server to version 5.6.3 changes the database in the following ways:

 
Tables Affected
Change
Database

database_instance_id

Table added

All

 

Upgrade the Foglight Agent Manager

This section describes the procedure for upgrading the Foglight Agent Manager (FglAM). The latest version of the Agent Manager is 5.9.3.

Remote updates of the Agent Manager are deployed from the Management Server. Local access to Agent Manager clients is typically not required to perform an upgrade.

 
* 
IMPORTANT: You cannot use the Agent Manager installer to upgrade. You must upgrade the Agent Manager through the Foglight Cartridge Inventory dashboard.

For more details, see these topics:

•
Upgrade the Agent Manager
•
Upgrade concentrators
•
Upgrade installations with multiple state instances
•
Upgrade a 32-bit FglAM installation on a 64-bit operating system
•
Agent Manager upgrade issues

Upgrade the Agent Manager

 
* 
NOTE: Agent Manager 5.9.3 requires the latest OS Patch level for AIX®. In order to support the AIX platform, the latest OS Service Packs must be applied prior to installing or upgrading the Agent Manager to 5.9.3.
To upgrade the Agent Manager to the latest version:
1
Navigate to Dashboards > Administration > Cartridges > Cartridge Inventory.
2
On the Installed Cartridges tab of the Cartridge Inventory dashboard, click Install Cartridge.
3
In the Install Cartridge dialog box, click Browse to locate the .car file you require to upgrade the Agent Manager.
 
* 
NOTE: On all platforms, the Agent Manager 5.8.1 and later includes an updated version of the Java® Runtime Environment (JRE). Therefore, you cannot use the Agent Manager patch cartridge (FglAM-patch-<version>.car) to upgrade from a pre-5.8.1 version to 5.8.1 or later. For that upgrade, you must use either FglAM-all-<version>.car, or one or more of the platform-specific FglAM-<platform>-<version>.car files.
4
Ensure that the Enable on Install box is selected.
 
* 
IMPORTANT: If the Enable on Install box is not selected, you must manually enable many different cartridges that are contained in the upgrade .car file you are deploying.
5
Click Install Cartridge to install the latest version of the Agent Manager upgrade .car file on the Management Server. Do not delete any of the old .car files.
A progress message appears and, after a few moments, the Operation(s) Complete message box appears, indicating success.
6
Click OK to close the message box.
7
On the navigation panel, click Dashboards > Administration > Agents > Agent Managers.
The Agent Managers dashboard lists connected Agent Managers.
8
Select one or more Agent Managers that you want to upgrade. If you are selecting more than one Agent Manager, they must have the same operating system name.
9
Click Upgrade.
The Deploy Agent Package dialog box opens.
10
From the Package list, select the version to which you want to upgrade, and then click Deploy.
It may take some time for the upgrade process to complete. The more Agent Managers you upgrade, the longer it takes. Once the upgrade is complete, the Agent Manager restarts.
After the “Agent deployment was successful.” message and a green checkmark appear in the Deploying Agent Package box (that is, after the Agent Managers have restarted), you must wait a few additional minutes for the version number of the affected Agent Manager to be updated.
11
On the Agent Managers page, click Refresh.
The version number for the Agent Manager you have modified is updated to the new number, for example 5.9.3.

Upgrade concentrators

When the Agent Manager is deployed using concentrators, all of the concentrators need to be upgraded before the downstream clients are upgraded. Otherwise, when a downstream client is restarted, it sends its upstream concentrator messages in an unknown format, making communication between the two impossible.

Consequently, the Upgrade button on the Agent Hosts dashboard is disabled for downstream clients until all of the upstream concentrators have been upgraded to the latest version.

See the Foglight Agent Manager Installation Guide for more information about running Agent Managers as concentrators.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating