综合业务系统配置文档TUXEDO配置文档.docx
《综合业务系统配置文档TUXEDO配置文档.docx》由会员分享,可在线阅读,更多相关《综合业务系统配置文档TUXEDO配置文档.docx(35页珍藏版)》请在冰豆网上搜索。
综合业务系统配置文档TUXEDO配置文档
综合业务系统-配置文档
TUXEDO配置文档
V1.0.1
2004年3月
上海华腾软件系统有限公司
修订控制页
章节编号
章节名称
修订内容简述
修订日期
修订前版本号
拟稿人
已评审
一:
参数诠释
区域
属性
备注
缺省值
resource
IPCKEY
IPCKEY是一个数字键值,用来标识应用所用到的共享内存块。
这个值必须大于32768,小于262143
MASTER
MASTER是应用分配给机器的一个逻辑名称(LMID)
PERM
表示BBL中IPC结构的访问权限
MAXACCESSERS
可以同时访问BBL的进程个数,不包括管理服务和tmadmin。
取值在0与32768之间
50
MAXACLGROUPS
支持ACL权限检查的组的最大个数
MAXGTT
支持的最大并发事务个数
100
MAXGROUPS
在BBL中可配置的最大组个数
MAXMACHINES
在BBL中可配置的最大机器数量
MAXQUEUES
在BBL中可配置的最大服务请求队列
MAXDRT
配置的最大数据路由标准个数
MAXRFT
配置的最大数据路由范围条数
MAXRTDATA
最大数据路由字符串缓存大小
MAXSERVERS
在BBL中server的个数,在0与32768之间
50
MAXSERVICES
在BBL中service的个数,在0与32768之间
100
MAXCONV
表示可以支持的同时会话的个数
10
MODEL
定义应用的类型,只有两种选择:
SHM和MP,SHM表示共享内存方式MP表示多处理器方式
LDBAL
表示是否采用负载平衡
CMTRET
表示TP_COMMIT_CONTROL这个属性的初始化值,支持COMPLETE|LOGGED
COMPLETE
MAXBUFTYPE
在BBL中可配置的最大buffer种类
SCANUNIT
BBL寻找旧事务和阻塞请求之间的时间(单位:
秒)
10
SANITYSCAN
检查应用健全的SCANUNIT的倍数时间
DBBLWAIT
DBBL等待每个BBL超时的SCANUNIT的倍数时间
BBLQUERY
DBBL验证状态的频率的SCANUNIT的倍数时间
BLOCKTIME
阻塞一个请求的最大允许的SCANUNIT的倍数时间
NOTIFY
表示发送到客户端的消息的触发方式
SYSTEM_ACCESS
取值为FASTPATH或ROTECTED,其中FASTPATH表示可以用非保护方式快速访问内部表,ROTECTED表示用保护方式快速访问内部表
USIGNAL
表明应用的信号
machines
LMID
LMID是处理机的逻辑名称,LMID的定义不能超过30个字符,并不允许含有逗号和点号
TUXCONFIG
是二进制配置文件的绝对路径,不能超过64个字符
TUXDIR
是TUXEDO系统安装的绝对路径
APPDIR
是应用所在的绝对路径
TLOGDEVICE
表示TLOG设备
TLOGNAME
表示DTP交易日志的名称
TLOGSIZE
表示TLOG的页数,
100
ENVFILE
本机所要执行的环境变量
MAXWSCLIENTS
保留的最大客户端访问数量
CMPLIMIT
表示给远程和本地进程的消息的最大长度
NETLOAD
计算在机器间传递请求的耗时时,增加附加负载
0
SPINCOUNT
信号量阻塞处理前,在用户级给BBL加锁的尝试次数
MAXACLCACHE
在缓存中ACL条目最大个数
groups
OPENINFO
表示启动一个资源管理器需要的信息
TMSNAME
表示与本组相关的TMS
TMSCOUNT
启动TMSNAME的个数
GRPNO
是组的一个数字表示,大与0,小于30000,并且要唯一
servers
SRVGRP
指明了server的组
SRVID
是一个数字,表示一组内的一个server,这个数字在1至30000之间。
CLOPT
是一系列命令选项,在启动时传递给进程。
最大长度不能超过256,用双引号引起来。
-A:
表示启动时发布所有的服务
-e:
重新定向错误到一个文件
-o:
指明进程的标准输出
RQADDR
请求消息队列的一个符号
REPLYQ
表示请求消息队列和应答消息队列是否分开,’Y’表示分开,’N’表示不分开
RQPERM
给请求消息队列分配访问权限
RPPERM
给应答消息队列分配访问权限,只有当REPLYQ为Y时,此参数起作用
SYSTEM_ACCESS
取值为FASTPATH或ROTECTED,其中FASTPATH表示可以用非保护方式快速访问内部表,ROTECTED表示用保护方式快速访问内部表
MAXGEN
控制在GRACE参数指定的时间内的启动次数
1
GRACE
如果RESTART为’Y’,本参数表示服务重起MAXGEN-1次所需要的时间(单位:
秒)
86400
RESTART
表明server是否可以重启动
MAX
Server的最大并发数
MIN
Server的最小并发数
CONV
‘Y’表明是一个会话服务,如果是一个请求/应答服务,可以忽略这个参数或设为’N’
二:
案例讲解
应用的描述信息配置在系统核心位置,用一个文件描述,通常称为ubbconfig文件,在主控机器上。
整个TUXEDO系统的管理任务可以在一台机器上完成,在配置中被定为主控节点。
在运行时,这些信息被装入一段共享内存(一个IPC资源),称为公告牌(BulletinBoard—BB);包含有配置中不同机器的信息,在这些机器上运行的服务的信息,这些服务提供的交易的信息以及其他相关信息。
客户端在运行时连接公告牌。
当客户端程序调用一个交易,将根据公告牌找到合适的服务队列。
所以,公告牌是:
——供客户端寻找适当的服务运行一个交易请求
——包含应用信息:
机器,服务,交易,网络等
——创建于ubbconfig文件
TUXEDO提供一个管理进程,称为BBL(BulletinBoardLiaison),包含了一个公告牌的本地拷贝和本地服务器上应用的状态。
TUXEDO提供的另一个管理进程DBBL(DistinguishedBulletinBoardLiaison),用于多服务器配置时。
DBBL与BBL协同,保证所有部分的公告牌内容的一致性。
2.1配置文件
任何TUXEDO应用系统的最基本的管理任务,是建立并维护配置文件。
该文件通常称为ubbconfig文件。
负责该工作的系统管理员必须很好的了解分布于各台机器上的应用服务的数据流,消息队列的构造,资源间的相互关系。
ubbconfig文件可视作包含应用启动信息的容器,需编译成二进制文件tuxconfig,作为启动时的参考。
其内信息包括:
系统范围信息(*RESOURCES节)
机器信息(*MACHINES节)
组信息(*GROUPS节)
服务信息(*SERVERS节)
交易信息(*SERVICES节)
网络组信息(*NETGROUPS节)
网络信息(*NETWORK节)
路由原则信息(*ROUTING节)
当完成了ubbconfig文件后,用tmloadcf命令生成tuxconfig。
另一种从ubbconfig生成tuxconfig的方法是使用图形管理界面(GAI—GraphicalAdministrationInterface)。
2.2应用的信息
*RESOURCES节包含整个应用范围的信息。
本节必须在配置文件第一节,不可缺少。
信息说明如下:
参数
意义
RESOURCES
RESOURCES节
IPCKEY
共享内存id
UID
TUXEDO管理员用户id
GID
TUXEDO管理员用户id
PERM
TUXEDO管理员组用户的权限
MAXACCESSERS
服务端和客户端的最大进程数
MAXSERVERS
限制可以启动服务总数
MAXSERVICES
限制可以发布交易总数
MASTER
指出主控节点的逻辑名,第二个是备份节点
MODEL
应用构架,MP表示多机
OPTIONS
LAN,MIGRATE表示是一个网络应用,服务可以移植到替代处理器上
SECURITY
安全级别(5个)
AUTHSVC
客户端可以通过交易“AUTHSVC”获得认证
NOTIFY
DIPIN客户端通过dip-in收到广播通知
SYSTEM_ACCESS
PROTECTED,NO_OVERRIDE,应用代码不得干扰共享内存
LDBAL
设Y则进行负载平衡
MAXBUF[S]TYPE
数据缓冲类型及子类的最大数
CANUNITS
内部时间间隔单位,单位是秒
SANITYSCAN
检索公告牌的内部时间间隔,单位是SCANUNIT
BLOCKTIME
交易超时时间,单位是SCANUNIT
BBLQUERY
DBBL查询所有BLL的时间间隔
DBBLWAIT
DBBL等待BBL回应的超时时间
MAXCONV
同时最大会话数
注意:
本处未列出全部参数。
这些系统范围内参数可以被后序节内参数超越。
范例
*RESOURCES
IPCKEY80952
UID213
GID1
PERM0660
MAXACCESSERS150
MAXSERVERS75
MAXSERVICES200
MASTERSITE1,SITE2
MODELSHM
OPTIONSLAN,MIGRATE
SECURITYAPP_PW
AUTHSVCAUTHSVC
NOTIFYDIPIN
SYSTEM_ACCESSPROTECTED,NO_OVERRIDE
LDBALY
MAXBUFTYPE10
MAXBUFSTYPE15
SCANUNIT10
SANITYSCAN12
BLOCKTIME3
BBLQUERY24
DBBLWAIT10
MAXCONV10
2.3机器信息
*MACHINES节包含应用有关的每个处理器的信息。
本节必须在*RESOURCES节后列出。
参数
意义
MACHINES
MACHINES节
TUXDIR
TUXEDO系统软件安装位置
APPDIR
应用服务位置全路径
TUXCONFIG
TUXEDO配置文件全路径
ENVFILE
环境文件全路径
ULOGPFX
应用日志文件全路径
MAXACCESSERS
本机最多处理器数,可以超越*RESOURCES节定义
MAXCONV
本机最大会话数,可以超越*RESOURCES节定义
ibm_p610
物理处理器名,可以通过”uname–n”或节点名得到
范例
*MACHINES
ibm_p610LMID=SJZCCB
TUXDIR=”/tuxedo”
APPDIR=”/app2/sjzccb/run”
TUXCONFIG=”/app2/sjzccb/tuxedo/tuxconfig”
ENVFILE=”/app2/sjzccb/tuxedo/ENVFILE”
ULOGPFX=”/usr/apps/atmapp/logs/ULOG”
MAXACCESSERS=100
MAXCONV=15
2.4组定义
*GROUP节包含服务组的定义。
一台机器至少要定义一个服务组。
如果没有定义组,管理命令tmadmin可能依然能运行。
每个组只要定义组名,映射组名的组号和逻辑机器名。
组为分布式交易系统和数据依赖路由等灵活性措施提供了支持。
参数
意义
GROUPS
GROUP节
BANKB1
组的唯一标识符,可以是字母数字
GRPNO
组的唯一数字标识符
LMID
组所在的机器
范例
*GROUPS
HOSTGRPNO=200LMID=SITE1
HOSTINQGRPNO=220LMID=SITE1
WSGRPNO=110LMID=SITE1
2.5服务定义
ubbconfig的*SERVERS节包含的是服务进程的信息。
本节中每一个入口代表一个应用启动时加载的服务。
这些信息包含服务名,命令行参数,服务环境,重启动等等。
由于每个服务功能各不相同,其配置参数也因此相同或相异。
参数
意义
SERVERS
SERVER节,列出所有服务程序
DEFAULT
本处列出的参数为其下列出的服务的缺省值,但可以被单列条目替代相应值
RESTART
如果设成Y,则服务可以重启动
MAXGEN
在GRACE定义时间之内,服务可以重启动MAXGEN次
GRACE
周期,单位是秒
RCMD
每次服务重启动,本处定义的脚本或命令被执行
ENVFILE
列有环境变量的文件,在交易启动前设入环境
TLR
一个服务名,用buildserver建立,应在APPDIR或$TUXDIR/bin
SRVGRP
服务属于一个在*GROUPS节中定义的服务组;如果需要移植服务,也可以定义在多个组中。
SRVID
服务组中代表服务的唯一值
MIN
最少在启动时启动的服务数
MAX
运行时,最多可以起的实例数
CLOPT
跟随服务启动的其他参数
-A服务内建交易全发布
–r指定服务记录时间戳,用于以后计算交易处理时间
-e定义标准错误重定向文件
-o定义标准输出重定向文件
--TUXEDO参数和服务特定参数的分隔符
…传给tpsvrinit()的参数
SYSTEM_ACCESS
设定后,应用错误不干扰公告牌
RQADDR
当设定此项后,所有本服务的实例都使用相同的请求队列。
这是在应用中设置MSSQ(MultipleServerSingleQueue)的方便办法,可以改善处理流量。
任何时候,所有MSSQ集中的实例发布相同的交易集。
XFER
另一个服务
REPLYQ
设成Y,则服务又作为一个MSSQ集配置,任何其中的交易调用其他交易,就建立一个单独的回应队列。
范例
*SERVERS
DEFAULT:
RESTART=YMAXGEN=5GRACE=3600
RCMD=”/sur/apps/atmapp/scripts/beeper”
CLOPT=”-A”ENVFILE=”/app2/sjzcb/tuxedo/envfile”
TLRSRVGRP=HOSTSRVID=10MIN=1MAX=2
CLOPT=”-A–r-e/usr/apps/atmapp/logs/TLR1.err-o/usr/apps/atmapp/logs/TLR1.out---T101–e300–ddbfile”
SYSTEM_ACCESS=PROTECTEDRQADDR=”TLR_Q1”
XFERSRVGRP=BANKB1SRVID=20MIN=1MAX=2RQADDR=”XFER_Q1”REPLYQ=YCLOPT=”-A–r”
2.6交易定义
*SERVICES节提供了应用的特殊交易的信息。
包括负载平衡(LOAD)和数据缓冲类型检查(BUFTYPE)。
如果全部都是缺省值则本节可以省略。
参数
意义
SERVICES
交易节
#
注释行符号
BUFTYPE
任何向该交易的请求,数据应该是此处定义类型
GROUP
交易所在服务所在的组
LOAD
负载因子,表示处理请求的时间,用于计算负载平衡
PRIO
优先级
范例
*SERVICES
#commentline
DEPOSITBUFTYPE=”FML”
SRVGRP=BANKB1
LOAD=25PRIO=70
2.7生成TUXCONFIG文件
UBBCONFIG文件是一个可以编辑成需要的应用配置的文本文件。
但是,/T在实际应用上读取的是二进制TUXCONFIG文件用于操作。
命令tmloadcf可以把UBBCONFIG文件转化成TUXCONFIG文件。
tmloadcf命令接受以下4个参数:
-c计算运行应用需要的IPC资源,该信息将提供给管理员,用于在各机器上配置资源。
-n进行语法检查并不生成TUXCONFIG。
-b控制TUXCONFIG占用的物理页数。
-y无条件覆盖TUXCONFIG
环境变量TUXCONFIG必须设定指向二进制TUXCONFIG文件。
在安全要求高的应用中,tmloadcf不能从标准输入接受,环境变量APP_PW必须包含应用密码。
tmunloadcf将TUXCONFIG转换成ASCII格式用于检查。
该工具读取环境变量TUXCONFIG指向的文件。
输出包含所有的参数,包括TUXEDO设定的缺省值,是UBBCONFIG文件的一个超集。
附件1:
生产机UBB配置
*RESOURCES
IPCKEY59018
MASTERSJZCCB
PERM0660
MAXACCESSERS1500
MAXACLGROUPS16384
MAXGTT100
MAXGROUPS100
MAXMACHINES256
MAXQUEUES80
MAXDRT0
MAXRFT0
MAXRTDATA4
MAXSERVERS120
MAXSERVICES140
MAXCONV10
MODELSHM
LDBALY
CMTRETCOMPLETE
MAXBUFTYPE16
MAXBUFSTYPE32
SCANUNIT10
SANITYSCAN12
DBBLWAIT2
BBLQUERY30
BLOCKTIME6
NOTIFYDIPIN
SYSTEM_ACCESSFASTPATH
USIGNALSIGUSR2
*MACHINES
"ibm_p610"LMID="SJZCCB"
TUXCONFIG="/app2/sjzccb/tuxedo/tuxconfig"
TUXDIR="/tuxedo"
APPDIR="/app2/sjzccb/run/"
TLOGDEVICE="/app2/sjzccb/tuxedo/TLOG"
TLOGNAME="TLOG"
TLOGSIZE=100
ENVFILE="/app2/sjzccb/tuxedo/envfile"
MAXWSCLIENTS=900
CMPLIMIT="MAXLONG,MAXLONG"
NETLOAD=0
SPINCOUNT=0
MAXACLCACHE=100
*GROUPS
"HOST"LMID="SJZCCB"GRPNO=1
OPENINFO="INFORMIX-OnLine:
sjzccb"
TMSNAME="TMS_INFX"
TMSCOUNT=2
"HOSTINQ"LMID="SJZCCB"GRPNO=2
OPENINFO="INFORMIX-OnLine:
sjzinq"
TMSNAME="TMS_INFX"
TMSCOUNT=2
"WS"LMID="SJZCCB"GRPNO=3
TMSCOUNT=3
*SERVERS
"WSL"SRVGRP="WS"SRVID=10
CLOPT="---n//sjzccbdev:
12445-d/dev/tcp-m5-M20-x20-T60-p15000
-P16000"
RQPERM=0660REPLYQ=NRPPERM=0660MIN=1MAX=1CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"balcrypt"SRVGRP="HOST"SRVID=20
CLOPT="-A"
RQADDR="balcrypt"
RQPERM=0660REPLYQ=YRPPERM=0660MIN=1MAX=2CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"balsubcpt"SRVGRP="HOST"SRVID=30
CLOPT="-A---RHOST"
RQADDR="balsubcpt1"
RQPERM=0660REPLYQ=YRPPERM=0660MIN=1MAX=1CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"balsubcpt"SRVGRP="HOSTINQ"SRVID=30
CLOPT="-A---RHOSTINQ"
RQADDR="balsubcpt2"
RQPERM=0660REPLYQ=YRPPERM=0660MIN=1MAX=1CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"balftp"SRVGRP="HOST"SRVID=50
CLOPT="-A-eerr/balftp.err-oout/balftp.out"
RQADDR="balftp"
RQPERM=0660REPLYQ=YRPPERM=0660MIN=1MAX=5CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"dr_u"SRVGRP="HOST"SRVID=140
CLOPT="-A-eerr/dr_u.err-oout/dr_u.out"
RQADDR="dr_u"
RQPERM=0660REPLYQ=YRPPERM=0660MIN=1MAX=5CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"pf_u"SRVGRP="HOST"SRVID=240
CLOPT="-A-eerr/pf_u.err-oout/pf_u.out"
RQADDR="pf_u"
RQPERM=0660REPLYQ=YRPPERM=0660MIN=1MAX=5CONV=N
SYSTEM_ACCESS=FASTPATH
MAXGEN=1GRACE=86400RESTART=N
"vo_u"SRVGRP="HOST"SRVID=510
CLOPT="-A-eerr/vo_u.err-oout/vo_u.out"
RQADDR="vo_u"
R