tuxedo配置管理简要说明

一、tuxedo基本命令

#1.设置环境变量tuxdir,appdir,tuxconfig，lang(跟os相关),ld_library_path(跟os相关)
#2.编译ubb文本生成二进制配置文件：tmloadcf ?cy ubbconfig
#3.所有机器上运行tlisten,具体见文档中network一节
#4.启动tmboot ?cy
#5.关闭tmshutdown ?cy
参数：
-a 在所有机器上启动/关闭管理的server进程
-m 只在master机器上启动/关闭管理的server进程
-i srvid 启动/关闭某个server id指定的server进程
-g grpname 启动/关闭某个server group名字指定的server group
-s 启动/关闭所有应用服务器（lmid）
-s server-name 启动/关闭某个server名字指定的server进程
-l lmid option 在指定的机器上启动/关闭所有tms进程和应用服务器（lmid）
-t grpname 启动/关闭指定的server group中所有的tms进程
-b lmid 在指定的机器上启动/关闭bbl进程
-e command 指定一个程序可以当在master机器上启动任何一个进程失败时执行
-c 计算出当前ubb配置的tuxedo启动最少要占用的系统ipc资源

#用tmunloadcf > generated.ubb 可以得出目前配置得ubb文件所有得参数值（没有设置的有缺省值）
#用tmloadcf ?cc或tmboot ?cc可以计算出当前ubb配置的tuxedo启动最少要占用的系统ipc资源。

二、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
#允许负载均衡

scanun99v 10
#scanun99v 是bbl在所有服务请求中定期扫描以寻找超时的交易和被阻塞德调用和德间隔时间（秒）。这个参数指定bbl扫描间隔时间的基本单位， 它会影响在tpbegin中指定的交易超时时间和用blocktime指定的请求阻塞超时时间的精确程度。san99vyscan, bblquery, dbblwa99v, blocktime等参数都是scanun99v的倍数，而不是实际秒数。而作为时间单位scanun99v必须是5的倍数，并且满足0<scanun99v<60。

san99vyscan 12
#san99vyscan的值指定在每个machine上bbl自动检测所有进程的时间间隔，以scanun99v为单元。缺省值满足（scanun99v*san99vyscan）约为120秒。

dbblwa99v 2
#dbblwa99v的值指定dbbl扫描bbl时等待所有bbl应答的最大时间，以scanun99v为单元，即超过dbblwa99v*scanun99v（秒）就超时。每一次dbbl将请求转发给它的bbl时，bbl会在请求返回结果之前先回复一个肯定的应答。这样可以定时检测死掉或不正常的bbl。缺省值满足（scanun99v*dbblwa99v）的值等于scanun99v和20秒两者之间的最大者。

bblquery 30
#bblquery指定dbbl对所有bbl进行状态检查的时间间隔，它也是以scanun99v为计算单位。如果dbbl的状态询问没有回答，该bbl就被‘隔离'了。缺省值满足(scanun99v * bblquery) 约为 300秒。

blocktime 6
#blocktime指定在阻塞队列中的被阻塞请求的超时时间，以scanun99v为计算单位。缺省值满足(scanun99v * 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 ?cr -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 ort方式，-m ?cm 表示最小和最大启动多少个wsh和前端通讯，-x则表示一个wsh和几个client端连接。-t 10表示如果client端和server连接后10分钟内没有交易请求则关闭连接。

*services
#不要求将所有的service在这里描述，当某个service有特别参数时才在service节中说明。
toupper

*network
#network节对多机之间如何进行网络连接进行描述。
#cluster方式下要求先启动tlisten。事实上，对于非master机启动应用服务器是由tlisten完成的。
#tlisten的启动方式为
#unicom1: tlisten ?cl //130.36.1.101:8891
#unicom2: tlisten ?cl //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"

三、数据库xa设置
3.1 oracle xa
1.在附件中提供了rm文件,另外建议运行oracle的demo文件获得要连接的所有lib库的名称.然后将这些名称全部写在rm文件中.
2.ubb 文件中 *group节 tmsname=tms_ora tmscount=3 openinfo="oracle_xa:oracle_xa+acc=p/scott/tiger+sestm=120+logdir=.+sqlnet=abcde"
具体在oracle联机文档application development->oracle8 application development´s
guild->oracle xa->defining the xa_open string中提供了解释
3.在oracle一侧需运行xaview.sql,并且scott用户有操作权限,运行结果会记录trc文件里.(在oracle8.0.5这一步不是必须的)
4.运行 buildtms -o $(tuxdir)/bin/tms_ora -r oracl