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


Appendix A Sample Configurations : A Sample Installation

A Sample Installation
The large number of parameter files in an TIBCO Object Service Broker installation are designed to increase flexibility and give system administrators greater control. The following sample installation should help you understand the connections among these files.
This installation has 100 users of which 15 are developers, and 85 are production users. Each of these groups needs a separate service from TIBCO Object Service Broker. This system comprises three production Data Object Brokers connected as distributed data peers, with the developers using a fourth Data Object Broker, in Perth. Production is spread over three locations: Perth, Sydney, and Melbourne. The system administrator wants to be able to shutdown and restart any of these cities’ servers as a group, and to be able to identify the servers by the names appearing in the Data Object Broker log.
Data Object Broker
The first step is to identify the Data Object Brokers. You do this using parameters in the crparm file and the huron.dir file.
This is part of the crparm file for the Data Object Broker serving the users in Perth:

 
NODENAME=PDOB

 
The huron.dir file for this Data Object Broker appears as follows:

 
node name=PDOB,
host=WINHOST,
port=12000

 
TIBCO Object Service Broker Monitor Process
The next step is to create a separate TIBCO Object Service Broker monitor process (osMon) for each Data Object Broker. Multiple osMon's can run on the same machine as long as each has a unique port and tn3270port number. An identical mon.prm file is defined for each of Perth, Sydney and Melbourne. This is the resulting mon.prm file for our installations:

 
NAME=DEV
DOB=MYDOB
PORT=9068
TN3270PORT=9099
MONLOG=d:\ostar\log\devmon.log
 
NAME=PERTH
DOB=PDOB
SERVERS="10 PERSERV"
PORT=9069
TN3270PORT=9010
MONLOG=d:\ostar\log\permon.log
 
NAME=SYDNEY
DOB=SDOB
SERVERS="10 SYDSERV"
PORT=9070
TN3270PORT=9011
MONLOG=d:\ostar\log\sydmon.log
 
NAME=MELBOURNE
DOB=MELDOB
SERVERS="10 MELBSERV"
PORT=9071
TN3270PORT=9012
MONLOG=d:\ostar\log\melmon.log

 
Server Group Identification
Each group of SERVERS referenced in mon.prm requires a NAME entry in the session.prm file:

 
NAME= PERSERV
SERVERTYPE=PRS
SEARCH=I
EENAME=PERTH
SERVERLOGPATH=d:/temp
 
NAME= SYDSERV
SERVERTYPE=PRS
SEARCH=I
EENAME=SYDNEY
SERVERLOGPATH=d:/temp
 
NAME= MELSERV
SERVERTYPE=PRS
SEARCH=I
EENAME=MELBOURNE
SERVERLOGPATH=d:/temp

 
The same session.prm file can be used for each location. For ease of identification, we specified a unique EENAME for each location. You use the EENAME to reference a NAME entry in the ee.prm file, discussed later.
Setting Up Parameters for Users
Generally, the users of this system use the TIBCO Object Service Broker UI client, for which a parameter file is not required. The user can specify session parameters when starting the TIBCO Object Service Broker UI.
To log in using a 3270 emulator, a user supplies the host name or IP address of the machine running osMon and the osMon tn3270port number. For example, to log in to the Data Object Broker in Sydney, a user specifies the host name or IP address of the Sydney machine and a tn3270port of 9011.
Identifying the Execution Environment
Finally, an ee.prm entry must be created for each of the EENAMEs used in the session.prm.

 
NAME=PERTH
MAXSESSION=25
SECAUDITLOG=DISABLED
EELOG=d:/TIBCO Object Service Broker/log/PERTHee.log
 
NAME=SYDNEY
MAXSESSION=25
SECAUDITLOG=DISABLED
EELOG=d:/TIBCO Object Service Broker/log/PERTHee.log
 
NAME=MELBOURNE
MAXSESSION=25
SECAUDITLOG=DISABLED
EELOG=d:/TIBCO Object Service Broker/log/MELBee.log

 
Each Execution Environment has MAXSESSION set to 25. This does not mean that a total of 25 sessions can be supported by each Execution Environment. MAXSESSION controls the total number of sessions associated with a particular instance of that Execution Environment. Every Execution Environment can have multiple instances defined, up to the number specified by the MAXEE Execution Environment parameter. By not specifying a value for MAXEE in mon.prm, we choose to use the default value of 100. So in our example, the maximum number of sessions per Execution Environment is 100 x 25 (MAXEE x MAXSESSION) = 2500.
Using these configurations, the administrator can start and stop a distributed database server with a command such as:
osMon name=perth
...
osMon name=perth stop

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