Tuxedo学习笔记-UBBCONFIG

一个Tuxedo应用系统的所有资源都在一个文本文件中进行定义,该文件称为UBBCONFIG。在配置完成之后,UBBCONFIG被编译成一个二进制的文件TUXCONFIG。在Tuxedo系统启动时,从该文件中读取系统的配置信息。UBBCONFIG文件类似于Windows下的*.ini文件。它包括以下8大部分,我们称之为节。

 

Ø        *RESOURCES节(必须):与整个系统有关的配置信息

Ø        *MACHINES节(必须):一个Tuxedo应用系统可能跨越多台服务器,在该节中配置与每台服务器有关的信息

 

Ø        *GROUPS节(必须):Tuxedo中的服务可被分为多个组,在该节配置与组有关的信息

Ø        *SERVERS节(可选):与Server有关的信息

 

Ø        *SERVICES节(可选):与Services有关的信息

Ø        *NETWORK节(可选):与网络有关的信息

 

Ø        *ROUTING节(可选):配置路由规则

Ø        *NETGROUPS节(可选):与网络分组有关的信息

 

一个Tuxedo应用系统=服务端程序+客户端程序+配置文件

Server:每一个服务端程序文件都被编译成一个相应的可执行文件,该文件在运行的时候称为Server,它实际上就是一个进程。

 

Services:在每个服务端程序中,主要是一个个函数,在Tuxedo中称这些函数为Services,一般也称之为服务。

一个系统可以跨越多台服务器,一台服务器可以有多个Group,但一个Group只能在一台服务器上,一个Group可以有多个Server,一个Server可以有多个Service

 

*RESOURCES节   

常见参数意义

 

参数     

  意义

 

IPCKEY

  共享内存id。Tuxedo用它标识公告板和其它IPC资源,范围32769~262142

 

MASTER

  指出主控节点的逻辑名LMID,也可以为该MASTER机指定一台备份机

 

UID

  TUXEDO管理员用户id,在UNIX下就是执行tnloadcf的用户ID,在Windows下没用,取0

 

GID

  TUXEDO管理员用户所在的组id。在Windows下取0

 

PERM

  指定对此IPC资源的存取权限。默认为0666,即任何人都可以对该IPC资源进行存取

 

DOMAINID

  该TUXEDO应用系统的唯一标识

 

MAXACCESSERS

  设定在本系统一个节点(一台服务器)上,可以有多少进程访问该系统的公告板,默认为50

 

MAXSERVERS

  设定系统中最多有多少个Server存在,默认值50

 

MAXSERVICES

  设定系统中最多有多少个Service存在,默认值100

 

MODEL

  部署模式:SHM(单机或者多台服务器但公用一个全局共享内存)、MP(多台服务器但没使用一个全局共享内存)

 

OPTION

  LAN(表使用MP部署模式),MIGRATE(表服务可以移植到替代处理器上)

 

SCANUNIT

  内部时间间隔单位,单位是秒,默认值10秒

 

SANITYSCAN  Tuxedo的管理进程BBL定时对它所在的服务器上的Tuxedo系统进行检查,检查超时的事务、超时的客户端连接等。SANITYSCAN指每隔多少个SCANUNIT检查一次,默认值12,即为12×SCANUNIT(默认10秒)=120秒

 

BLOCKTIME  交易超时时间,单位是SCANUNIT,默认值6

 

MAXCONV

  同时最大会话数,范围:0~32768,默认值10

 

NOTIFY

  设置消息的通知方式。默认为DIPIN(当客户端调用ATMI函数时,顺便查看是否有消息,如果有就发送给Client)

 

范例:

 

*RESOURCES

IPCKEY                            80952 UID                                    213 GID                                          1 PERM                               0660     MAXACCESSERS        150 MAXSERVERS                     75 MAXSERVICES                    200 MASTER                          SITE1,SITE2 MODEL                                   MP OPTIONS                         LAN,MIGRATE SCANUNIT                      10 SANITYSCAN                 12 BLOCKTIME                   3 MAXCONV                      10 NOTIFY                      DIPIN

*MACHINES节

 

常见参数意义

参数     

  意义

 

LMID

  物理处理器名,可以通过”uname –n”或节点名得到

 

TUXDIR

  TUXEDO系统软件安装位置

 

APPDIR

  应用服务位置全路径

 

TUXCONFIG

  TUXEDO配置文件全路径

 

ENVFILE

  环境文件全路径

 

TYPE

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

 

ULOGPFX

  指定应用日志文件所在的目录及前缀。

 

 

