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