Tuxedo

Tuxedo配置维护手册

Tuxedo作为系统的中间件，其配置主要包括：资源文件的配置和应用环境的配置；其管理和维护主要包括：系统的启动和关闭、日志的跟踪查看工作。

Tuxedo应用系统的配置

一、应用系统的资源配置，全都包含在两个资源配置文件中（ubbco nfig 和dmco nfig ），在这两个配置文件中包含了系统所有的应用资源（文件）。

1、对于ubbco nfig 文件，可以任意使用一个文件名（如：ubb.txt ）,使用一种文本编辑工具，将应用系统的资源分类进行配置，相关进程启动数量等等都应该配置在其中，然后设置环境变量TUXCONFIG ,使用系统命令：tmloadcf来将文本文件ubb.txt ,转化生成环境变量TUXCONFIG 制定的二进制文件。在该文件中主要包含了几个参数的设置：系统所使用的共享内存的键值IP CKEY，针对workstation 客户端的监听进程的端口（WSL ），多台机器之间互连（登记中心与各网关）的网络地址和端口（NADDR , NLSADDR ）,数据依赖路由的设定等等。

详细的内容参看《Ubbconfig 配置.doc》参看模版来实现移植或添加应用进程等等。

2、对于dmco nfig文件，可以任意使用一个文件名（如：dm.txt ），使用一种文本编辑工具，将应用系统的多域互联及互相调用的关系进行配置，包括多域之间互联的地址和端口，然后使用系统命令：dmloadcf来将文本文件dm.txt，转化成环境变量BDMCONFIG 所指定的二进制文件。在该文件中主要包含了在多个域互连时用到的一些设置，主要包括：各个域的定义，各个域通讯连接的地址和端口（NWADDR ）,本地服务（DM_LOCAL_SERVICES ）和远端服务（DM_REMOTE_S ERVICES）以及数据依赖路由等等。

详细的内容参看《dmconfig 配置.doc》参看模版来实现移植或添加应用远端或本地服务等等。

3、客户端代码：是指使用编译工具buildclie nt 编译生成的执行代码。在编译过程中，当使用编译参数：-w时，将连接库wsc等，生成的执行代码将调用远端的服务，即通过环境变量：WSNADDR 来查找相应的WSL的地址和端口；当编译没有使用参数：—时，生成的执行代码将调用本机的服务，通过环境变量：TUX CONFIG来实现调用相应的服务，如果要调用异域（如：代理集中点到登记中心）的服务，就需要在dmconfig文件中配置和公布服务。

4、服务进程：是指使用编译工具buildserver 编译生成的执行代码，不要出现ma in （）函数，启动和关闭要使用Tuxedo的工具：tmboot和tmshutdown

二、应用系统的环境配置，即系统运行时的环境变量的设置一般的这些环境变量都放在用户注册是的.p rofile文件中，也可以根据应用放置在专门的文件中，如：sete nv等等，环境的设置主要包括：TUXDIR :其值为TUXEDO 的安装目录。

例如：TUXDIR=/home/tuxedo 或TUXDIR=/home/bea

TUXCONFIG :其值为含有绝对路径二进制的资源配置文件的文件名，系统启动、监控、关闭等等都要用到此环境变量，当客户端的代码要调用应用系统的本机服务时也需要使用此变量。

例如：TUXCONFIG=/home/work/etc/tuxconfig

BDMCONFIG :其值为含有绝对路径二进制的多域配置文件的文件名，在使用多域间互联时要用到此环境变量。

例如：BDMCONFIG=/home/work/etc/dmcomfig

PRINTERDIR :传输文件的放置目录，主要是针对文件传输来使用的。

例如：PRINTERDIR=/home/work/print

FTP_BLOCK_SIZ :针对文件传输的，每次传输的快的大小，如果没有设置，则系统默认为1024。

例如：FTP_BLOCK_SIZE=10240 ; export FTP_BLOCK_SIZE

WSNADDR :客户端（workstation ）设定的，指向服务器端WSL监听的地址和端口，当客户端的代码要调用系统的远端服务时需要此环境变量。

单机系统的启动（如：代理集中点的起动） 首先设置环境变量，然后使用命令tmboot

-A 在机器上启动核心的进程（BBL ）。

-g grpname 启动 某一组 grpname 中 的全部 进程。

-s server 启 动某一个进程 server 。

二、系统的关闭：

1、多机系统的关闭（如：登记中心的关闭）

应该在主管理机上，使用命令tmshutdown

tmshutdow n 命令可以选择使用多个参数:

grpname 关闭 某一组grpname 中 的全部进程。

单机系统的关闭（如：代理集中点的关闭） 使用命令tmshutdown

-y 关闭机器上的全部进程。

-g grpname 关闭 某一组 grpname 中 的全部 进程。

-s server 关 闭某一个进程 server 。

