Deploying the Tuxedo Application Servers › Tuxedo Administrator Tasks › Configuring the UBBCONFIG File

Configuring the UBBCONFIG File

You need to configure several sections of the UBBCONFIG file to allow CA Gen generated clients and servers to interact in a Tuxedo environment. See the OracleTuxedo documentation on minimum Tuxedo specific requirements, and the CA Gen specific requirements described in the UBBCONFIG template file.

A commented UBBCONFIG template is located in $IEFH/make directory. The following sample UBBCONFIG file illustrates a one server implementation. Pay special attention to the SERVERS and SERVICES sections.

Sample UBBCONFIG File

# Copyright (C) 2009 CA, All rights reserved.
# Sample ubbconfig file for Gen application
# Replace the <bracketed> items with the appropriate values.
# Rename this file following any modification
*RESOURCES
IPCKEY               <Replace with a valid IPC Key>

#Example:
#IPCKEY              123456
DOMAINID             GENAPP
MASTER               ADVANTAGE
MAXACCESSERS         15
MAXSERVERS           10
MAXSERVICES          20
MODEL                SHM
LDBAL                Y
#Change security level as necessary
SECURITY             NONE
*MACHINES
DEFAULT:
ENVFILE="<Replace with your ENVFILE pathname>"
APPDIR="<Replace with the application directory pathname>"
TUXCONFIG="<Replace with your TUXCONFIG pathname>"
TUXDIR="<Replace with your Tuxedo installation directory>"
MAXWSCLIENTS=<replace with the MAX NUMBER OF WS CLIENTS>
TYPE="hpux"
TLOGDEVICE="<Replace with your TLOG pathname>"
TLOGNAME="TLOG"
TLOGSIZE=10

#Example:
#        ENVFILE="/users/tony/GENAPP/inqload/ENVFILE"
#        APPDIR="/users/tony/GENAPP/inqload"
#        TUXCONFIG="/users/tony/GENAPP/inqload/tuxconfig"
#        TUXDIR="/opt/tuxedo"
#        MAXWSCLIENTS=9
#        TYPE="hpux"
#        TLOGDEVICE="/users/tony/IT/TEST/inqload/TLOG"
#        TLOGNAME="TLOG"
#        TLOGSIZE=10
<Machine-name>        LMID=ADVANTAGE
#Example:
#salesunx             LMID=ADVANTAGE
*GROUPS
GROUP1
  LMID=ADVANTAGE   GRPNO=1 TMSNAME="TMS_Oracle" TMSCOUNT=2
  OPENINFO="Oracle_XA:Oracle_XA+Acc=P/<Oracle usrname>/<Oracle
  password>+S
  esTm=60"
GROUP2
        LMID=ADVANTAGE   GRPNO=2
#Example of OPENINFO
#for Oracle:
#OPENINFO="Oracle_XA:Oracle_XA+Acc=P/tony/tonypassword+SesTm=60"
#Create one entry in *SERVER section for every server load module
#you wish to deploy
*SERVERS
#XA Server.
<SERVER LOAD MODULE NAME> SRVGRP=GROUP1 SRVID=1
                          RQADDR=<Give a unique queue name for each
                          server LM>
                          REPLYQ=Y
                          CLOPT="-A -- -t 15"
#Non-XA Server
<SERVER LOAD MODULE NAME> SRVGRP=GROUP2 SRVID=1
                          RQADDR=<Give a unique queue name for each
                          server LM>
                          REPLYQ=Y
                          CLOPT="-A -- -O"
#Example:
#SERVER1                  SRVGRP=GROUP1 SRVID=1
#                         RQADDR=SERVER1_Q
#                         REPLYQ=Y
#                         CLOPT="-A -- -t 15"
#
#SERVER2                  SRVGRP=GROUP2 SRVID=1
#                         RQADDR=SERVER2_Q
#                         REPLYQ=Y
#                         CLOPT="-A -- -O"
#Add security server if needed
#AUTHSVR                  SRVGRP=GROUP1 SRVID=23 RQADDR=AUTH_Q 
REPLYQ=Y
#Workstation Listener Server
WSL                       SRVGRP=GROUP1 SRVID=21   RQADDR=WSL_Q   REPLYQ=Y                  CLOPT="-A -- -n <Address and port no.>
#Example of  WSL network address using TCP:
#CLOPT="-A -- -n  0x00029000AC193709"
#TCP: 0002         Port: 9000          IP address: AC 19 37 09 (172.25.55.9)
# Jolt Listener (JSL) Server.
# To be set for Tuxedo server's that need to be accessed using the Jolt API
JSL     SRVGRP=GROUP1 SRVID=21   RQADDR=JSL_Q   REPLYQ=Y
        CLOPT="-A -- -n //hostName:portNumber"
# Jolt Repository Server (JREPSVR)
# The server that handles the jolt repository which stores the Server Interfaces
# used by the Jolt based clients. RepositoryFileName specifies the repository file
JREPSVR SRVGRP=GROUP1 SRVID=22 RESTART=Y MAXGEN=3 GRACE=0 
        CLOPT="-A -- -W -P repositoryFileName"