You can define the MQXR service manually by using IBM® MQ Explorer.
A queue manager can have only one instance
of the MQXR service defined.
Before you begin
- Install the MQ Telemetry feature.
Procedure
- In the Navigator view, right-click the Services folder.
- Click to open the New Service Definition wizard.
- In the Name field, type SYSTEM.MQXR.SERVICE and
click Next.
- In the Description field, type
a description of the service (for example, Manages clients
using MQXR protocols such as MQTT).
- Select an option from the Service control menu.
- In the Start command field, type +MQ_INSTALL_PATH+\mqxr\bin\runMQXRService.bat
- In the Start args field, enter the
following text. You must edit the details of the -sf option to specify the
location of your credentials key file. This key file is used to encrypt passphrase for MQTT TLS
channels:
STARTARG('-m +QMNAME+ -d "+MQ_Q_MGR_DATA_PATH+" -g "+MQ_DATA_PATH+" -sf "C:\pathToKeyfile\keyfile.txt"')
To use the default key file, use
-sf "[DEFAULT]"
CAUTION:
The default initial key is the same for all IBM MQ installations. To protect passwords securely, supply an
initial key that is unique to your installation when you encrypt passwords.
For more information about the
-sf option, see
Encrypting passphrases for MQTT TLS channels.
- In the Stop command field, type +MQ_INSTALL_PATH+\mqxr\bin\endMQXRService.bat
- In the Stop args field, type -m
+QMNAME+
- In the StdOut field, type +MQ_Q_MGR_DATA_PATH+\mqxr.stdout
- In the StdErr field, type +MQ_Q_MGR_DATA_PATH+\mqxr.stderr
- Select Server from the Service
type menu.
- Click Finish.
Results
The MQXR service is created. To view the MQXR service in
the Navigator view click the Services folder.
Ensure the Show System Objects option is selected,
and navigate to the service.
In this task, the service is called SYSTEM.MQXR.SERVICE.