三、系统的日志跟踪：

1、使用管理工具tmadmin

运行tmadmin 进入管理维护界面

2、查看系统日志ULOG.mmddyy

例如：WSNADDR=//192.168.42.210:7001

Tuxedo 的管理和维护

、系统的启动：

1、多机系统的启动（如：登记中心的启动） 首先设置环境变量，在各台机器上启动tiiste n 进程，一般设置在sete nv 中，然后在主管理机上，使用命令tmboot 启动应用系统 tmboot 命令可以选择使用多个参数: -A 在各台机器上启 动核心的进程（DBBL,BBL ）。 -I imid 启动某一台机器imid 上的全部进程，机器名：Imid 是在文件ubb.txt 中配置的逻辑名。 -g grpname 启动 某一组 grpname 中 的全部 进程。

-s server 启 动某一个进程 server 。

-y 关闭各台机器上的全部进程。

-l lmid 关闭某一台机器lmid 上的全部进程。

-s server 关 闭某一个进程 server 。

-g

在系统设定的目录下查看日志文件：ULOG.mmddyy 和应用系统自己的日志。

代理集中点的安装和配置

、软件打包

将目前的代理集中点上的配置文件目录~/etc 和简单测试目录~/apps 打成 运行后就不再有什么作用了。

二、系统安装和配置

1、修改资源管理配置文件：ubb.txt

可以使用任意的文本编辑工具，如Vi 等等编辑工具，以下同。

修改其 中的：IPCKEY , TUXDIR , APPDIR , TUXCONFIG , ENVFILE , ULOGFPX 和主机名(通过 uname -n 看到的)

SL 的参数：CLO PT=“ -A -- -n 地址：端口 …”，使之与实际的环境一致，例如：CLO PT= “ -A -- -n 192.168.42.220:7410 2、修改域管理配置文

件：dm.txt

要注意在系统中的dm.txt 中的DOMAINID 要保持一致，即在不同的文件重要有

统一的命名。

3、修改环境变量设置文件：sete nv ,将如下环境变量的值进行修改，使之与

实际的配置想符合，以下是参考。

例如：

TUXDIR=/home/tuxedo; export TUXDIR

P ATH=$TUXDIR/bi n:$ PATH:$HOME/ru ntime:.; export P ATH

SHLIB_ PATH=$TUXDIR/lib:/usr/lib:/lib;ex port SHLIB_ PATH LIB PATH=$TUXDIR/lib:$LIB PATH; exp ort LIB PATH ( for AIX ) LD_LIBRARY_

PATH=/usr/tuxedo/lib: /usr/i nformix/lib/esql NLS PATH=$TUXDIR/locale;ex port NLS PATH

LANG=C;ex port LANG

TUXCONFIG=/home/ebistest/c on fig/tuxco nfig;ex port TUXCONFIG

BDMCONFIG=/home/ebistest/co nfig/bdmco nfig;ex port BDMCONFIG

FIELDTBLS32=ft pflds;ex port FIELDTBLS32

FLDTBLDIR32=$TUXDIR/a pi105;ex port FLDTBLDIR32

针对文件传输的，如果文件较大，可以将环境变量FTP_BLOCK_SIZE 的值设置的大一点，如果没有设置该环境变量，

FTP _BLOCK_SIZE=10240 ; exp ort FTP _BLOCK_SIZE

4、系统启动

首先设置环境变量，可以放在.p rofile 中，也可以执行文件../sete nv ，并创建日志存放目录~/log 。

然后执行tmboot 即可 三、故障排除 修改：NWADDR 的地址：端口，例如： NWADDR="〃192.168.42.231:7310"

在SCO 、HP 、IBM 系统上的函数库环境设置有个不相同的环境变量（如：SHLIB_ PATH 、LIB PATH )

， 需要注意。 个包。在目录~/apps 下的内容多适用于测试环境配置结束后是否正常，在系统正常启动

等 的值，使之与实际环境相一致。修改W O (for HPUX )

(for SCO )

则系统默认为1024 。例如：

查看系统日志ULOG.mmddyy 在系统设定的目录下查看日志文件：ULOG.mmddyy 和应用系统自己的日志。

登记中心的安装和配置

、软件打包 将目前的登记中心及其网关机上的配置文件目录Tetc 和简单测试目录Tapps ,及网关机上的~/cjhb 打成一个包。在目录~/cjhb 下的内容是用于完成成交回报交易 的。

二、系统安装和配置

1、修改资源管理配置文件：ubb.txt

可以使用任意的文本编辑工具，如Vi 等等编辑工具，以下同。

修改其中的：IP CKEY , TUXDIR , APP DIR , TUXCONFIG , ENVFILE , ULOGFPX 和主机名（通过un ame -n 看到的）等的值，使 之与实际环境相一致。修改 W

