Chat now with support
Chat with Support

Foglight 5.9.5 - 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 Microsoft .NET from version 5.9.x

To upgrade Foglight for Microsoft .NET from version 5.9.x to 5.9.12:
1
Install the 5.9.12 cartridge (ApplicationServers-DotNET-5_9_12.car) as you would install a new cartridge. Do not delete or uninstall the previous version. For cartridge installation instructions, see “Installing Foglight cartridges” in the Foglight Administration and Configuration Help.
 
* 
NOTE: As the new version of the cartridge is installed, all Nexuses are automatically upgraded to the new version. While this happens, agents disconnect briefly and then reconnect once the new version of Nexus is restarted.
2
Upgrade the .NET Agent Installations.
 
* 
NOTE: Once an Agent Installation has been upgraded, you must reset IIS before the agents will reconnect.
a
On the navigation panel, under Dashboards, click Application Servers > Administration > Application Servers Administration.
b
On the Application Servers Administration dashboard, click .NET Administration.
c
On the .NET Administration dashboard, click the Installations tab.
d
Click the name of the host of the .NET agent that you want to upgrade and, in the menu that opens, click Upgrade.
e
Confirm that you want to upgrade the agent package by clicking Upgrade in the message box.
 
* 
NOTE: Once confirmed, the upgrade process starts and the Agents disconnect. The agents will reconnect only when the IISReset has been completed in Step g.
f
A task is added to the Task History list at the bottom of the view. Check the Result column for information on the upgrade process and its status.
g
Once the Upgrade task is successful, on the monitored host, perform an IISReset.
Nexus agent upgrade:
•
If your Nexus agents are running, they are upgraded automatically when you install the cartridge.
•
If your Nexus agents are not running, you must upgrade them manually from the Application Servers Administration dashboard before allowing any agents to connect to the Nexus.

Configuration migration during upgrades

If you have modified the configuration files and you perform a minor version upgrade (for example from x.y.z to x.y.z+1), your modified files are preserved. The default contents of the configuration files from the new version are overwritten with your changes.

For example, you have version 5.9.3.2 currently installed and you have modified the Nexus recording.config and the .NET agent instrumentation.config. Upgrading to version 5.9.12 would overwrite the default contents of the 5.9.10 versions of those files with your file contents from 5.9.3.2. All other 5.9.12 configuration files are unchanged, and contain the default contents installed by the 5.9.12 cartridge.

 
* 
NOTE: Configuration files managed through the Advanced dashboards (for example, nexus/aggregation.config) are not automatically migrated. If you have made any modifications to these files, they must be migrated manually, with the assistance of Customer Support where necessary.
In addition, the nexus/compatible-builds.config file is never automatically migrated. If you have any patch build IDs, these must be manually added to the new version’s compatible-builds.config with the assistance of Customer Support.
 
* 
IMPORTANT: No automatic migration occurs during an upgrade to the next major version (for example, from 5.9.x to 5.10.x).

Upgrade the cartridge from version 5.6.x to version 5.9.x

To upgrade from version 5.6.x:
1
Install the 5.9.x cartridge as you would a new cartridge. Do not delete or uninstall the previous version.
2
Use the Agent Setup wizard (Application Servers > Administration > Application Server Administration dashboard) to create a new installation. Creating the installation will upgrade the existing agents.
3
Manually delete the old 5.6.x agent.

Upgrade Foglight for IBM WebSphere MQ Server

The latest version of Foglight for IBM WebSphere MQ Server is 5.5.5.13.

Foglight for IBM WebSphere MQ Server 5.5.5.13 requires Management Server version 5.6.5 or later.

To upgrade Foglight for IBM WebSphere MQ Server to the latest version:
1
From the Agent Status dashboard (Administration > Agents > Agent Status), select and deactivate all MQAgent instances.
2
Install the 5.5.5.13 cartridge (MQ-5_5_5_13.car) on the Management Server. For cartridge installation instructions, see “Installing Foglight cartridges” in the Foglight Administration and Configuration Help.
3
Deploy the MQ Agent Package to the Agent Managers that are monitoring the MQ servers.
4
Activate the MQAgent instances.

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating