HCL Workload Automation, Version 9.4

Preparing the HTTP server for high availability

Install the IBM HTTP Server and configure the Web server plug-in for passing requests to the Jazz™ for Service Management application server that are part of the high availability configuration.

Before you begin

The IBM HTTP Server uses a web server plug-in to forward HTTP requests to the Jazz for Service Management application server. You can configure the HTTP server and the web server plug-in to act as the high availability server, that is, pass requests (HTTP or HTTPS) to one of any number of nodes. The high availability methods that are supported by the plug-in are round robin and random.
  • With a round robin configuration, when a browser connects to the HTTP server, it is directed to one of the configured nodes. When another browser connects, it is directed to a different node.
  • With the random setting, each browser is connected randomly to a node. When a connection is established between a browser and a particular node, that connection remains until the user logs out or the browser is closed.
The HTTP server is necessary for directing traffic from browsers to the applications that run in the Dashboard Application Services Hub environment. The server is installed between the console and the Jazz for Service Management application server, and is outside the firewall.

The web server plug-in uses the plugin-cfg.xml configuration file to determine whether a request is for the Jazz for Service Management application server.

About this task

Complete this procedure to configure the web server plug-in for obtaining high availability for each node.


  1. If IBM HTTP Server Version 8.5 is not installed, install it before you proceed. It must be installed where it can be accessed from the Internet or intranet (or both).
    Note: Jazz for Service Management bundles the WebSphere Application Server Version 8.5 Supplements installation media, which contains the installation packages for IBM HTTP Server and the IBM HTTP Server plug-in for IBM® WebSphere Application Server. If you do not have the DVDs, you can download the electronic images for Jazz for Service Management from IBM Passport Advantage®. See Downloading Jazz for Service Management.
  2. Install IBM HTTP Server ensuring that you include the IBM HTTP Server Plug-in for IBM WebSphere Application Server option. For more information, see Installing, updating, rolling back, and uninstalling IBM HTTP Server.
  3. Create a CMS-type key database. For more information, see Creating a new key database using the command-line interface.
  4. Create a self-signed certificate to allow SSL connections between nodes. For more information, see Creating a self-signed certificate.
  5. To enable SSL communications for the IBM HTTP Server, in a text editor, open HTTP_server_install_dir/conf/httpd.conf. Locate the line # End of example SSL configuration and add the following lines, ensuring that the KeyFile line references the key database file that was created in step 3 and save your changes.
    LoadModule ibm_ssl_module modules/mod_ibm_ssl.so
    Listen 443
    <VirtualHost *:443>
    SSLProtocolDisable SSLv2
    ErrorLog "C:/Program Files (x86)/HCL/HTTPServer/logs/sslerror.log"
    TransferLog "C:/Program Files (x86)/HCL/HTTPServer/logs/sslaccess.log"
    KeyFile "C:/Program Files (x86)/HCL/WebSphere/Plugins_1/etc/plugin-key.kdb"
    SSLStashfile "C:/Program Files (x86)/HCL/WebSphere/Plugins_1/etc/plugin-key.sth"
    For more information, see the first example at Securing with SSL communications.
  6. Restart the IBM HTTP Server, For more information, see Starting and stopping IBM HTTP Server.
  7. On the IBM HTTP Server computer, to verify that SSL is enabled ensure that you can access https://localhost.
  8. Stop and restart the Jazz for Service Management application server:
    1. In the JazzSM_WAS_Profile/bin directory, for a server named server1, run the following command:
      On Windows
      stopServer.bat server1
      On UNIX
      stopServer.sh server1
      Note: You are prompted to provide an administrator username and password.
    2. In the JazzSM_WAS_Profile/bin directory, for a server named server1, run the following command:
      On Windows
      startServer.bat server1
      On UNIX
      startServer.sh server1
  9. Start the HTTP server:
    1. Change to the directory where it is installed.
    2. Run this command: bin/apachectl start Note you must restart the server after you change the plugin-cfg.xml file.

What to do next

Enter the URL for the HTTP Server in a browser http://HTTP_server_host/HTTP_server_port and it is forwarded to one of the nodes.
Note: The default high availability method is random, whereby each browser is connected randomly to a node.