Starting Servers on Windows

To make RoboServer start automatically on Windows, you need to add it as a Windows service. We will show how to add and remove Windows services using the ServiceInstaller.exe program that is included in the Kapow Katalyst installation.

Adding Windows Services

To run RoboServer as a service you need to install it first using the ServiceInstaller.exe program. The following is a general example outlining the command-line arguments to this program (although displayed on multiple lines here, this is a one-line command):

ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account=Account wrapper.ntservice.password.prompt=true wrapper.ntservice.name=Service-name wrapper.ntservice.starttype=Start-method wrapper.syslog.loglevel=INFO wrapper.app.parameter.1="First-Argument" wrapper.app.parameter.2="Second-argument"
wrapper.ntservice.account:

The account of the user that has to run RoboServer. Kapow Katalyst stores configuration in the user's directory and it is important to choose a user that has the correct configuration.

If RoboServer has to run as a domain user you need to enter the account in the form domain\account

If RoboServer has to run as a regular user you need to enter the account in the form .\account

wrapper.ntservice.password.prompt:

The value true will prompt the user for the password for the account. If you prefer to enter the password on the command line, you must instead use wrapper.ntservice.password=whatever-the-password-is.

wrapper.ntservice.name:

The name of the service to install. The name of the service can not contain spaces.

wrapper.ntservice.starttype:

AUTO_START if the service should be started automatically when the system is rebooted.

DELAY_START if the service should be started after a short delay. (Not supported on Windows XP and 2003).

DEMAND_START if you want to start the service manually.

wrapper.syslog.loglevel:

Redirect the console output from RoboServer to the event log.

wrapper.app.parameter.*:

The arguments for RoboServer. You can enter as few or as many as needed.

When the service is installed the user will be granted the "log on as a service" rights. If the service fails to start, check that the right is granted by opening gpedit.msc and (on Windows 7) navigate to Computer Configuration -> Windows Settings-> Security Settings -> Local Policies -> User Rights Assignment -> Log on as a service and add the user.

Example

This example installs a service named RoboServer9.4.9 (note: no spaces) that runs as the user bob. When running the script, the user will be prompted for the password. The arguments for RoboServer are -p 50000 (meaning that it will be able to execute robots):

ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account=.\bob wrapper.ntservice.password.prompt=true wrapper.ntservice.name="RoboServer9.4.9" wrapper.ntservice.starttype=AUTO_START wrapper.syslog.loglevel=INFO wrapper.app.parameter.1="-p" wrapper.app.parameter.2="50000"
Example

This example installs a service named RoboServer9.4.9 (note: no spaces) that runs as the user bob on the domain mydomain. The arguments for RoboServer are -p 50000 -MC (meaning that it will be able to both execute robots and run Management Console):

ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account=mydomain\bob wrapper.ntservice.password=secret wrapper.ntservice.name="RoboServer9.4.9" wrapper.ntservice.starttype=AUTO_START wrapper.syslog.loglevel=INFO wrapper.app.parameter.1="-p" wrapper.app.parameter.2="50000" wrapper.app.parameter.3="-MC"

Removing Windows Services

To uninstall a service you can run

ServiceInstaller.exe -r RoboServer.conf wrapper.ntservice.name=Service-name
wrapper.ntservice.name:

The name of the service to remove

Example

This example removes a service named RoboServer9.4.9.

ServiceInstaller.exe -r RoboServer.conf wrapper.ntservice.name="RoboServer9.4.9"