Tuxedo ubbconfig配置详解

应用的描述信息配置在系统核心位置，用一个文件描述，通常称为ubbconfig文件，在主控机器上。整个TUXEDO系统的管理任务可以在一台机器上完成，在配置中被定为主控节点。 

在运行时，这些信息被装入一段共享内存（一个IPC资源），称为公告牌（Bulletin Board—BB）；包含有配置中不同机器的信息，在这些机器上运行的服务的信息，这些服务提供的交易的信息以及其他相关信息。 
客户端在运行时连接公告牌。当客户端程序调用一个交易，将根据公告牌找到合适的服务队列。 
所以，公告牌是： 
——供客户端寻找适当的服务，运行一个交易请求 
——包含应用信息：机器，服务，交易，网络等 
——创建于ubbconfig文件 
TUXEDO提供一个管理进程，称为BBL(Bulletin Board Liaison),包含了一个公告牌的本地拷贝和本地服务器上应用的状态。 
TUXEDO提供的另一个管理进程DBBL(Distinguished Bulletin Board Liaison)，用于多服务器配置时。DBBL与BBL协同，保证所有部分的公告牌内容的一致性。 


配置文件 
任何TUXEDO应用系统的最基本的管理任务，是建立并维护配置文件。该文件通常称为ubbconfig文件。负责该工作的系统管理员必须很好的了解分布于各台机器上的应用服务的数据流，消息队列的构造，资源间的相互关系。ubbconfig文件可视作包含应用启动信息的容器，需编译成二进制文件tuxconfig，作为启动时的参考。 
其内信息包括： 
2 系统范围信息（*RESOURCES节） 
2 机器信息（*MACHINES节） 
2 组信息（*GROUPS节） 
2 服务信息（*SERVERS节） 
2 交易信息（*SERVICES节） 
2 网络组信息（*NETGROUPS节） 
2 网络信息（*NETWORK节） 
2 路由原则信息（*ROUTING节） 
当完成了ubbconfig文件后，用tmloadcf命令生成tuxconfig 
另一种从ubbconfig生成tuxconfig的方法是使用图形管理界面(GAI—Graphical Administration Interface)。 

代码  

1. // 应用的信息  
2. *RESOURCES节包含整个应用范围的信息。本节必须在配置文件第一节，不可缺少。信息说明如下：  
3. // 参数 意义  
4. *RESOURCES *RESOURCES节  
5. IPCKEY 共享内存id  
6. UID TUXEDO管理员用户id  
7. GID TUXEDO管理员组id  
8. PERM TUXEDO管理员组用户的权限  
9. MAXACCESSERS 服务端和客户端的最大进程数  
10. MAXSERVERS 限制可以启动服务总数  
11. MAXSERVICES 限制可以发布交易总数  
12. MASTER 指出主控节点的逻辑名，第二个是备份节点  
13. MODEL 应用构架，MP表示多机  
14. OPTIONS LAN，MIGRATE表示是一个网络应用，服务可以移植到替代处理器上  
15. SECURITY 安全级别（5个）  
16. AUTHSVC 客户端可以通过交易“AUTHSVC”获得认证  
17. NOTIFY DIPIN，客户端通过dip-in收到广播通知  
18. SYSTEM_ACCESS PROTECTED，NO_OVERRIDE，应用代码不得干扰共享内存  
19. LDBAL 设Y则进行负载均衡  
20. MAXBUF[S]TYPE 数据缓冲类型及子类的最大数  
21. SCANUNIT 内部时间间隔单位，单位是秒  
22. SANITYSCAN 检索公告牌的内部时间间隔，单位是SCANUNIT  
23. BLOCKTIME 交易超时时间，单位是SCANUNIT  
24. BBLQUERY DBBL查询所有BLL的时间间隔  
25. DBBLWAIT DBBL等待BBL回应的超时时间  
26. MAXCONV 同时最大会话数  
27. 注意：本处未列出全部参数。这些系统范围内参数可以被后序节内参数超越。  
28. 范例  
29. *RESOURCES  
30. IPCKEY 80952  
31. UID 213  
32. GID 1  
33. PERM 0660  
34. MAXACCESSERS 150  
35. MAXSERVERS 75  
36. MAXSERVICES 200  
37. MASTER SITE1,SITE2  
38. MODEL MP  
39. OPTIONS LAN,MIGRATE  
40. SECURITY APP_PW  
41. AUTHSVC AUTHSVC  
42. NOTIFY DIPIN  
43. SYSTEM_ACCESS PROTECTED,NO_OVERRIDE  
44. LDBAL Y  
45. MAXBUFTYPE 10  
46. MAXBUFSTYPE 15  
47. SCANUNIT 10  
48. SANITYSCAN 12  
49. BLOCKTIME 3  
50. BBLQUERY 24  
51. DBBLWAIT 10  
52. MAXCONV 10  

 

