For client versions prior to 22.214.171.1249 / 126.96.36.1996, the Integration Client service is launched using a so called “Wrapper” launcher. For versions 188.8.131.529 / 184.108.40.2066 and later, an improved launcher called “Procrun” is being used.
Installation and un-installation are identical between the two launchers. Only configuration of existing and additional settings vary.
This page describes how to configure the Integration Client “Run as Service” for client versions prior to 220.127.116.119 / 18.104.22.1686 using the “Wrapper” launcher. Only files specific for the Wrapper launcher are mentioned.
Am I using the old or the new service launcher
To learn what version you are using
- Open the Windows Services Manager (Run->Services.msc).
- Show the properties of the RobexClient_XXXX_Y service in question
- If the “Path to executable” contains “wrapper.exe” you are using the old launcher
- If the “Path to executable” contains “RobexServiceXX.exe” you are using the new launcher
How to upgrade an old integration client launcher
If you have an old Wrapper based launcher and would like to change it into the new Procrun launcher, you may follow these steps. The description assumes an old integration client installed in the directory
- Update the ROB-EX client to ROB-EX 22.214.171.1249 / 126.96.36.1996 or newer (for older client versions, the service is not stoppable by procrun)
- Take a backup of
\service\serviceX to \service\serviceXbackup
- Copy new updated RobexIntegrationClientSetup.exe to
- The updated
service/RobexIntegrationClientSetup.exeinstaller is included in SetupRobexClient_v188.8.131.529.exe or later. For 6.2 use a zip upgrade and ask our support help desk for a manual copy of the
- The updated
- Run RobexIntegrationClientSetup.exe and uninstall serviceX
- Run RobexIntegrationClientSetup.exe and install serviceX – remember to specify correct site name
- Add additional custom settings from old settings file
\service\serviceXbackup\conf\service.conf. Use Regedit.exe to edit the settings.
- Make sure to run the new RobexTray.exe (will be installed by RobexIntegrationClientSetup.exe) – it has a new icon. If it has the old icon, then you are not using the correct version.
- Start the new service from RobexTray.exe or “services.exe”
Configuring the old Wrapper based launcher
The old Wrapper based launcher is configured by editing files in a text editor. The following gives you an overview of the configuration files used.
Configuration files specific for the old Wrapper launcher are explained below.
The file “service.conf” contains settings of the service client which from time to time may need to be changed or updated in case the default values conflicts with other applications. Edit this file with a text editor (Notepad or the like). Especially the following two settings may need to be changed:
# Communication Port number (TCP) the Scheduler uses for communication with the # tray manager and other automation clients. This setting can be changed after # the service has been installed. # If you have existing applications occupying the same port numbers change # this setting to an unused port and restart the client service. set.default.SERVICE_PORT_NUMBER=9999 # home directory of this particular service. Client settings, Log files etc. are # stored here set.default.USER_HOME_DIR_PATH=./service/service%SERVICE_ID%
The file “service_common.conf” contains more advanced settings which are typically only changed in rare circumstances.
In case the PC has more than one Java Runtime installed (e.g. 1.6 and 1.7 versions), a specific Java runtime may be chosen by removing the comment character # and edit the line so it points to the JRE you would like to use. Notice that an environment variable can be specified which points to the correct JRE location. Notice the use of environment variables enclosed in % like JAVA_HOME in the default example below.
# Specify a specific java binary. If commented out then by default, # the Wrapper will look for a Sun JRE using the default registry key wrapper.java.command=%JAVA_HOME%/bin/java
To learn more about the available settings read the descriptive comments directly in the file.