Chat now with support
Chat with Support

Foglight 5.9.1 - 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 Upgrade the Infrastructure Management cartridges Upgrade the Integration cartridges Upgrade the cartridges in a federated or High Availability (HA) environment Appendix: Deploy an agent package using the browser interface

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.

Where to find upgrade information

For information on how to upgrade the Management Server, see Upgrade the Foglight Management Server.

For information on how to upgrade the Agent Manager, see Upgrade the Foglight Agent Manager.

For information on how to upgrade Foglight cartridges, see:

•
Upgrade the Application Monitoring cartridges
•
Upgrade the Database cartridges
•
Upgrade the End User Management cartridges
•
Upgrade the Infrastructure Management cartridges
•
Upgrade the Integration cartridges
•
Upgrade the cartridges in a federated or High Availability (HA) environment

Update the Java Runtime Environment

Both the Management Server and the Agent Manager require a Java® Runtime Environment. Quest Software Inc. tests and bundles each Foglight release with versions of the JRE that are compatible with the Management Server and the Agent Manager. Quest audits the security bulletins from Oracle® that are related to those versions of the JRE. If Quest determines that any of the bulletins are applicable to the Management Server or Agent Manager code, Quest releases a security update with the necessary fixes incorporated.

Quest recommends that you use the JRE versions bundled with the Foglight release, because Quest cannot guarantee that other versions of the JRE will perform correctly. However, Quest recognizes that you may have particularly stringent security requirements that require you to use a different version of the JRE.

If you must upgrade a version of the JRE, Quest will make the effort, in good faith, to support the upgrade, as long as it meets the following guidelines:

•
The new JRE must be on the same major release branch, and the upgrade must update no more than the 4th set of digits in the version number (for example, 1.8.0.xx).
•
You must use the following JRE upgrade process for the Agent Manager:
a
Stop the Agent Manager.
b
In the jre subdirectory of your Agent Manager installation directory, create a new directory named for the version number of the JRE to which you want to upgrade, with components separated by periods (for example, 1.8.0.25).
c
Unpack the new JRE into that directory.
d
Restart the Agent Manager, which will look for and use the newest JRE available to it.
•
You must use the following JRE upgrade process for the Management Server.
a
Stop the Management Server.
b
Rename <foglight_home>/jre to <foglight_home>/jre.bak.
c
Create a new <foglight_home>/jre directory.
d
Unpack the new JRE into the new <foglight_home>/jre directory.
e
Restart the Management Server.
•
For problem replication:
a
You must advise Quest technical support that you are on a non-standard JRE.
b
Quest will first try to reproduce problems on our bundled version of the JRE.
c
Quest will then try to reproduce problems on the version of the JRE to which you upgraded.
d
If Quest cannot replicate the problem on either the bundled version or the specific version of the JRE to which you upgraded, you may be asked to return our bundled version of the JRE.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating