---

7. Edit bankapp Configuration Files

---

Configuration Files for bankapp

A configuration file brings together all the detail about how an application maps to the machines on which it runs. As bankapp is delivered, there are two configuration files in the ASCII format described in ubbconfig(5). The file called ubbshm contains the configuration for an application on a single computer. The file called ubbmp contains the configuration for a networked application.

The configuration files are delivered with the value of some parameters enclosed in angle brackets (<>). You need to replace these generic values with values that pertain to your installation. All of these fields occur within the RESOURCES, MACHINES, and GROUPS sections in both files. In ubbmp, the NETWORK section also has entries you must localize. In Listing 7-1 we show ubbmp through the NETWORK section; this illustration also covers all the changes you need to make in RESOURCES, MACHINES, and GROUPS if you are bringing up a single-processor application. An explanation of the values that need to be replaced follows Listing 7-1.

If you want to enable the application password feature, add this line to the RESOURCES section of ubbshm or ubbmp:

SECURITY       APP_PW

Listing 7-1 Configuration File Fields to Be Replaced

---

     #Copyright (c) 1997 BEA Systems, Inc.
     #All rights reserved

     *RESOURCES
     IPCKEY           80952
001  UID              <user id from id(1)>
002  GID              <group id from id(1)>
     PERM             0660
     MAXACCESSERS     40
     MAXSERVERS       35
     MAXSERVICES      75
     MAXCONV          10
     MAXGTT           20
     MASTER           SITE1,SITE2
     SCANUNIT         10
     SANITYSCAN       12
     BBLQUERY         180
     BLOCKTIME        30
     DBBLWAIT         6
     OPTIONS          LAN,MIGRATE
     MODEL            MP
     LDBAL            Y
     #
     *MACHINES
003  <SITE1's uname>  LMID=SITE1
004                   TUXDIR="<TUXDIR>"
005                   APPDIR="<APPDIR>"
                      ENVFILE="<APPDIR>/ENVFILE"
                      TLOGDEVICE="<APPDIR>/TLOG"
                      TLOGNAME=TLOG
                      TUXCONFIG="<APPDIR>/tuxconfig"
006                   TYPE="<machine type>"
                      ULOGPFX="<APPDIR>/ULOG"
007  <SITE2's uname>  LMID=SITE2
                      TUXDIR="<TUXDIR>"
                      APPDIR="<APPDIR>"
                      ENVFILE="<APPDIR>/ENVFILE"
                      TLOGDEVICE="<APPDIR>/TLOG"
                      TLOGNAME=TLOG
                      TUXCONFIG="<APPDIR>/tuxconfig"
                      TYPE="<machine type>"
                      ULOGPFX="<APPDIR>/ULOG"
     #
     *GROUPS
     DEFAULT: TMSNAME=TMS_SQL   TMSCOUNT=2
     BANKB1   LMID=SITE1         GRPNO=1
008           OPENINFO="TUXEDO/SQL:<APPDIR>/bankdl1:bankdb:readwrite"
BANKB2        LMID=SITE2         GRPNO=2
009  OPENINFO="TUXEDO/SQL:<APPDIR>/bankdl2:bankdb:readwrite"
*NETWORK
010  SITE1    NADDR="<network address of SITE1>"
011           BRIDGE="<device of provider>"
012           NLSADDR="<network listener address of SITE1>"
013  SITE2    NADDR="<network address of SITE2>"
014           BRIDGE="<device of provider>"
015            NLSADDR="<network listener address of SITE2>"

---

Notes to Listing 7-1

The following table describes the values you must provide for the angle-bracketed strings.

Line	Value	Description
001	UID	The effective user ID (UID) for the owner of the bulletin board IPC structures. In a multiprocessor configuration, the value must be the same on all machines. You avoid problems by using the same UID as that of the owner of the BEA TUXEDO system software.
002	GID	The effective group ID (GID) for the owner of the bulletin board IPC structures. In a multiprocessor configuration, the value must be the same on all machines. Users of the application should share this group ID.
003	SITE1 name	The name of the machine. Use the value produced by the UNIX command: uname -n
004	TUXDIR	The absolute pathname of the root directory for the BEA TUXEDO system software. Make this a global change to put the value in all occurrences of <TUXDIR> in the file.
005	APPDIR	The absolute pathname of the directory where the application runs. Make this a global change to put the value in all occurrences of <APPDIR> in the file.
006	machine type	An identifying string. This parameter is important in a networked application where machines of different types are present. The BEA TUXEDO system checks for the value on all communication between machines. Only if the values are different are the message encode/decode routines called to convert the data.
007	SITE2 name	The name of the second machine. Use the value produced by the UNIX command: uname -n on that machine.
008	OPENINFO	The statement here and in the following entry are in a format understood by BEA TUXEDO system resource managers. They need to be changed (or removed) to meet the requirements of other resource managers.
009	Network Address of SITE1	The full network listening address of the bridge process on this machine. For example addresses, see Administering the BEA TUXEDO System.
010	Device of provider	The full pathname of the device for your network provider. This value should be the same for all entries in the NETWORK section.
011	Network listener address of SITE1	The value of the network listener address for the tlisten process on this machine.
012	Network Address of SITE2	The full network listening address of the bridge process on this machine. This will be a different value on each machine.
013	Device of provider	The full pathname of the device for your network provider. This value should be the same for all entries in the NETWORK section.
014	Network listener address of SITE2	The value of the network listener address for the tlisten process on this machine.

References

All of the configuration parameters and their values are described in ubbconfig(5) in the BEA TUXEDO Reference Manual.

As noted above, there are examples of the proper format for network address parameters in Administering the BEA TUXEDO System.

---

---