Chat now with support
Chat with Support

Foglight 5.9.5 - 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

Scenario 3 — Agent Manager client-side feature dependency or defect fix

A new release of the Agent Manager typically delivers new features and defect fixes. For information about new features and defect fixes, see the Foglight Agent Manager Release Notes. Customers who want to take advantage of a new feature or defect fix may consider a move to the latest Agent Manager client.

The 5.9.x Agent Manager Adapter is updated as part of the Management Server 5.9.x upgrade, and the new adapter is backward compatible with all earlier versions of the Agent Manager.

Generally, there is no need to upgrade the client side of the Agent Manager. An Agent Manager client-side upgrade is required only in the following situations:

•
You require one or more of the new 5.9.x Agent Manager features or defect fixes in your environment. See the Foglight Agent Manager Release Notes for details.
•
You are planning to install a cartridge that requires version 5.9.x of the Agent Manager.

You do not need to upgrade all Agent Manager clients to the latest version. You only need to upgrade the ones that meet one or more of the conditions specified above.

Dependency and compatibility matrices

This section provides information on upgrade version compatibility.

The following table presents the upgrade matrix for the key components of Foglight 5.9.x.

 
Table 1. Upgrade matrix for key Foglight components
Item
Version Supported in Foglight 5.9.x
Version Recommended for New Management Server 5.9.x Installations
Version Recommended for Management Server 5.9.x Upgrades
Agent Manager client

5.6.2 and later

5.9.x

5.9.x

Foglight for Infrastructure

5.6.3 and later

5.9.x

5.9.x

The matrix below lists the new components and cartridges and their main features and indicates whether or not upgrade to a component for a particular feature requires the upgrade of one or more core components.

 
* 
NOTE: The core components are the Management Server, client-side Agent Managers, and agents on the monitored host.
 
Table 2. Upgrade matrix for Foglight components and cartridges
Component
Feature
Requires Management Server Upgrade?1
Requires Agent Manager Client-side Upgrade
(on the Monitored Host)?
Requires Agent Deployment After Upgrade

Agent Manager 5.9.x

All features and fixes

No

No

No

End User Core Cartridge 5.6.7

Defect fixes

No

No

No

Foglight for Active Directory 5.7.2.3

All features and fixes

No

No

No

Foglight for Apache 5.8.0.3

Defect fixes

No

No

Yes

Foglight APM for Real User Experience 5.9.11.1

Defect fixes

Yes

No

No

Foglight for Application Operations 5.9.8.5

Defect fixes

No

No

No

Foglight Automation 5.6.3.8

Defect fixes

No

No

No

Foglight Change Analyzer 5.8.0

Defect fixes

No

No

No

Foglight Chargeback 5.7.7

Defect fixes

No

No

No

Foglight for Citrix XenDesktop and XenApp 5.8.0

Defect fixes

Yes

Yes

Yes

Foglight for DB2 LUW 5.9.4.10

All features and fixes

No

No

No

Foglight for Exchange 5.7.2.3

All features and fixes

No

No

No

Cartridge for FxM 5.6.5

Defect fixes

No

No

No

Cartridge for FxV 5.6.5

Defect fixes

No

No

No

Foglight for Hyper-V 5.8.0

All features and fixes

No

No

Yes

Foglight for IBM WebSphere MQ Server 5.5.5.13

Defect fixes

No

No

No

Foglight for Infrastructure 5.9.x

NOTE: Includes Foglight for PowerVM 5.9.x

All features and fixes

Yes

No

No

Foglight for Integration 5.9.4

Defect fixes

No

No

No

Foglight Integration for OpenManage Essentials 5.7.0

Defect fixes

No

No

Yes

Foglight for Java EE Technologies 5.9.13

All features and fixes

No

No

Yes

Foglight for JMX 5.9.8

Defect fixes

No

No

Yes

Foglight for Microsoft .NET 5.9.13

All features and fixes

No

No

Yes

Foglight Net Monitor 5.9.4

Defect fixes

No

No

Yes

Foglight for NMS Integration 5.6.4.6

Defect fixes

No

No

Yes

Foglight for OpenStack 5.7.4

Defect fixes

No

No

No

Foglight for Oracle 5.9.4.10

All features and fixes

No

No

No

Foglight Resource Optimizer 5.8.0

All features and fixes

No

No

No

Foglight for SNMP 5.9.5

Defect fixes

No

No

No

Foglight for SQL Server 5.9.4.10

All features and fixes

No

No

No

Foglight for Storage Management 4.7.0

