2.4.2 Starting and stopping HTTP Server (httpsdctl command)
This section describes the httpsdctl command that starts and stops HTTP Server.
- Organization of this subsection
(1) Format
/opt/hitachi/httpsd/sbin/httpsdctl {start | stop | restart | graceful | gracefulstop | configtest | help}
(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.
(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
(4) Example of usage
The following example starts HTTP Server.
export PRFSPOOL=/opt/Cosminexus/PRF/spool /opt/hitachi/httpsd/sbin/httpsdctl start
(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.