Defining the MQXR service manually on Linux®

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

  1. In the Navigator view, right-click the Services folder.
  2. Click New > Service to open the New Service Definition wizard.
  3. In the Name field, type SYSTEM.MQXR.SERVICE and click Next.
  4. In the Description field type a description of the service (for example, Manages clients using MQXR protocols such as MQTT).
  5. Select an option from the Service control menu.
  6. In the Start command field, type +MQ_INSTALL_PATH+/mqxr/bin/runMQXRService.sh
  7. 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.
  8. In the Stop command field, type +MQ_INSTALL_PATH+/mqxr/bin/endMQXRService.sh
  9. In the Stop args field, type -m +QMNAME+
  10. In the StdOut field, type +MQ_Q_MGR_DATA_PATH+/mqxr.stdout
  11. In the StdErr field, type +MQ_Q_MGR_DATA_PATH+/mqxr.stderr
  12. Select Server from the Service type menu.
  13. 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.