Chat now with support
Chat with Support

Foglight 6.0.0 - Upgrade Guide

Understand product versions Best practices Upgrade the Foglight Management Server Upgrade the Foglight Agent Manager Upgrade the Database 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

Upgrade a Management Server in a federated environment

Upgrade a Management Server in a federated environment

The procedure for upgrading a Federation Master and Federated Child(ren) is the same as described in Upgrade the Management Server. There are a few items in particular that should be noted when working in a Federated environment.

 
* 
NOTE: Foglight for Automation is not supported when Foglight is configured to use the Federation Master or High Availability features. This limitation will be addressed in a future release. For more information, see the Foglight Release Notes.

Federation compatibility

A version 5.9.x Federation Master requires that all Federated Children be upgraded to version 5.9.x as well.

Upgrade sequence

To upgrade your Federation servers to 6.0.0, follow the appropriate procedure below.

 
* 
IMPORTANT: You must upgrade your Federation Master before the Federated Children. Otherwise, the Federation Master may fail to start after an upgrade.

 

* 
NOTE: Configuration of SecurityToken through the federation.config file (adopted in Foglight 5.7.5.8 and before) was removed in Foglight 5.9.x. Therefore, configuring an SSL for Federation is required when you upgrade the Federation environment to version 6.0.0, if your Federation environment configures SecurityToken before.
When upgrading the Management Server:
1
Shut down and upgrade the Federation Master.
2
Shut down and upgrade each Federated Child, one by one.
3
Restart the Federation Master.
4
(Optional) If you have enabled SecurityToken in the configuration file ($fmshome/config/federation.config), you must configure an SSL for communication on Federation Master and Children. For more information, see the Security settings section in the Foglight Federation Field Guide.
5
Restart the each Federated Child, one by one.

Upgrade the Management Server in a High Availability (HA) environment

The procedure for upgrading the servers in an HA environment is the same as described in Upgrade the Management Server. There are a few items in particular that should be noted when working in an HA environment. These are:

1
All HA members should be stopped before any of them is upgraded. Each HA member should then be upgraded individually and sequentially.
2
If you are going to upgrade the Management Server to 6.0.0 from version 5.7.5.8 and have enabled TCP in the configuration file ($fmshome/server/jboss/deploy/cluster-service.xml), after the upgrade, the $fmshome/config/jgroups-config.xml file will enable TCP and only merge the previous initial_host of TCPPING. If you change other TCP configurations before, manually merge your configuration. For more information about this configuration, refer to the To tune the Management Server procedure in the Foglight High Availability Field Guide.
* 
NOTE: After the upgrade, the Management Server backs up the previous $fmshome/server/jboss/deploy/cluster-service.xml file to $fmshome/state/backup/<fms_previous_version>/server/jboss/deploy/cluster-service.xml.
3
All HA-related communications have been encrypted after upgrading your server to 6.0.0. For more information about the HA encryption, refer to the Security considerations for HA configuration section in the Foglight High Availability Field Guide.
4
Foglight for Automation is not supported when Foglight is configured to use the Federation Master or High Availability features.This limitation will be addressed in a future release. For more information, see the Foglight Release Notes.
 
* 
NOTE: If you are upgrading cartridges in an HA environment, see Upgrade cartridges in a High Availability environment.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating