Switching between console types

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

About this task

You switch between consoles by using the setmqweb command.

If you switch back to using the Dashboard Web Console, consult the IBM MQ Appliance 9.1.0 documentation for usage instructions (https://www.ibm.com/docs/SS5K6E_9.1.0/com.ibm.mqa.doc/administering/ad00010_.html).

Procedure

  • To switch to the Dashboard Web Console, enter the following commands at the mqcli prompt:
    • Set the mqConsoleEnableUnsafeInline property to true:
      setmqweb properties -k mqConsoleEnableUnsafeInline -v true
      Note: 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:
      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), enter the following command at the mqcli prompt:
    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

What to do next

After following any of those steps, you must restart the appliance, see Restarting the appliance.