PingDirectory

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

  1. Stop the server with bin\stop-server.

    You cannot register a server while it is running.

  2. To register the server as a service, from a Windows command prompt, run bat\register-windows-service.bat.

  3. 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 and stop-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

  1. To run additional service instances, change the wrapper.name property on each additional instance.

  2. 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

  1. To remove the service from the Windows registry, use the bat\deregister-windows-service.bat file.

  2. 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

  1. These configurations can be changed in the <server-root>\config\wrapper.conf file.