Back up custom JRE certificates before upgrading Agent Manager

Upgrade and compatibility

The 7.1.x Foglight Agent Manager cartridge requires Foglight Management Server 7.1 or later

Agent Manager upgrades from a 5.5.4.x legacy release require an intermediary upgrade to 5.6.7 prior to upgrading to 5.8.5 or later. To complete this intermediary upgrade, install one or more of the Agent Manager 5.6.7 platform-specific cartridges (as required), and upgrade the legacy hosts to this release before deploying the 7.1.x Agent Manager cartridge or upgrading the Foglight Management Server to version 5.9.2 or later. After all of the legacy hosts are running version 5.6.7, and the Foglight Management Server is upgraded to version 5.9.2 or later, you can start upgrading your hosts to version 7.1.x.

The following is a list of Foglight product versions and platforms compatible in this release.

For more information about upgrading the Management Server and the Agent Manager, see the Foglight Upgrade Guide.

Back up custom JRE certificates before upgrading Agent Manager

When upgrading external Agent Manager, if the new Agent Manager uses a higher version JRE than the old Agent Manager, the JRE trust store (cacerts) in the old Agent Manager will be replaced by the new trust store from the higher version JRE. This will cause all the custom certificates imported to the old JRE trust store by customers get lost after the Agent Manager upgrade.

To keep the custom certificates, you need to back up the old JRE trust store before upgrading external Agent Manager, by following below steps:

1. Verify if the new Agent Manager uses a higher version JRE than the old Agent Manager.
2. If yes, copy the file <fglam_home>/jre/<current_jre_version>/jre/lib/security/cacerts to a local directory before upgrading Agent Manager.
3. After Agent Manager is upgraded, replace the cacert trust store with the copied cacert trust store and restart Agent Manager.

As for the embedded Agent Manager, it uses the same JRE as the Management Server. If there are custom certificates stored in JRE trust store and a higher JRE version is used, back up the JRE cacert trust store used by the Management Server before upgrading Management Server.

Note: if the new JRE trust store has different entries than the old JRE trust store, there is a risk that these entries would get lost after replacing with the old JRE trust store.

Below is a list of JRE versions used by Agent Manager on various platforms in this release:

Note: To avoid the need for reinstalling the certificate after an upgrade, it is recommended to install an FglAM CA certificate using the fglam- -add-certificate method instead of the keytool command. For more information, refer to the Configuring the Agent Manager to use SSL certificates section of the Foglight Agent Manager Guide.

Back to Top

System requirements

System requirements

Final platform support notice

Support of Foglight Agent Manager (FglAM) on AIX, Sun Solaris, and HP-UX platforms has been discontinued on this release (7.1.0). FglAM installers are only provided for Windows and Linux platforms.

Back to Top

Final platform support notice

System requirements

Support of Foglight Agent Manager (FglAM) on AIX, Sun Solaris, and HP-UX platforms has been discontinued on this release (7.1.0). FglAM installers are only provided for Windows and Linux platforms.

Back to Top

Product licensing

Product licensing

Foglight includes a licensing capability that restricts access to those features that are defined in the license. All Management Server installations require a license that grants access to server-specific parts of the browser interface and the features associated with them. Foglight cartridges are also license-protected. While some cartridges are covered by the base Foglight license (such as Foglight for Infrastructure), others may require an additional license. Foglight Agent Manager is covered by the base Foglight license.

To activate a trial or a purchased commercial license:

1. On the navigation panel, under Dashboards, click Administration > Setup > Manage Licenses.
2. Click Install.
3. In the Install License dialog box, click Browse.
4. In the file browser that appears, specify the location of the license file.
5. In the Install License dialog box, click Install License.

Back to Top