SL 的参数：CLO PT=“ -A -- -n 地址：端口 …”，使之与实际的环境一致，例如：CLO PT= “ -A -- -n 192.168.42.220:7410

”

2、修改域管理配置文件：dm.txt ，此文件可以放在登记中心机器上，也可以放在网关机器上的响应目录下。 要注意在系统中的dm.txt 中的DOMAINID 要保持一致，即在不同的文件重要有统一的命名。

3、修改环境变量设置文件：sete nv ,将如下环境变量的值进行修改，使之与实际的配置想符合。

例如：

TUXDIR=/home/tuxedo; export TUXDIR

P ATH=$TUXDIR/bi n:$ PATH:$HOME/ru ntime:.; export P ATH SHLIB_ PATH=$TUXDIR/lib:/usr/lib:/lib;ex port SHLIB_ PATH

LIB PATH=$TUXDIR/lib:$LIB PATH; exp ort LIB PATH ( for AIX ) LD_LIBRARY_

PATH=/usr/tuxedo/lib: /usr/i nformix/lib/esql

NLS PATH=$TUXDIR/locale;ex port NLS PATH

LANG=C;ex port LANG

TUXCONFIG=/home/ebistest/c on fig/tuxco nfig;ex port TUXCONFIG BDMCONFIG=/home/ebistest/co nfig/bdmco nfig;ex port BDMCONFIG FIELDTBLS32=ft pflds;ex port FIELDTBLS32

FLDTBLDIR32=$TUXDIR/a pi105;ex port FLDTBLDIR32 针对文件传输的，如果文件较大，可以将环境变量FTP_BLOCK_SIZE 的值设置的大一点，如果没有设置该环境变量，则系统默认为1024。例如：

FTP _BL0CK_SIZE=10240 ； exp ort FTP _BLOCK_SIZE

4、修改在网关机上的环境设置文件envfile 和setenv ，将如下的环境变量进行修改，使之与实际的配置想符合。

除了上面列出的还有如下几个变量：

修改：NWADDR 的地址：端口，例如：

NWADDR="〃192.168.42.231:7310"

(for HPUX )

(for SCO )

MCHSNDFILE=/t mp/beta/matchse nd.txt;ex port MCHSNDFILE

FSNDLOG=/tm p/beta/Fs nd.log;ex port FSNDLOG

P RINTERDIR=/t mp/beta; export P RINTERDIR

主要是用于成交回报交易的。

5、系统启动

首先设置环境变量，可以放在.p rofile 中，也可以执行命令../sete nv

然后再登记中心机器上（MASTER ）执行tmboot 即可，可以选择分步来启动应用系统，使用：tmboot -A 和tmboot -来逐个启动系统。

网点的安装和配置 一、软件打包

1、网点的中间件软件（tuxedo ），只是需要一些客户端的库函数等等，在选择workstation 模式安装后，将tuxedo 的所有文件达成一个包即可。

2、需要在网点编译时，要注意配置环境变量，参看下面的系统配置。

二、系统的配置

1、配置环境变量

修改环境变量设置文件（tux.e nv 或sete nv ），将如下环境变量的值进行修改，使之与实际的配置想符合。

例如：

TUXDIR=/home/tuxedo; export TUXDIR

P ATH=$TUXDIR/bi n:$ PATH:$HOME/ru ntime:.; export P ATH

SHLIB_ PATH=$TUXDIR/lib:/usr/lib:/lib;ex port SHLIB_ PATH LIB PATH=$TUXDIR/lib:$LIB PATH; exp ort LIB PATH ( for AIX )

LD_LIBRARY_ PATH=/usr/tuxedo/lib: /usr/i nformix/lib/esql

NLS PATH=$TUXDIR/locale;ex port NLS PATH

LANG=C;ex port LANG 2、配置与代理集中点相连接的环境变量

各个网点的应用代码都是通过工作站（workstation ）方式与代理集中点连结的。因此要配置连结代理集中点的tcp/ip 地址和端口。

例如：

WSNADDR=//192.168.42.220:7520; export WSNADDR

也可以主机名加端口，例如：

WSNADDR=//h p01:7520; export WSNADDR

常见的问题及解决方法 以下常见的都是在使用中间过程中遇到的问题：

一、与数据库的连接问题 在测试中看到，应用代码都是自己去联的数据库，为了保证效率，都是在进程启动的时候预先建立起连接，这样保证了交易进行时的效率；但当数据库出现宕机 时，连接也将随之丢失了，这时的应用程序就不能再访问数据库了，在目前的应用中都没有对访问数据库的返回码进行判断，如果是连接失败的可以选择重新连 接数据库，而不是退出交易，这样交易又可以正常运行了。 (for HPUX )

(for SCO )

目前，这样的情况出现后，就需要将应用系统重新启动，使应用程序同数据库进行重新连接。

二、代理集中点上常见的一个问题 在代理集中点上常看到两条队列，键值是32和3e8，这两条队列在写满时，因为监控进程没有及时读队列，常常会影响与之有关的几个进程，只 需要将这两条队 列清空就可以了。

三、系统启动不正常 常见的原因有如下几个：

环境变量没有设好，如上面的所说的各个环境变量。可以到~/etc 目录下使用命令：../sete nv 来设置一下。

据库连接失败，这样会导致连接数据库的应用进程不能启动。检查数据库确保能够正常连接后，再重新启动这些进程。

单个进程的问题，比如执行权限等等，参看日志文件来找出原因。

4、在登记中心使用的是多机互连方式，主管机器负责启动所用的进程，在所有的机器上都要有相应的监听进程：tlisten ,对于网关机上的服务，如果网关机宕机 或被重新启动时，要将监听进程启动起来，在~/etc 目录下，使用命令：../sete nv 即可，然后先在主管机器上运行tmadmi n ,进入后并执行pci gwn ame 命令来清 理掉网关机得响应信息，再退出并重新启动网关机上的应用系统：tmboot - gw name 。

注：gwname 时网关机的逻辑名，在ubb.txt(Ubbconfig) 中定义的，不同的网关机有不同的逻辑名。

注：tlisten 进程可以多次启动，当该进程已经正常运行时，再次启动会报出错误信息：CMDTUX_CAT:1319: 也有相应的记录，这说明该进程已经启动了。

5、如果有某些进程始终在内存中，导致系统不能启动时，可以将这些进程杀掉，并将与之相关的队列和内存也都清掉，然后重新启动系统。

四、系统关闭不正常

1、客户端与系统在发生交易或连接，如：tmadm in 等等或客户端的某些服务等正在运行，这些都会导致系统的主进程不能正常关闭。

2、登记中心使用的是多机互连方式，主管机器负责启动和关闭所用的进程，在所有的机器上都要有相应的监听进程：tliste n ,对于网关机上的服务，如果网关机 宕机或被重新启动时，要将监听进程启动起来，在~/etc 目录下，使用命令：../setenv 即可，然后先在主管机器上运行tmadmin 命令，然后执行pci gwname 命令 来清理掉网关机得响应信息，再退出并重新关闭网关机上的应用系统：tmshutdow n - gw name 。

注：gwname 时网关机的逻辑名，在ubb.txt(Ubbconfig) 中定义的，不同的网关机有不同的逻辑名。

注：tlisten 进程可以多次启动，当该进程已经正常运行时，再次启动会报出错误信息：CMDTUX_CAT:1319: 也有相应的记录，这说明该进程已经启动了。

3、如果有某些进程始终在内存中，导致系统不能正常关闭时，可以将这些进程杀掉，并将与之相关的队列和内存也都清掉；这些进程往往都是由于运行中出现的 异常导致僵死在内存里了，需要手工干预的。

4、有时候，有几个操作人员在同时启动系统，会导致系统的某些进程与主进程失去联系，这样就很难关闭了，只好手工来杀掉(kill)，并将与之相关的队列、信 号灯和共享内存也都清掉(ipcrm)。

五、交易连接失败

1、环境变量设置有误，特别是使用客户端代码，直接连接远端服务的；需要重新设定环境变量，如：WSNADDR ，TUXCONFIG 等等，环境变量设置正确后，再 进行交易就可以了。 INFO: Term in ati ng tliste n p rocess ，在日志文件中 INFO: Term in ati ng tliste n p rocess ，在日志文件中

2、对方交易没有启动，这是的出错代码在日志文件中tperrno=6 ,是很典型的，找不到相应的服务；检查服务是否存在，重新启动服务即可。

3、在代理集中点上常常因为某条队列（32或3e8）阻塞，影响几个进程的访问，如操作员注册等会因为超时而失败；只需要将这两条队列清空就可以了。

六、成交回报的交易出错

1、进程（gwreadfs ）启动时有错误；检查网关机上环境设置是否正确，查看文件~/etc/e nvfile 中的内容，并根据其中的环境变量MCHSNDFILE 和FSNDLOG 所指定的文件，如：~/data/matchse nd.txt

和~/data/Fs nd.log ，看看这两个文件是否存在，否则，启动时会指出文件打不开而出错的。

~/data/matchse nd.txt

2、成交回报的内容没有正确的传到代理集中点上，要检查文件：se nderr.log 看其中的代理集中点号是否正确，主要是位置是否正确，并且看看在路由表中是否有配置，这类问题在测试初期曾出现过多次。

3、交易过程中，文件如果被删除掉了，（特别是目前放在临时目录下的这种情况），就需要在启动进程前，手工创建一个同名的空文件matchse nd.txt ;如果进程已经启动，则需要重新启动该进程。

编辑于联动北方技术论坛