Defining a sample configuration
We can use the Define sample configuration wizard to reconfigure your queue manager, making it suitable for the MQ Telemetry feature. The sample configuration defines and starts the MQXR service, defines the transmit queue, and creates a sample telemetry channel.
Before you begin
Before you run the Define sample configuration wizard:
- You must install the IBM MQ Telemetry feature on the computer.
- You must be willing to let the wizard reconfigure your queue manager. If you are unsure of the implications, create a new queue manager solely for this purpose, or see Implications of running the sample configuration.
About this task
By using the sample configuration to get started, we can set up a basic configuration on your computer so that we can explore the telemetry features. We cannot run the sample configuration twice on the same queue manager unless you remove one or more of the IBM MQ object definitions created. When an object definition created by the sample configuration is deleted, running the wizard again only re-creates that missing object.
Procedure
- From the Telemetry welcome page, click Define sample configuration. The Define sample configuration wizard opens.
- Review the list of actions that will occur on completion of this wizard, and click Finish.
Results
The Define sample configuration wizard performs the following actions and creates the appropriate resources:
- Defines and starts the MQXR service.
- Defines the default transmit queue.
- Allows Guest on Windows systems, and nobody on Linux systems, to send messages to clients connected to the MQTT listener.
- Allows Guest on Windows systems, and nobody on Linux systems, to both publish on and subscribe to any topic.
- Defines a sample telemetry channel.
Also, the Define sample configuration link on the Telemetry welcome page is replaced by The sample configuration has been set up for this queue manager. This is the first form of visual verification that the sample configuration was set up properly.
What to do next
We can view the sample telemetry channel that the wizard created by expanding the Telemetry folder and clicking the Channels folder.
If you remove one of the definitions created by the sample configuration wizard, we can run the wizard again. The wizard creates the same resource that you deleted and informs you in the summary section.