Configuring an instance of IBM HTTP Server on z/OS V2R1
You can configure an instance of IBM® HTTP Server on the z/OS® operating system after installing IBM HTTP Server code by using IBM Installation Manager.
Before you begin
Before you use the installer program, check for the following:
- Ensure that your environment meets the prerequisites for the application server. For more information, see Preparing the base operating system.
- Install the IBM HTTP Server product code using IBM Installation Manager.
- Mount the file system containing this directory on the z/OS system where the IBM HTTP Server instance runs.
- Perform the z/OS system configurations that are required for IBM HTTP Server.
- For first-time installation, create a System Authorization Facility (SAF) user ID and group for
IBM HTTP Server. For information, see the topic about required
z/OS system configurations.
The examples that follow in this topic assume a server user ID of WWWSERV and a server group of WWWGROUP.
- Create an installation directory for the configuration files for the server instance. For more
information, see the topic about migrating and installing IBM
HTTP Server on z/OS systems.The examples that follow in this topic assume an installation directory of /etc/websrv1. Set the directory permissions to 770 and the directory ownership to the server user ID and group:
mkdir /etc/websrv1 chown WWWSERV:WWWGROUP /etc/websrv1 chmod 770 /etc/websrv1
- For first-time installation, enable the administrative console to modify
the httpd.conf file by adding the WebSphere® Application Server control region user ID to the IBM HTTP Server group using SAF. For example, to add a user ASCR1 to the
group WWWGROUP, type the following
command:
CONNECT ASCR1 GROUP (WWWGROUP) OWNER (WWWGROUP)
About this task
Procedure
Results
Perform the following steps to confirm that you have successfully installed a running version of the product on your machine:
- Log in to the OMVS shell using the server user ID. Verify that the server user ID has a non-zero
UID value. Change the directory to the server instance's installation
directory:
cd /etc/websrv1
- Run the following command to verify the installation of the program: apachectl
-v and apachectl configtestThe following sample output is an example of a successful program installation:
The actual version string and build date varies.# bin/apachectl -v Server version: IBM_HTTP_Server/9.0.0.0 (Unix) Server built: Jan 9 2016 11:20:34 # bin/apachectl configtest Syntax OK
- Start IBM HTTP
Server.
bin/apachectl start
- Point a web browser to the IP name or address of your z/OS system, using either the non-SSL port number you specified when running the installer program, or the default port of 80. You should see the IBM HTTP Server default home page.
- Stop IBM HTTP Server by running the following
command:
bin/apachectl stop
What to do next
- Required: Create a runtime instance of IBM HTTP Server. For more information, see Installing and configuring IBM HTTP Server on the z/OS V2R2 system.
- Optional: If you are using IBM HTTP Server with WebSphere Application Server, install the WebSphere Application Server Web Server Plug-ins.