tuxedo基本命令详细说明

1、1 tmloadcf 检查UBBCONFIG文件的内容及格式 将文本格式的UBBCONFIG文件编译生成二进制文件 必须在主机上运行 格式 tmloadcf -n -y -c -b blocks UBBCONFIG_file | - 参数-c 计算最小的IPC需求-n 仅仅进行UBBCONFIG文件的内容检查，不生成二进制文件-y 覆盖已有的二进制文件之前不提示-b blocks 如果环境变量TUXCONFIG所指的文件存放在一个裸设备上，建议使用该参数；如果该文件存放在文件系统上，则不需要2 tmunloadcf 将二进制TUXCONFIG文件反编译为文本格式3 tmipcrm 清除本机上的

2、IPC资源 自动根据TUXCONFIG_file参数查找相应的IPC资源 一般在Tuxedo非正常停止的情况下用来清理残留IPC资源 格式tmipcrm -y -n TUXCONFIG_file 参数-y 对命令运行过程中的询问回答y-n 不清除IPC资源，只是列出IPC资源TUXCONFIG_file Tuxedo的配置文件。如果不指定，则使用环境变量TUXCONFIG4 tmboot 启动Tuxedo 格式tmboot -l lmid -g grpname -i srvid -s aout -o sequence -S -A -b -B lmid -T grpname -e command

3、 -w -y -g -n -c -M -d1 参数-l lmid 启动所有绑定到这个逻辑主机的服务，包括应用Server、TMS、Gateway等等-g grpname 启动grpname包含的所有服务，包括应用Server、TMS等-i srvid 启动所有SRVID为srvid的服务-s aout 启动Server名字为aout的服务，也可以用来启动TMS、Gateway等服务。通常和-g选项联合使用-o sequence 启动SERVERS段中SEQUENCE参数为sequence的服务-S 启动SERVERS段中的所有Server-A 启动管理Server，例如DBBL、BBL、BRI

4、DGE等-b 从BACKUP主机上启动服务-B lmid 启动逻辑主机lmid上的BBL服务-M 启动主机上的管理服务-d1 将命令行参数打印在stdout，一般多用来调试应用时给出更多的信息-T grpname 启动grpname组上的TMS服务-e command 在启动过程中，如果某个服务没有启动成功，则执行command，可以是可执行程序、脚本等-w 通知tmboot启动另外一个服务，不必等待初始化的完成。该选项要慎用，因为某些服务是存在依赖关系的，例如BBL和DBBL，应用的Server和BBL等-y 在命令执行过程中遇到询问，回答y-q 不在stdout上显示执行顺序-n 只显示启

5、动时的执行顺序，不执行真正的启动-c 显示最小的IPC需求5 tmshutdown 停止Tuxedo 参数-w delay 向Server发出停止信息，等待delay秒后，如果没有正确停止，则向Server发送一个SIGTERM，然后再发送一个SIGKILL消息-k TERM|KILL 向需要停止的Server发送SIGTERM或者SIGKILL消息 其他参数请参考tmboot6 tmadmin Tuxedo命令行管理终端 格式tmadmin -r -c -v 参数-r tmadmin以客户端的身份连入Tuxedo，而不是以管理员身份连入。以客户端身份连入时，很多管理命令无法使用-c 进入配置

6、模式-v 显示Tuxedo的版本及许可证信息6.1 tmadmin - bbp bbparms (bbp) 显示BB参数的一个概要信息 示例 bbpBulletin Board Parameters: MAXSERVERS: 50 MAXSERVICES: 100 MAXACCESSERS: 100 MAXGTT: 100 MAXCONV: 1 MAXBUFTYPE: 16 MAXBUFSTYPE: 32 MAXOBJECTS: 1000 MAXINTERFACES: 150 IPCKEY: 123456 MASTER: simple MODEL: SHM LDBAL: N SCANUNIT:

7、 10 SANITYSCAN: 6 DBBLWAIT: 2 BBLQUERY: 30 BLOCKTIME: 8 Shared Memory ID: 06.2 tmadmin - psr printserver (psr) 显示Server的信息 格式printserver (psr) -m machine -g groupname -i srvid -q qaddress 参数-m machine 指定逻辑主机名称-g groupname 指定组名-i srvid 指定Server ID-q qaddress 指定队列名称 列说明 Prog Name: Server的名字 Queue Name

8、: 对应队列的名字 Grp Name: 该Server所属的组名称 ID: Server的ID RqDone: 已经请求的次数，包括成功的和失败的请求 Load Done: RqDoneServer的权重因子，权重因子默认为50 Current Service: 当前正在执行的Service，IDLE表示空闲6.3 tmadmin - psc printservice (psc) 显示Service信息 格式printservice (psc) -m machine -g groupname -i srvid -a 0 | 1 | 2 -q qaddress -s service 参数-m m

9、achine 指定逻辑主机名称-g groupname 指定组名-i srvid 指定Server ID-q qaddress 指定队列名称-s service 指定service名称-a 0 | 1 | 2 -a0显示应用Service，-a1显示应用Service和系统Service中可以被应用直接调用的，-a2显示显示应用Service和系统Service中可以被应用直接调用的以及可以被Tuxedo系统调用的 列说明 Service Name: 发布出来的服务名 Routine Name: 服务对应的方法名，或者函数名 Prog Name: 服务所在的Server名字 Grp Name:

10、 服务所在的组名字 ID: 服务所在的Server ID Machine: 服务所在逻辑主机名字 #Done: 服务被调用的次数 Status: 服务当前状态6.4 tmadmin - pclt printclient (pclt) 显示连接到Tuxedo的客户端信息 格式printclient (pclt) -m machine -u usrname -c cltname 参数-m machine 指定主机名称-u usrname 指定用户名称-c cltname 指定客户端名称 列说明 LMID: 逻辑主机名称 User Name: 用户名称 Client Name: 客户端名称 Time

11、: 客户端连接的时间 Bgn/Cmmt/Abrt: 开始的、已提交的、中断的事务数量 关于结构体tpinfo_t tuxedo客户端使用tpinit连接tuxedo服务器时，tpinit函数有一个参数，类型为tpinfo_t，pclt命令中看到的User Name, Client Name都是来自该结构体6.5 tmadmin - pq printqueue (pq) 显示请求队列信息 格式printqueue (pq) qaddress 参数qaddress 指定队列名称 列说明 Prog Name: Server的名字 Queue Name: 队列名称 # Server: 该队列上Serv

12、er的数量 Wk Queued: 队列中的请求数权重系数， 缺省是50 # Queued: 排队的请求数，此数量包括正在处理的请求 Ave. Len: 按照一定的时间，对排队的数量取得平均值一、Tuxedo基本命令 #1.设置环境变量TUXDIR,APPDIR,TUXCONFIG，LANG(跟OS相关),LD_LIBRARY_PATH(跟OS相关) #2.编译ubb文本生成二进制配置文件：tmloadcfyubbconfig #3.所有机器上运行tlisten,具体见文档中NETWORK一节 #4.启动tmbooty #5.关闭tmshutdowny 参数： -A 在所有机器上启动/关闭管理的

13、Server进程 -M 只在MASTER机器上启动/关闭管理的Server进程 -i srvid 启动/关闭某个serverid指定的Server进程 -g grpname 启动/关闭某个servergroup名字指定的ServerGroup -S 启动/关闭所有应用服务器（LMID） -s server-name 启动/关闭某个server名字指定的Server进程 -l lmidoption在指定的机器上启动/关闭所有TMS进程和应用服务器（LMID） -T grpname 启动/关闭指定的servergroup中所有的TMS进程 -B lmid 在指定的机器上启动/关闭BBL进程 -e

14、command 指定一个程序可以当在MASTER机器上启动任何一个进程失败时执行 -c 计算出当前UBB配置的Tuxedo启动最少要占用的系统IPC资源 #用tmunloadcfgenerated.ubb可以得出目前配置得UBB文件所有得参数值（没有设置的有缺省值） #用tmloadcfc或tmbootc可以计算出当前UBB配置的Tuxedo启动最少要占用的系统IPC资源。 二、UBB文件配置说明 UBB配置文件分成*RESOURCES,*GROUP,*SERVER,*SERVICE,*NETWORK等若干节。DEFAULT表示该节中所有对象共有的缺省属性。 *RESOURCES #RESOU

15、CES节提供整个系统的基本参数。 IPCKEY 55555（32767-262143） #进行IPC通讯的key值 DOMAINID unicom #DOMAIN的ID值 MASTER unicom1,unicom2 #指定DOMAIN中的管理主机为unicom1,运行过程中unicom1若出现问题，管理主机切换至unicom2 MAXACCESSERS1000 #这里该值表示整个系统中每个机器上可以访问TUXEDO的Client和Server的总数(可以访问BBL的最大进程数)，应大于license用户数+server数（副本应记入）。该字段会被MACHINE部分的MAXACCESSERS覆

16、盖。 #系统核心参数中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表示可以以组为单位进行机

17、器间SERVER的迁移。 LDBAL Y #允许负载均衡 SCANUNIT 10 #SCANUNIT是BBL在所有服务请求中定期扫描以寻找超时的交易和被阻塞德调用和德间隔时间（秒）。这个参数指定BBL扫描间隔时间的基本单位，它会影响在tpbegin中指定的交易超时时间和用BLOCKTIME指定的请求阻塞超时时间的精确程度。SANITYSCAN,BBLQUERY,DBBLWAIT,BLOCKTIME等参数都是SCANUNIT的倍数，而不是实际秒数。而作为时间单位SCANUNIT必须是5的倍数，并且满足0SCANUNIT1，并且使用了MSSQ（RQADDR，RQPERM）的Server可以配置-p

18、来控制进程的增加和减少。控制算法如下：如果请求队列中的请求个数大于high_water后超过create_time秒,就增加该服务的一个新进程；如果请求队列中的请求个数小于low_water后超过terminate_time秒,就停止该服务的一个进程。low_water缺省是平均每个服务进程有一个请求消息或者workload50；high_water缺省是平均每个服务进程有两个请求消息或者workload100.create_time缺省是50,andterminate_time缺省是60。 注意；使用TUXEDO的服务进程池时，用户自己在程序中如果用alarm（）等系统调用来停止进程是不起作

19、用的，但也不会报错。 L标记意味着增减服务进程基于负载而不是请求队列的长度。仅用于SHM模式下并且LDBAL=Y，否则会报错(LIBTUX_CAT:1542)，服务进程也不会增减。 WSL SRVGRP=GROUP2SRVID=1 CLOPT=-A-n/130.36.0.103:8889-m3-M10-x10-T10 #WSL用于和client端进行连接。-n表示出接入点为IP:PORT方式，-mM表示最小和最大启动多少个WSH和前端通讯，-x则表示一个WSH和几个client端连接。-T10表示如果client端和server连接后10分钟内没有交易请求则关闭连接。 *SERVICES #不

20、要求将所有的service在这里描述，当某个service有特别参数时才在SERVICE节中说明。 TOUPPER *NETWORK #NETWORK节对多机之间如何进行网络连接进行描述。 #cluster方式下要求先启动tlisten。事实上，对于非master机启动应用服务器是由tlisten完成的。 #tlisten的启动方式为 #unicom1:tlistenl/130.36.1.101:8891 #unicom2:tlistenl/130.36.0.102:8891 #NADDR指定网络连接的接入点。 #NLSADDR则指定tlisten的接入点。 #BRIDGE则指TCP连接所用的

21、设备文件。 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.1ORACLEXA 1.在附件中提供了rm文件,另外建议运行oracle的demo文件获得要连接的所有lib库的名称.然后将这些名称全部写在RM文件中. 2.ubb文件中*GROUP节TMSNAME=TM

22、S_ORATMSCOUNT=3OPENINFO=Oracle_XA:Oracle_XA+Acc=P/scott/tiger+SesTM=120+LogDir=.+SqlNet=abcde 具体在Oracle联机文档ApplicationDevelopment-oracle8ApplicationDevelopments Guild-OracleXA-Definingthexa_openString中提供了解释 3.在oracle一侧需运行xaview.sql,并且scott用户有操作权限,运行结果会记录trc文件里.(在oracle8.0.5这一步不是必须的) 4.运行buildtms-o$(

23、TUXDIR)/bin/TMS_ORA-rOracle_XA 5.在tpsvrinit()中EXECSQLCONNECT.改成tpopen,tpsrvdone()中EXECSQLDISCONNECT.改成tpclose();实际可拷贝$TUXDIR/apps/bankapp/appinit.c 6.需在ubb文件中MACHINE节指定TLOGDEVICE,TLOGSIZE 例:TLOGDEVICE=/home/usr1/TLOGDEV TLOGSIZE=100 7.建立TLOG文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.设定相关的环境变量后运行该shell文件.

24、8.启动事务用tpbegin(3,0),提交回滚用tpcommit/tpabort. 3.2SYBASEXA 1.在RM文件,运行sybase获得要连接的所有lib库的名称.然后将这些名称全部写在RM文件中:Sybase_XA:?. 2.ubbconfig文件中*GROUP节TMS_NAME=TMS_SYBTMSCOUNT=3OPENINFO=? 具体察看Sybase文当中xa_openString中提供了解释 3.运行buildtms-o$(TUXDIR)/bin/TMS_SYB-rSybase_XA 4.在tpsvrinit()中EXECSQLCONNECT.改成tpopen,tpsrvd

25、one()中EXECSQLDISCONNECT.改成tpclose();实际可查看$TUXDIR/apps/bankapp/appinit.c 5.需在ubb文件中MACHINE节指定TLOGDEVICE,TLOGSIZE 例:TLOGDEVICE=/home/usr1/TLOGDEV TLOGSIZE=100 6.建立TLOG文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.设定相关的环境变量后运行该shell文件. 7.启动事务用tpbegin(3,0),提交回滚用tpcommit/tpabort. 3.3INFORMIXXA 1.运行esql-lib获得要连接的所

26、有lib库的名称.然后将这些名称全部加到RM文件中INFORMIX-OnLine:infx_xa_switch:$INFORMIXDIR/lib/esql/libinfxxa.a/usr/informix/lib/esql/libixos.a/usr/informix/lib/esql/libixgen.a/usr/informix/lib/esql/libixsql.a/usr/informix/lib/libixasf.a/usr/informix/lib/esql/libixos.a/usr/informix/lib/esql/libixgen.a/usr/informix/lib/es

27、ql/libixgls.a-lnsl_s-lm-lV3-lcl-lsec/usr/informix/lib/esql/libixglx.a 2.ubbconfig文件中 *GROUP节TMS_NAME=TMS_INFOTMSCOUNT=3OPENINFO=INFORMIX-OnLine:test_tux 具体察看Sybase文当中xa_openString中提供了解释 3.运行buildtms-o$(TUXDIR)/bin/TMS_INFO-rINFORMIX-OnLine 4.在tpsvrinit()中EXECSQLCONNECT.改成tpopen,tpsrvdone()中EXECSQLDI

28、SCONNECT.改成tpclose();实际可查看$TUXDIR/apps/bankapp/appinit.c 5.需在ubb文件中MACHINE节指定TLOGDEVICE,TLOGSIZE 例:TLOGDEVICE=/home/usr1/TLOGDEV TLOGSIZE=100 6.建立TLOG文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.设定相关的环境变量后运行该shell文件. 7.启动事务用tpbegin(3,0),提交回滚用tpcommit/tpabort. 四、Tuxedo多机方式配置要点 tuxedo多机方式配置有两个方面 4.1启动tlisten

29、tlisten在tuxedo启动时扮演控制者的角色,在非master机上由tlisten启动bbl和应用服务器,tlisten的启动方法为 tlisten-l/host:ipport 注意这里的ipport必须和ubb文件中NETWORK域的NLSADDR一致 tlisten必须在所有的机器上启动,启动后才能运行tmboot.建议操作系统启动时就运行tlisten. 4.2ubb文件配置 对于多机模式一般就是指单一domain管理的多台机器,所有机器上仅需要一个ubb文件,以下是ubb文件的模板 *RESOURCES IPCKEY 80952 MAXACCESSERS 40 MAXSERVERS 35 MAXSERVICES 75 MASTER SITE1,SITE2 OPTIONS LAN,