Foglight 5.9.3 - Upgrade Guide

Transition FTR agents from the Foglight Client (SPID) to the Agent Manager

When you transition an FTR agent from the Foglight Client (SPID) to the Agent Manager, historical data is preserved and the data is continuous.

FTR agent host machines should run either all FTR Foglight Client agents or all FTR Agent Manager agents. While a combination of agents will function, Quest does not recommend such a configuration.

To transition an FTR agent host machine from the Foglight Client to the Agent Manager:

Deactivate all FTR agents running on the agent host machine and stop the Foglight Client (SPID).

If you have not already done so, upgrade the EU-Core Cartridge and Foglight for FTR on the Management Server.

Install the Agent Manager version using the “Installing the Agent Manager” instructions in the Foglight Agent Manager Guide.


	NOTE: With these instructions, you install the Agent Manager and migrate agents from your existing Foglight Client installation to the new Agent Manager installation.

Follow the “Deploy the Foglight Transaction Player Agent package” and “Create, configure, and activate the Foglight Transaction Recorder (FTR) Agent” procedures in the Foglight End User Monitoring Installation and Configuration Guide.


	IMPORTANT: You must specify the Instance Name (agent name) and Location Name of each new agent to be identical, including case, to the Foglight Client FTR agent that it is replacing. IMPORTANT: When configuring the properties of the new agent, the location name you specify must be identical, including case, to the location name of the Foglight Client FTR agent it is replacing.


	NOTE: The new fields available for Agent Manager FTR agents do not affect the transition and are optional.

The previously published scripts are available to both the SPID and Agent Manager agents, but the defined script lists are not. However, when the EU-Core_<version>.car is installed, a new Agent Manager script list is created for any existing SPID script list when there is no existing Agent Manager script list with the same name. Any changes that are made to the SPID script list after the upgrade are not reflected in the new Agent Manager script list. The SPID script list and the Agent Manager script list are not connected. An Agent Manager version of the SPID script list is made only at the time the upgrade to Foglight for FTR is performed. Select the script list for the agent. The script list for an Agent Manager FTR agent does not have to have the same name as the script list used by the Foglight Client FTR agent it is replacing.

Once activated, the data from the new agent should merge seamlessly with the historical data.

Quest recommends that the existing Foglight Client FTR agents be retained and deactivated until you are satisfied that the new Agent Manager FTR agents are configured and running properly. That way, at any time, the Agent Manager agents can be deactivated and the Foglight Client agents reactivated.

Upgrade the Foglight Experience Monitor appliance

The latest version of the Foglight Experience Monitor appliance is version 5.7.0.


	IMPORTANT: Before you upgrade the Foglight Experience Monitor, create a full system backup. For information about how to create a full system backup of the Foglight Experience Monitor, see the “Backing up and restoring data” section of the Foglight Experience Monitor Installation and Administration Guide.


	IMPORTANT: As of release 5.5.4, the Foglight FxM Agent no longer resides on the Foglight Experience Monitor. When you upgrade the Foglight Experience Monitor from version 5.5.0 to 5.5.4, 5.5.5, 5.5.8, 5.6.2, 5.6.3, or 5.6.5, if you have the Cartridge for FxM version 5.5.2 or earlier installed on the Foglight Experience Monitor, it is automatically uninstalled. In addition, upgrading the Foglight Experience Monitor removes any Foglight agents that are currently installed. To avoid lost data, you must upgrade the Foglight Experience Monitor, the Foglight Management Server, and the Cartridge for FxM to version 5.5.4 or later.

To upgrade Foglight Experience Monitor to the latest version, follow the instructions in the Foglight Experience Monitor Installation and Administration Guide.

The Foglight Experience Monitor Release Notes, which contain compatibility and other important information, are also available on our Support Portal.