Verifying the installation of IBM MQ Telemetry by using MQ Explorer
Use the Define sample configuration wizard and the MQTT client utility in MQ Explorer to verify that the IBM® MQ Telemetry components have installed. Also check that publish/subscribe works correctly.
Before you begin
The IBM MQ Telemetry runtime and support for MQ Explorer must be installed. The telemetry folder is part of a queue manager. To view the telemetry folder, you must start a queue manager.
Before running the define sample configuration wizard on an existing queue manager, review the information provided by the wizard about the configuration changes that are made. The changes might have implications for the configuration of the existing queue manager. Alternatively, run the sample configuration wizard on a newly created queue manager to avoid changing any security settings.
About this task
To configure IBM MQ Telemetry there is a define sample configuration wizard that can be run from MQ Explorer. The wizard runs through a series of steps, including defining and starting the telemetry (MQXR) service, setting up the default transmission queue, and configuring a telemetry channel.
If you would prefer to do this manually, see Configuring a queue manager for telemetry on Linux® and AIX® . For Windows, see Configuring a queue manager for telemetry on Windows .
You can open the define sample configuration wizard from the IBM MQ Telemetry Welcome page in MQ Explorer. The wizard determines which steps are required based on the current configuration.
For example, the following actions might be specified by the wizard:
- Define the telemetry (MQXR) service.
- Start the telemetry (MQXR) service.
- Define the telemetry transmit queue.
- Set the default transmit queue of the queue manager to SYSTEM.MQTT.TRANSMIT.QUEUE.
If telemetry is already configured for this queue manager, the link to open the wizard is replaced with static text. The text confirms that the sample configuration has been set up.
After the configuration has finished, you can use MQ Explorer to open the MQTT client utility. Use the MQTT client utility to verify that IBM MQ Telemetry is set up correctly.
The following items summarize the main goals that can be achieved using the MQTT client utility:
- Validation of a basic or custom IBM MQ Telemetry configuration by connecting, subscribing to topics and publishing messages.
- Showcases the main features of MQTT protocol.
- Provides a simple tool to aid in debugging IBM MQ Telemetry applications.
You can find additional information within the MQ Explorer by using the Help menu or pressing the F1 key.
Procedure
Results
If the publish/subscribe finishes successfully, the IBM MQ Telemetry installation is verified.
If you encounter problems during the installation process, view the error log:
- On Windows, the default location for this log is, WebSphere MQ data directory\qmgrs\qMgrName\mqxr
- On AIX and Linux, the default location for this log is, /var/mqm/qmgrs/qMgrName/mqxr/