Foglight 5.9.2 - Upgrade Guide


	NOTE: All original rules in each cartridge are reset when the cartridge is upgraded; therefore if you applied custom conditions to any original rules these modifications will be lost. It is recommended that when modifying rules you make a copy of the original, disable the original and enable the copy with the new condition. Use the Rules dashboard (Dashboards > Administration > Rules & Notifications > Rules) to copy a rule.


	IMPORTANT: Foglight for Active Directory 5.7.2 may require more memory be allocated to the main Agent Manager instance than was previously needed. For details, see the Foglight for Active Directory Release Notes.

To upgrade Foglight for Active Directory to the latest version:

Create and release the lockbox.


	NOTE: You can skip this step if upgrading Foglight for Active Directory from version 5.6.6 or later.

From the navigation panel, navigate to the Credentials > Manage Lockboxes dashboard.

Create a custom lockbox for the Active Directory® credential. In the New Lockbox dialog box, type ActiveDirectory as the lockbox name, and secure the lockbox by typing a password (optionally). If you choose to use the default lockbox (System), you can ignore this step.

In the Manage Lockboxes dashboard, release the lockbox for the newly create ActiveDirectory lockbox, by clicking the icon on its Release to Credentials Clients column. Enter the password for authorizing the operation, select the clients from the list, and click Release.

Deactivate all of the Active Directory agents.

Install version 5.7.2 of the cartridge as you would install a new Foglight for Active Directory. Do not delete the older version of the .car file. For cartridge installation instructions, refer to “Installing Foglight cartridges” in the Foglight Administration and Configuration Help.

Deploy the agent package to each Foglight Agent Manager that hosts an Active Directory agent instance and wait for the version to update.


	NOTE: This may take two to three refresh cycles.

From the navigation panel, navigate to Dashboards > Active Directory Environment > Administration tab. In the Agent Management view select the Active Directory agents that you want to upgrade, and click Upgrade Agent.


	NOTE: You can specify the lockbox when upgrading the agents. The credentials for the existing agents are updated automatically. NOTE: You can skip this step if upgrading Foglight for Active Directory from version 5.6.6 or later.

Verify the agent properties and update the properties and collection intervals as required.

Activate the agents and start data collections.


	NOTE: For a list of issues that you may encounter after upgrading the Foglight for Active Directory to version 5.7.2, and ways to troubleshoot these issues, see the Foglight for Active Directory Release Notes.


	NOTE: If you are also running Foglight for Exchange, you must upgrade the Exchange agents as well. It is strongly recommended that you run the same version and patch level of both cartridges.

Upgrade Foglight for Exchange

The latest version of Foglight for Exchange is 5.7.2. You can upgrade to version 5.7.2 of Foglight for Exchange from version 5.6.2 and later.

Foglight for Exchange 5.7.2 requires Management Server version 5.9.2, or Foglight for Virtualization, Enterprise Edition 8.7 or later.


	NOTE: All original rules in each cartridge are reset when the cartridge is upgraded; therefore if you applied custom conditions to any original rules these modifications will be lost. It is recommended that when modifying rules you make a copy of the original, disable the original and enable the copy with the new condition. Use the Rules dashboard (Dashboards > Administration > Rules & Notifications > Rules) to copy a rule.


	IMPORTANT: Foglight for Exchange 5.7.2 may require more memory be allocated to the main Agent Manager instance than was previously needed. For details, see the Foglight for Exchange Release Notes.


	IMPORTANT: When data collection starts up, the Exchange agent installs a “Quest Remote Command Service” service in monitored server, to execute a PowerShell script. This service is uninstalled automatically when data collection stops.

To upgrade Foglight for Exchange to the latest version:

Create and release the lockbox.


	NOTE: You can skip this step if upgrading Foglight for Exchange from version 5.6.6 or later.

From the navigation panel, navigate to the Credentials > Manage Lockboxes dashboard.

