Foglight 7.1.0 - 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 7.1.0 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 7.1.0 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 7.1.0, 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 .7.1.0 You can upgrade to version 7.1.0 of Foglight for Exchange from version 5.7.2.2 and later.

Foglight for Exchange 7.1.0 requires Management Server version 7.1.0.


	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 7.1.0 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.

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 7.1.0 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 7.1.0, 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.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

Foglight 7.1.0 - Upgrade Guide

Upgrade Foglight for Azure SQL Database

Upgrading the Infrastructure Management cartridges

Upgrade Foglight for Active Directory

Upgrade Foglight for Exchange