2.4.2 Starting and stopping HTTP Server (httpsdctl command)

(1) Format

/opt/hitachi/httpsd/sbin/httpsdctl {start | stop | restart | graceful | gracefulstop | configtest | help}

To Page Top

(2) Options

• start

  This option starts HTTP Server.

  Before you use the httpsdctl command to start HTTP Server, set the PRFSPOOL environment variable.

• stop

  This option stops HTTP Server.

• restart

  This option restarts HTTP Server (server restart). End the running server processes immediately. After all the server processes end, restart HTTP Server. If you are using the prefork MPM, the change in the value specified in the MaxClients directive is not applied when HTTP Server restarts. Instead, the value that was set earlier will continue to be used. If you changed the value specified in the Listen directive and the settings for the private key used in SSL communication (that is, the SSLCertificateKeyFile directive), stop and restart HTTP Server.

• graceful

  Restart HTTP Server. End the running server processes, and then stop the server. Start the server process with a new configuration file when required. If you are using the prefork MPM, the change in the value specified in the MaxClients directive is not applied when HTTP Server restarts. Instead, the value that was set earlier will continue to be used. If you changed the value specified in the Listen directive and the settings for the private key used in SSL communication (that is, the SSLCertificateKeyFile directive), stop and restart HTTP Server.

• gracefulstop

  Use this option to perform planned termination of HTTP Server. End the running server processes, and then stop the server. If a KeepAlive connection is active, the server process remains active until the KeepAlive connection is deactivated. If you do not end the running processes, the processes will end when the waiting time specified in the HWSGracefulStopTimeout directive ends.

• configtest

  This option checks the configuration file syntax. If there is a syntax error, an error message is displayed on the screen. If you specify the configtest option, HTTP Server will not start.

• help

  This option displays the httpsdctl help.

To Page Top

(3) How to confirm the start

To confirm the start of HTTP Server, check the control process. For details, see (3) Monitoring the control process of 4.1.4 Operation management.

In addition, make sure that the following message is output to the error log after HTTP Server starts:

Cosminexus HTTP Server version (Unix) configured -- resuming normal operations

To Page Top

(4) Example of usage

The following example starts HTTP Server.

export PRFSPOOL=/opt/Cosminexus/PRF/spool
/opt/hitachi/httpsd/sbin/httpsdctl start

To Page Top

(5) Notes

• When you stop the Web server with httpsdctl stop and gracefulstop, if the configuration file of HTTP Server is not correctly defined, an error will occur in the httpsdctl execution and the Web server will not stop.

• When you restart the Web server with httpsdctl restart and graceful, if the configuration file of HTTP Server is not defined correctly, an error will occur in the httpsdctl execution and the Web server will not restart.

• When you start, restart, and stop HTTP Server with the httpsdctl command, the message showing the completion of start and stop is not output.

• If you attempt to stop a Web server by running httpsdctl gracefulstop while a KeepAlive connection is active, the processing to stop the Web server does not start until the KeepAlive connection is deactivated.

• The /opt/hitachi/httpsd/conf/httpsd.conf file is used as the configuration file.

• Do not delete or edit the file specified in the PidFile directive when you stop a Web server by using the httpsdctl command with the stop or gracefulstop options specified. If you do so, execution of the httpsdctl command results in an error and the Web server does not stop.

To Page Top