UID、GID、PERM、MAXACCESSERS、MAXCONV在这里可以被重新配置,以这里为准

*GROUPS节

 

一台机器至少要定义一个服务组。如果没有定义组,管理命令tmadmin可能依然能运行。

       每个组只要定义组名,映射组名的组号和逻辑机器名。组为分布式交易系统和数据依赖路由等灵活性措施提供了支持。

 

常见参数意义

参数     

  意义

 

组名

  组的唯一标识符,可以是字母数字

GRPNO

  组的唯一数字标识符

LMID

  逻辑机器名

 

 

范例

*GROUPS

BANKB1     GRPNO=200     LMID=SITE1

BANKB2     GRPNO=220     LMID=SITE1

SYSGRP     GRPNO=110     LMID=SITE1

EVTGRP1   GRPNO=120     LMID=SITE1

*SERVERS节

常见参数意义

 

参数     

  意义

 

SRVGRP

  服务属于一个在*GROUPS节中定义的服务组名

 

SRVID 

  该Server所对应的ID。在组中应该唯一

 

MIN

  最少启动的进程数

 

MAX

  最多启动的进程数

 

RESTART

  如果设成Y,则服务可以重启动

 

GRAC,MAXGEN

  在GRACE定义时间之内,服务可以重启动MAXGEN次

 

RCMD

  每次服务重启动要执行的一个可执行文件名

 

CLOPT        跟随服务启动的其他参数

-A         服务内建交易全发布

–r           指定服务记录时间戳,用于以后计算交易处理时间

              -e          定义标准错误重定向文件

              -o          定义标准输出重定向文件

              --            TUXEDO参数和服务特定参数的分隔符

              …          传给tpsvrinit()的参数

在默认情况下,Tuxedo的每一个Server对应一个请求队列,也可以多个Server对应一个请求队列,即MSSQ方式,以提高响应的速度。方法是设置以下参数。

 

RQADDR:当设定此项后,所有本服务的实例都使用相同的请求队列。这是在应用中设置MSSQ(Multiple Server Single Queue)的方便办法,可以改善处理流量。任何时候,所有MSSQ集中的实例发布相同的交易集。

XFER:另一个服务      

 

REPLYQ:  设成Y,则服务又作为一个MSSQ集配置,任何其中的交易调用其他交易,就建立一个单独的回应队列。

范例

 

*SERVERS

DEFAULT:  RESTART=Y     MAXGEN=5      GRACE=3600

                     RCMD=”/sur/apps/atmapp/scripts/beeper”

                     CLOPT=”-A”      ENVFILE=”/usr/apps/atmapp/envfile”

TLR              SRVGRP=BANKB1       SRVID=10  MIN=1   MAX=2

                     CLOPT=”-A –r

                     -e /usr/apps/atmapp/logs/TLR1.err

                     -o /usr/apps/atmapp/logs/TLR1.out

                     --

                     -T 101 –e 300 –d dbfile”

                     SYSTEM_ACCESS=PROTECTED

                     RQADDR=”TLR_Q1”

XFER   SRVGRP=BANKB1       SRVID=20  MIN=1   MAX=2

              RQADDR=”XFER_Q1”  REPLYQ=Y

              CLOPT=”-A –r”

*SERVICES节

常见参数意义

 

参数     

  意义

 

BUFTYPE

  任何向该交易的请求,数据应该是此处定义类型

 

SRVGRP

  交易所在服务所在的组

 

LOAD

  负载因子,表示处理请求的时间,用于计算负载平衡,默认为50

 

PRIO

  优先级,默认为50

 

范例

 

*SERVICES

DEPOSIT    BUFTYPE=”FML”

                     SRVGRP=BANKB1

                     LOAD=25   PRIO=70

配置文件的编译(生成TUXCONFIG文件)

UBBCONFIG文件是一个可以编辑成需要的应用配置的文本文件。但是,/T在实际应用上读取的是二进制TUXCONFIG文件用于操作。命令tmloadcf可以把UBBCONFIG文件转化成TUXCONFIG文件。

 

Tmloadcf  -y UBBCONFIG文件名

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

 

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

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

 

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

-y    无条件覆盖TUXCONFIG,对全部问题都选“yes”

 

反编译命令tmunloadcf将TUXCONFIG转换成ASCII格式用于检查。该工具读取环境变量TUXCONFIG指向的文件。输出包含所有的参数,包括TUXEDO设定的缺省值,是UBBCONFIG文件的一个超集。

Tmunloadcf  >myubb

 

 

http://blog.csdn.net/xfanghua/archive/2005/04/21/357171.aspx

你可能感兴趣的:(Tuxedo学习)