Copyright © Cloud Software Group, Inc. All Rights Reserved

Rendezvous Transport Communication

Rendezvous is the internal transport used for communication between the various components of the Core Engine.

Figure Rendezvous Transport Communication shows the communication for the various components using Rendezvous transport.

Figure 6 Rendezvous Transport Communication

Configuration Setup

This section explains the configuration setup required for Rendezvous communication.

To ensure that Rendezvous is only used as an internal transport with the Core Engine, do the following actions:

•	Kill any running Rendezvous daemons on the system.

•	Explicitly start the Rendezvous daemons.

You can start the Rendezvous daemons using the Rendezvous session parameters as defined in the ASG_CONFIG_HOME/asg.properties file. By default, the Rendezvous connection parameters are defined as follows:

−	RvDaemon tcp:7500

−

RvNetwork

−	RvService 7500

If you want to change the network, daemon or service parameters for the Rendezvous transport connection, edit the properties defined in the ASG_CONFIG_HOME/asg.properties and ASG_CONFIG_HOME/asg_cl.properties files. See Setting Rendezvous Transport Properties.

If the Gateway components are deployed on the machines within the same subnet, the rvd daemon is used. In case the components are deployed on the machines within different subnets, it requires the rvrd daemon setup. See TIBCO Rendezvous Administration Guide for the configuration setup and starting the Rendezvous daemons.

Setting Rendezvous Transport Properties

This section explains the properties to be set for Rendezvous transport as a communication channel between the TIBCO API Exchange Gateway components.

Rendezvous Session Connection Parameters for Apache Module

The parameters used for Apache module to connect to the Rendezvous daemon are defined in the mod_ASG.conf file located under ASG_HOME/modules/http_server/apache directory. To set the parameters for Apache module, do the following:

1.	Navigate to the ASG_HOME/modules/http_server/apache directory.

2.	Open the mod_ASG.conf file in a text editor.

3.	Set the values for the following parameters:

Table 19 Rendezvous Session Connection Parameters for Apache Module

Parameter	Description
AsgService	Specifies the Rendezvous daemon service parameter. The default value is: 7500
AsgNetwork	Specifies the Rendezvous daemon network parameter. The default value is: lo
AsgDaemon	Specifies the Rendezvous daemon parameter. This parameter is set as the tcp port. The default value is: tcp:7500
AsgSubject	• Specifies the subject to which the Rendezvous daemon sends the client request. The default value is: _LOCAL.asg.north.request You can change the default value, as required. • This value should match the value set in the tibco.clientVar.ASG/modRV/north_request parameter of the ASG_CONFIG_HOME/asg.properties file.

For the communication between the Apache module and the Core Engine, the Rendezvous session connection parameters in the ASG_CONFIG_HOME/asg.properties file and ASG_HOME/modules/http_server/apache/mod_ASG.conf file must match.

4.	Save the changes to the file.

Rendezvous Session Connection Parameters for Core Engine

This section lists the properties required for the Core Engine to listen to the messages from the Apache module using Rendezvous daemon. The properties are defined in the ASG_CONFIG_HOME/asg.properties file.

To set or edit the properties, do the following:

1.	Navigate to the ASG_CONFIG_HOME directory.

2.	Open asg.properties file in a text editor.

3.	Set the following properties:

Table 20 Rendezvous Session Parameters for Apache Module and Core Engine Communication

Parameter	Description
tibco.clientVar.ASG/modRV/facade_request	Specifies the subject name used by the Rendezvous daemon to listen to the requests from Apache module. The Core Engine listens to the requests on the same subject. • This property value must match the subject value specified in the Apache module configuration file (mod_ASG.conf) for Apache server. The default value is: _LOCAL.asg.north.request
tibco.clientVar.ASG/modRV/RvDaemon	Specifies the value of Rendezvous daemon for the Core Engine to connect and listen for the requests from the Apache module. The default value is: tcp:7500
tibco.clientVar.ASG/modRV/RvNetwork	Specifies the value of the Rendezvous network for the Core Engine to connect and listen for the requests from the Apache module. This property value must match the network value specified in the Apache module configuration file for Apache server.
tibco.clientVar.ASG/modRV/RvService	Specifies the value of the Rendezvous service for the Core Engine to connect and listen for the requests from the Apache module. The default value is: 7500

