Foglight 5.9.3 - Upgrade Guide

Understand product versions

This guide provides instructions on how to upgrade to the latest version of the Foglight® Management Server and the Foglight Agent Manager. This guide also provides upgrade instructions for the cartridges and cartridge-related components that are included with Foglight 5.9.x. The latest version of the Foglight Management Server is 5.9.3.

This section provides information about important changes made in this release, product versions, and components compatibility:

•

Components compatibility

•

Compatible cartridges list

Components compatibility

The Foglight 5.9.x code line includes a number of critical changes which require particular attention for customers upgrading from a 5.7.x version. Specifically, three primary functional capabilities (server side data handling, Federation, High Availability) that used legacy JBoss components in versions prior to 5.9.x have been re-written to improve Foglight Management Server security. This has the following specific impacts on customers upgrading from a 5.7.x version.

•

Foglight Management Servers must be upgraded to version 5.7.5.8 before they can upgrade to the 5.9.x code line. If the Foglight Management Server is below 5.7.5.8, the installer will fail and display the appropriate error message.

•

All Quest or Quest partner delivered cartridges that have a dependency on the changed components in the data submission handler must be upgraded prior to upgrading to the 5.9.x code line. A complete list of cartridges is provided in Compatible cartridges list. If there are incompatible Quest or Quest partner delivered cartridges, the installer will fail and display the appropriate error message.

•

Other custom cartridges MAY have a dependency on the server side data handling component that has changed. A pre-upgrade analysis tool has been developed to identify any custom cartridges that might need changed.

•

Before upgrading to 5.9.x, Quest recommends you create a Management Server Support Bundle to facilitate future communications with support regarding upgrade failures.

•

There are new configuration requirements for customer running High Availability (HA) or Federation. For more information, see Upgrade the cartridges in a federated or High Availability (HA) environment, Federation Field Guide, and High Availability Field Guide.

Compatible cartridges list

If the following cartridges are installed on your Management Server, you will need to upgrade them to a version compatible with Management Server 5.9.x before upgrading the Management Server.


	NOTE: Foglight for SQL Azure does not have a version compatible Foglight 5.9.x. If you must move to 5.9.x now, contact support for the latest information on when compatible cartridges are expected.

•

Foglight for VMware: must be upgraded to 5.7.3

•

Foglight for DB2 LUW: must be upgraded to 5.7.5.41

•

Foglight for SQL Server: must be upgraded to 5.7.5.41

•

Foglight for Sybase: must be upgraded to 5.7.5.40

•

Foglight for Oracle: must be upgraded to 5.7.5.41

•

Foglight for Application Operations: must be upgraded to 5.9.8.5

•

Foglight for Microsoft .NET: must be upgraded to 5.9.12

•

Foglight for Java EE Technologies: must be upgraded to 5.9.12

•

Foglight ActionPacks: must be upgraded to 5.6.3.5

•

Foglight for Automation: must be upgraded to 5.6.3.5

•

Foglight APM for End User Experience: must be upgraded to 5.9.11.1

•

Foglight for Transaction Recorder and Player: must be upgraded to 5.6.13

•

Cartridge Builder: must be upgraded to 5.6.6

•

MySQLAgent: must be upgraded to 5.7.5.90

•

PostgreSQLAgent: must be upgraded to 5.7.5.90

•

MongoDBAgent: must be upgraded to 5.7.5.140

•

CassandraAgent: must be upgraded to 5.7.5.50

•

TIBCOAgent: must be upgraded to 5.7.5.16

The following software has been updated for the Foglight 5.9.3 release:

•

Foglight Agent Manager, version 5.9.3

•

Foglight for Infrastructure, version 5.9.3

•

Foglight for Integration, version 5.9.3

•

Foglight for Application Operations, version 5.9.8.5

•

Foglight for JMX, version 5.9.8

•

Foglight for Java EE Technologies, version 5.9.13

•

Foglight for Microsoft .NET, version 5.9.13

•

Foglight for Active Directory, version 5.7.2.1

•

Foglight for SNMP, version 5.9.2

•

Foglight for DB2 LUW: version 5.7.5.50

•

Foglight for SQL Server: version 5.7.5.50

•

Foglight for Sybase: version 5.7.5.50

•

Foglight for Oracle: version 5.7.5.50

•

Foglight Capacity Director, version 5.7.6

•

Foglight Capacity Manager, version 5.7.6

•

Foglight Change Analyzer, version 5.7.6

•

Foglight Chargeback, version 5.7.6

•

Foglight for Citrix XenDesktop and XenApp, version 5.7.6

•

Foglight for Container Management, version 0.9 (new product)

•

Foglight for Hyper-V, version 5.7.6

•

Foglight for NetVault, version 1.0 (new product)

•

Foglight for Storage Management, version 4.6

•

Foglight for VMware, version 5.7.6

•

Foglight for VMware Horizon View, version 5.7.6

•

Foglight Net Monitor, version 5.9.3

•

Foglight Web Monitor, version 5.9.3

•

Foglight Hybrid Cloud Manager, version 1.3

•

Quest Protect Dashboard, version 1.4

•

Foglight for Automation, version 5.6.3.7

•

Foglight ActionPacks, version 5.6.3.7

•

Foglight APM for End User Experience: version 5.9.11.1

•

Foglight for Transaction Recorder and Player: version 5.6.13

•

Cartridge Builder: version 5.6.6

•

MySQLAgent: version 5.7.5.90

•

PostgreSQLAgent: version 5.7.5.90

•

MongoDBAgent: version 5.7.5.151

•

CassandraAgent: version 5.7.5.50

•

TIBCOAgent: version 5.7.5.16

For a complete list of fixes for any of these components, please refer to the release notes that accompany them. If you decide to maintain the version you have of any of the updated components, as opposed to upgrading, you will not acquire the new fixes for that component.

For more details, see these topics:

•

Foglight cartridge upgrade issues

•

Foglight appliance upgrade issues

Foglight cartridge upgrade issues


	NOTE: Any versions earlier than those listed in the Components compatibility list may not be compatible with Foglight 5.9.x. It is recommended that you only use the listed versions.

The following cartridges are not compatible with the Foglight 5.9.x release:

•

Cartridge for DB2 LUW, version 5.5.8.1

•

Cartridge for Integration, version 5.5.8

•

Cartridge for Java EE Technologies, version 5.8.x and earlier

•

Cartridge for JMX, version 5.8.x and earlier

•

Cartridge for WebService Integration, version 1.0.8

•

Foglight APM for Real User Experience cartridge

•

Foglight for Transaction Recorder and Player

•

Foglight APM for End User Experience

•

Foglight for SQL Azure

•

Foglight for Guest Process Investigation, version 5.6.7


	NOTE: Foglight for Guest Process Investigation is no longer available with this Foglight release. A new multi-host process monitoring agent is provided as part of the Foglight for Infrastructure cartridge.

For any Foglight cartridge, follow the instructions in this guide to upgrade the cartridge to the latest version. If any additional information is required to upgrade a particular cartridge, the instructions in this guide will direct you to the release notes for that cartridge for the information.