Plan for the removal of IBM HTTP Server powered by Domino

Description

z/OS V2R1 was the last release to include the IBM HTTP Server powered by Domino. New base element, IBM HTTP Server - Powered by Apache (IHSA), is introduced in z/OS V2R2. This element replaces IBM HTTP Server powered by Domino. z/OS V2R2 contains IHSA at level 9.0.

If your installation is using IBM HTTP Server powered by Domino, you must migrate to IBM HTTP Server - Powered by Apache. It is strongly recommended that you perform this migration in two phases, as described in Steps to take. Both IBM HTTP Server - Powered by Apache 8.5.5 and IBM HTTP Server - Powered by Apache 9.0 are supported on z/OS V2R2. Note, however, that IBM HTTP Server - Powered by Apache 8.5.5 support on z/OS V2R2 is planned to continue only until the end of service date for z/OS V2R1 (planned for September 2018).

IBM HTTP Server powered by Domino is not supported on z/OS V2R2.

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: IBM HTTP Server powered by Domino.
When change was introduced: z/OS V2R2. This change was also announced in the statement of direction IBM United States Software Announcement 213-292 "IBM z/OS Version 2 Release 1 delivers the foundation for Smarter Computing," dated July 23, 2013.
Applies to migration from: z/OS V2R1 and z/OS V1R13.
Timing: Before installing z/OS V2R2.
Is the migration action required? Yes, if you currently use IBM HTTP Server powered by Domino.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: The HTTP servers that are included in other IBM licensed programs, such as WebSphere Application Server, are not affected. This migration action applies only to users of the IBM HTTP Server that is included in the base z/OS operating system.
Related IBM Health Checker for z/OS check: The check IBMZMIG,ZOSMIG_HTTP_SERVER_DOMINO is used to determine whether IBM HTTP Server powered by Domino is in use on your system. The check is written in REXX and is provided on an as-is basis at http://www.ibm.com/systems/z/os/zos/installation/HTTP_Health_Checker.html.

The check is not provided in an APAR; for instructions on adding it to your system, see the web page.

Steps to take

In z/OS V2R2, you must migrate to IBM HTTP Server - Powered by Apache, which is included as a base element of z/OS. It is recommended that you perform this migration in two phases, as follows:
  1. Before you install z/OS V2R2, use the separate licensed program z/OS Ported Tools HTTP Server feature (5655-M23) on z/OS V2R1 or z/OS V1R13. You can run the IBM Ported Tools HTTP Server and the IBM HTTP Server powered by Domino concurrently, if necessary, for certain functions that do not support the IBM Ported Tools HTTP Server on z/OS V2R1 or z/OS V1R13, such as Infoprint Server at those release levels (see "Infoprint migration action for HTTP Server").

    In this phase of the migration, you can perform much of the migration work for z/OS V2R2 IBM HTTP Server in advance and stabilize on IBM HTTP Server - Powered by Apache. The z/OS Ported Tools HTTP Server feature is at level 8.5.5 (Apache V2.2.8 level).

  2. After you install z/OS V2R2, migrate from z/OS Ported Tools HTTP Server feature to z/OS V2R2 IBM HTTP Server - Powered by Apache. In z/OS V2R2, IBM HTTP Server - Powered by Apache is at the 9.0 level (based on Apache V2.4). Here, you need only to perform the migration actions between IBM HTTP Server 8.5.5 and 9.0, which are fewer than the number of migration actions that are needed to move from IBM HTTP Server powered by Domino directly to IBM HTTP Server - Powered by Apache at the 9.0 level.
Note: To avoid an error (condition code 0137 and ABENDU4093 RC00000281) ensure that REGION=0M is specified on the EXEC statement of the IBM HTTP Server started procedure. APAR PI47828 (Apache 8.5.5) and APAR PI50373 (Apache 9.0) updates the sample procedure to specify REGION=0M and TIME=NOLIMIT.

Reference information

For more information, see the following references:
  • For information about supported versions of IBM HTTP Server, see Washington Systems Center flash 10857 at http://www.ibm.com/support/techdocs. Search for "flash10857".
  • For instructions on migrating from IBM HTTP Server powered by Domino to IBM HTTP Server - Powered by Apache, see IBM Redbook "IBM HTTP Server on z/OS: Migrating from Domino-powered to Apache-powered, REDP-4987.
  • For instructions on migrating from IBM HTTP Server - Powered by Apache 8.5.5 to 9.0, see http://httpd.apache.org/docs/2.4/upgrading.html.