代码  

1. // 机器信息  
2. *MACHINES节包含应用有关的每个处理器的信息。本节必须在*RESOURCES节后列出。  
3. //  参数 意义  
4. *MACHINES MACHINES节  
5. gumby 物理处理器名，可以通过”uname –n”或节点名得到  
6. TUXDIR TUXEDO系统软件安装位置  
7. APPDIR 应用服务位置全路径  
8. TUXCONFIG TUXEDO配置文件全路径  
9. ENVFILE 环境文件全路径  
10. ULOGPFX 应用日志文件全路径  
11. MAXACCESSERS 本机最多处理器数，可以超越*RESOURCES节定义  
12. MAXCONV 本机最大会话数，可以超越*RESOURCES节定义  
13. 范例  
14. *MACHINES  
15. gumby LMID=SITE1  
16. TUXDIR=”/usr/tuxedo”  
17. APPDIR=”/usr/apps/atmapp”  
18. TUXCONFIG=” /usr/apps/atmapp/atmapp.tux”  
19. ENVFILE=” /usr/apps/atmapp/ENVFILE”  
20. ULOGPFX=”/usr/apps/atmapp/logs/ULOG”  
21. MAXACCESSERS=100  
22. MAXCONV=15  

 

代码  

1. // 组定义  
2. *GROUP节包含服务组的定义。一台机器至少要定义一个服务组。如果没有定义组，管理命令tmadmin可能依然能运行。  
3. 每个组只要定义组名，映射组名的组号和逻辑机器名。组为分布式交易系统和数据依赖路由等灵活性措施提供了支持。  
4. // 参数 意义  
5. *GROUPS GROUP节  
6. BANKB1 组的唯一标识符，可以是字母数字  
7. GRPNO  组的唯一数字标识符  
8. LMID 组所在的机器  
9. 范例  
10. *GROUPS  
11. BANKB1 GRPNO=200 LMID=SITE1  
12. BANKB2 GRPNO=220 LMID=SITE1  
13. SYSGRP GRPNO=110 LMID=SITE1  
14. EVTGRP1 GRPNO=120 LMID=SITE1  

 

代码  

