3.2.3 httpsdctl

The httpsdctl command starts, restarts, or stops the Web server.

Synopsis

httpsdctl {start|stop|restart|graceful|gracefulstop|configtest|help}

Storage location

Application Server installation directory/httpsd/sbin

Function

Starts, restarts, or stops the Web server.

Execution permission

Superuser or general user

Precondition

The PRF daemon needs to be running.

Environment variable

LD_LIBRARY_PATH(Linux)

Specify Application Server installation directory/common/PRF/lib.
PRFSPOOL

Sets the execution environment directory for the PRF daemon.
TZ

Sets the time zone.

Files

httpsd.conf file

Arguments

start: This option starts Web server. If you are using an encrypted private key for SSL, a request to enter the private key password is displayed when starting Web server.
stop: This option stops Web server.
restart: This option restarts Web server (server restart). End the running server processes immediately. After all the server processes end, restart Web server. When you restart Web server, the change in the value specified in the MaxRequestWorkers 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 Web server.
graceful: Restart Web 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 Web server, the change in the value that is specified in the MaxRequestWorkers 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 Web server.
gracefulstop: This option stops Web 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, Web server will not start.
help: This option displays the httpsdctl help.

Examples

The following example starts Web server. If you are using an encrypted private key, enter the password.

/opt/hitachi/APServer/httpsd/sbin/httpsdctl start
Enter PEM pass phrase:

How to confirm the start

To confirm the start of Web server, check the control process. The process name (execution program name) is httpsd.

In addition, after starting Web server, confirm that the AH00163 message was output to the error log.

Notes

When you stop the Web server with httpsdctl stop and gracefulstop, if the configuration file of Web 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 Web 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 Web server with the httpsdctl command, the message showing the completion of start and stop is not output.