Chat now with support
Chat with Support

Foglight for Integrations 5.9.8 - User 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.

Related topics:
•
Deploying QMX Agents
•
Configuring QMX Agent Properties
•
Configuring QMX

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:

Table 6. QMX agent properties
Agent Property
Description

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.

NOTE: Administrative access is required by default for polling this information. Setting up other users is outside the scope of this document.

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.

To update agent properties:
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.
The running QMX host is listed in the table.
4
Edit the Username and Password.

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

Starting the Agent

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

* 
NOTE: QMX must be installed before activating the agent. If QMX is not installed, the agent fails to activate correctly.

You do not need to run QMX to activate the agent because the agent does not interface directly with QMX.

Configuring QMX

Requirements

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

•
A Foglight capable instrumentation pack must be installed in QMX.
a
Confirm a successful installation of this instrumentation pack by looking for a Foglight tab within that instrumentation pack’s configuration menu. If present, the installation was successful.
b
For Instrumentation Packs that are Foglight enabled, start any of the QMX Virtual Agents for that Instrumentation Pack to send data to the QMX agents.
Configuration
To configure QMX:

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

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

Troubleshooting

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

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating