Chat now with support
Chat with Support

Foglight for Virtualization Enterprise Edition 8.9.3 - Upgrade Guide

Upgrading Foglight for Virtualization, Enterprise Edition

The Foglight for Virtualization, Enterprise Edition components (Management Server, Embedded Agent Manager, Cartridges) are all upgraded automatically by the Foglight for Virtualization, Enterprise Edition installer.

To upgrade Foglight for Virtualization, Enterprise Edition from a previous version:
1
Download the Foglight for Virtualization, Enterprise Edition installation package for your platform from the Support Portal.
2
Manually shut down your Foglight Management Server. Do not depend on the installer to shut down your running Management Server and/or embedded database, due to the timing problem. Ensure that the Management Server has stopped running before launching the Foglight for Virtualization, Enterprise Edition installer. To verify that all Management Server processes have stopped, type the following command:
Windows®:
tasklist /v | find "fms"
Linux®:
ps -C fms
 
* 
IMPORTANT: If your Management Server uses an external database, do not stop the database. It is important that it continue to run during the upgrade.
3
For extra reliability, you must back up the Foglight database, as recommended in the Administration and Configuration Help.
4
Upgrade the existing Foglight for Virtualization, Enterprise Edition installation using the appropriate installer. Follow the on-screen instructions in the installation wizard.
 
* 
IMPORTANT: If you have previously installed Foglight for Virtualization, Enterprise Edition in a custom location, select the Custom Install option. You must specify the same installation directory as used for the existing installation.
5
The installer detects the earlier version of Foglight for Virtualization, Enterprise Edition.
6
Follow the on-screen upgrade instructions.
Select Upgrade and click Next.
7
The upgrade process continues in a similar fashion to the installation. For step-by-step assistance, refer to the appropriate Foglight Installation and Setup Guide for the database and platform you are running.
 
* 
NOTE: The database upgrade may be time consuming if you have a large topology.
8
After the Foglight for Virtualization, Enterprise Edition application is upgraded, the licensed cartridges are upgraded automatically.
 
* 
NOTE: At this point you should install the Foglight for Virtualization, Enterprise Edition license that is provided to the existing users.

Backing 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 TrustStore (caserts) in the old Agent Manager will be replaced by the new TrustStore from the higher version JRE. This will cause all the custom certificates imported to the old JRE TrustStore by customers get lost after the Agent Manager upgrade.

To keep the custom certificates, you need to back up the old JRE TrustStore 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 TrustStore with the copied cacert TrustStore and restart Agent Manager.

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

* 
NOTE: If the new JRE TrustStore has different entries than the old JRE TrustStore, there is a risk that these entries would get lost after replacing with the old JRE TrustStore.

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

Platform
JRE Version
windows-x86_64
1.8.0.222
linux-x86_64
1.8.0.222
windows-ia32
1.8.0.181
linux-ia32
1.8.0.181
solaris-sparc64
1.8.0.181
solaris-x86_64
1.8.0.181
aix-powerpc64
1.8.0.537
hpux-ia64
1.8.0.18

Upgrading the Agent Manager

The embedded Agent Manager is updated as part of the upgrade process. Any additional, external Agent Managers may need to be updated.

1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Managers.
The Agent Managers dashboard lists all agent hosts currently connected to the Foglight for Virtualization, Enterprise Edition server. If an agent host is not connected, start the Agent Manager process on that host.
2
If the Version of any agent host listed is not 5.9.8, continue following this procedure to upgrade the Agent Manager.
Otherwise, see the Appendix: Deploying an agent package using the browser interface.
3
To upgrade, select the agent host from the list and click Upgrade. The process may take a few minutes and the agent host may disappear from the list temporarily while it is restarting.
 
* 
NOTE: Repeat the upgrade process for every agent host that is not at version 5.9.8 or prior.
4
In some cases the upgraded Agent Manager may fail to restart after upgrading, and report as failed. If this happens, manually start the Agent Manager on the remote host.
 
* 
NOTE: If you are upgrading from Management Server version 5.2.4, an Agent Manager and Guest Process agent do not yet exist. For information on how to install and configure the Agent Manager, see the Agent Manager Guide.

Upgrading Foglight for Virtualization, Enterprise Edition agents

After upgrading Foglight for Virtualization, Enterprise Edition, the database, and cartridges, the agents used by some of the cartridges must be updated to ensure proper data collection. Specifically, this section describes the procedures for upgrading monitoring agents.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating