Chat now with support
Chat with Support

Foglight for Integrations 5.9.4 - User and Reference Guide

Using Foglight for Integrations Reference

Deploying and Configuring QMX Agents

The QMX Agent can be deployed and used to receive data from Quest Management Extensions (QMX). QMX instrumentation packs can be configured to send data to Foglight. When configured, the packs send data to the FL_Performance_Event MOF table. The QMX Agent can be deployed to a server and then subscribe to that table to get the performance data.

Deploying QMX Agents

The QMX agent can be located either directly on the same server as QMX or on a remote server that has RPC and WMI access to the QMX server. Both installations are supported, but the collocated agent is easier to diagnose since the only network traffic that takes place is between two machines instead of three. A remotely located agent needs to communicate remotely with Management Server and remotely with the QMX server.

Configuring QMX Agent Properties

The agent properties for the QMX agent contain only a single secondary ASP where each of its rows defines another QMX host to poll data from. The definition for each column is as follows:

Host

The host name or IP address of the QMX host. This should be set to localhost if the agent and QMX are collocated, otherwise set to the host name of the QMX machine.

Username

The Windows user name that has access to poll WMI information from the specified host.

Password

The password associated with the specified user name.

Domain

If the username is part of a domain, it can be specified here. This field can usually be left blank.

1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Properties.
2
On the Namespace > Type column, click QMXAgents and then click QMXAgent type.
3
Click Edit.
4
Edit the Username and Password.

For more information about Agent Properties, see the Foglight Administration and Configuration Guide.

Once the agent is configured, it can then be activated using the standard Foglight Agent activation process.

Configuring QMX

In order for QMX to publish Foglight data to the QMX agents, the following requirements must be met:

For QMX Versions earlier than 4,0,0,499:

1
To configure QMX to send data to Foglight, the file FoglightTranslationTable.xml file must be copied to the \eXc Software\WMI Providers\nonWindows\Virtual Agent Library\MOM directory on the QMX server. The file is located in the Administration > Cartridges > Components for Download dashboard.
2
Set the following values in the commonroutinesInsertPerformanceRecord.js script:
a
Open \eXc Software\WMI Providers\nonWindows\Virtual AgentLibrary\MOM\CommonRoutinesInsertPerformanceRecord.js;
b
Set l_booluseSDK = false and l_booluseFL = true.
3
Click the MOM GlobalVariables tab, and uncheck the g_boolUseOpsMgrSingleton variable.

For QMX Versions 4,0,0,499 and later:

1
Update \WMI Providers\nonWindows\Virtual Agent Library\MOM\
GlobalVariables.js.
2
Set variable g_boolIsFogLight to true on line 51.

Once data is being published using the QMX agent into Foglight, new hosts for each Virtual Agent appears within the Foglight Hosts view.

To troubleshoot any problems with an agent, create both a Foglight and Foglight Agent Manager (FglAM) support bundle. The QMX virtual agent log is also typically required to ensure that the QMX data is being published.

Related Documents