Create a custom lockbox for the Exchange credential. In the New Lockbox dialog box, type ExchangeLockbox as the lockbox name, and secure the lockbox by typing a password (optionally). If you choose to use the default lockbox (System), you can ignore this step.

In the Manage Lockboxes dashboard, release the lockbox for the newly create ExchangeLockbox lockbox, by clicking the icon on its Release to Credentials Clients column. Enter the password for authorizing the operation, select the clients from the list, and click Release.

Deactivate all of the Exchange agents.

Install version 5.7.2 of the cartridge as you would install a new Foglight for Exchange.

For detailed cartridge installation instructions, see the “Installation instructions” section in the Foglight for Exchange Release Notes.

Deploy the agent package to each Foglight Agent Manager that hosts an Exchange agent instance and wait for the version to update.


	NOTE: This may take two to three refresh cycles.

From the navigation panel, navigate to Dashboards > Exchange Environment > Administration tab. In the Agent Management view select the Exchange agents that you want to upgrade, and click Upgrade Agent.


	NOTE: You can specify the lockbox when upgrading the agents. The credentials for the existing agents are updated automatically. NOTE: You can skip this step if upgrading Foglight for Exchange from version 5.6.6 or later.

Verify the agent properties and update the properties and collection intervals as required.

Activate the agents and start data collections.


	NOTE: For a list of issues that you may encounter after upgrading the Foglight for Exchange to version 5.7.2, and ways to troubleshoot these issues, see the Foglight for Exchange Release Notes.


	NOTE: If you are also running Foglight for Active Directory, you must upgrade the Active Directory agents as well. It is strongly recommended that you run the same version and patch level of both cartridges.

Upgrade Foglight for Infrastructure

The latest version of Foglight for Infrastructure is 5.9.2.

As part of the transition to Quest Software, Foglight for Infrastructure 5.8.5.8 and higher deprecate the following agent types:

•

DellUnixAgent: Replaced with the new UnixAgentPlus agent type.

•

DellFileLogMonitorAgent: Replaced with the new FileLogMonitorAgent agent type.

•

DellWindowsEventLogMonitorAgent: Replaced with the new WindowsEventLogMonitorAgent agent type.

The specific agent types listed above are being deprecated in order to comply with rebranding requirements. The deprecated agent types and their replacements are identical, with the exception of the agent type name. Previously created instances of deprecated agent types will continue to run, however, you will only be able to deploy new instances of the replacement agent type.

As of 5.8.5.8, migrating deprecated agent types to the new agent types is not required. An option to migrate deprecated agent instances to the new agent types is available, but hidden. Contact Quest Support for instructions on how to migrate your agents.

Foglight for Infrastructure version 5.9.2 requires Management Server version 5.7.5 (or later). Foglight Agent Manager 5.8.0 (or later) must be installed on all the hosts that you want to use for local or remote monitoring.


	NOTE: Some content in Foglight for Infrastructure supersedes that of the legacy Cartridge for Operating Systems. However, no upgrade path is provided for replacing an existing legacy Cartridge for Operating System with Foglight for Infrastructure.


	NOTE: Foglight for Infrastructure 5.8.1 (and later) requires the latest OS Patch level for AIX®. In order to support the AIX platform, the latest OS Service Packs must be applied prior to installing or upgrading Foglight for Infrastructure to 5.8.5.4 (or later).

To upgrade Foglight for Infrastructure to version 5.9.2:

•

Install version 5.9.2 of the cartridge as you would a new Foglight for Infrastructure cartridge. Do not delete the older version of the .car file. Install version 5.9.2 over the older version.

For cartridge installation instructions, see “Installing Foglight for Virtualization, Enterprise Edition cartridges” in the Foglight for Virtualization, Enterprise Edition Administration and Configuration Help.

After the cartridge is installed, you must deploy the new HostAgents.gar agent package to each of your Agent Managers to update the agents. Do not deactivate the agents before deploying; they are updated automatically.

For information about upgrading Foglight for PowerVM, see Upgrade Foglight for PowerVM.