Getting started with the web console

Get started quickly with the web console.

Before starting

To complete this task, we must be a user with certain privileges so that we can use the dspmqweb command:

• On z/OS, we must have authority to run the dspmqweb command, and write access to the mqwebuser.xml file.
• On all other operating systems, we must be a privileged user.

Procedure

1. If the mqweb server is not already configured for use by the web console, configure the mqweb server. For more information about creating a basic configuration for the mqweb server with a basic registry, see Basic configuration for the mqweb server.
2. On z/OS, set the WLP_USER_DIR environment variable so that we can use the dspmqweb command. Set the variable to point to your mqweb server configuration by entering the following command:

   export WLP_USER_DIR=WLP_user_directory

   where WLP_user_directory is the name of the directory that is passed to crtmqweb. For example:

   export WLP_USER_DIR=/var/mqm/web/installation1

   For more information, see Create the mqweb server.

3. Determine the URI for the web console by entering the following command:

   dspmqweb status

   The command generates an output similar to the following:

   MQWB1124I: Server 'mqweb' is running.
      URLS:
      https://localhost:9443/ibmmq/rest/v1/
      https://localhost:9443/ibmmq/console/

   The URI for the web console ends with the suffix console/.

4. Connect to the web console by entering the URL from 3 in a browser.

   A security exception might be produced by the browser because the default certificate that is provided with the mqweb server is not a trusted certificate. Choose to proceed to the web console .

5. Log in to the web console. Use the user name mqadmin, and the password mqadmin.

What to do next

By default, the web console uses token-based authentication to authenticate users. We can also use client certificate authentication. For more information, see Use client certificate authentication with the REST API and Web Console.

• Restrictions on z/OS
  The following restrictions apply when using the IBM MQ Console to manage queue managers on z/OS.
• Restrictions on IBM MQ for Multiplatforms
  The following restrictions apply when using the IBM MQ Console to manage queue managers on IBM MQ for Multiplatforms.

Parent topic: Administration using a web console