Skip to Main Content
Return to Navigation

Running Jolt Relay

This section discusses how to:

Using the JRLY Administration Program

You use the jrly command located in TUXDIR\udataobj\jolt\relay to administer Jolt Relay on all platforms. You can use the following jrly command options at any time:

  • jrly -version

    Display the current version of the JRLY binary.

  • jrly -help

    Display a summary of command-line options with brief descriptions.

Running Jolt Relay on Windows

On Windows, you set up Jolt Relay to run as a service. On other platforms you must run Jolt Relay directly.

See Running Jolt Relay on UNIX.

If you want to install multiple Jolt Relay services, you must specify a string to be used as a display suffix that uniquely identifies each additional service you install. You subsequently use the suffix to identify each service it commands. An additional service with the suffix MyJoltRelay, for example, is called Oracle Jolt Relay_MyJoltRelay, but you refer to it using only the suffix. You can omit the suffix when installing only one of these services, which becomes the default Jolt Relay service, calledOracle Jolt Relay.

Note: All administrative commands in the following table except -start and -stop require that you have write access to the Windows registry. The -start and -stop commands require that you have Windows service control access. These requirements are based on Windows user restrictions.

Command

Description

jrly -install [display_suffix]

Install JRLY as a Windows service.

jrly -remove [display_suffix | -all]

Remove one instance, all instances, or the default JRLY Windows service.

jrly -set [-d display_suffix] -fconfig_file

Update the registry with the full path of a new configuration file for the specified JRLY service.

Note: You can run multiple Jolt Relay services by specifying a different display suffix along with the name of a different configuration file for each installed service. Each configuration file must contain a unique value for the LISTEN parameter that specifies a different port. This is essential to avoid port clashes when running the services concurrently. You must run this command before the service starts.

jrly -manual [display_suffix]

Set the start/stop to manual. This command sets the specified JRLY service to be manually controlled, using either the command-line options or the Service Control Manager (SCM).

jrly -auto [display_suffix]

Set the start/stop to automatic. This command sets all the operations for a specified JRLY service to be automatically started when the OS boots and stopped when the OS shuts down.

jrly -start [display_suffix]

Start the specified JRLY service.

jrly -stop [display_suffix]

Stop the specified JRLY service.

Running Jolt Relay on UNIX

This section discusses how to start and stop Jolt Relay directly from a command line on UNIX.

To start Jolt Relay on UNIX:

  1. Change directories to the Jolt Relay directory within your Tuxedo installation:

    cd $TUXDIR/udataobj/jolt/relay
  2. Run the following command:

    jrly -f jrly_config &

    Where jrly_config is the name of a Jolt Relay configuration file.

    You can run multiple instances of Jolt Relay by using a different port for each instance. You run JRLY once for each instance, and specify a different configuration file each time. Each configuration file must contain a value for the LISTEN parameter that specifies a different port.

    The & causes JRLY to run in the background.

To shut down Jolt Relay on UNIX, use the UNIX kill -9 command.