Start RoboServer

You can start a RoboServer using the following actions.

  • Click the RoboServer program icon (or the Start Management Console program icon which starts both the Management Console and RoboServer).
  • Start the RoboServer from the command line.
  • Run the server as a service. For more information about running RoboServer as a service, see Starting Servers Automatically.

To invoke a RoboServer from the command line, open a Command Prompt window, navigate to the bin folder in the Kofax RPA installation folder and type:

RoboServer

If all necessary parameters are specified in the roboserver.settings configuration file, the RoboServer starts.

If any of the necessary parameters is missing, the RoboServer specifies an error and displays the usage help and available parameters.

RoboServer Parameters

The command line for starting a RoboServer may include the following parameters:

RoboServer [-cl <arg>] [-cpuThreads <arg>] [-h]
       [-maxConcurrentRobots <arg>] [-maxQueuedRobots <arg>] [-MC] [-mcUrl
       <arg>] [-p <arg>] [-pauseAfterStartupError] [-s <arg>] [-sslPort
       <arg>] [-v] [-V]

Regardless of how you start RoboServer, it accepts the parameters in the following table. Note that you can edit all the parameters in the RoboServer Settings utility. See RoboServer Configuration for more details.

Parameter

Description

-mcUrl <arg>

This required parameter specifies which Management Console to register to in the following format:

http[s]://<username>:<password>@<hostname>:<port number>

Example: -mcUrl http://admin:password@myserver:8080/ManagementConsole

When using Document Transformation step with a Callback option in a robot, use the RoboServer host name or IP address in the -mcUrl parameter. Do not use 'localhost', because the Document Transformation Service will not be able to reach the Management Console, and the callback robot will not be queued.

-cl

--cluster <arg>

This required parameter automatically registers a RoboServer with the specified cluster on the Management Console. In the following example the RoboServer registers itself with the Production cluster.

Example: -cl Production

Example: -mcUrl http://admin:password@myserver:8080/ManagementConsole -cl Production

-pauseAfterStartupError

Pauses if an error occurred at startup.

-v

-verbose

This optional parameter causes a RoboServer to output status and runtime events.

-V

-version

This optional parameter causes RoboServer to output the version number, and then exit.

-h

--help

Displays help.

-eh

-externalHost <port number>

Explicitly specifies the name or IP address of the RoboServer host.

This parameter should be specified when the host address is different from what a RoboServer discovers on the local machine, such as when running with NAT in the cloud, or when you run the RoboServer in a Docker container.

Example: -eh 10.10.0.123

-ep

-externalPort <port number>

Explicitly specifies the port number of the RoboServer host.

This parameter should be specified when the host port is different from what a RoboServer discovers on the local machine, such as when running with NAT in the cloud, or when you run the RoboServer in a Docker container.

-jmxPass

Sets the JMX password if you monitor a RoboServer with JMX application and require a password.

-s <service-name:service-parameter> |

-service <service-name:service-parameter>

This parameter specifies a RQL or JMX service that a RoboServer should start. This parameter must be specified at least once, and may be specified multiple times to start multiple services in the same RoboServer. The available services depend on your installation.

Example: -service socket:50000

Example: -service jmx:50100

See "Available services" in the table below for more information.

-p <port-number> |

-port <port-number>

This is shorthand for calling -s socket:<port-number>

Example: -port 50000

-sslPort <arg>

This is a shorthand for writing -s ssl:<port number>

-nd

-NoDoc

This optional parameter disallows the robot documentation requests to this RoboServer.

-sn

-serverName

This is an optional parameter that sets the server name for logging RoboServer statistics, which is later displayed in Kofax Analytics for RPA. If you do not specify the server name, the statistics is collected based on the server IP address.

Available services

-service socket:<portNumber>

<portNumber>: The port number for the socket-service to monitor.

-service ssl:<portNumber>

<portNumber>: The port number for the socket-service to monitor.

-service jmx:<jmx_port_Number>,<jmx_rmi_url>

<jmx_port_Number>: The port number for the JMX service to monitor.

<jmx_rmi_url>: Optional RMI host and port for the JMX service. Use if you need to connect through a firewall.

Example: example.com:51001

Note that to set passwords, you must either use the RoboServer Settings utility or the ConfigureRS tool. For more information, see RoboServer Configuration and RoboServer Configuration - Headless Mode.

Starting Servers Automatically

If your installation includes any server functionality, you can configure it to start the servers automatically.

When referring to "server functionality", we mean RoboServers and the Management Console (license server). In fact these two components are provided by RoboServer, depending on the arguments supplied to it when it starts.

The RoboServer Parameters topic contains a detailed description of the command-line arguments for a RoboServer program. To enable the RoboServer program to execute robots, specify the -service argument. Similarly, the -MC argument enables the Management Console functionality (see Management Console (License Server) in the Installation Guide).

For information about how to start RPA components automatically on Windows and Linux, see "Run RPA Components As Services" in the Kofax RPA Administrator's Guide.

Shutting Down RoboServer

RoboServer can be shut down using the following command line tool. Run ShutDownRoboServer without arguments to see the various options for how to shut down the server, particularly how to handle any robots currently running on the server.