Foglight 6.0.0 - Upgrade Guide

Upgrade Foglight for SAP ASE

The latest version of Foglight for SAP ASE (formerly Foglight for Sybase) is 6.0.0. However, due to architectural changes in Foglight for SAP ASE 5.9.7.20, legacy cartridge versions cannot be upgraded to version 5.9.7.20 or 6.0.0. You may install the new SAP ASE cartridge on the same FMS instance as the old cartridge. The new Sybase cartridge must use a different FglAM than the legacy cartridge. Both FglAMs may be installed on the same FMS.

NOTE: If you upgrade the Management Server to version 5.5.8 or later, you must upgrade the Cartridge for SAP ASE to version 5.5.5 or later.

NOTE: If the agent fails to collect data, check the agent log for information about the problem.

When upgrading from version 5.5.5 of the cartridge, the upgrade overrides the value of the common Performance Poll Cycle (seconds) property, and uses that value to set the collection rate for each table in the PerfMon_Dflt list. Versions of the cartridge prior to 5.5.8 included the common Sybase_MDA agent properties, Performance Collection True/False and Performance Poll Cycle (seconds), used to control the collection of performance data. This version of the cartridge includes performance monitoring properties that enable or disable the collection of performance data and the length of the polling interval on a per-table basis. The secondary agent properties in the PerfMon_Dflt list now include two new columns, Collect and Poll Cycle (sec), that control these values for each individual table.

NOTE: The file setup_mon_tables.sql contains all of the required parameters with sample values. The last four parameters were added in version 5.5.8. NOTE: There is a known defect: when deploying the agent package, a progress bar appears but never indicates completion. Typically the deployment has completed successfully. For a workaround procedure that verifies that the deployment has completed, see section “Upgrade” in the Cartridge for Sybase 5.7.5.50 Release Notes.

Upgrade Foglight for Azure SQL Database

The latest version of Foglight for Azure SQL Database is 6.0.0. Starting to work with a Foglight for Azure SQL Database cartridge requires upgrading to the current version of both the cartridge and the Foglight Agent Manager that runs the cartridge.

For cartridge installation instructions, see the Foglight for Databases Deployment Guide.

Upgrading the Infrastructure Management cartridges

This section explains how to upgrade an earlier version of an Infrastructure Management cartridge to the most current version. For details, refer to the following topics:

Upgrade Foglight for Active Directory

The latest version of Foglight for Active Directory is 6.0.0. You can upgrade to version 6.0.0 of Foglight for Active Directory from 5.7.2.2 or higher.

Foglight for Active Directory 6.0.0 requires Management Server version 6.0.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 Active Directory 6.0.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.

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

NOTE: This may take two to three refresh cycles.

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.

NOTE: For a list of issues that you may encounter after upgrading the Foglight for Active Directory to version 6.0.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.