Chat now with support
Chat with Support

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

Upgrade Foglight for VMware

The latest version of Foglight for VMware is 5.8.3.

Foglight for VMware 5.8.3 requires Management Server version 5.9.8, or Foglight Evolve 9.3.

Upgrades are supported from Foglight for VMware 5.6.15.x and later. Upgrades from the versions earlier than 5.6.15.x are not supported.

Important: The VMware Performance Agent uses a Virtual Center account to log in to the monitored Virtual Center. The administrative role associated with that account must be granted the Performance > Modify intervals privilege. When collecting traffic-type network metrics from the monitored ESX hosts, this privilege enables the VMware Performance Agent to change the performance metric counter levels in order to collect this data. On the Virtual Center server, verify that the user has the following privileges:

•
Datastore > Browse datastore
•
Datastore > Remove file
•
Performance > Modify intervals
•
Sessions > View and stop sessions
•
Virtual machine > Configuration > Change CPU count
•
Virtual machine > Configuration > Change resource
•
Virtual machine > Configuration > Memory
•
Virtual machine > Interaction > Power Off
•
Virtual machine > Interaction > Power On
•
Virtual machine > State > Remove Snapshot
 
* 
NOTE: Java 7 or later requires that the vCenter Certificate’s public key length must be 1024-bits or higher and should not use MD5.
If you try to add a vCenter for monitoring, and these requirements are not met, the server generates a Certificate error and cannot add the vCenter. The vCenter server Certificate should be updated to 1024-bits or higher and no MD5, to be able to add it for monitoring. For more information, see the Foglight for VMware Release Notes.
To upgrade Foglight for VMware to the latest version:
1
Deactivate all VMware Performance agent instances.
2
On the Cartridge Inventory dashboard, install the following cartridge files. Do not remove the older version of these cartridges. Install the new versions over the older versions. The sequence of cartridge installation is important because of their dependencies. For cartridge installation instructions, see “Installing Foglight cartridges” in the Foglight Administration and Configuration Help.
a
vUsage-Feedback-5_8_3.car
b
DRP-5_8_3.car
c
OptimizerAutomation-5_8_3.car
d
CommonAnalyics-5_8_3.car
e
Virtual-VMware-5_8_3.car
f
Virtual-VMware-Admin-5_8_3.car
3
On the VMware Environment dashboard, on the Administration tab, update all of the existing VMware Performance agent instances.
4
Important. If you increased the JVM memory allocation in a previous cartridge installation (as described in the “System Requirements” section of the Foglight for VMware Release Notes), you need to repeat this process after deploying the new agent package and before activating the agents.
5
Activate all VMware Performance agent instances.

Upgrade Foglight for VMware Horizon View

The latest version of Foglight for VMware Horizon View is 5.8.3.

Foglight for VMware Horizon View 5.8.3 requires Management Server version 5.9.8 or Foglight Evolve 9.3. It also requires Foglight for VMware 5.8.3 (or later) to be installed and enabled on the same Foglight Management Server.

To upgrade a VMware Horizon View agent:
1
On the Cartridge Inventory dashboard, install the following cartridge files. Do not remove the older version of these cartridges. Install the new versions over the older versions. The sequence of cartridge installation is important because of their dependencies.
1
vUsage-Feedback-5_8_3.car
2
DRP-5_8_3.car
3
Virtual-VMware-5_8_3.car
4
Virtual-VMware-Admin-5_8_3.car
5
VMware-View-5_8_3.car
For cartridge installation instructions, see “Installing Foglight Evolve cartridges” in the Foglight Evolve Administration and Configuration Help.
2
On the navigation panel, under Dashboards, click VMware View to open the VMware View Environment dashboard.
3
Click the Administration tab.
The Agent Version column in the Agents table shows the agents that are out of date.
4
Click Update Agent once for each Foglight Agent Manager instance on which outdated VMware Horizon View agents are running.
The selected agents are updating. When the operation completes, the Agent Version column is updated to read Version Up To Date.
5
Click the Details tab, then the Desktops tile.
6
In the Quick View, identify whether there are any Unmanaged or Terminal Server Hosts instances.
 
* 
NOTE: The Summary view for any Unmanaged or Terminal Server Hosts instances would displays no data. This is due to the default properties used by the View Discovery Wizard to create Infrastructure agents, for any Unmanaged or Terminal Server Hosts.
7
If any Unmanaged or Terminal Server Hosts instances exist on the list, update the properties for their corresponding Infrastructure agents.
 
