WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Configuring the web user interface server

To enable access to broker resources through the web user interface, configure the WebSphere® Message Broker web user interface server.

To configure a web user interface server, complete the following steps:

  1. Configure the properties relating to the HTTP or HTTPS port to be used, and enable the web user interface server, by using the WebSphere Message Broker Explorer or the mqsichangeproperties command.
    • If you are using the WebSphere Message Broker Explorer, complete the following steps:
      1. In the MQ Explorer - Navigator view, navigate to IBM WebSphere MQ > Brokers, right-click your broker name, and select Properties.
      2. Select the WebAdmin tab.
      3. Enable the web user interface and set the port to use for your chosen protocol.

        If you are using HTTP, set Enabled to true, set Enabled SSL to false, and enter a value for the HTTP Port.

        If you are using HTTPS, set Enabled to true, set Enabled SSL to true, and enter a value for the HTTPS Port.

        To set additional parameters for the HTTPS protocol, you must use the command-line interface. For more information, see Parameter values for the webadmin component.

      4. To review your changes, click Apply; to close the Properties window, click OK. You can also confirm the changes by examining recent Change Notification entries in the Administration Log view.
    • If you are using the mqsichangeproperties command, complete the following steps:
      1. Configure the properties relating to the HTTP or HTTPS port to be used.
        • If you are using HTTP, run the following command:
          mqsichangeproperties brokerName 
          -b webadmin -o HTTPConnector -n port -v portValue
          • brokerName is the name of your broker
          • portValue is the HTTP port value that you want to use for the web user interface
        • If you are using HTTPS, run the following command:
          mqsichangeproperties brokerName 
          -b webadmin -o HTTPSConnector -n port,keystoreFile,keystorePass 
          -v portValue,fileName,password
          • brokerName is the name of your broker.
          • portValue is the HTTPS port value that you want to use for the web user interface.
          • fileName is your keystore file.
          • password is the password for the keystore file.

        For more information about the properties that can be set for the HTTPConnector and HTTPSConnector objects, see Parameter values for the webadmin component.

      2. Confirm that the properties are set correctly.
        • If you are using HTTP, run the following command:
          mqsireportproperties brokerName 
          -b webadmin -o HTTPConnector -a
        • If you are using HTTPS, run the following command:
          mqsireportproperties brokerName 
          -b webadmin -o HTTPSConnector -a
        This command produces a response similar to this example (for the HTTPConnector):
        HTTPConnector
          uuid='HTTPConnector'
          address=''
          port='4144'
          maxPostSize=''
          acceptCount=''
          compressableMimeTypes=''
          compression=''
          connectionLinger=''
          connectionTimeout=''
          maxHttpHeaderSize=''
          maxKeepAliveRequests=''
          maxThreads=''
          minSpareThreads=''
          noCompressionUserAgents='
          restrictedUserAgents=''
          socketBuffer=''
          tcpNoDelay=''
          enableLookups='false'
      3. Enable the web user interface server for the broker:
        • To enable the web user interface, and to use HTTP as the communication protocol between the broker and the web user interface server, run the following command on a WebSphere Message Broker command line, where brokerName is the name of your broker:
          mqsichangeproperties brokerName 
          -b webadmin -o server -n enabled,enableSSL -v true,false
        • To enable the web user interface, and to use HTTPS as the protocol for communication between the broker and the web user interface server, run the following command:
          mqsichangeproperties brokerName 
          -b webadmin -o server -n enabled,enableSSL -v true,true

        For more information about the properties of the web user interface server, see Parameter values for the webadmin component.

      4. Confirm that the web user interface component is enabled by running the mqsireportproperties command, as shown in the following example.
        mqsireportproperties brokerName -b webadmin -o server -a
        This command produces a response similar to this example:
        server=''
          uuid='server'
          enabled='true'
          enableSSL='true'
  2. To ensure that the changes take effect, restart the broker. For more information, see Starting and stopping a broker.
  3. Create a web user account by using the mqsiwebuseradmin command. For more information, see Managing web user accounts.
When you have configured a web user interface server, you can log on to the web user interface by following the steps described in Accessing the web user interface.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:14


Task topicTask topic | Version 8.0.0.7 | bj23620_