2.4.2 Starting and stopping Cosminexus HTTP Server (httpsdctl command)
(1) Format
/opt/hitachi/httpsd/sbin/httpsdctl {start | stop | restart | graceful | gracefulstop | configtest | help} |
(2) Options
- start
This option starts Cosminexus HTTP Server. If you are using an encrypted private key for SSL, a request to enter the private key password is displayed when starting Cosminexus HTTP Server.
- stop
This option stops Cosminexus HTTP Server.
- restart
This option restarts Cosminexus HTTP Server (server restart). End the running server processes immediately. After all the server processes end, restart Cosminexus HTTP Server. When you restart Cosminexus HTTP Server, the change in the value specified in the MaxClients directive is not applied, and the value that is 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 Cosminexus HTTP Server.
- graceful
Restart Cosminexus HTTP Server. End the running server processes, and then stop the server. Start the server process with a new configuration file when required. When you restart Cosminexus HTTP Server, the change in the value that is specified in the MaxClients directive is not applied, and the value that is 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 Cosminexus HTTP Server.
- gracefulstop
This option stops Cosminexus HTTP Server. End the running server processes, and then stop the server. 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, Cosminexus HTTP Server will not start.
- help
This option displays the httpsdctl help.
(3) How to confirm the start
(4) Example of usage
The following example starts Cosminexus HTTP Server. If you are using an encrypted private key, enter the password.
/opt/hitachi/httpsd/sbin/httpsdctl start
Enter PEM pass phrase:
(5) Notes
- When you stop the Web server with httpsdctl stop and gracefulstop, if the configuration file of Cosminexus 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 Cosminexus 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 Cosminexus HTTP Server with the httpsdctl command, the message showing the completion of start and stop is not output.