 Installing Kapow Katalyst
|
Silent Installation on Windows |
You need to have administrator rights to install on Windows.
You will have received instructions on how to download the
installer. Download and save the KapowKatalyst_8.2.0.msi (32-bit) or
KapowKatalyst_8.2.0_x64.msi (64-bit) file to your hard
disk. After the download is completed, run the file to start the
installation and follow the steps and dialogs of the installer.
If you primarily want to run Design Studio you can now go directly to
Configuring Kapow Katalyst. On a server installation, however,
you probably will also want to configure RoboServer to run as
a Windows Service, which is explained in the following.
To run RoboServer as a service you need to install it first using the
ServiceInstaller.exe
executable.
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.app.parameter.1="First-Argument"
wrapper.app.parameter.2="Second-argument"
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 including a valid license key.
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
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.
The name of the service to install. The name of the service can not contain spaces.
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.
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 navigate to Computer Configuration->
Security Settings->User Rights Assignment->Log on as a service
and add the user.
This example install a service named RoboServer8.2.0 (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
-service socket:50000
ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account=.\bob
wrapper.ntservice.password.prompt=true wrapper.ntservice.name="RoboServer8.2.0"
wrapper.ntservice.starttype=AUTO_START wrapper.app.parameter.1="-service"
wrapper.app.parameter.2="socket:50000"
The same example except this limits RoboServer to run on a single core. See How to Start RoboServer
for details. The arguments for RoboServer are
-service socket:50000 -cpuThreads 0,1
ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account=.\bob
wrapper.ntservice.password.prompt=true wrapper.ntservice.name="RoboServer8.2.0"
wrapper.ntservice.starttype=AUTO_START wrapper.app.parameter.1="-service"
wrapper.app.parameter.2="socket:50000" wrapper.app.parameter.3="-cpuThreads"
wrapper.app.parameter.4="0,1"
This example install a service named RoboServer2 that runs as the user
bob on the domain
mydomain. The arguments for RoboServer are
-service socket:50000 -MC
ServiceInstaller.exe -i RoboServer.conf wrapper.ntservice.account=mydomain\bob
wrapper.ntservice.password=secret wrapper.ntservice.name="RoboServer2"
wrapper.ntservice.starttype=AUTO_START wrapper.app.parameter.1="-service"
wrapper.app.parameter.2="socket:50001" wrapper.app.parameter.3="-MC"
To uninstall a service you can run
ServiceInstaller.exe -r RoboServer.conf wrapper.ntservice.name=Service-name
The name of the service to remove
This example removes a service named RoboServer8.2.0.
ServiceInstaller.exe -r RoboServer.conf wrapper.ntservice.name="RoboServer8.2.0"