All features and fixes

Yes

Yes

Yes

Foglight for Sybase 5.9.3.10

Defect fixes

No

No

No

Foglight for vCloud Director 5.7.4.1

Defect fixes

No

No

No

Foglight for VMware 5.8.0

Defect fixes

No

No

Yes

Foglight for VMware Horizon View 5.8.0

All features and fixes

Yes

Yes

Yes

Foglight Web Monitor 5.9.3

Defect fixes

No

No

Yes

1

If it is indicated that a Management Server upgrade is not required, please ensure that your current Management Server version is compatible. The matrix above only covers potential upgrades from the previous version of Foglight.


The matrix below outlines the compatibility of the latest cartridges and core components with earlier versions of the Management Server and with the current Management Server. This matrix will assist you in determining whether you need to upgrade your Management Server, if you are presently running an older version.

 
Table 3. Compatibility matrix of cartridges and core components
Management Server version per component
5.6.10
5.6.11/5.7.1
5.7.6
5.7.6.1
5.7.6.2
5.7.6.3
5.7.6.4
5.7.6.5/5.7.6.6/5.7.6.7
5.7.5.8
5.9.x

Agent Manager 5.9.x

N

N

N

N

N

N

N

Y

Y

Y

End User Core Cartridge 5.6.7

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Active Directory 5.7.2.3

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Apache 5.8.0.3

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight APM for Real User Experience 5.9.11.1

N

N

N

N

N

Y

Y

Y

Y

Y

Foglight for Application Operations 5.9.8.5

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Automation 5.6.3.8

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Capacity Management 5.7.7

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Change Analyzer 5.8.0

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Chargeback 5.7.7

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Citrix XenDesktop and XenApp 5.8.0

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for DB2 LUW 5.9.4.10

N

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Exchange 5.7.2.3

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for FTR 5.6.13*

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Cartridge for FxM 5.6.5

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Cartridge for FxV 5.6.5

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Hyper-V 5.8.0

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for IBM WebSphere MQ Server 5.5.5.13

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Infrastructure 5.9.x

N

N

N

N

N

N

N

Y

Y

Y

Foglight for Integration 5.9.4

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Integration for OpenManage Essentials 5.7.0

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Java EE Technologies 5.9.13

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for JMX 5.9.8

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Microsoft .NET 5.9.13

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Net Monitor 5.9.4

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for NMS Integration 5.6.4.6

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for OpenStack 5.7.4

N

N

N

N

N

N

Y

Y

Y

Y

Foglight for Oracle 5.9.4.10

N

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for PowerVM 5.9.x

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Resource Optimizer 5.8.0

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for SNMP 5.9.5

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for SQL Server 5.9.4.10

N

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for Storage Management 4.7.0

N

N

N

Y

Y

Y

Y

Y

Y

Y

Foglight for Sybase 5.9.3.10

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for vCloud Director 5.7.4.1

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight for VMware 5.8.0

N

N

N

N

Y

Y

Y

Y

Y

Y

Foglight for VMware Horizon View 5.8.0

N

N

Y

Y

Y

Y

Y

Y

Y

Y

Foglight Web Monitor 5.9.3

Y

Y

Y

Y

Y

Y

Y

Y

Y

Y

*Starting from ACE.2, Foglight for FTR is not supported.

Prepare for an upgrade

Preparing for a Foglight upgrade is straightforward, but may be time-consuming. Before upgrading you should:

1
Create a support bundle from your Management Server. For information on how to do this, see the “Managing Support Bundles” section in Foglight Administration and Configuration Guide.
2
If you are upgrading the Management Server, back up the file system in which Foglight is installed. For information on how to do this, see the “Backing up Foglight” section in the Foglight Administration and Configuration Help.
3
If you are upgrading the Management Server, back up your database. For information on how to do this, see the “Backing up Foglight” section in the Foglight Administration and Configuration Help.

Upgrade order

 
* 
IMPORTANT: Consult the sections above to decide which components, if any, you will be upgrading.

Foglight components should be upgraded in the following order:

1
Some cartridges must be upgraded prior to upgrading the Management Server. For more information, see Components compatibility.
2
Management Server, if necessary
3
Cartridges, if necessary
4
Agent Manager, if necessary
5
New agents, if necessary

Step 2 may require some time, because agents may need time to reconnect.

In some cases, a successful step 2 may require one or more cartridge upgrades. Where special instructions are required, they are documented in this guide.

Only perform steps 4 and 5 after the system has stabilized.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating