TUXEDO管理命令总结

tmboot  启动服务：

参数说明：

-l  lmid 启动逻辑服务器名为lmcd服务器上的所有进程

-g grpname 启动GROUP名为grpname的所有进程

-i  srvid 启动SRVID为srvid中的服务进程

-s aout 启动名aout的服务进程

- o sequence 启动SEQUENCE=sequence的服务进程

-A 启动所有的管理进程

-b 在没有把BACKUP服务器变为MASTER服务器的情况下，从BACKUP服务器上启动整个TUXEDO的进程。

-B lmid 在逻辑名为lmid的服务器上启动BBL进程

-M 在MASTER服务器上启动所有管理进程。如果TUXEDO应用系统是SHM模式，则启动BBL进程如果该TUXEDO应用系统是MP模式，则启动DBBL、BBL、和BRAIDGE进程

-dl 把服务进程启动时命令行参数显示出来，一般在用sdb等调试工具调试服务进程是使用。

-T grpname 启动grpname中所有TMS进程

-e command 若某个基础启动失败，执行command参数指定的命令，该命令可以是一个可执行程序，SHELL脚本等

-y 对启动服务器上的所有进程回答YES

-c 计算该TUXEDO 应用系统在运行时对IPC资源的最小需求并输出

如果一个TUXEDO应用启动失败，可能的原因有：

1，MAXACCESSES,MAXSERVERS和MAXSERVICES参数的值太大，超过了系统的IPC资源的限制，可减少它们的值再试。

2，在该TUXEDO应用系统中要用到TLOG，当该TLOG文件还没有创建时，应该先创建该TLOG文件。

3，在UBBCONFIG中指定的IPCKEY的值与其他系统的值冲突，可改变IPCKEY的值再试。

tmshutdown  关闭进程

参数同上，

区别参数：

-w    delay 立即挂起所有要关闭的server,并在过了delay秒之后马上关闭这些服务进程。系统将给这些服务进程发送SIGTERM信号，然后发送SIGKILL信号。

-k (TERM|KILL) 立即挂起所有要关闭的SERVER，系统将给这些服务进程先发送SIGTERM信号或发送

-R 只有在进行系统迁移时才用到，必须和-l或-g一起使用，关闭指定的服务进程，但不把它从BB中删除。

-c 管理BBL进程，即使现在有客户端与该TUXEDO应用系统连接

-p lmid 在lmid指定的机器上执行该命令，把该服务器从整个tuxedo应用系统中分离出去。如果该unix平台上TUXEDO应用服务器出了很严重的错误，无法正常管理该TUXEDO应用系统，可用下面的脚本把该tuxedo系统管理员所拥有的IPC资源全部清空，这样就可以把该TUXEDO应用系统关闭，名为rmipc的脚本内容如下?/P>

cipcrm `ipcs |grep $1|awk '{print "~" $1 " " $2 } ' `

如果TUXEDO系统管理员用户名为TUXEDO,则用下面的命令执行：

rmipc tuxedo

实例如下：ipckill.sh

if [ $# = "0" ]
then
USER=`logname`
else
USER=$1
fi

ipcrm `ipcs -s|grep $USER|awk '{print "-s" $2}'`
ipcrm `ipcs -m|grep $USER|awk '{print "-m" $2}'`
ipcrm `ipcs -q|grep $USER|awk '{print "-q" $2}'`
运行： ipckill  zhcx

tmadmin tmadmin是TUXEDO提供的一个命令行管理工具，可用它对TUXEDO应用系统进行监控、管理和动态修改配置等操作。

查询类命令：

psr 显示该系统所有server的信息

>psr

Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Service
---------      ----------  --------      -- ------ --------- ---------------
Q73001         00004.00200 GROUP4       200      0         0 (  IDLE )
BBL            170105                SITE1          0         1        50 (  IDLE )
WSL            00001.00005 GROUP1          5          0         0 (  IDLE )
信息含义：

RqDone:该SERVER当前已接受的请求数。

Load Done:RqDone*负载因子（负载因子的默认值为50）

CurrentServerce:当前正在处理客户端请求的SERVER，如果没有则为IDLE

Ø         help(h)              查看所能使用的管理命令

Ø         help(h)  command     查看指定命令的使用方法

Ø         default (d)          为其他命令设置默认参数

default  -m site1    将管理的对象设成site1 LMID

default –m *        解除缺省

Ø         dump(du) filename    将当前的Bulletin Board 下载到指定的文件

Ø         echo (e)             显示命令的输入行

Ø         pageinate(page)      按页显示命令输出

Ø         quit(q)              退出当前管理session

Ø         verbose(v)           将命令输出以详细信息格式显示

Ø         ! shlcmd             退出到shell执行特定的shell命令

Ø         !!                   重复前一个shell command

Ø         <RETURN>             回车重复上一次tmadmin命令

Ø         psr [-m machine] [-g groupname] [-i srvid] [-q qaddress]

-m  machine  LMID为 machine的所有服务进程

-g  groupname 组名为groupname的所有服务进程

-I srvid  SRVID为srvid的服务进程

-q qaddress 消息队列为qaddress的所有SERVERS

查看server的信息

Prog Name      Queue Name  Grp Name      ID RqDone Load Done Current Servic

BBL            123456      SITE1          0      0         0 (  IDLE )

WSL            00001.00001 GROUP1         1      0         0 (  IDLE )

A01100         00002.00011 GROUP2        11     46      2300 (  IDLE )

显示的结果包括:

l         Prog  Name  程序名

l         Queue Name  消息队列名,如果没有指定名称，则消息队列的名称的规则为“5为GRPNO.5位SRVID”，不足5位前补0。在SHM模式中，BBL的消息队列名是RESOUCES Section 的IPCKEY

的值。在MP模式，DBBL的消息队列名是RESOUCES Section 的IPCKEY的值。

l         Grp Name  SERVER所在的组

l         ID        SERVER的ID号

l         RqDone    SERVER 被调用的次数

l         Load Done  负载量(该SERVER的所有service的负载因子总和)

l         Current Service 当前正在被调用的service名称。如果当前没有service被调用，则为IDLE

Ø         psc [-m machine] [-g groupname] [-I srvid] [-q qaddress]

[-s service] [-a {0|1|2}]

-s service 显示名为sevice的service信息

-a {0|1|2} 显示系统的隐含的service

其他参数与psr命令相同

查看service的信息

Service Name Routine Name Prog Name  Grp Name  ID    Machine  # Done Status

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

A0110025     A0110025     A01100     GROUP2    11      SITE1       2 AVAIL

l         Service Name  :服务名

l         Routine Name  :函数名(采用TUXEDO服务的别名机制,一个函数可以对应多个服务名)

l         Prog Name     :service 所在的SERVER名

l         Grp Name      :组名

l         ID            ：server的ID号

l         Machine       :server所在的LMID

l         # Done        ：service被调用的次数

l         Status        :service的状态。AVAIL表示可用

Ø           bbstats(bbs)

打印BB的统计信息

Current Bulletin Board Status:

Current number of servers: 63

Current number of services: 936

Current number of request queues: 62

Current number of server groups: 12

Ø         printclient (pclt) [-m machine] [-u usrname] [-c cltname]

显示client端连接的情况

-m machine    显示LMID号为machine上的客户端连接

-u usrname    显示用户名为usename 的客户端连接

-c ctlname    显示用户进程为ctlname的客户端连接

显示结果

LMID         User Name       Client Name    Time    Status  Bgn/Cmmt/Abrt

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

SITE1           cpic            WSH             17:50:42 IDLE    0/0/0

SITE1           cpic            WSH             17:50:42 IDLE    0/0/0

SITE1           cpic            tmadmin          0:10:36 IDLE    0/0/0

l         LMID               逻辑机器名

l         UerName            用户名

l         Client Name        客户进程名

l         Time               客户进程处在Staus的时间

l         Status            IDLE/BUSY

l         Bgn/Cmmt/Abrt     the num of transaction begun/commited/aborted

Ø         printqueue (pq) [qaddress]

显示消息队列的信息

qaddress 消息队列名称

Prog Name      Queue Name  # Serve Wk Queued  # Queued  Ave. Len    Machine

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

A00000         A00000_q        2         0         0       0.0      SITE1

输出结果说明:

l         Prog Name    :消息队列对应的可执行文件名

l         Queue Name   :消息队列名

l         #Serve       :连接到消息队列的SERVER数

l         Wk Queued    :消息队列的当前负载量

l         Queued       :消息队列的当前实际请求数

l         Ave.Len      :消息队列的平均长度

l         Machine      :逻辑机器名

Ø         printnet (pnw) [mach_list]

site1                          Connected To:  msgs sent    msgs received

site2         28               54

site2                          Connected To:  msgs sent    msgs received

site1         55               29

打印当前系统的网络连接情况。

Ø          bbparms

打印BB的主要参数配置

Bulletin Board Parameters:

MAXSERVERS: 150

MAXSERVICES: 32000

MAXACCESSERS: 160

MAXGTT: 100

MAXCONV: 64

MAXBUFTYPE: 16

MAXBUFSTYPE: 32

IPCKEY: 123456

MASTER: SITE1

MODEL: SHM

LDBAL: Y

SCANUNIT: 10

SANITYSCAN: 12

DBBLWAIT: 2

BBLQUERY: 30

BLOCKTIME: 18

Shared Memory ID: 303

tmadmin 用来查看TUXEDO的运行情况。在tmadmin命令界面中可以使用如下命令：

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

psr
为printserver命令的简写，监控服务器运行情况，查看处理的请求数目、忙闲程度。

参数如下：
-m machine LMID为 machine的所有服务进程
-g groupname 组名为groupname的所有服务进程
-i srvid SRVID为srvid的服务进程
-q qaddress 消息队列为qaddress的所有SERVERS查看server的信息

> psr -i 15058
Prog Name Queue Name Grp Name ID RqDone Load Done Current Service
——— ———- ——– — —— ——— —————
RK016 00060.15058 CHGGRP_+ 15058 0 0 ( IDLE )

-i srvid SRVID为srvid的服务进程
#接续日志记录
RK016 SRVGRP=CHGGRP_SXBOSS SRVID=15058 CONV=N MIN=1 MAX=1
CLOPT=”-A -r -t -o /boss18/run/log/RK016.log”

结果说明:
列号 描述
1. 服务的可执行文件名
2. 服务连接的队列名
3. 组名
4. 服务的数字id
5. 服务已经处理的请求数(该SERVER的所有service的负载因子总和)
6. 服务处理的全部请求的参数和，如果当前没有service被调用，则为IDLE

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

psc
为printservice的简写，查看TUXEDO各服务的运行情况和处理的交易数。
psc [-m machine] [-g groupname] [-I srvid] [-q qaddress][-s service] [-a {0|1|2}]
-s service 显示名为sevice的service信息
-a {0|1|2} 显示系统的隐含的service
其他参数与psr命令相同

(2) 结果示例:
> psc -s sK005insert
Service Name Routine Name Prog Name Grp Name ID Machine # Done Status
———— ———— ——— ——– — ——- —— ——
sK005insert sK005insert RK005 CHGGR+ 15046 SXBOSS 33 AVAIL

(3) 结果说明:
列号 描述
1. Service Name :服务名
2. Routine Name :函数名(采用TUXEDO服务的别名机制,一个函数可以对应多个服务名)
3. Prog Name :service 所在的SERVER名
4. Grp Name :组名
5. ID ：server的ID号
6. Machine :server所在的LMID
7. # Done ：service被调用的次数
8. Status :service的状态。AVAIL表示可用

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

pq
查看队列信息
(1) 命令: printqueue 简写:pq [PADRESS]
(2) 结果示例:
pq 00004.05062
Prog Name Queue Name # Serve Wk Queued # Queued Ave. Len Machine
——— ———— —— ——— ——– ——– ——-
CCS_GEDAIPC_50 00004.05062 1 0 0 0.0 simple
(3) 结果说明:
列号 描述
1. Prog Name :队列连接的服务的可执行文件名
2. Queue Name :字符队列名，是RQADDR参数或一个随机值
3. #Serve :连接的服务数
4. Wk Queued :当前队列的所有请求的参数和
5. #Queued :实际请求数
6. Ave.Len :平均队列长度
7. Machine :队列所在机器的LMID

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

pclt
4查看客户端信息pclt
(1) 命令: printclient 简写:pclt
-m machine 显示LMID号为machine上的客户端连接
-u username 显示用户名为username 的客户端连接
-c ctlname 显示用户进程为ctlname的客户端连接
(2) 结果示例:
LMID User Name Client Name Time Status Bgn/Cmmt/Abrt
———- ————— ————— ——– ——- ————-
simple ccsmis WSH 17:42:47 IDLE 0/0/0
simple ccsmis tmadmin 0:44:28 IDLE 0/0/0
(3) 结果说明:
列号 描述
1. 已经登录的客户端机器的LMID
2. 用户名，由tpinit()提供的
3. 客户端名，由tpinit()提供的
4. 客户端连接后经过的时间
5. 客户端状态
6. IDLE——表示客户端目前没有任何交易在工作
7. IDLET——表示客户端启动了一个交易
8. BUSY——表示客户端在工作中
9. BUSYT——表示客户端正在交易控制下工作
10. 启动/提交/中断的交易数

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

bbs
5查看部分统计信息bbs
(4) 命令: bbstats 简写：bbs
> bbs
Current Bulletin Board Status:
Current number of servers: 335
Current number of services: 2324
Current number of request queues: 27
Current number of server groups: 11
Current number of interfaces: 0

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

default
6观察某个节点的进程信息default
(5) 命令：default –m
> default -m SITE13

SITE13> psr
Prog Name Queue Name Grp Name ID RqDone Load Done Current Service
——— ———- ——– — —— ——— —————
BBL 30004.00000 SITE13 0 22827 1141350 ..ADJUNCTBB
BRIDGE 836437 SITE13 1 0 0 ( IDLE )
GWADM 00021.00019 BGWGRP1+ 19 0 0 ( IDLE )
GWTDOMAIN 00021.00020 BGWGRP1+ 20 123826 0
GWADM 00022.00021 BGWGRP2+ 21 0 0 ( IDLE )
GWTDOMAIN 00022.00022 BGWGRP2+ 22 0 0 ( IDLE )
GWADM 00025.00027 GWGRP1_+ 27 4 200 ( IDLE )

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

pnw
7查看消息发送状态pnw
(6) 命令：printnetwork 简写 pnw
> pnw SITE12

SITE12 Connected To: msgs sent msgs received
SITE14 61904 62319
SITE13 61890 62288
SITE11 15972 13564

修改了UBBCONFIG文件后，需要对该文件进行重新加载，tmloadcf命令即用来实现该功能。

tmloadcf命令接受以下4个参数：

-c 计算运行应用需要的IPC资源，该信息将提供给管理员，用于在各机器上配置资源。

-n 进行语法检查并不生成TUXCONFIG。

-b 控制TUXCONFIG占用的物理页数。

-y 无条件覆盖TUXCONFIG

tmshutdown命令用于关闭所有或部分应用并释放IPC资源。
本命令所有参数与tmboot类似（如：-A，-g，-i，-s，-S），意义相同。

tmshutdown的特殊参数有：
-c
当有客户端正在连接时，tmshutdown不能关闭管理服务。参数-c则可以超越次规则。该参数仅用于管理员需要立即关机而又无法及时通知客户端时。

-P
在非主控节点上，可以用-P参数仅关闭该机器上的应用。

示例：
tmboot -s s1104Cfm;
s1104Cfm为服务名。

tmboot命令启动TUXEDO系统的应用，创建必要的IPC资源、启动相关机器的规定的系统和应用服务进程。

tm的主要参数有：
-A 启动所有机器上的管理进程。
-M 启动主控机器上的管理进程。
-i srvid 启动服务id等于srvid的进程。
-g grpname 启动指定的一组服务（含TMS）。
-S 启动所有应用服务。
-s server-name 启动可执行文件名为server-name的服务。
-e 打印本配置所需要的最少的IPC资源。

示例：
tmboot -s s1104Cfm;
s1104Cfm为服务名。