Tuxedo学习笔记－UBBCONFIG
一个Tuxedo应用系统的所有资源都在一个文本文件中进行定义，该文件称为UBBCONFIG。在配置完成之后，UBBCONFIG被编译成一个二进制的文件TUXCONFIG。在Tuxedo系统启动时，从该文件中读取系统的配置信息。UBBCONFIG文件类似于Windows下的*.ini文件。它包括以下8大部分，我们称之为节。
Ø *RESOURCES节（必须）：与整个系统有关的配置信息
Ø *MACHINES节（必须）：一个Tuxedo应用系统可能跨越多台服务器，在该节中配置与每台服务器有关的信息
Ø *GROUPS节（必须）：Tuxedo中的服务可被分为多个组，在该节配置与组有关的信息
Ø *SERVERS节（可选）：与Server有关的信息
Ø *SERVICES节（可选）：与Services有关的信息
Ø *NETWORK节（可选）：与网络有关的信息
Ø *ROUTING节（可选）：配置路由规则
Ø *NETGROUPS节（可选）：与网络分组有关的信息
一个Tuxedo应用系统＝服务端程序＋客户端程序＋配置文件
Server：每一个服务端程序文件都被编译成一个相应的可执行文件，该文件在运行的时候称为Server，它实际上就是一个进程。
Services：在每个服务端程序中，主要是一个个函数，在Tuxedo中称这些函数为Services，一般也称之为服务。
一个系统可以跨越多台服务器，一台服务器可以有多个Group，但一个Group只能在一台服务器上，一个Group可以有多个Server，一个Server可以有多个Service
*RESOURCES节
常见参数意义
参数
意义
IPCKEY
共享内存id。Tuxedo用它标识公告板和其它IPC资源，范围32769~262142
MASTER
指出主控节点的逻辑名LMID，也可以为该MASTER机指定一台备份机
UID
TUXEDO管理员用户id，在UNIX下就是执行tnloadcf的用户ID，在Windows下没用，取0
GID
TUXEDO管理员用户所在的组id。在Windows下取0
PERM
指定对此IPC资源的存取权限。默认为0666，即任何人都可以对该IPC资源进行存取
DOMAINID
该TUXEDO应用系统的唯一标识
MAXACCESSERS
设定在本系统一个节点（一台服务器）上，可以有多少进程访问该系统的公告板，默认为50
MAXSERVERS
设定系统中最多有多少个Server存在，默认值50
MAXSERVICES
设定系统中最多有多少个Service存在，默认值100
MODEL
部署模式：SHM（单机或者多台服务器但公用一个全局共享内存）、MP（多台服务器但没使用一个全局共享内存）
OPTION
LAN（表使用MP部署模式），MIGRATE（表服务可以移植到替代处理器上）
SCANUNIT
内部时间间隔单位，单位是秒，默认值10秒
SANITYSCAN Tuxedo的管理进程BBL定时对它所在的服务器上的Tuxedo系统进行检查，检查超时的事务、超时的客户端连接等。SANITYSCAN指每隔多少个SCANUNIT检查一次，默认值12，即为12×SCANUNIT（默认10秒）＝120秒
BLOCKTIME 交易超时时间，单位是SCANUNIT，默认值6
MAXCONV
同时最大会话数，范围：0～32768，默认值10
NOTIFY
设置消息的通知方式。默认为DIPIN（当客户端调用ATMI函数时，顺便查看是否有消息，如果有就发送给Client）
范例：
*RESOURCES
IPCKEY 80952 UID 213 GID 1 PERM 0660 MAXACCESSERS 150 MAXSERVERS 75 MAXSERVICES 200 MASTER SITE1,SITE2 MODEL MP OPTIONS LAN,MIGRATE SCANUNIT 10 SANITYSCAN 12 BLOCKTIME 3 MAXCONV 10 NOTIFY DIPIN
*MACHINES节
常见参数意义
参数
意义
LMID
物理处理器名，可以通过”uname –n”或节点名得到
TUXDIR
TUXEDO系统软件安装位置
APPDIR
应用服务位置全路径
TUXCONFIG
TUXEDO配置文件全路径
ENVFILE
环境文件全路径
TYPE
指定该服务器类型，当两台服务器类型不同时，在它们之间传送数据要进行编码/解码工作
ULOGPFX
指定应用日志文件所在的目录及前缀。
UID、GID、PERM、MAXACCESSERS、MAXCONV在这里可以被重新配置，以这里为准
*GROUPS节
一台机器至少要定义一个服务组。如果没有定义组，管理命令tmadmin可能依然能运行。
每个组只要定义组名，映射组名的组号和逻辑机器名。组为分布式交易系统和数据依赖路由等灵活性措施提供了支持。
常见参数意义
参数
意义
组名
组的唯一标识符，可以是字母数字
GRPNO
组的唯一数字标识符
LMID
逻辑机器名
范例
*GROUPS
BANKB1 GRPNO=200 LMID=SITE1
BANKB2 GRPNO=220 LMID=SITE1
SYSGRP GRPNO=110 LMID=SITE1
EVTGRP1 GRPNO=120 LMID=SITE1
*SERVERS节
常见参数意义
参数
意义
SRVGRP
服务属于一个在*GROUPS节中定义的服务组名
SRVID
该Server所对应的ID。在组中应该唯一
MIN
最少启动的进程数
MAX
最多启动的进程数
RESTART
如果设成Y，则服务可以重启动
GRAC，MAXGEN
在GRACE定义时间之内，服务可以重启动MAXGEN次
RCMD
每次服务重启动要执行的一个可执行文件名
CLOPT 跟随服务启动的其他参数
-A 服务内建交易全发布
–r 指定服务记录时间戳，用于以后计算交易处理时间
-e 定义标准错误重定向文件
-o 定义标准输出重定向文件
-- TUXEDO参数和服务特定参数的分隔符
… 传给tpsvrinit()的参数
在默认情况下，Tuxedo的每一个Server对应一个请求队列，也可以多个Server对应一个请求队列，即MSSQ方式，以提高响应的速度。方法是设置以下参数。
RQADDR：当设定此项后，所有本服务的实例都使用相同的请求队列。这是在应用中设置MSSQ（Multiple Server Single Queue）的方便办法，可以改善处理流量。任何时候，所有MSSQ集中的实例发布相同的交易集。
XFER：另一个服务
REPLYQ： 设成Y，则服务又作为一个MSSQ集配置，任何其中的交易调用其他交易，就建立一个单独的回应队列。
范例
*SERVERS
DEFAULT: RESTART=Y MAXGEN=5 GRACE=3600
RCMD=”/sur/apps/atmapp/scripts/beeper”
CLOPT=”-A” ENVFILE=”/usr/apps/atmapp/envfile”
TLR SRVGRP=BANKB1 SRVID=10 MIN=1 MAX=2
CLOPT=”-A –r
-e /usr/apps/atmapp/logs/TLR1.err
-o /usr/apps/atmapp/logs/TLR1.out
--
-T 101 –e 300 –d dbfile”
SYSTEM_ACCESS=PROTECTED
RQADDR=”TLR_Q1”
XFER SRVGRP=BANKB1 SRVID=20 MIN=1 MAX=2
RQADDR=”XFER_Q1” REPLYQ=Y
CLOPT=”-A –r”
*SERVICES节
常见参数意义
参数
意义
BUFTYPE
任何向该交易的请求，数据应该是此处定义类型
SRVGRP
交易所在服务所在的组
LOAD
负载因子，表示处理请求的时间，用于计算负载平衡，默认为50
PRIO
优先级，默认为50
范例
*SERVICES
DEPOSIT BUFTYPE=”FML”
SRVGRP=BANKB1
LOAD=25 PRIO=70
配置文件的编译（生成TUXCONFIG文件）
UBBCONFIG文件是一个可以编辑成需要的应用配置的文本文件。但是，/T在实际应用上读取的是二进制TUXCONFIG文件用于操作。命令tmloadcf可以把UBBCONFIG文件转化成TUXCONFIG文件。
Tmloadcf -y UBBCONFIG文件名
tmloadcf命令接受以下4个参数：
-c 计算运行应用需要的IPC资源，该信息将提供给管理员，用于在各机器上配置资源。
-n 进行语法检查并不生成TUXCONFIG。
-b 控制TUXCONFIG占用的物理页数。
-y 无条件覆盖TUXCONFIG，对全部问题都选“yes”
反编译命令tmunloadcf将TUXCONFIG转换成ASCII格式用于检查。该工具读取环境变量TUXCONFIG指向的文件。输出包含所有的参数，包括TUXEDO设定的缺省值，是UBBCONFIG文件的一个超集。
Tmunloadcf >myubb
http://blog.csdn.net/xfanghua/archive/2005/04/21/357171.aspx