Jolt Relay Adapter


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Using BEA Jolt \| Local Topics \| Previous Topic \| Next Topic \| Contents \| Index

Jolt Relay Adapter

The Jolt Relay Adapter (back-end relay) is a BEA Tuxedo system server. The Jolt Relay Adapter (JRAD) server may or may not be located on the same BEA Tuxedo host machine in single host mode (SHM) and server group to which the JSL server is connected.

The JRAD can be started independently of its associated JRLY. JRAD tracks its startup and shutdown activity in the BEA Tuxedo log file.

JRAD Configuration

A single JRAD process can only be connected to a single JRLY. A JRAD can be configured to communicate with only one JSL and its associated JSHs. However, multiple JRADs can be configured to communicate with one JSL. The CLOPT parameter for the BEA Tuxedo servers must be included in the UBBCONFIG file. A sample of the file is shown in the listing Sample JRAD Entry in UBBCONFIG File.

The following table contains additional information about the CLOPT parameters.

JRAD CLOPT Parameter Descriptions

CLOPT Parameter

Description

-l netaddr

Port to listen for the JRLY to connect on behalf of the client.

-c netaddr

The address of the corresponding JSL to which JRAD connects.

-H netaddr

The listening address for an external proxy. An external proxy is one that runs on a client host. This proxy handles HTTP and other protocols. The other end of the proxy connects to JRLY, which connects to JSL/JSH.

In order for the proxy to work for Jolt clients (specifically applets that connect to JRLY), the JRAD passes the -H argument to an applet, instructing it to connect to the proxy address instead of the JRLY address.

Note: Unlike the JSL -H option, the JRAD -H option is not used as a network address translator, nor is it used as an address mask.

CLOPT Parameter	Description
-l netaddr	Port to listen for the JRLY to connect on behalf of the client.
-c netaddr	The address of the corresponding JSL to which JRAD connects.
-H netaddr	The listening address for an external proxy. An external proxy is one that runs on a client host. This proxy handles HTTP and other protocols. The other end of the proxy connects to JRLY, which connects to JSL/JSH. In order for the proxy to work for Jolt clients (specifically applets that connect to JRLY), the JRAD passes the -H argument to an applet, instructing it to connect to the proxy address instead of the JRLY address. Note: Unlike the JSL -H option, the JRAD -H option is not used as a network address translator, nor is it used as an address mask.

The address for the JRAD CLOPT parameters can be specified in either of the following formats:

//hostname:port

0x0002pppphhhhhhhh
(where pppp is the port number and hhhhhhhh is the hexadecimal IP address)

Sample JRAD Entry in UBBCONFIG File

# JRAD host 200.100.100.10 listens at port 2000, connects to JSL port 8000 on the same host

JRAD    SRVGRP=JSLGRP   SRVID=60
        CLOPT="-A -- -l 0x000207D0C864640A -c 0x00021f40C864640A"

Network Address Configurations

A Jolt Internet Relay configuration requires that several networked components work together. Prior to configuration, review the criteria in the following table and record the information to minimize the possibility of misconfiguration.

Jolt Internet Relay Network Address Configuration Criteria

JRLY	JRAD	JSL
LISTEN: Location where the clients connect. CONNECT: Location of your JRAD. Must match the -l parameter of JRAD.	-l: Location where the listener connects to the JRLY. -c: Location of JSL. Must match -n parameter of JSL.	-n: Location of JSL. Must match -c parameter of JRAD.