Use apachectl commands to start IBM HTTP Server

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

  • Start and stop 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.

    Issue the commands from the default installation directories, based on your operating system.

    • /usr/IBM/HTTPServer/bin/apachectl start|stop

    • /opt/IBM/HTTPServer/bin/apachectl start|stop

    • /opt/IBM/HTTPServer/bin/apachectl start|stop

    • /opt/IBM/HTTPServer/bin/apachectl start|stop

    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

  • Start and stop 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

We can configure your server for:

For more apachectl command options see Apache Hypertext Transfer Protocol Server.


Related tasks