二、UBB 文件配置说明
UBB 配置文件分成*RESOURCES,*GROUP,*SERVER,*SERVICE,*NETWORK 等若干节。DEFAULT 表示该节中所有对象共有的缺省属性。
*RESOURCES
#RESOUCES 节提供整个系统的基本参数。
IPCKEY 55555 (32767-262143)
#进行IPC 通讯的key 值
DOMAINID unicom
#DOMAIN 的ID 值
MASTER unicom1,unicom2
#指定DOMAIN 中的管理主机为unicom1,运行过程中unicom1 若出现问题,管理主机切换至unicom2
MAXACCESSERS 1000
#这里该值表示整个系统中每个机器上可以访问TUXEDO 的Client 和Server的总数(可以访问 BBL 的最大进程数),应大于license 用户数+server 数(副本应记入)。该字段会被MACHINE 部分的MAXACCESSERS 覆盖。
#系统核心参数中SEMAPHORE 的数目(SEMMNS)要大于这里的MAXACCESSERS 数目,而ipc 消息个数(MSGMAX)应大于MAXACCESSERS 数+所有带REPLYQ 的SERVER 的个数。
MAXSERVERS 80
#最大的server 数(副本应记入)
MAXSERVICES 200
#最大的service 数(多个server 重复记入)
MAXGTT 20
#系统最多的并发的全局交易数目
MODEL MP
#表示cluster 方式,否则为SHM
OPTIONS LAN,MIGRATE
#多机cluster 方式时必须指定为LAN 方式,MIGRATE 表示可以以组为单位进行机器间SERVER 的迁移。
LDBAL Y
#允许负载均衡
SCANUNIT 10
#SCANUNIT 是BBL 在所有服务请求中定期扫描以寻找超时的交易和被阻塞
的调用和间隔时间(秒)。这个参数指定BBL 扫描间隔时间的基本单位, 它会影响在tpbegin 中指定的交易超时时间和用BLOCKTIME 指定的请求阻塞超时时间的精确程度。SANITYSCAN, BBLQUERY, DBBLWAIT, BLOCKTIME 等参数都是SCANUNIT的倍数,而不是实际秒数。而作为时间单位SCANUNIT 必须是5 的倍数,并且满足0<SCANUNIT<60。
SANITYSCAN 12
#SANITYSCAN的值指定在每个MACHINE上BBL自动检测所有进程的时间间隔,以SCANUNIT 为单元。缺省值满足(SCANUNIT*SANITYSCAN)约为120 秒。
DBBLWAIT 2
#DBBLWAIT 的值指定DBBL 扫描BBL 时等待所有BBL 应答的最大时间,以SCANUNIT 为单元,即超过DBBLWAIT*SCANUNIT(秒)就超时。每一次DBBL 将请求转发给它的BBL 时,BBL 会在请求返回结果之前先回复一个肯定的应答。这样可以定时检测死掉或不正常的BBL。缺省值满足(SCANUNIT*DBBLWAIT)的值等于SCANUNIT 和20 秒两者之间的最大者。
BBLQUERY 30
#BBLQUERY 指定DBBL 对所有BBL 进行状态检查的时间间隔,它也是以SCANUNIT 为计算单位。如果DBBL 的状态询问没有回答,该BBL 就被‘隔离’了。缺省值满足(SCANUNIT * BBLQUERY) 约为 300 秒。
BLOCKTIME 6
#BLOCKTIME 指定在阻塞队列中的被阻塞请求的超时时间,以SCANUNIT 为计算单位。缺省值满足(SCANUNIT * BLOCKTIME) 约为60 秒。
*MACHINES
DEFAULT:
#该部分对各主机进行描述。
unicom2 LMID=unicom2
APPDIR="/usr/tuxedo/apps/simpapp"
TUXCONFIG="/usr/tuxedo/apps/simpapp/tuxconfig"
TUXDIR="/usr/tuxedo"
UID=17
GID=26
MAXACCESSERS=100
unicom1 LMID=unicom1
APPDIR="/usr/tuxedo/apps/simpapp"
TUXCONFIG="/usr/tuxedo/apps/simpapp/tuxconfig"
TUXDIR="/usr/tuxedo"
UID=17
GID=26
MAXWSCLIENTS=50
#unicom2, unicom1 为网络主机名用hostname 获得。
#LMID:Logical Machines ID 为tuxedo 对主机的内部逻辑命名。
#APPDIR 要求放置SERVER 的可执行文件。
#TUXCONFIG 为全路径的二进制配置文件,要求和环境变量TUXCONFIG 相同。对于master 机tuxconfig 文件是由tmloadcf 生成的,而非master 机则是由tmboot 启动后由tlisten 从master 机上拷贝获得。
#TUXDIR 为tuxedo 安装目录,要求和环境变量TUXDIR 相同。
#MAXWSCLIENTS 表示可连接client 的最大个数。
*GROUPS
#GROUP1 为组名,LMID 表示该组运行的主机,GRPNO 为组号,OPENINFO 为该组通过XA 打开RM(通常指数据库)的初始串。
GROUP1 LMID=unicom2 GRPNO=1 OPENINFO=NONE
GROUP2 LMID=unicom3 GRPNO=2 OPENINFO=NONE
*SERVERS
#这里描述应用服务器。SRVGRP 的该SERVER 所属组名,SRVID 为服务器ID 号,MIN 表示该服务器CLOPT 提供运行的相关参数,要求是”-A -- ….”,可以在应用服务器的srvinit 函数中获得这些参数。
DEFAULT:
CLOPT="-A"
BillServer SRVGRP=GROUP1 SRVID=1 MIN=2 MAX=4
RQADDR=QNAME REPLYQ=Y
CLOPT="-A -o ./out.log –r -e ./err.log --
-p [L][low_water][,[terminate_time]][:[high_water][,create_time]]
如果MAX>1,并且使用了MSSQ(RQADDR, RQPERM)的Server 可以配置-p 来控制进程的增加和减少。控制算法如下:如果请求队列中的请求个数大于high_water 后超过create_time 秒,就增加该服务的一个新进程; 如果请求队列中的请求个数小于low_water 后超过terminate_time 秒, 就停止该服务的一个进程。low_water 缺省是平均每个服务进程有一个请求消息或者workload 50;high_water 缺省是平均每个服务进程有两个请求消息或者
workload 100. create_time 缺省是50, and terminate_time 缺省是60。
注意:使用TUXEDO 的服务进程池时,用户自己在程序中如果用alarm()等系统调用来停止进程是不起作用的,但也不会报错。[L] 标记意味着增减服务进程基于负载而不是请求队列的长度。仅用于SHM 模式下并且LDBAL=Y,否则会报错(LIBTUX_CAT:1542) ,服务进程也不会增减。
WSL SRVGRP=GROUP2 SRVID=1
CLOPT="-A -- -n //130.36.0.103:8889 -m 3 -M 10 -x 10 -T 10"
#WSL 用于和client 端进行连接。-n 表示出接入点为IP:PORT 方式,-m –M 表示最小和最大启动多少个WSH 和前端通讯,-x 则表示一个WSH 和几个client 端连接。-T 10 表示如果client 端和server 连接后10 分钟内没有交易请求则关闭连接。
*SERVICES
#不要求将所有的service 在这里描述,当某个service 有特别参数时才在
SERVICE 节中说明。
TOUPPER
*NETWORK
#NETWORK 节对多机之间如何进行网络连接进行描述。
#cluster 方式下要求先启动tlisten。事实上,对于非master 机启动应用服务器是由tlisten 完成的。
#tlisten 的启动方式为
#unicom1: tlisten –l //130.36.1.101:8891
#unicom2: tlisten –l //130.36.0.102:8891
#NADDR 指定网络连接的接入点。
#NLSADDR 则指定tlisten 的接入点。
#BRIDGE 则指TCP 连接所用的设备文件。
unicom2
NADDR="//130.36.0.102:8899"
NLSADDR="//130.36.0.102:8891"
BRIDGE="/dev/streams/xtiso/tcp"
unicom1
NADDR="//130.36.0.101:8899"
NLSADDR="//130.36.0.101:8891"
BRIDGE="/dev/streams/xtiso/tcp"