Configuring Web server plug-ins

Why and when to perform this task

See Web server plug-in policy for WebSphere Application Server for information about how to verify what V4.0, V5.0, V5.1 and V6.0 plug-in versions are installed on local or remote Web servers, and how to determine if the installation complies with supported configurations.

Web server plug-ins are included with the WebSphere Application Server for z/OS product. These plug-in can be used to forward requests for Web applications from a supported Web server to a WebSphere Application Server for z/OS Web container. A WebSphere Application Server Configuring transports provides the connection between the Web server plug-in and the Web container.

In a WebSphere Application Server for z/OS environment, it is faster to directly use the HTTP transport than to configure Web server plug-ins. However, you might want to use the Web server plug-ins if you are looking for easier configuration of new application servers or applications within a cluster.

To configure a Web server plug-in:

Steps for this task

  1. Install a supported Web server if one is not already installed.
    See WebSphere Application Server Supported hardware and software for a complete list of supported Web servers.
  2. Configure your Web server.
    Refer to your Web server documentation for information on configuring your Web server.

    Ensure that Web servers are configured to perform operations required by Web applications, such as GET and POST. Typically, this involves setting a directive in the Web server configuration file (such as httpd.conf for IBM HTTP Server). Refer to the Web server documentation for instructions. If an operation is not enabled when a servlet or JSP file requiring the operation is accessed, an error message displays, such as this one from IBM HTTP Server:

    IMW0093E Method POST is disabled on this server

  3. If you encounter problems starting your Web server, check the plug-in log file in the WebSphere logs directory for information on what portion of the plug-in configuration file contained the error. The log file states the line number on which the error occurred along with other details that might help you diagnose why the Web server did not start. A frequent reason for a Web server not starting is an improper entry in a plug-in configuration file.
  4. Install either the WebSphere HTTP Plug-in for z/OS, or a WebSphere plug-in for a Web server that is running on a distributed platform..
  5. Check the version of your IBM HTTP Server installation.
  6. Regenerate the plug-in configuration or manually edit the plug-in configuration file.. After changing configurations to plug-ins, transports or virtual hosts, you must regenerate your Web server plug-in for the changes to take effect.

Related concepts
Transports
Web server plug-in remote user information processing
Web server plug-ins
Related tasks
Configuring transports
Changing the HTTP plug-in configuration
Related reference
plugin-cfg.xml file
Supported distributed platform Web server plug-in configurations
Plug-ins: Resources for learning



Searchable topic ID:   trun_plugin
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/twsv_plugin.html

Library | Support | Terms of Use | Feedback