TUXEDO之UBBCONFIG配置说明

UBBCONFIG文件的定义
一个tuxedo应用系统的所有资源都在一个文本文件中定义，该文件被称为UBBCONFIG。在配置完成后，UBBCONFIG被编译成一个二进制的文件：TUXCONFIG。在tuxedo系统启动时，会从该文件中读取系统的配置信息。UBBCONFIG文件类似Windows下的*.ini文件。

UBBCONFIG文件的组成
UBBCONFIG包括以下8部分，我们称之为节。

RESOURCE(必须) --> 与整个系统有关的配置信息。
MACHINES（必须） --> 一个tuxedo应用系统可以跨越多台服务器，在该节中配置与每台服务器有关的信息。
GROUPS（必须） --> tuxedo中规定而服务可以被分为多个组，在该节中配置与组有关的信息。
SERVERS（可选） --> 与server有关的信息在该节中配置。
SERVICES（可选） --> 与service有关的信息在该节中配置。
NETWORK（可选） --> 与网络有关的信息在该节中配置。
ROUTING（可选） --> 路由规则在该节中配置。
NETGROUPS（可选） --> 与网络分组有关的信息在该节中配置。

RESOURCES（必须）参数
IPCKEY:
tuxedo使用它标识公告板及其他的IPC资源，它不能与服务器上其他的IPC资源的ID号冲突，其范围为32769--262142。

MASTER:
指定tuxedo应用系统的MASTER服务器，在该服务器上对整个tuxedo系统进行管理配置。

DOMAINID
是该tuxedo应用系统的唯一标识。

UID
可对该tuxedo应用系统进行管理的tuxedo系统管理员的用户ID，在unix下就是unix系统的用户ID，默认为执行tmloadcf的用户的ID。

GID
在unix下为UID所指定的用户所在组的ID。

PERM
指定对tuxedo系统IPC资源的存取权限。默认为0666，即任何人都可以对该IPC资源进行存取。

MAXACCESSERS:
设定在本系统的一个节点（一台服务器）上，可以同时有多少个进程访问该tuxedo系统的公告板，默认值为50。它包括本地客户端进程、server进程、service进程，但不包括管理进程，如：BBL、DBBL等。

MAXSERVERS:
设定在本系统中，总共可以有多少个server存在，包括进行管理的server，如：BBL、TMS等。默认值为50。

MAXSERVICES:
设定在本系统中，总共可以有多少个service存在，默认值为100。

MAXACCESSERS、MAXSERVERS和MAXSERVICES三个参数控制该tuxedo应用系统对IPC资源的使用情况。

示例：

*RESOURCES
IPCKEY                       111111
PERM                          0660
MASTER                      SXBOSS
MAXACCESSERS         4000
MAXSERVERS             2000
MAXSERVICES            4000
MAXNETGROUPS         200
MAXGTT                   200
MAXCONV                 100
SCANUNIT 10
SANITYSCAN                   5
BBLQUERY                      180
BLOCKTIME                    900
MODEL                          SHM
SYSTEM_ACCESS            PROTECTED,NO_OVERRIDE
LDBAL                           Y

MACHINES（必须）参数
LMID
物理处理器名，可以通过”uname –n”或节点名得到

TUXDIR
TUXEDO系统软件安装位置

APPDIR
应用服务位置全路径

TUXCONFIG
TUXEDO配置文件全路径

ENVFILE
环境文件全路径

TYPE
指定该服务器类型，当两台服务器类型不同时，在它们之间传送数据要进行编码/解码工作

ULOGPFX
指定应用日志文件所在的目录及前缀。

UID、GID、PERM、MAXACCESSERS、MAXCONV在这里可以被重新配置，以这里为准

示例：

*MACHINES

nas3_old       LMID=SXBOSS
TYPE=AIX
APPDIR="/boss18/run/bin"
TUXCONFIG="/boss18/run/cfg/tuxconfig"
TUXDIR="/bea/tuxedo8.1"
ULOGPFX="/boss18/run/log/ULOG"
MAXWSCLIENTS=2000

GROUPS（必须）参数
一台机器至少要定义一个服务组。如果没有定义组，管理命令tmadmin可能依然能运行。每个组只要定义组名，映射组名的组号和逻辑机器名。组为分布式交易系统和数据依赖路由等灵活性措施提供了支持。

常见参数意义
组名
组的唯一标识符，可以是字母数字

GRPNO
组的唯一数字标识符

LMID
逻辑机器名

示例：

*GROUPS
OPENGRP_SXBOSS LMID=SXBOSS GRPNO=50
CHGGRP_SXBOSS LMID=SXBOSS GRPNO=60
PAYGRP_SXBOSS LMID=SXBOSS GRPNO=70
QRYGRP_SXBOSS LMID=SXBOSS GRPNO=80
CONGRP_SXBOSS LMID=SXBOSS GRPNO=90
WTCGRP_SXBOSS LMID=SXBOSS GRPNO=190 OPENINFO=NONE
WTCGRP_SXBOSS1 LMID=SXBOSS GRPNO=196 OPENINFO=NONE

SERVERS（可选）参数
SRVGRP
服务属于一个在*GROUPS节中定义的服务组名

SRVID
该Server所对应的ID。在组中应该唯一

MIN
最少启动的进程数

MAX
最多启动的进程数

RESTART
如果设成Y，则服务可以重启动

GRAC，MAXGEN
在GRACE定义时间之内，服务可以重启动MAXGEN次

RCMD
每次服务重启动要执行的一个可执行文件名

CLOPT
跟随服务启动的其他参数
-A 服务内建交易全发布
–r 指定服务记录时间戳，用于以后计算交易处理时间
-e 定义标准错误重定向文件
-o 定义标准输出重定向文件
-- TUXEDO参数和服务特定参数的分隔符
… 传给tpsvrinit()的参数

示例：

DEFAULT:
CLOPT="-A " SRVGRP=OPENGRP_SXBOSS
RESTART=Y       GRACE=0 MAXGEN=10

SERVICES（可选）参数
BUFTYPE
任何向该交易的请求，数据应该是此处定义类型

SRVGRP
交易所在服务所在的组

LOAD
负载因子，表示处理请求的时间，用于计算负载平衡，默认为50

PRIO
优先级，默认为50

示例：

*SERVICES
DEPOSIT    BUFTYPE=”FML”
                     SRVGRP=BANKB1
                     LOAD=25   PRIO=70