Why and when to perform this task
Web server plug-ins for distributed platform Web servers are no longer shipped with the WebSphere Application Server for z/OS product. Use the installation CD for WebSphere Application Server or WebSphere Application Server Network Deployment V5 for distributed platforms to install these Web server plug-ins.Note: If you do not have a copy of Version 5 of the WebSphere Application Server or WebSphere Application Server Network Deployment for distributed platforms product, you must request a not-for-resale copy from IBM.
Once you have the application server, the Web server and the plug-in properly configured, requests can be routed from a browser, through that Web server and plug-in, to one of the application server J2EE server instances defined in the ServerGroup element in the plugin-cfg.xml file. New requests are sent to randomly selected server instances, but once a session is established, requests will get routed back to the correct HTTP or HTTPS internal transport the J2EE server Web container assigned to the original request.
WebSphere plug-ins for Web servers, in addition to regular plug-in functions, enable you to use private headers as a mechanism for forwarding proxy information from these plug-ins to the WebSphere Application Server for z/OS Web container. This information is not otherwise included with the HTTP and HTTPS requests.
Steps for this task
Note: If you have WebSphere Application Server Network Deployment V5 or later for distributed platforms installed on your workstation, you can use the IBM HTTP Server that is provided with that product, and the Web server plug-in that is appropriate for that Web server.
Once the plug-in files are installed on the Web server, update the Web server configuration file on the workstation with the location of the plug-in and plug-in configuration file. For Windows systems, also add user_install_part to the PATH statement.
Specific instructions for configuring plug-ins within a Web server configuration file are contained in the documentation for each Web server.
Both methods will create the plug-in configuration file, plugin-cfg.xml, in EBCDIC format, which is the proper format for execution in a z/OS environment.
To use the Update Web Server Plug-in Configuration page in the administrative console:
You can set the TrustedProxy property to true from either the Web container Custom Properties page or the HTTP Transport Custom Properties page. If you set it on the Web container Custom Properties page, all transports will support private headers.
Note: If you try to use private headers without adding the TrustedProxy property, they will be ignored. If the private headers are ignored, the application server might not locate the requested application.
After you add this setting, the HTTP or HTTPS internal transport trusts all private headers it receives. Therefore, you must ensure that all paths to the HTTP or HTTPS transport are trusted.
Results
The configuration is complete. To activate the configuration, stop and restart both the WebSphere Application Server for z/OS and the Web server that is running on your workstation.