Migrate the Library Server configuration to work with IBM HTTP Server - Powered by Apache

Description

Starting with z/OS V2R2, the web server is IBM HTTP Server - Powered by Apache. As a result, the HTTP Server configuration required by Library Server, particularly the configuration file directives, is significantly different than that required for the Domino-based HTTP Server used prior to z/OS V2R2.

If Library Server on your z/OS V2R1 or V1R13 system was not already configured to use an Apache-based HTTP Server, you must change the configuration of the z/OS V2R2 Library Server to operate with IBM HTTP Server - Powered by Apache. z/OS V2R2 includes IBM HTTP Server - Powered by Apache as a base element.

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: Library Server.
When change was introduced: z/OS V2R2.
Applies to migration from: z/OS V2R1 and z/OS V1R13.
Timing: Before the first IPL of z/OS V2R2.
Is the migration action required? Yes, if Library Server on your z/OS V2R1 or V1R13 system was not already configured to use an Apache-based HTTP Server.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: None.
Related IBM® Health Checker for z/OS® check: None.

Steps to take

The following steps summarize the Library Server changes to consider when migrating from IBM HTTP Server powered by Domino to IBM HTTP Server - Powered by Apache in z/OS V2R2:
  1. The envvars file of environment variable settings moves from conf/httpd.envvars to bin/envvars.
  2. For each environment variable set in bin/envvars, a PassEnv directive is needed in conf/httpd.conf.
  3. All Pass directives are required to become Alias directives in conf/httpd.conf.
  4. All Exec directives are required to become ScriptAlias directives in conf/httpd.conf.
  5. Multiple port support is configured in a single conf/httpd.conf using the VirtualHost directive, such as <VirtualHost *:8080>.
  6. A Listen port# directive must be specified for each port (default and VirtualHost) configured in conf/httpd.conf.
  7. A <LocationMatch> directive is required in conf/httpd.conf to prevent EBCDIC to ASCII translation when downloading CSS files.
  8. If configuring an SSL port in conf/httpd.conf, the LoadModule ibm_ssl_module modules/mod_ibm_ssl.so directive must be enabled.
  9. A self-identifying ServerName directive, such as ServerName MYMVS.ibm.com:80, should be specified in conf/httpd.conf.
  10. Other directives such as ErrorLog, CustomLog, and ServerAdmin should be configured as needed in conf/httpd.conf.

Add the new directives mentioned here to the conf/httpd.conf file that is installed with IBM HTTP Server - Powered by Apache, and base them on the corresponding directives, if applicable, from your conf/httpd.conf file that was previously used with IBM HTTP Server powered by Domino. Examples of the new directives are provided in the HTTP server customization topic of the Library Server Customization Considerations section in the z/OS Program Directory.

Reference information

For more information, see the following references:
Parent topic: Library Server actions to perform before the first IPL of z/OS V2R2