IBM HTTP Server on z/OS

1 RedpaperFront coverIBM HTTP Server on z/OS Migrating from Domino-powered to Apache-poweredEdward McCarthyInternational Technical Support OrganizationIBM HTTP Server on z/OS: Migrating from Domino-powered to Apache-poweredOctober 2016 REDP-4987-02 Copyright International Business Machines Corporation 2013, 2016. All rights to Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Edition (October 2016)This edition applies to Version 9 of IBM HTTP Server powered by Apache (product number xxx-xxx).

2 This document was created or updated on July 12, : Before using this information and the product it supports, read the information in Notices on page ix. Copyright IBM Corp. 2013, 2016. All rights .. ixTrademarks ..xIBM Redbooks promotions .. xiPreface .. xiiiAuthors .. xiiiNow you can become a published author, too! .. xivComments welcome.. xivStay connected to IBM Redbooks .. xivSummary of changes.. xvOctober 2016, Third Edition .. xvChapter 1. Introduction to IBM HTTP Server for z/OS.. Why you should migrate .. HTTP Server terminology.

3 IBM statement of support .. Documentation .. New features in .. Updates to this IBM Redpaper publication .. New features in .. Determining which IBM HTTP Server you are running .. Using SDSF to find running HTTP Servers.. Determining which TCP/IP ports are used .. Accessing the home page.. Using the ps command to check for HTTP Servers .. Checking for non-running IBM HTTP Servers.. Checking your IBM HTTP Server version .. Determining IBM HTTP Server powered by Domino version.

4 Determining IBM HTTP Server powered by Apache version .. For more information.. 12 Chapter 2. Features and performance.. New features in .. Listing MVS data sets .. HTTP response translation improvements .. Federal Information Processing Standards (FIPS140-2) support .. 31-bit support .. Features in IHS powered by Domino and not in IHS powered by Apache .. Support for zEnterprise Data Compression .. zEnterprise Data Compression requirements .. Verifying that zEnterprise Data Compression is active.

5 Enabling use of zEnterprise Data Compression .. Testing .. SMF information .. Comparing results .. SMF information about hardware compression .. Compression log usage information .. 23iv IBM HTTP Server on z/OS: Migrating from Domino-powered to Functional differences .. Performance comparison .. Basic measure of throughput test .. CPU utilization test .. Measure of throughput with and without caching test .. Measure of CPU test.. 27 Chapter 3. Installing your first IHS .. IHS code that is shipped with z/OS.

6 Obtaining and installing the product code .. Delivered as a component of other IBM products .. Downloaded at no charge from the IBM Shopz website .. Ordering and installing by using Shopz.. IBM Shop z website .. Ordering software .. Downloading the software.. FTP product code to z/OS UNIX in z/OS .. First job to run: GIMUNZIP .. Second job to run: UNZIPJCL.. Setting up SMP/E .. Receiving the product code .. Applying the product code .. Accepting the product code .. Summary.

7 Installation when a component of another IBM product .. Sample real-world setup process .. Defining a configuration directory .. Defining a user ID .. Defining a protected user ID for the started task.. Creating the IHS .. Defining a RACF STARTED rule .. Creating a Started Task to run the IHS .. Verifying that IHS is working .. Using intermediate symbolic links .. Setting up an intermediate link .. Maintenance upgrade .. Gradual maintenance rollout approach .. New_install_root shell.

8 62 Chapter 4. Administration .. Running IBM HTTP Server powered by Apache.. Using started tasks .. Starting the Server .. Stopping the Server .. Recycling the Server to pick up changes.. Modifying command support in .. Displaying version in job log .. Using apachectl from the command line .. Starting the Server .. Stopping the Server .. Restarting the Server .. Mix and match.. Integration with WebSphere Application Server .. 72 Contents Configuration .. Listen directive .. Virtual hosting.

9 Monitoring .. SDSF .. Checking pid and log files .. Server status .. Server status by using the modify command .. Thread usage .. Diagnostic tools and information .. Troubleshooting .. Migrating previous versions .. Tracing .. Information about tracing .. Limitation.. Some examples .. Handling logging .. Macro support .. Conditional controls.. 83 Chapter 5. Migration.. Planning your migration .. Migration plan .. Migration guidance .. Scalable mode.

10 SMF records .. Server home directory.. Ports .. Virtual hosts .. Security .. Logging .. URL and file mapping directives .. WebSphere Application Server plug-in .. Timeouts .. Caching .. ASCII/EBCDIC considerations .. GWAPI .. Reverse Proxy .. Comparing DGW and IHS use of directives .. Cleaning up PARMLIB .. Migrating Library Server .. Set up in DGW .. Set up in .. Testing Library Server .. 101 Chapter 6. Scalability and workload management.. Overview.