1. // 服务定义  
2. ubbconfig的*SERVERS 节包含的是服务进程的信息。本节中每一个入口代表一个应用启动时加载的服务。这些信息包含服务名，命令行参数，服务环境，重启动等等。由于每个服务功能各不相同，其配置参数也因此相同或相异。  
3. 参数 意义  
4. *SERVERS SERVER节，列出所有服务程序  
5. DEFAULT: 本处列出的参数为其下列出的服务的缺省值，但可以被单列条目替代相应值  
6. RESTART 如果设成Y，则服务可以重启动  
7. MAXGEN 在GRACE定义时间之内，服务可以重启动MAXGEN次  
8. GRACE 周期，单位是秒  
9. RCMD 每次服务重启动，本处定义的脚本或命令被执行  
10. ENVFILE 列有环境变量的文件，在交易启动前设入环境  
11. TLR 一个服务名，用buildserver建立，应在APPDIR或$TUXDIR/bin  
12. SRVGRP 服务属于一个在*GROUPS节中定义的服务组；如果需要移植服务，也可以定义在多个组中。  
13. SRVID 服务组中代表服务的唯一值  
14. MIN 最少在启动时启动的服务数  
15. MAX 运行时，最多可以起的实例数  
16. CLOPT 跟随服务启动的其他参数  
17. -A 服务内建交易全发布  
18. –r 指定服务记录时间戳，用于以后计算交易处理时间  
19. -e 定义标准错误重定向文件  
20. -o 定义标准输出重定向文件  
21. -- TUXEDO参数和服务特定参数的分隔符  
22. … 传给tpsvrinit()的参数  
23. SYSTEM_ACCESS 设定后，应用错误不干扰公告牌  
24. RQADDR 当设定此项后，所有本服务的实例都使用相同的请求队列。这是在应用中设置MSSQ（Multiple Server Single Queue）的方便办法，可以改善处理流量。任何时候，所有MSSQ集中的实例发布相同的交易集。  
25. XFER 另一个服务  
26. REPLYQ 设成Y，则服务又作为一个MSSQ集配置，任何其中的交易调用其他交易，就建立一个单独的回应队列。  
27. 范例  
28. *SERVERS  
29. DEFAULT: RESTART=Y MAXGEN=5 GRACE=3600  
30. RCMD=”/sur/apps/atmapp/scripts/beeper”  
31. CLOPT=”-A” ENVFILE=”/usr/apps/atmapp/envfile”  
32. TLR SRVGRP=BANKB1 SRVID=10 MIN=1 MAX=2  
33. CLOPT=”-A –r  
34. -e /usr/apps/atmapp/logs/TLR1.err  
35. -o /usr/apps/atmapp/logs/TLR1.out  
36. --  
37. -T 101 –e 300 –d dbfile”  
38. SYSTEM_ACCESS=PROTECTED  
39. RQADDR=”TLR_Q1”  
40. XFER SRVGRP=BANKB1 SRVID=20 MIN=1 MAX=2  
41. RQADDR=”XFER_Q1” REPLYQ=Y  
42. CLOPT=”-A –r”  

 

代码  

1. // 交易定义  
2. *SERVICES节提供了应用的特殊交易的信息。包括负载平衡（LOAD）和数据缓冲类型检查（BUFTYPE）。如果全部都是缺省值则本节可以省略。  
3. 参数 意义  
4. *SERVICES 交易节  
5. # 注释行符号  
6. 大写字母 交易名，由应用服务提供  
7. BUFTYPE 任何向该交易的请求，数据应该是此处定义类型  
8. GROUP 交易所在服务所在的组  
9. LOAD 负载因子，表示处理请求的时间，用于计算负载平衡  
10. PRIO 优先级  
11. 范例  
12. *SERVICES  
13. #comment line  
14. DEPOSIT BUFTYPE=”FML”  
15. SRVGRP=BANKB1  
16. LOAD=25 PRIO=70  

生成TUXCONFIG文件 
UBBCONFIG文件是一个可以编辑成需要的应用配置的文本文件。但是，/T在实际应用上读取的是二进制TUXCONFIG文件用于操作。命令tmloadcf可以把UBBCONFIG文件转化成TUXCONFIG文件。 
tmloadcf命令接受以下4个参数： 
-c 计算运行应用需要的IPC资源，该信息将提供给管理员，用于在各机器上配置资源。 
-n 进行语法检查并不生成TUXCONFIG。 
-b 控制TUXCONFIG占用的物理页数。 
-y 无条件覆盖TUXCONFIG 
环境变量TUXCONFIG必须设定指向二进制TUXCONFIG文件。 
在安全要求高的应用中，tmloadcf不能从标准输入接受，环境变量APP_PW必须包含应用密码。 
tmunloadcf将TUXCONFIG转换成ASCII格式用于检查。该工具读取环境变量TUXCONFIG指向的文件。输出包含所有的参数，包括TUXEDO设定的缺省值，是UBBCONFIG文件的一个超集。 
*************************************************
UID和GID是你的服务以哪个用户和组运行，联合PERMS可以判断执行权限，不置为本用户。 

Domain是在Tuxedo的架构中，可以共同负载均衡，迁移，备份等功能的一组机器，勿要同Group混淆。 
 

一个tuxedo应用只能有一个DMADM，可以在任何一个组中
一个tuxedo应用可以有多个GWADM---GWTDOMAIN对,一个组只能有一个GMADM----GWTDOMAIN对,