3.4.1 Starting and stopping HTTP Server
When you install HTTP Server, it is registered in the system as a service called Cosminexus HTTP Server. The server is registered as a service to be started manually. the service does not start automatically when the OS is started.
To start, stop, and restart HTTP Server, you can use any of the following methods:
-
Starting, stopping, and restarting the service from Management Server
-
Starting and stopping as a service from the Control Panel
-
Starting, stopping, and restarting from the Command Prompt
When executing HTTP Server as a service, the user account will be "LocalSystem" at the time of installation. HTTP Server including the CGI program and the API connection module is executed by this user account. For operation by other user accounts, see 3.4.2 Operation by general user accounts.
- Organization of this subsection
(1) Starting, stopping, and restarting the service from Management Server
For details, see 4.1.2 How to start the system or 4.1.4 How to stop the system in the manual uCosminexus Application Server Management Portal User Guide.
(2) Starting and stopping as a service from the control panel
Open the Service window from the Control Panel, select Cosminexus HTTP Server, and then click the Start button to start Cosminexus HTTP Server, or click the Stop button to stop Cosminexus HTTP Server. You cannot restart Cosminexus HTTP Server from the Service window. The installation-path/httpsd/conf/httpsd.conf file is used as the configuration file.
(3) Starting, stopping, and restarting from the Command Prompt
Enter the httpsd command from the command prompt. The httpsd command is coded below:
(a) Format
"Application Server-installation-directory\httpsd\httpsd.exe" [[-d directory][-f file-name][ [-n "Service-name"][-k {start | stop | restart | gracefulstop | install | uninstall} ] ]| -v | -t ](b) Options
-
-d directory
Use this option to set the default value used when the ServerRoot directive is not specified in the configuration file.
-
-f file-name
You can specify the path of the configuration file that you want to use. Specify the file name with an absolute path, or with a relative path from the specified value of the ServerRoot directive.
-
-n "Service-name"
Use this option to specify the service name of HTTP Server. Specify the service name within " (quotation marks). You can specify a maximum of 128 characters in the service name. Specify the service name in ASCII code. You cannot specify the following characters in the service name:
'
![[Figure]](GRAPHICS/ZUENG03A.GIF)
', '/', '"', control codes, and multi-byte characters
The default value of the service name is Cosminexus HTTP Server.
If you specify this option, you also need to specify the -k option.
-
-k start
Use this option to start HTTP Server. When the -n "Service-name" is specified, the corresponding service starts.
-
-k stop
Use this option to stop HTTP Server. When the -n "Service-name" is specified, the corresponding service stops.
-
-k restart
Use this option to restart HTTP Server.
-
-k gracefulstop
Use this option to perform planned termination of HTTP Server. The option stops the server after ending the running server threads. If a KeepAlive connection is active, the server process remains active until the KeepAlive connection is deactivated. If running server threads do not end, the server threads will end when the waiting time specified in the HWSGracefulStopTimeout directive ends.
-
-k install
Use this option to register HTTP Server as a service. When the -n "Service-name" is specified, the corresponding service is registered. When registering the service, the startup type will be 'Manual'. When HTTP Server starts as a service, it sets the default value of the ServerRoot directive to the path specified in the httpsd.exe command or to the value specified in the -d option.
-
-k uninstall
Use this option to delete HTTP Server from the service. When the -n "Service-name" is specified, the corresponding service is deleted. If the service is running, first stops the service and then deletes the service.
-
-v
Use this option to display the version information. HTTP Server does not start when you specify this option.
-
-t
Use this option to check the configuration file syntax. If there is a syntax error, an error message is displayed on the screen. HTTP Server does not start when you specify this option.
(4) Operating HTTP Server from a remote machine using the terminal service
HTTP Server allows you to use the Windows terminal service (remote desktop service) functionality to start and stop HTTP Server or execute commands on the server machine from a remote machine.
For details on the prerequisite OS for HTTP Server, see the manual uCosminexus Application Server Overview.
For details on operating a terminal service, see the OS manual.
(5) Notes
-
When HTTP Server is stopped from Control Panel, or by the -k stop option executed from a command prompt, if a server thread is running, it will stop after waiting up to 30 seconds.
-
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.