Chat now with support
Chat with Support

Foglight 5.9.7 - 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 cartridges in a federated environment

Cartridge upgrades in a Federated environment need to be handled differently than typical cartridge upgrades. To maintain the Federated topology, you must disconnect/reconnect the queries as part of the upgrade procedure.

You must also ensure that the required cartridges are being upgraded in a Federated environment. For example, you may determine the following:

•
Federated Child # 1 requires upgrades to the Foglight for Infrastructure and Foglight for Oracle.
•
Federated Child # 2 requires upgrades to the Foglight for Infrastructure and Foglight for SQL Server.

In this example, after upgrading the two Federated Children, you need to upgrade the Foglight for Infrastructure, Foglight for Oracle, and Foglight for SQL Server on the Federation Master.

The procedure outlined below describes the required sequence of steps.

To upgrade cartridges in a Federated environment:
1
Disable the topology synchronization in the Federation Master by commenting out all child server URLs (the FederationURLs in the federation.config file).
2
Upgrade one or more cartridges on the stand-alone Management Servers (Federated Children).
 
* 
NOTE: All Federated Children that need to be upgraded must be upgraded before uncommenting the URLs in the federation.config file.
3
Upgrade same cartridges on the single, central Management Server (Federation Master).
 
4
Uncomment the child server URLs in the federation.config file.

Upgrade cartridges in a High Availability environment

When upgrading cartridges in an HA environment, if both the primary and the secondary Management Servers are running, you only need to install each cartridge you want to upgrade on the primary Management Server. The cartridges are then copied over to the secondary Management Server automatically.

The management log reports on the copying of the cartridges.

 

Appendix: Deploying an agent package using the browser interface

This section explains how to deploy an agent package using the browser interface. This method is an alternative to using the command-line interface.

In Foglight, you can use the command-line interface to deploy an agent package for an upgraded cartridge, or you can use the browser interface.

Before you can deploy an agent package on a machine, you must first install the Agent Manager and the relevant agent package on that machine.

Use the Agent Managers dashboard to deploy one agent package at a time, or to deploy the agent package to multiple hosts. You can also deploy agent packages to a single host from the Agent Status page.

 
* 
NOTE: On the Agent Managers dashboard, you can deploy an agent package to multiple hosts, as long as the hosts you select are running the same operating system.

Deploying an agent package through the Agent Managers dashboard

To deploy an agent package to one or more monitored hosts:
1
On the navigation panel, under Dashboards, select Administration > Agents > Agent Managers.
2
On the Agent Managers dashboard, select one or more hosts from the list.
3
Click Deploy Agent Package in the toolbar.
 
* 
NOTE: In order to select the host, the Foglight Agent Manager must be up and running on the monitored host.
The Deploy Agent Package dialog wizard opens.
4
Select the agent packages that you want to deploy to the hosts you selected.
The entries that appear in the Agent Packages list include only those agent packages whose platform is compatible with the platform of the hosts you selected in Step 2. For example, if the host runs a particular Windows OS, the list contains only the agent packages that include the agent processes that can run on that Windows OS.
 
* 
NOTE: You can only deploy those agent packages whose cartridges have already been installed on the Foglight Management Server.
Optional — To see all packages that are available for deployment, including those are not compatible with the selected hosts, select Show Packages for All Platforms.
 
* 
IMPORTANT: Do not deploy any agent packages that are not compatible with the host’s platform. Deploying incompatible agent packages on top of existing compatible agent packages deletes the existing agents which can cause unpredictable results.
Click Next.
5
On the Summary page, review the choices you have made. Click Finish.
The task appears in the Tasks list. Use the Tasks list to follow the progress and determine the status of the task.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating