This topic describes how to start and stop IBM® HTTP
Server using the apachectl commands.
About this task
To start and stop IBM HTTP Server, use the
apachectl command.
The apachectl command is located in the bin subdirectory
within the IBM HTTP Server installation directory. If that
directory is not in your PATH, the full path should
be given on the command line.
Log on as the Web server user ID. This user ID must
have an OMVS segment defined and a UID which is not zero. Verify that
both the IBM HTTP Server product directory and the installation
directory for the server instance are mounted and available.
Procedure
- Starting and stopping IBM HTTP
Server using the default configuration file.
To
start IBM HTTP Server using the default httpd.conf configuration
file, run the apachectl start command.
To
stop IBM HTTP Server using the default httpd.conf configuration
file, run the apachectl stop command.
![[z/OS]](../images/ngzos.gif)
Issue
the commands from the installation directory of the IBM HTTP
Server instance.
- <IHS_install_dir>/bin/apachectl start|stop
For example, if
the
apachectl command is not in your
PATH,
the IBM HTTP Server installation directory is
/usr/IBM/HTTPServer,
and the default configuration file is used:
# /usr/IBM/HTTPServer/bin/apachectl start
# /usr/IBM/HTTPServer/bin/apachectl stop
- Starting and stopping IBM HTTP
Server using an alternate configuration file.
To
start IBM HTTP Server using an alternate configuration
file, run the following command:
- apachectl -k start -f <path_to_configuration_file>
To stop IBM HTTP Server using an alternate configuration
file, run the following command:
- apachectl -k stop -f <path_to_configuration_file>
For example, the
apachectl command
is not in your
PATH, the IBM HTTP
Server installation directory is
/opt/IBM/HTTPServer,
and an alternate configuration file,
/opt/IBM/HTTPServer/conf/nodeb.conf,
is used:
# /opt/IBM/HTTPServer/bin/apachectl -k start -f /opt/IBM/HTTPServer/conf/nodeb.conf
# /opt/IBM/HTTPServer/bin/apachectl -k stop -f /opt/IBM/HTTPServer/conf/nodeb.conf
Results
To confirm that IBM HTTP Server started successfully,
open a browser and type in your server name in the URL box.
If
you are going to run Application Response Measurement (ARM) agents,
make sure you have the authority to run ARM agents when you start IBM HTTP
Server.
What to do next
You can configure your server for:
- Secure Sockets Layer (SSL)
- Lightweight Directory Access (LDAP)
Fast Response Cache Accelerator (FRCA)
For more apachectl command options
see Apache Hypertext Transfer Protocol Server.