* 
NOTE: If some instances on the list do not have a corresponding Infrastructure agent, you must first create an Infrastructure agent manually, define appropriate agent properties, and create the correct credentials for them. Alternatively, you can add these instances to an existing credential’s resource mapping.
a
On the navigation panel, click Administration > Agents > Agent Status, to open the Agent Status dashboard.
b
Select the Infrastructure agent that needs edits, and click Edit > Edit Properties.
c
Click Modify the private properties for this agent.
d
In the Properties area, set to True the following options: Collect CPU metrics, Collect disk metrics, Collect memory metrics, and Collect network metrics.
e
Click Save.
f
Repeat steps b to e for all other Infrastructure agents used for monitoring Unmanaged or Terminal Server Hosts.
The Infrastructure agents now start to collect CPU, disk, memory, and network metrics from the monitored hosts and the VMware View Environment dashboard will display this information correctly.

Upgrade Foglight for Citrix XenDesktop and XenApp

The latest version of Foglight for Citrix XenDesktop and XenApp is 5.8.3.

Foglight for Citrix XenDesktop and XenApp 5.8.3 requires Management Server version 5.9.8, or Foglight Evolve 9.3.

To upgrade Foglight for Citrix XenDesktop and XenApp to the latest version:
1
Download the following packages from Quest Support Portal:
•
Foglight for VMware version 5.8.3 (which includes the vUsage-Feedback-5_8_3.car, DRP-5_8_3.car, Virtual-VMware-5_8_3.car, and Virtual-VMware-Admin-5_8_3.car cartridge files)
•
Foglight for Citrix XenDesktop and XenApp version 5.8.3 (which includes the XenDesktop-5_8_3.car cartridge file)
2
Deactivate all XenDesktop and NetScaler agent instances.
3
On the Cartridge Inventory dashboard, install and enable the following cartridge files. Do not remove the older version of these cartridges. Install version 5.8.3 over the older version. The sequence of cartridge installation is important because of their dependencies:
a
vUsage-Feedback-5_8_3.car
b
DRP-5_8_3.car
c
Virtual-VMware-5_8_3.car
 
* 
NOTE: After installing the Virtual-VMware-5_8_3.car cartridge, existing vCenter agents (VC agents) must be updated using the Update Agent button in the VMware Environment > Administration tab.
d
Virtual-VMware-Admin-5_8_3.car
e
XenDesktop-5_8_3.car
For cartridge installation instructions, see “Installing Foglight cartridges” in the Foglight Administration and Configuration Help.
4
On the XenDesktop Environment dashboard, on the Administration tab, update all of the existing XenDesktop and NetScaler agent instances.
5
Activate all XenDesktop and NetScaler agent instances.

Upgrade Foglight for Container Management

The latest version of Foglight for Container Management is 4.0.0.

Foglight for Container Management 4.0.0 requires Management Server version 5.9.8, or Foglight Evolve 9.3.

 

* 
NOTE:  
•
If you are using Foglight for Container Management on Foglight for Virtualization, Enterprise Edition with a version prior to 2.0.0, ensure to upgrade Foglight for Container Management to version 2.0.0 or later before upgrading.
•
Container Cost dashboard is not supported on Foglight for Virtualization, Enterprise Edition.
To upgrade Foglight for Container Management to the latest version:
1
Download the following packages from Quest Support Portal:
Foglight for Container Management version 4.0.0, which includes the following cartridge files:
a
vUsage-Feedback-5_8_3.car
b
DRP-5_8_3.car
c
OptimizerAutomation-5_8_3.car
d
CommonAnalytics-5_8_3.car
e
Optimizer-5_8_3.car
f
Container-Manager-4_0_0.car
2
Deactivate all agent instances.
3
On the Cartridge Inventory dashboard, install and enable the following cartridge files. Do not remove the older version of these cartridges. Install version 4.0.0 over the older version. The sequence of cartridge installation is important because of their dependencies:
a
vUsage-Feedback-5_8_3.car
b
DRP-5_8_3.car
c
OptimizerAutomation-5_8_3.car
d
CommonAnalytics-5_8_3.car
e
Optimizer-5_8_3.car
f
Container-Manager-4_0_0.car
For cartridge installation instructions, see “Installing Foglight cartridges” in the Foglight Administration and Configuration Help.
4
On the Container Environment dashboard, on the Administration tab, update all of the existing container agent instances.
5
Activate all container agent instances.

 

* 
NOTE: Support for Heapster metrics collector will be removed in the future release, users are encouraged to use the Prometheus metrics collector. Refer to the steps below to migrate from Heapster metrics collector to Prometheus metrics collector.
To migrate from Heapster metrics collector to Prometheus metrics collector:
1
On the Foglight for Container Management Administration Dashboard, locate the agent you want to migrate.
2
Click the Migrate icon to launch the Migrate wizard. There are two ways to migrate the Heapster metrics collector to Prometheus metrics collector.
•
If you already have Prometheus in your cluster, choose Yes I have. Enter the namespace and name for the Prometheus server service.
•
If you don't have Prometheus in your cluster yet, choose No I haven't. You can deploy a Prometheus server service to your cluster by using the template we provided.

For detailed information, refer to Administration section in Foglight for Container Management User and Administration Guide.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating