Switching between console types

You can switch between the New Web Console (which is the default web console for IBM® MQ 9.2) and the Dashboard Web Console (which was the web console for earlier versions of IBM MQ).

About this task

You switch between consoles by using the setmqweb command.

If you switch back to using the Dashboard Web Console, consult The Dashboard Web Console in the IBM MQ 9.1 documentation. for usage instructions.

To complete this task, you must be a user with certain privileges so that you can use the dspmqweb and setmqweb commands:

On z/OS®, you must have authority to run the dspmqweb and setmqweb commands, and write access to the mqwebuser.xml file.
On all other operating systems, you must be a privileged user.

Attention:

Before issuing either the setmqweb or dspmqweb commands on z/OS, you must set the WLP_USER_DIR environment variable, so that the variable points to your mqweb server configuration.

To do this, issue 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.

Procedure

To switch to the Dashboard Web Console, use the following commands:
- Set the mqConsoleEnableUnsafeInline property to true by entering the following command:
```
setmqweb properties -k mqConsoleEnableUnsafeInline -v true
```
  Note that setting this property relaxes the CSP ruleset to enable unsafe-inline, which might make your configuration less secure, but is required by the Dashboard Web Console
- Switch the mqweb server to use the Dashboard Web Console by entering the following command:
```
setmqweb properties -k mqConsoleEarName -v com.ibm.mq.console
```
To revert to the default settings for the mq web server (which includes the New Web Console), use the following command:
```
setmqweb properties -r
```
To revert to the New Web Console while preserving any other customizations you have made to the mqweb server, use the following commands:
- Set the mqConsoleEnableUnsafeInline property to false to restore the security configuration by entering the following command:
```
setmqweb properties -k mqConsoleEnableUnsafeInline -v false
```
- Switch the mqweb server to use the New Web Console by entering the following command:
```
setmqweb properties -k mqConsoleEarName -v com.ibm.mq.webconsole
```