Adding a plug-in configuration to a web server

You can configure a web server plug-in to receive an HTTP request for dynamic resources. You can forward the request to the Liberty server, which provides high-availability and workload balancing through the web server plug-in.

Before you begin

  1. Install a supported web server, such as the IBM® HTTP Server that is included with IBM WebSphere® Application Server.

    For more information, see the Configuring IBM HTTP Server for WebSphere Liberty support document.

  2. Install the web server plug-ins.

    To install the web server plug-in, see Configuring web server plug-ins in the documentation for WebSphere Application Server traditional.

About this task

A web server plug-in is used to forward HTTP requests from a supported web server to one or more application servers. The plug-in checks the request against configuration data in the plugin-cfg.xml file. The configuration data maps the URI for the HTTP request to the hostname of an application server. The web server plug-in then uses this information to forward the request to the application server.

The procedure applies to Liberty servers not in a collective.

Procedure

  1. Distributed: [AIX MacOS Linux Windows] Configure the web server plug-in for your chosen web server.

    If IBM HTTP Server is installed with IBM Installation Manager, run the <IHS_ROOT>/bin/simple.pct{.sh|bat} script to configure an instance of the Web Server Plug-ins for IBM WebSphere Application Server.

  2. Copy the plugin-cfg.xml file from the Liberty server ${server.config.dir}/logs/state/ subdirectory to the config/webserver1/ directory under the Web Server Plug-ins for IBM WebSphere Application Server installation root.
    For more information, see Configuring IBM HTTP Server for WebSphere Liberty.
  3. Optional: If you want the web server plug-in to forward HTTP requests to more than one Liberty server, repeat the previous steps for each additional server. Consolidate all the plug-in configurations into one plugin-cfg.xml file.

    To merge plug-in configurations, you can use one of the following tools: