Extension preferences

The extension requires some configuration to determine what it monitors, and where the monitored resources are. At a minimum, the extension needs to know the name of the WebSphere MB Broker it should monitor, and which messaging transport it can subscribe to in order to collect statistical data.

For an IIB v10 or higher broker not using WebSphere MQ, the minimum information required would be:

• Broker name
• MQTT Server port

Otherwise, the minimum information required would be:

• Broker Name
• WebSphere MQ Queue Manager name

These can be set using the agentpref command line tool.

The following can be used to configure monitoring of a broker that is not using WebSphere MQ:

agentpref --set "com.bmc.mmpa.wmb.monitor" –-pref_path ComMQSoftwareWebSphereMBBroker <MQTTServer> MQTTPort <PortNo>

where:

<MQTTServer> is the MQTT server name
<PortNo> is the port of the local MQTT server (11883 is the default)

For example, the following can be used to configure monitoring of a broker that is using WebSphere MQ:

agentpref --set "com.bmc.mmpa.wmb.monitor" –-pref_path ComMQSoftwareWebSphereMBBroker <WMQBroker> WMQQMgrName <IIBQMGR>

where:

<WMQBroker> is the broker name
<IIBQMGR> is the local queue manager name.

Additional preferences allow for more detailed configuration of the extension.

• Messaging Transport Preferences
• WebSphereMQ preferences, for brokers publishing operational events via WebSphereMQ
• Define local or remote queue manager
• Provide security configuration or credentials
• MQTT preferences, for brokers publishing operational event via an MQTT Server
• Define local or remote MQTT server
• Provide security configuration or credentials
• Control communications with the broker via the CMP API (Integration API in IIBv10)
• Control collection of resource and message flow statistics
• Control filtering of resource managers and configurable services
• Control handling of received statistics

The topics in this section describe all available preferences in detail. The same information is provided by the agentpref command line tool (use the --list-preferences option).