Foglight 7.3.0 - Upgrade Guide


	NOTE: If you have previously added certificates to the JRE manually, and are upgrading from a version earlier than 5.6.2.2, see Certificate migration from version 5.6.2.1 or earlier.

FglAM vm.config file migration fails under multi-state installations

Description

When upgrading a multi-state Foglight Agent Managers that share “bin” directories, some of the agent managers become unresponsive as the states are running out of memory. “Out of memory” messages appear in the logs. In addition, error messages like the following appear in the agent manager log:

Foglight_Agent_Manager\state\default\config\client.config does not exist and will not be loaded.

Foglight_Agent_Manager\state\default\config\baseline.jvmargs.config does not exist and will not be loaded.

Workaround:

Locate the client.config and baseline.jvmargs.config files.

Two new files are deployed to the state config directory during a FglAM upgrade. Locate these files (client.config and baseline.jvmargs.config) within the FglAM state instance that was upgraded.

As these file instances may already contain transferred values from the legacy vm.config, you need to review each of the settings in both of these files in order to ensure that these configuration options apply to the FglAM state instance that they are being copied into.

Note that the vm.config settings were migrated.

The legacy vm.config file has be replaced with two new config files. The settings in this file have been split between the new client.config and the baseline.jvmargs.config files.

Migrate the vmparameter.x from vm.config to baseline.jvmargs.config.

Locate the vm.config file within the config state directory instance of FglAM. At the bottom of the file there is a section for defining vmparameter.x = ""; values. Copy over the vmparameter.x settings from the legacy vm.config here into the baseline.jvmargs.config file.

Validate the settings in client.config with vm.config values.

Review all of the options declared in the vm.config with those of the client.config you have copied over. The client.config is a super-set of properties from the vm.config (with the exception that the vmparameter values are no longer defined here). So each property that exists in the vm.config should also exist in the client.config. Ensure that each of the common config values in the client.config file matches the values in the vm.config. If they are different, then update the client.config to match.

Migrate the java.vm config option.

If the java.vm config option was set in the vm.config, then update the java.vm option in the new client.config. When transferring this value over, ensure that the path value is quoted and back-slashes escaped. For example:

Windows:

java.vm = "C:\\shared_java_vms\\1.5\\jre";

Unix:

java.vm = "/opt/shared_java_vms/1.5/jre";

Once migration is complete, and you have validated that all config settings are in their new locations, delete the vm.config file and restart the FglAM process.

Upgrade the Database cartridges

This section explains how to upgrade an earlier version of a database monitoring cartridge to the latest version. For details, refer to the following topics:

•

Upgrade Foglight for DB2 LUW

•

Upgrade Foglight for Oracle

•

Foglight for Oracle 7.3.0.x requires Management Server version 7.3.0 and Agent Manager version 7.3.0.

•

Upgrade Foglight for SAP ASE

•

Upgrade Foglight for Azure SQL Database

Upgrade Foglight for DB2 LUW

The latest version of Foglight for DB2 LUW is 7.3.0.x, which requires Management Server version 7.3.0 (or later) and Agent Manager version 7.3.0 (or later).


	NOTE: This cartridge does not have an upgrade path from the Cartridge for DB2 LUW version 5.5.8.1 or 5.5.8.2, which use different technology. Contact Quest Support for assistance migrating from the Cartridge for DB2 LUW to Foglight for DB2 LUW.

To upgrade Foglight for DB2 LUW to version 7.3.0.x:

Upgrade the Management Server to version 7.3.0 or later.

Install version 7.3.0.x of the cartridge as you would install a new cartridge. Do not delete the older version of the .car file. Install version 7.3.0 over the older version.


	NOTE: Using the integrated installer to upgrade to Foglight version 5.7.0 (or later) with the updated cartridge requires a Foglight Management Server restart.

For complete cartridge upgrade and installation instructions, see the Foglight for DB2 LUW User and Reference Guide.