Chat now with support
Chat with Support

Foglight for IBM WebSphere MQ 5.5.5.9 - Installation Guide

Creating MQ Agent instances

The Foglight for IBM WebSphere MQ Server uses the MQ Agent to collect information from monitored hosts. Creating an MQ Agent instance creates the agent process.
The following procedure describes the process of creating MQ Agent instances using the Agent Status dashboard in the Foglight browser interface. This dashboard is useful for creating agent instances one host at a time. Alternatively, for creating MQ Agent instances on multiple hosts, you can use the Agent Hosts dashboard. For more information, see the Administration and Configuration Guide.
Another way to create agent instances is using the fglcmd command-line interface. For more information about the available fglcmd commands, see the Command-Line Reference Guide.
To create an MQ Agent instance:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, click Create Agent (in the lower-left corner).
3
In the Create Agent dialog box, click Host and select the host that you want to monitor.
The Agent Type list refreshes. If you have deployed the MQ Agent package to that host, the MQAgent appears in the list.
4
In the Agent Type list, select MQAgent.
5
In the Instance Name box, type a name for the MQ Agent instance.
Tip
Each MQ queue manager that you want to monitor must have its own agent instance, so consider using queue manager names in agent instance names to emphasis that relationship. For example: MQAgent_QueueManager_on_HostName.
6
Click Create.
The Create Agent dialog box closes and the Create Agent Results dialog box opens, showing the status of the agent creation. A green check mark in the Status column indicates that the agent was created successfully.
7
Click OK to close the Create Agent Results dialog box.
The Agent Status dashboard refreshes, and the newly-created MQ Agent instance appears in the list.
Next, edit the MQ Agent properties. For more information, see Setting MQ Agent properties .

Upgrading Foglight for IBM WebSphere MQ Server

If you have been using version 5.5.5 or later of Foglight for IBM WebSphere MQ Server (or the Foglight Cartridge for IBM WebSphere MQ Server), you can upgrade to the latest version instead of performing a completely new installation.
To upgrade Foglight for IBM WebSphere MQ Server, you must first deactivate any existing agents, and then install version 5.5.5.9 of the cartridge as you would a new Foglight for IBM WebSphere MQ Server. Do not delete the older version of the .car file.
To upgrade Foglight for IBM WebSphere MQ Server
1
On the Agent Status page, deactivate all existing MQ Agent instances.
2
Install and enable the new cartridge.
3
Deploy the new MQ Agent package to each monitored host.
4
Activate the MQ Agent instances and start data collection.
For detailed information on upgrade compatibility, see the Foglight for IBM WebSphere MQ Server Release Notes.
 

Setting MQ Agent properties

The MQ Agent provides an effective monitoring solution for the distributed IBM WebSphere MQ infrastructure. It collects data from the distributed IBM WebSphere MQ infrastructure and sends it to Foglight for IBM WebSphere MQ Server. The agent keeps track of MQ objects such as queue managers, queues, channels and listeners. This solution uses a messaging infrastructure to alert you before end-users are affected.
When an agent connects to Foglight, it is provided with sets of properties that it uses to configure its correct running state. Each agent is provided with a combination of two types of properties: agent properties and shareable properties.
Default versions of these properties are installed with the Foglight for IBM WebSphere MQ Server. However, you can edit the default shareable and agent properties, configure agent properties that apply only to a specific agent instance, and create edited clones of shareable properties that are used by a subset of agents of a certain type.
For more information about working with agent properties, see the Foglight Administration and Configuration Guide.
Each queue manager that you want to monitor requires its own MQ Agent instance.
 
* 
IMPORTANT: A technical limitation currently restricts the number of monitored queues for each Agent Manager to 1000. Ensure that this limit is adhered to when monitoring multiple queue managers from the same Foglight for IBM WebSphere MQ Server Agent Manager.
The configuration of agent properties described in this section include:
•
Identity properties
•
Connection properties
•
SSL properties
•
Discovery properties
•
Monitor lists properties
•
Event properties
•
Statistics events properties
•
Listener monitoring property
•
Advanced (batch) properties
•
Data collection scheduler property
Modify the properties for each MQ Agent instance. An MQ Agent instance can have a combination of global and private properties. Global properties apply to all instances of the agent type while private properties apply only to specific agent instances.
To modify agent properties:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select the instance of the MQ Agent whose properties you want to modify and click Edit Properties.
 
* 
IMPORTANT: Another way of editing MQ Agent properties is through the Agent Properties dashboard. However, keep in mind that the properties you specify on this dashboard apply to all instances of the MQ Agent type. To ensure that you are editing properties for a particular agent instance, without overwriting any properties for other MQ Agent instances, use the Agent Status dashboard instead of the Agent Properties dashboard.
3
Click Modify the private properties for this agent.
A list of agent properties appears in the display area.

Identity properties

The MQ Agent provides an effective monitoring solution for the distributed IBM WebSphere MQ infrastructure. It collects data from the distributed IBM WebSphere MQ infrastructure and sends it to Foglight for IBM WebSphere MQ Server. The agent keeps track of MQ objects such as queue managers, queues, channels and listeners. This solution uses a messaging infrastructure to alert you before end-users are affected.
When an agent connects to Foglight, it is provided with sets of properties that it uses to configure its correct running state. Each agent is provided with a combination of two types of properties: agent properties and shareable properties.
Default versions of these properties are installed with the Foglight for IBM WebSphere MQ Server. However, you can edit the default shareable and agent properties, configure agent properties that apply only to a specific agent instance, and create edited clones of shareable properties that are used by a subset of agents of a certain type.
For more information about working with agent properties, see the Foglight Administration and Configuration Guide.
Each queue manager that you want to monitor requires its own MQ Agent instance.
 
* 
IMPORTANT: A technical limitation currently restricts the number of monitored queues for each Agent Manager to 1000. Ensure that this limit is adhered to when monitoring multiple queue managers from the same Foglight for IBM WebSphere MQ Server Agent Manager.
The configuration of agent properties described in this section include:
•
Identity properties
•
Connection properties
•
SSL properties
•
Discovery properties
•
Monitor lists properties
•
Event properties
•
Statistics events properties
•
Listener monitoring property
•
Advanced (batch) properties
•
Data collection scheduler property
Modify the properties for each MQ Agent instance. An MQ Agent instance can have a combination of global and private properties. Global properties apply to all instances of the agent type while private properties apply only to specific agent instances.
To modify agent properties:
1
On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.
2
On the Agent Status dashboard, select the instance of the MQ Agent whose properties you want to modify and click Edit Properties.
 
* 
IMPORTANT: Another way of editing MQ Agent properties is through the Agent Properties dashboard. However, keep in mind that the properties you specify on this dashboard apply to all instances of the MQ Agent type. To ensure that you are editing properties for a particular agent instance, without overwriting any properties for other MQ Agent instances, use the Agent Status dashboard instead of the Agent Properties dashboard.
3
Click Modify the private properties for this agent.
A list of agent properties appears in the display area.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating