Configuring a WebSphere Application Server proxy server for dashboards

If you use a WebSphere Application Server proxy server, make sure that all the modules are enabled for the proxy server so that dashboards work in your IBM® Business Monitor environment.

Before you begin

Before you configure WebSphere Application Server proxy server to work with dashboards, complete the following steps:
  1. Make sure that you have applied the latest version of WebSphere Application Server.
  2. Create a proxy server (click Servers > Server Types > WebSphere proxy servers). For more information, see Setting up the proxy server in the WebSphere Application Server information center.
  3. Make sure that the HTTP protocol is selected.

Procedure

  1. Optional: Make sure that modules are mapped to the WebSphere Application Server proxy server. For each of the applications that dashboards require, verify that the modules are enabled for the proxy server.
    1. Log on to the administrative console as an administrative user.
    2. Select Applications > Application Types > WebSphere enterprise applications.
    3. From the Enterprise Applications panel, select the name of the application.
      Check the following applications. You might have some or all applications in this list, based on which products you are using with Business Space.
      • For all products, select the following applications:
        • BSpaceEAR_nodename_servername
        • BSpaceForms_nodename_servername
        • BSpaceHelp_nodename_servername
        • BusinessSpaceHelpEAR_nodename_servername
        • REST Services Gateway
        • mm.was_nodename_servername
        • PageBuilder2_nodename_servername
      • For IBM Business Monitor, select the following applications:
        • HumanTaskManagementWidgets_nodename_servername
        • WBMDashboardWeb_nodename_servername
    4. For each application, if you click the name of the application, then Virtual hosts, verify that it uses the value default_host.
    5. For each application, on the Configuration tab, under Modules, click Manage Modules, then on the Manage Modules page for the application, click each module, and select Web Module Proxy Configuration and verify that Enable Proxy is selected.
  2. Verify that the host name alias default_host contains the correct information for every cluster member, web server, or proxy server.
    1. Log on to the administrative console as an administrative user.
    2. Select Servers > Server Types > WebSphere application servers.
    3. For every cluster member, select the name of the application server to view the port number for the WC_defaulthost port name.
      • Under Communications, expand Ports.
      • Note the port number for the WC_defaulthost port.
    4. From the left navigation area of the administrative console, select Environment > Virtual hosts.
    5. Click default_host.
    6. Under Additional Properties, click Host Aliases.
    7. If the host name and port number for the cluster members is not displayed in the list, click New to add the missing entry to the list. You can use the wildcard character * (asterisk) for the host name.
    8. If you add a new entry, click Save and then click Synchronize.
  3. To use HTTP protocol, configure the WebSphere Application Server proxy server.
    1. Log on to the administrative console as an administrative user.
    2. Select Servers > Server Types > WebSphere proxy servers, and then select the proxy server that you previously created.
    3. Expand HTTP Proxy Server Settings and click Proxy settings.
    4. Click Custom Properties and add a new property with a name of cache.query.string for a name and a value of true.
    5. Click Save, and then restart the proxy server.