Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 Configuring a Communication Environment for Access of Distributed Data : Connecting Windows to Windows or Solaris

Connecting Windows to Windows or Solaris
This section describes a sample connection between two TIBCO Object Service Broker Data Object Brokers (node A and node B) on two Windows machines connected via TCP/IP. The sample would be the same for a Windows to Solaris connection. Node A is the local node and node B is the remote node with peer servers attached. This connection is referred to as an outgoing or outbound connection from node A.
Refer to Managing Peer Servers for more information about configuring and operating peer-to-peer distributed data connections.
Configuring Node A
1.
NODENAME=nodename
nodename is the Data Object Broker name. In this sample configuration, NODENAME=A.
PEERS=(remote_node, outbound#, inbound#, prefix, fslevel)
remote_node is the Data Object Broker name of the node to which this server is connecting. fslevel should be 2. The following example corresponds to the sample configuration PEERS=(B,9,10,NTK,2).
nn is the number of users needed to accomodate peer users. Valid values are 1 to 4096. MAXUSERS must be large enough to allow incoming peers to log in. Each incoming peer uses 2 user slots, for example, if the total incoming peers is equal to 10, 20 incoming slots of MAXUSERS should be devoted to incoming peers. In this sample configuration, MAXUSERS=32.
2.
To simplify the procedure, the same port number is used; the port numbers could differ if there is more than one Data Object Broker on a single machine.

 
node name=A,
host=brussels.monarch.com,
port=7209,
ipckey=0x7209
node name=B,
host=fornax.monarch.com,
port=7209,
ipckey=0x7209

 
Refer to Attributes Defined for details about the huron.dir entries.
Configuring Node B
1.
NODENAME=nodename
nodename is the Data Object Broker name of the node to which this server is connecting. In this sample configuration, NODENAME=B.
PEERS=(remote_node, outbound#, inbound#, prefix, fslevel)
remote_node is the Data Object Broker name. fslevel should be 2. The following example corresponds to the sample configuration PEERS=(A,9,10,NTK,2).
nn is the number of users needed to accomodate peer users. Valid values are 1 to 4096. MAXUSERS must be large enough to allow incoming peers to log in. Each incoming peer uses 2 user slots, for example, if the total incoming peers is equal to 10, 20 incoming slots of MAXUSERS should be devoted to incoming peers. In this sample configuration, MAXUSERS=32.
2.
3.
In your mon.prm file, specify the following values to the SERVERS Execution Environment parameter to define the peer servers, in the format SERVERS=’numberN sessionnameN’, where
Represents a session defined to the NAME parameter in the session.prm file (refer to step #4.), for example, PEERSERV1. It defaults to DEFAULT0 if left blank. If you specify a value on node A, the @PEERSERVERID shareable tool, which is a system-interpreted session table, must contain an entry with that name in the SERVERID field.
4.
If EENAME is specified, you must also specify a corresponding NAME parameter in the ee.prm file.
See Also
TIBCO Object Service Broker Shareable Tools for details about @PEERSERVERID
TIBCO Object Service Broker Parameters for detailed information about the Execution Environment and Data Object Broker parameters
Establishing the Connection
1.
On node A you should see the following messages in the Data Object Broker log:

 
2012/06/29 14:04:44 S6BUC013I Connection(0) to ’B’ established
2012/06/29 14:04:44 S6BUC013I Connection(1) to ’B’ established

 
On node B you should see the following messages in the Data Object Broker log:

 
2012/06/29 13:58:49 S6BUA020I Peer user ’NTA00001’ logged on from ’A’
2012/06/29 13:58:51 S6BUA020I Peer user ’NTA00002’ logged on from ’A’

 
2.

 
2012/06/29 14:02:38 S6BUA021I User ’@HR2WU01’ logged on from ’B’
2012/06/29 14:02:58 S6BUA023I PRS server DEFAULT0(THR2WU01) logged on from ’@HR2WU01’
2012/06/29 14:04:15 S6BUA021I User ’@HR2WU02’ logged on from ’B’
2012/06/29 14:04:29 S6BUA023I PRS server DEFAULT0(THR2WU02) logged on from ’@HR2WU02’

 
From node A, you can now access TIBCO Object Service Broker distributed data on node B. You must have identical TIBCO Object Service Broker userids on both nodes with the same security access.
Ending the Connection
1.
hrncr stopserver=ALLPRS
2.
For more information on hrncr, refer to Available Operator Commands.
See Also
TIBCO Object Service Broker Parameters for detailed information about the Execution Environment and Data Object Broker parameters.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved