tuxedo命令和配置的详细解释及应用实例.docx

tuxedo命令和配置的详细解释及应用实例.docx

《tuxedo命令和配置的详细解释及应用实例.docx》由会员分享，可在线阅读，更多相关《tuxedo命令和配置的详细解释及应用实例.docx（10页珍藏版）》请在冰豆网上搜索。

tuxedo命令和配置的详细解释及应用实例

tuxedo命令和配置的详细解释及应用实例

域的组成

BDMCONFIG：

二进制配置文件

DMADM：

域管理服务器，管理多个

GWADMGWADM：

运行时网关管理服务器，从DMADM服务器上获取域信息

GWTDOMAIN：

是一个网关进程，在域之间转发消息

tmshutdown/tmboot-s服务名按服务名停/启单个服务

tmshutdown/tmboot-S（大写的S）停/启所有服务

tmshutdown/tmboot-i进程号按进程号停/启单个服务

tmshutdown/tmboot-g组名字按组停/启服务

tmshutdown/tmboot-y-w1按用户停/启服务

tmloadcf-n文件名只做语法检查不编译

tmloadcf-y文件名编译二进制文件

tmloadcf-c文件名测试IPC资源最小需求

tmadmin-v版本

tmadmin>bbp查BB的参数

bbsBB统计信息

pclt连接客户端信息

psrserver信息

pscservice信息

pt当前事物信息

pq队列信息

echopsr|tmadmin|grep-vIDLE

echopsr|tmadmin|sort+4

echopsc|tmadmin|sort+6

echopq|tmadmin|sort+4

echopclt|tmadmin|grep-vWSH|grep-vtmadmin

以下是tmadmin命令的printserver（简写为psr）的简单输出。

列号描述

1.服务的可执行文件名

2.服务连接的队列名

3.组名

4.服务的数字id

5.服务已经处理的请求数

6.服务处理的全部请求的参数和

7.服务正在处理的交易，若为IDLE则服务当前是空闲

ccsmis:

/home2/ccsmis>tmadmin

tmadmin-Copyright（c）1996BEASystems,Inc.

Portions*Copyright1986-1997RSADataSecurity,Inc.

AllRightsReserved.

DistributedunderlicensebyBEASystems,Inc.

Tuxedoisaregisteredtrademark.

>printserver

ProgNameQueueNameGrpNameIDRqDoneLoadDoneCurrentService

-----------------------------------------------------------

rz_Ecsb00004.04000APGP2400000（IDLE）

BBL70020simple0150（IDLE）

IFMTMSAPGP2_TMSAPGP230001150（IDLE）

交易信息

来自GAI的信息本处略去。

以下是tmadmin命令的printservice（简写为psc）的简单输出。

列号描述

1.交易名

2.交易函数名

3.服务可执行文件名

4.服务所在组名

5.服务的数字id

6.提供交易的机器的LMID

7.交易已经执行的次数

8.交易当前状态

ServiceNameRoutineNameProgNameGrpNameIDMachine#DoneStatus

--------------------------------------------------------------

416701rz_Ecsbrz_EcsbAPGP24000simple0AVAIL

416601rz_Ecsbrz_EcsbAPGP24000simple0AVAIL

416501rz_Ecsbrz_EcsbAPGP24000simple0AVAIL

队列信息

以下是tmadmin命令的printqueue（简写为pq）[qaddress]的简单输出。

如果不指定address，所有队列信息将被输出。

列号描述

1.队列连接的服务的可执行文件名

2.字符队列名，是RQADDR参数或一个随机值

3.连接的服务数

4.当前队列的所有请求的参数和

5.实际请求数

6.平均队列长度

7.队列所在机器的LMID

>pq00004.05062

ProgNameQueueName#ServeWkQueued#QueuedAve.LenMachine

------------------------------------------------------------

CCS_GEDAIPC_5000004.050621000.0simple

客户端信息

来自GAI的信息本处略去。

以下是tmadmin命令的printclient（简写为pclt）的输出，来自TUXEDO系统的日志信息。

主要有以下信息：

客户端id，用户名和当前状态

登录的LMID和进程号（PID）

服务组和上一访问过的服务组

交易（启动/提交/中断）和会话的统计数字

中继队列id，通知方法和提交控制

列号描述

1.已经登录的客户端机器的LMID

2.用户名，由tpinit（）提供的

3.客户端名，由tpinit（）提供的

4.客户端连接后经过的时间

5.客户端状态

IDLE――表示客户端目前没有任何交易在工作

IDLET――表示客户端启动了一个交易

BUSY――表示客户端在工作中

BUSYT――表示客户端正在交易控制下工作

6.启动/提交/中断的交易数

>pclt

LMIDUserNameClientNameTimeStatusBgn/Cmmt/Abrt

-------------------------------------------------------------------------

simpleccsmisWSH17:

42:

47IDLE0/0/0

simpleccsmistmadmin0:

44:

28IDLE0/0/0

######UBBCONFIG文件的例子：

###############

#ident"@（#）apps/simpapp/ubbsimple$Revision:

1.3$"

#SkeletonUBBCONFIGfilefortheTUXEDOSimpleApplication.

#Replacetheitemswiththeappropriatevalues.

*RESOURCES#资源

IPCKEY123456#TUXEDO使用它标识公告板及其他的IPC资源。

它不能与该服务器上其他的IPC资源的ID号冲突范围：

32,769-262,142

DOMAINIDsimpapp#DOMAIN的ID值,该TUXEDO应用系统的唯一标识

MASTERsimple#指定DOMAIN中的管理#MASTERunicom1,unicom2指定DOMAIN中的管理主机为unicom1,运行过程中unicom1若出现问题，管理主机切换至unicom2

UID,GID,PERM:

这三个参数控制对系统IPC资源的存取权限

UID:

可对该TUXEDO应用系统进行管理的TUXEDO系统管理员的用户ID,在UNIX下就是UNIX系统的用户ID,默认为执行TMLOADCF的户的ID。

在NT下该设置没有用,要设为0。

GID:

在UNIX下为UID中所指定的用户所在的组ID,在NT下该设置没有用,要设为0

PERM:

指定对TUXEDO系统IPC资源的存取权限。

默认值为0666,即任何人都可以对该IPC资源进行存取。

MAXACCESSERS,MAXSERVERS,MAXSERVICES:

这三个参数控制该TUXEDO应用系统对IPC资源的使用情况

MAXACCESSERS100#这里该值表示整个系统中每个机器上可以访问TUXEDO的Client和Server的总数,在本系统的一个节点（一台服务器）上,同时可以有多少个进程可以访问,该TUXEDO系统的公告板,默认值为50,它包括本地客户端进程,SERVER进程,但不包括管理进程如:

BBL,DBBL等

MAXSERVERS5#最大的server数,在本系统中,总共可以有多少个SERVER存在,包括进行管理的SERVER,如:

BBL,TMS等。

默认值为50。

MAXSERVICES10#最大的service数,在本系统中,总共可以有多少个SEVICE存在,默认值为100。

TUXEDO应用系统的部署方式：

一个TUXEDO应用系统可能部署在一台服务器上或多台服务器上,也可能是部署在共用一块全局共享内存的几台服务器上,可在MODEL,OPTIONAS中配置该TUXEDO应用系统的部署模式。

MODELSHM#cluster方式为MP:

多台服务器但没有共用一个全局共享内存

SHM:

单机或多台服务器但共用一个全局共享内存

TUXEDO的管理进程BBL定时对它所在的服务器上的TUXEDO系统进行检查,检查超时的事务,超时的客户端连接等。

SCANUNIT:

指定检查的最小时间单位,它单位为秒,必须是5的倍数。

默认值为10,即10

秒。

SANTIYSCAN:

每隔多少个SCANUNIT检查一次,SANITYSCAN*SCANUNIT不能大于300秒。

默认值为12,即120秒

BLOCKTIME:

指定一个消息可以阻塞多长时间,如果过了SANITYSCAN*SCANUNIT秒该

消息还没有发送出去,将超时出错。

SANITYSCAN*SCANUNIT不能大于32767秒。

默认值为6,即60秒。

同步调用的超时说明

对同步调用TPCALL,指从TPCALL（）开始调用,到SERVER端的返回结果到到该客户端并写到输入缓冲区这一段时间。

包括:

客户端开始调用TPCALL（）

把数据通过网络发送到SERVER端

SERVER端的处理时间

SERVER端把处理结果通过网络返回给客户端

客户端TPCALL（）调用返回

异步调用和会话方式的超时说明

对异步调用和会话方式,当一个进程调用TPACALL（）,TPCONNECT（）,TPSEND（）时,超时时间只包括如果接收队列满时,这些调用的等待时间,如在TPACALL（）中,所调用的SERVICE的接收队列如果满了,那么TPACALL（）可阻塞在那里,直到该队列不满,可以接收该TPACALL（）发送的请求。

从TPACALL（）开始阻塞到TPACALL（）返回这段时间为它的超时时间。

对TPGETRPLY（）,TPRECV（）的超时时间是指如果要接收的队列为空时,它们应该阻塞在那里等待有消息到来的时间。

如:

超时时间为60秒,一点整调用TPGETRPLY（）从接收的队列取消息,这时接收队列为空,如果到了一点零一分该接受队列还为空,那么TPGETRPLY（）将超时出错

LDBALN#要不要进行负载均衡,Y:

要,N:

不要,默认值为不要

MAXCONV:

在一台服务器上最多可以有多少个会话同时存在。

范围:

0-32768,默认值为10

NOTIFY:

设置消息的通知方式,有以下3种:

默认为DIPIN

IGNORE:

该TUXEDO系统中的CLIENT不接收任何消息

SIGNAL:

用SIGUSR1,SIGUSR2信号通知CLIENT有消息到来，如果在非UNIX平台上设置采用该方式，那么会被自动转化为DIPIN方式。

DIPIN:

当CLIENT调用ATMI函数时,顺便检查看是否有消息,如果有就发送给该CLIENT默认值为DIPIN

*MACHINES#网络主机名用hostname获得。

该TUXEDO应用系统所包含的每台服务器都要在该节中进行配置

CCBFJF85LMID=simple#LMID：

在TUXEDO，要为该应用系统中的每台服务器指定一个逻辑服务器名。

APPDIR="/home/tuxedo/samples/atmi/simpapp"#APPDIR要求放置SERVER的可执行文件,TUXEDO应用系统所在的目录

TUXCONFIG="/home/tuxedo/etc/tuxconfig"#TUXCONFIG为全路径的二进制配置文件，要求和环境变量TUXCONFIG相同,配置文件TUXCONFIG所在的路径

TUXDIR="/home/tuxedo"#TUXDIR为tuxedo安装目录，要求和环境变量TUXDIR相同。

注意：

TUXCONFIG，TUXDIR，APPDIR的值要与它们在环境变量中的设置的值一样

MAXWSCLIENTS=50#MAXWSCLIENTS表示可连接client的最大个数。

ENVFILE:

该服务器上与TUXEDO有关的环境变量（如FIELDTBLS等）可以放到一个文件中,在ENVFILE中指定该文件名。

TYPE:

指定该服务器的类型,当两台服务器的TYPE不一样时,在它们之间传送数据时要进行编码/解码工作

ULOGPFX:

指定ULOG文件所在的目录及前缀。

默认目录为$APPDIR,前缀为ULOG。

UID,GID,PERM,MAXACCESSERS,MAXCONV这些在RESOURCES中的配置,在MACHINES中可以被重新配置,并且这些新的配置值会覆盖在RESOURCES中的配置值。

*GROUPS

GROUP1#GROUP1为组名

LMID=simple#LMID表示该组运行的主机

GRPNO=1#GRPNO为组号

OPENINFO=NONE#OPENINFO为该组打开数据库的初始串

在TUXEDO中,要对SERVER进行分组,配置GROUP主要有三个目的,

1．因为GROUP与数据库之间是一对一的关系,在一TUXEDO应用系统中,如果有多个数据库,就要配置多个GROUP,在该GROUP中配置TUXEDO与数据库的连接参数等。

2．数据依赖路由是以GROUP为单位的。

3．进行系统迁移时也时以GROUP为单位的一个GROUP有一个名字,还有一个GROUPID,GROUP的名字和GROUPID在一个TUXEDO系统中必须唯一。

每个GROUP要指定该GROUP所在的服务器，及它的ID号，如果该GROUP中的SERVER要与数据库或其他的资源管理器相连，那么要在OPENINFO中设置连接的参数。

*SERVERSSERVER节，列出所有服务程序

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（）的参数

DEFAULT:

CLOPT="-A"

#WSL用于和client端进行连接。

-n表示出接入点为IP:

PORT方式，

#-m-M表示最小和最大启动多少个WSH和前端通讯，

#-x则表示一个WSH和几个client端连接。

#-T10表示如果client端和server连接后10分钟内没有交易请求则关闭连接。

WSLSRVGRP=GROUPWSLSRVID=1

CLOPT="-A-t---n//10.229.15.120:

8888-d/dev/tcp-p10000-P10950-m40-M80-x30-c0"

simpservSRVGRP=GROUP1SRVID=2

CLOPT="-A-o./out.log-r-e./err.log"

与远程客户端有关的配置：

1．在MACHINES中要配置MAXWSCLIENTS，即最多可以有多少个远程客户端同时连接到该服务器上，在上面的例子中为5个

2．在SERVERS中要配置SERVER：

WSL

WSLSRVGRP="GROUP1"SRVID=1116CLOPT="-A---n//192.168.120.113:

8888-m2-M5-x6"

说明：

-n//192.168.120.113:

8888:

远程客户端通过该端口与服务器建立连接

-m2:

最少启动多少个WSH进程

-M5：

:

最多启动多少个WSH进程，默认值为MAXWSCLIENTS/m

-x6：

每个WSH进程可同时处理多少个远程客户端

3．程客户端所在的服务器上要配置WSNADDR环境变量，它的值为-n参数的值，如在上面的配置中为：

SETWSNADDR=//192.168.120.113:

8888

*SERVICES:

在SERVICES中可针对每个SERVICE进行配置，主要有：

AUTOTRAN:

调用该SERVICE时是否自动启一个全局事务。

默认为N

LOAD:

如果采用负载均衡,指定该SERVICE的负载因子，默认为50

PRIO:

指定该SERVICE的优先级，默认为50

DDR:

指定数据依赖路由规则

-----------------------------------------

有关域（domain）管理的命令

$dmadmin

>pd-dLocalTUXDomainID显示与本地域关联的其他域

>co-dLocalTUXDomainID-RRemoteDomainID手动连接远程域

Tuxedo域的配置DMCONFIG

DM_RESOURCES?

定义域全局信息，如版本等，可忽略

DM_LOCAL_DOMAINS?

描述本地域网关环境

DM_REMOTE_DOMAINS?

描述远程域网关环境

DM_TDOMAIN?

定义域网关地址和端口

DM_LOCAL_SERVICES?

描述可被远程域访问的本地服务

DM_REMOTE_SERVICES?

描述由远程域提供给本地域访问的服务……..

如何清除IPC资源

如果你不想用tmshutdown停止或者当$TUXCONFIG文件被误删除而无法shutdownTUXEDO服务时，可以尝试直接删除当前用户的ipc资源，如下:

ipcs|grep`logname`|awk'{print"ipcrm-"$1,$2}'|sh–x

反编译tuxconfig文件和dmxconfig文件

a）tmunloadcf查看当前TUXCONFIG中的ubb内容tmunloadcf>>ubb.tmp

b）dmunloadcf查看当前DMXCONFIG中的dm内容dmunloadcf>>dm.tmp

启动tlisten服务Tlisten//本机IP:

端口号

如:

tlisten//128.192.94.8:

28300