4.	Save the changes to the file.

Rendezvous Session Connection Parameters For Core Engine and Central Logger Communication

This section lists the properties required for Rendezvous communication between the Core Engine and the Central Logger. The properties are defined in the ASG_CONFIG_HOME/asg.properties and ASG_CONFIG_HOME/asg_cl.properties files.

Parameters for Rendezvous connection from Core Engine to Central Logger

The Core Engine uses the Rendezvous daemon to send messages to the Central Logger. Set the properties for the Core Engine to communicate with the Rendezvous daemon for the Central Logger in the ASG_CONFIG_HOME/asg.properties file as follows:

Table 21 Rendezvous Session Parameters for Core Engine to Communicate with Central Logger

Parameter	Description
tibco.clientVar.Common/Connections/RV/SubjectPrefix	Specifies the prefix for the Rendezvous subject names used by the Core Engine to communicate with the other components. The default value is: TIBCO.ASG.INTERNAL
tibco.clientVar.ASG/CL/RV/RvDaemon	Specifies the value of the Rendezvous daemon for the Core Engine to send messages to the Central Logger. The default value is: tcp:7500
tibco.clientVar.ASG/CL/RV/RvNetwork	Specifies the value of the Rendezvous network for the Core Engine to send messages to the Central Logger.
tibco.clientVar.ASG/CL/RV/RvService	Specifies the value of the Rendezvous service for the Core Engine to send messages to the Central Logger. The default value is: 7500

 

Parameters for Rendezvous connection for Central Logger

The Central Logger uses the Rendezvous to listen to the messages from the Core Engine. Set the properties for the Central Logger to communicate with the Rendezvous daemon in ASG_CONFIG_HOME/asg_cl.properties file as follows:

Table 22 Rendezvous Session Connection Parameters for Central Logger

Parameter	Description
tibco.clientVar.Common/Connections/RV/SubjectPrefix	Specifies the prefix for the Rendezvous subject names used by the Core Engine to communicate with the Central Logger. The default value is: TIBCO.ASG.INTERNAL
tibco.clientVar.ASG/CL/RV/RvDaemon	Specifies the value of the Rendezvous daemon for the Central Logger to listen to the messages from the Core Engine. The default value is: tcp:7500
tibco.clientVar.ASG/CL/RV/RvNetwork	Specifies the value of the Rendezvous network for the Central Logger to listen to the messages from the Core Engine.
tibco.clientVar.ASG/CL/RV/RvService	Specifies the value of the Rendezvous service for the Central Logger to listen to the messages from the Core Engine. The default value is: 7500

For the communication between the Core Engine and the Central Logger components, the Rendezvous session connection parameters in the ASG_CONFIG_HOME/asg.properties file and ASG_CONFIG_HOME/asg_cl.properties file must match.

Rendezvous Session Connection Parameters for Core Engine and Global Throttle Manager Communication

This section lists the properties required for the Rendezvous communication between the Core Engine and the Global Throttle Manager. The properties must be defined in the ASG_CONFIG_HOME/asg.properties file.

Table 23 Rendezvous Parameters for Core Engine And Global Throttle Manager Communication

Parameter	Description
tibco.clientVar.Common/Connections/RV/SubjectPrefix	Specifies the prefix for the Rendezvous subject names used by the Core Engine to communicate with other components. The default value is: TIBCO.ASG.INTERNAL
tibco.clientVar.ASG/GTM/RV/RvDaemon	• Specifies the value of the Rendezvous daemon for the Core Engine to connect to the Global Throttle Manager. The default value is: tcp:7500
tibco.clientVar.ASG/GTM/RV/RvNetwork	• Specifies the value of the Rendezvous network for the Core Engine to connect to the Global Throttle Manager.
tibco.clientVar.ASG/GTM/RV/RvService	• Specifies the value of the Rendezvous service for the Core Engine to connect to the Global Throttle Manager. The default value is: 7500

Copyright © Cloud Software Group, Inc. All Rights Reserved