Running the server as a Microsoft Windows service
The server can run as a Windows service, which enables you to sign out of a machine without stopping the server.
Registering the server as a Windows service
Register the server as a Windows service using the Windows command prompt.
About this task
Perform the following steps to register the server as a service:
Steps
-
Stop the server with
bin\stop-server
.You cannot register a server while it is running.
-
To register the server as a service, from a Windows command prompt, run
bat\register-windows-service.bat
. -
After registration, start the server from the Windows Services Control Panel or with the
bat\start-server.bat
command.Command-line arguments for the
start-server.bat
andstop-server.bat
scripts are not supported while the server is registered to run as a Windows service. Using a task to stop the server is also not supported.
Running multiple service instances
Only one instance of a particular service can run at one time.
About this task
Services are distinguished by the wrapper.name
property in the <server-root>\config\wrapper-product.conf
file.
Steps
-
To run additional service instances, change the
wrapper.name
property on each additional instance. -
Add or change descriptions of the service in the
wrapper-product.conf
file.
Deregistering and uninstalling services
To uninstall a service, you must first deregister it.
About this task
While a server is registered as a service, it cannot run as a non-service process or be uninstalled.
Steps
-
To remove the service from the Windows registry, use the
bat\deregister-windows-service.bat
file. -
To uninstall the server, run the
uninstall.bat
script.
Configuring log files for services
About this task
The log files are stored in <server-root>\logs
, and file names begin with windows-service-wrapper
. They are configured to rotate each time the wrapper starts or the file reaches its maximum size. Only the last three log files are retained.
Steps
-
These configurations can be changed in the
<server-root>\config\wrapper.conf
file.