IBM MQ v9.0.1, the IBM MQ Console is now available across a wide range of platforms as an install able feature, including on MQ Appliance and on MQ on z/OS.

The IBM MQ Console is a web-based user interface that can be used to perform common administration tasks.You can create, delete, start and stop queue managers, as well as manage many MQ objects like queues, channels and listeners. It also allows you to create charts from resource monitoring data on system topics. Those of you familiar with the MQ Console that shipped on the Appliance will notice that we’ve refreshed the design and some internal changes means the UI in general should feel more responsive.

By configuring security to provide the user with the read only role, it will allow them to access the MQ Console but they will be unable to perform any destructive actions, such as creating or deleting objects, or stopping queue mangers. The UI will detect that a user has this role and will hide these actions from them.Additionally, if you require more fine grained control over authorization, a user can be configured to use the MQ authorization model when authenticating actions against a queue manager.


In this article, I will talk about how to configure IBM MQ Console on Windows environment:

1) Download IBM MQ v9.0.1.0 from following link:

2) Install the IBM MQ console and the REST API component, by selecting the Web Administration feature.

3) Configure basic security to allow users and groups to access the IBM MQ Console. Copy the basic_registry.xml file from the C:\Program Files\IBM\MQ\web\mq\samp\configuration directory and place the sample XML file in the C:\Program Files (x86)\IBM\WebSphere MQ\web\installations\Installation1\servers\mqweb directory. Rename the sample XML file to mqwebuser.xml.

4) By default the IBM MQ Console can be accessed only on the system on which the IBM MQ Console and administrative REST API are installed. To allow remote connections to the mqweb server by editing the mqwebuser.xml file.

Add the following XML to the mqwebuser.xml file, within the tags:

where hostname specifies the IP address, DNS host name of the server where IBM MQ is installed. Use an asterisk, *, to specify all available network interfaces.

5) Enter strmqweb command on the command line:
strmqweb command will start the mqweb server that supports the IBM MQ Console and administrative REST API.

6)From a web browser, launch the following URL: https://localhost:9443/ibmmq/console and connect to the IBM MQ Console.

7) Log in to the IBM MQ Console by entering user name and password as “admin”.

3 comments on"Configure IBM MQ Console"

  1. SatendraNNegi January 13, 2018


    Its working at the log in , admin / admin or mqadmin/mqadmin both are not working !! any help ?

    • Same problem here, for MQ 9.0.4 , I am unable to login to Webconsole with any of the user

  2. Great Help. I followed this article with[continues delivery edition] and all went fine on linux system – RHEL 7 , able to login with mqadmin & mqreader user.

Join The Discussion

Your email address will not be published. Required fields are marked *