Verifying the installation of MQ Telemetry by using IBM MQ Explorer
Use the Define sample configuration wizard and the MQTT client utility in IBM® MQ Explorer to verify that the MQ Telemetry components have installed. Also check that publish/subscribe works correctly.
Before you begin
The MQ Telemetry runtime and support for IBM 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 MQ Telemetry there is a define sample configuration wizard that can be run from IBM 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 MQ Telemetry Welcome page in IBM 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 IBM MQ Explorer to open the MQTT client utility. Use the MQTT client utility to verify that 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 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 MQ Telemetry applications.
You can find additional information within the IBM MQ Explorer by using the Help menu or pressing the F1 key.
Procedure
Results
If the publish/subscribe finishes successfully, the 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, IBM MQ data directory\qmgrs\qMgrName\mqxr
- On AIX and Linux, the default location for this log is, /var/mqm/qmgrs/qMgrName/mqxr/