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]](../../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.