如何配置Tuxedo-ubbconfig.doc
《如何配置Tuxedo-ubbconfig.doc》由会员分享，可在线阅读，更多相关《如何配置Tuxedo-ubbconfig.doc（42页珍藏版）》请在冰点文库上搜索。
如何配置Tuxedoubbconfig
应用软件开发部培训教材
如何配置Tuxedo_ubbconfig
（文档编号:
YR-WD-E-009）
方正奥德计算机系统有限公司
一九九九年十二月
37
文档管理信息表
主题
如何配置Tuxedo_ubbconfig
版本
V1.0.1
内容
Tuxedo配置文件ubbconfig的配置方法
关键字
ubbconfig
参考文档
BEATUXEDOAdministeringtheBEATUXEDOSystem
提交时间
1999年12月23日
撰写人
王煊
文档修改记录表
修改人
修改时间
修改内容
目录
一 术语对照说明 1
二 何为配置文件?
1
2.1 配置文件的两种形式 1
2.2 配置文件的内容 2
三 设置域范围参数 2
3.1 RESOURCES小节的信息 2
3.2 设置共享内存地址 4
3.3 指定主控机器（theMasterMachine） 5
3.4 设置应用类型 5
3.5 定义访问控制 6
3.6 定义IPC限制 7
3.7 激活负载均衡 8
3.8 设置缓冲区类型和子类型限制 8
3.9 设置健全检查（SanityChecks）数和阻塞超时值 9
3.10 设置会话限制 10
3.11 设置安全级别 10
3.12 设置主动通知参数 11
3.13 保护共享内存 12
四 配置机器 13
4.1 在MACHINES小节中指定机器 13
4.2 保留物理地址和机器ID 14
4.3 识别配置文件的位置 15
4.4 识别系统软件和应用服务器的位置 15
4.5 识别日志文件的位置 16
4.6 指定进程的环境变量设置 16
4.7 重载系统范围的参数 17
五 配置组（Groups） 18
5.1 指定组名、组号和LMID 18
六 配置服务器（Servers） 19
6.1 在SERVERS小节中指定服务器信息 19
6.2 定义服务器名、组别和ID 21
6.3 使用服务器命令行选项 21
6.4 设置服务器启动顺序 22
6.5 指定服务器的环境文件位置 23
6.6 指定服务器队列信息 23
6.7 定义服务器重启动信息 24
6.8 指定一个服务器为会话模式 25
6.9 定义服务器对共享内存的访问 25
七 配置服务（Services） 26
7.1 在SERVICES小节指定BEATUXEDO服务 26
7.2 激活负载均衡 26
7.3 通过服务优先级控制数据流向 27
7.4 为不同的服务组指定不同的服务参数 27
7.5 为一个服务指定允许使用的缓冲区列表 28
7.6 服务超时错误 29
7.6.1 导致服务超时的情况 29
7.6.2 超时发生的后果 30
7.6.3 如何报告服务超时 30
7.6.4 如何控制服务超时 31
八 配置路由（Routing） 32
8.1 在ROUTING小节中定义路由标准 32
8.2 在ROUTING小节中指定范围标准（RangeCriteria） 32
九 配置网络信息 34
9.1 在NETGROUPS小节中指定信息 34
9.2 网络组配置示例 35
9.3 配置有网络组的UBBCONFIG文件 36
一术语对照说明
中文
对应原英文
服务器
SERVER
服务
SERVICE
机器
SITE
机器
MACHINE
入口项
ENTRY
MSSQ集
MSSQSETS
小节
SECTION
标识
ID
发布
ADVERTISE
公告牌
BULLITINBOARD
路由
ROUTING
重载
OVERRIDE
标准
CRITERIA
二何为配置文件?
一个BEATUXEDO应用包含四个基本组成部分：
·一个用来描述应用的配置文件
·执行服务请求的服务器（Server）
·发起请求的客户端（Client）
·构造和运行应用的命令
2.1配置文件的两种形式
UBBCONFIG文件是配置文件的文本形式，可以使用任何一个文本编辑器创建和修改。
你必须为每个新应用创建一个UBBCONFIG文件。
注意：
做为bankapp和simpapp应用的一部分,BEATUXEDO软件提供了ubbshm,ubbmp,和ubbsimple三个UBBCONFIG文件的例子。
这些示例文件中的部分内容也将出现在本文中。
·TUXCONFIG文件是配置文件的二进制形式,它由tmloadcf命令根据文本形式的文件生成。
在tmloadcf被执行时，环境变量TUXCONFIG必须被设置为TUXCONFIG文件将被加载的设备文件或系统文件的全路径。
在应用程序运行时，可以使用tmconfig命令改变TUXCONFIG文件中的许多参数。
2.2配置文件的内容
配置文件最多时可以包含八个小节（section），最少时必须包含三个基本小节，如下所述：
·RESOURCES，本节定义所有的系统参数
·MACHINES，本节指明应用中的所有机器
·GROUPS，本节定义应用中所有的组（Group）、名称（name）、和标识（ID）。
文件中还必须包含最少九个参数。
总共有80个不同的参数，而且除过第一个小节外，其他小节都可以有同一参数的多个设置项。
在除第一个小节RESOURCES之外的其他小节，你可以使用DEFAULT参数表明同一参数的重复项。
三设置域范围参数
本节解释如何设置RESOURCES参数，这些参数从整体上控制应用。
其中一些参数是系统范围的缺省值，可以通过在MACHINES重新设置而使该机器忽略缺省值。
3.1RESOURCES小节的信息
RESOURCES小节是一个必须存在的小节，并且必须是配置文件中的第一个小节。
本节包括如下信息：
·共享内存的地址（IPCKEY）
·启动和关闭服务程序的管理点（MASTER）
·访问应用的用户控制（UID、GID和PERM）
·本应用的安全级别（SECURITY、AUTHSVC）
·应用中各进程的IPC限制，服务器进程的数量，以及提供的服务数（MAXACCESSERS、MAXSERVERS、MAXSERVICES）
·应用结构（MODEL），表明是单机器应用还是多机器应用
·是否使用服务器负载均衡（LDBAL）
·缓冲区类型和子类型的最大数目（MAXBUFTYPE、MAXBUFSTYPE）
·公告牌健全扫描（sanityscans）的时间间隔（SCANUNIT、SANITYSCAN）
·服务请求的超时值（BLOCKTIME）
·并发会话最大数目（MAXCONV）
·主动通知方法（NOTIFY、USIGNAL）
其中一些参数（UID、GID、PERM、MAXACCESSERS、MAXCONV）被用作系统范围的缺省值，但是可以被每个机器重载。
【RESOURCES小节示例及描述】
下面的表格给出某个BEATUXEDO应用的配置文件中RESOURCES小节的示例参数及其取值：
参数
取值
含义
IPCKEY
39211
一个大于32769，并且在本系统上本应用中唯一的数值
UID
0
BEATUXEDO管理员的用户标识
注意:
在WindowsNT上，此值必须为0
GID
1
管理员用户的组标识
注意:
在WindowsNT上，此值必须为0
PERM
0660
赋予管理员组的用户以读/写权限
MAXACCESSERS
15
允许最多15个进程在本机运行
MAXSERVICES
25
允许最多25个服务被发布到所有机器
MASTER
SITE1,SITE2
指明SITE1为主控机（master）。
如果SITE2也被指明，则该机器为备份机
MODEL
MP
本应用配置有多台机器
OPTIONS
LAN,MIGRATE
这是一个网络应用，服务器可以被迁移到替换处理器上
SECURITY
APP_PW
这是一个安全应用，客户端在加入前需要提供口令
AUTHSVC
"AUTHSVC"
在输入口令之外，客户端还许通过一个名为”AUTHSVC”的服务传送认证
NOTIFY
DIPIN
客户端通过dip-in接收主动消息
SYSTEM_ACCESS
PROTECTED,NO_OVERRIDE
应用代码未连接到共享内存（这一点不能更改）
LDBAL
Y
表明负载均衡功能启动
【RESOURCES小节示例】
RESOURCES
IPCKEY39211
UID0
GID1
PERM0660
MAXACCESSERS75
MAXSERVERS40
MAXSERVICES55
MASTERSITE1,SITE2
MODELMP
OPTIONSLAN,MIGRATE
SECURITYAPP_PW
AUTHSVC"AUTHSVC"
NOTIFYDIPIN
SYSTEM_ACCESSPROTECTED,NO_OVERRIDE
LDBALY
3.2设置共享内存地址
通过IPCKEY参数可以设置共享内存地址。
BEATUXEDO系统利用此参数来分配应用IPC资源，以便新加入应用的进程定位资源。
这个key及其变种被内部用来分配公告牌、消息队列及信号灯等新应用进程必须的资源。
在单处理器模式，这个key命名公告牌；在多处理器模式，这个key命名DBBL的消息队列。
【IPCKEY参数的特性】
·本参数必须出现在配置文件中
·本参数用来访问公告牌和其他IPC资源
·参数值必须是一个介于32,769和262,143之间的整数
·系统中其他应用不得使用此值做为自己的IPCKEY
3.3指定主控机器（theMasterMachine）
必须为所有的配置指定主控机器（MASTER），主控机器控制整个应用的启动和管理。
这个机器用逻辑机器标识（LMID）来指定。
LMID是由管理员选定的一个“字符＋数字”组成的名称。
如果允许主控机器迁移，则要指定两个LMID。
如果需要不中断应用而关闭主控机器，则需要指定备份机器。
【MASTER参数的特性】
·本参数是必须的，用来控制应用的启动和管理
·如果需要迁移备份主控机器，则需要指定两个LMID
3.4设置应用类型
以下几方面决定一个BEATUXEDO应用的结构：
·本应用是否要在单个处理器上运行并使用全局共享内存?
·应用是否将被网络化?
·是否将支持服务器迁移?
MODEL参数指明一个应用是否运行在单个处理器上。
对于单处理器和使用全局共享内存的多处理器应用，此参数值设为SHM。
MODEL值为MP用于多处理器并且没有全局共享内存的情况，以及网络化应用。
这个参数是必须的。
OPTIONS参数是个用逗号分隔的一系列应用配置选项。
两个可用的选项是LAN（表示一个网络化的配置）和MIGRATE（表示允许应用服务器迁移）。
【MODEL和OPTIONS参数特性】
参数
特性
MODEL
本参数为必需配置参数。
取值SHM表示一个有全局共享内存的单个机器。
取值MP表示有多台机器或者没有全局共享内存的多处理器机器。
OPTIONS
本参数是个用逗号分隔的一系列应用配置选项。
取值LAN表示一个局域网。
取值MIGRATE激活服务器迁移。
注意：
对SHM模式无需设置OPTIONS参数。
3.5定义访问控制
可以通过UID、GID和PERM三个参数提供基本的BEATUXEDO应用访问控制：
·UID -管理员的用户ID。
此值是启动和关闭系统的用户的UNIX系统用户ID。
·GID -管理员的组ID。
·PERM -一个八进制数，指明要分配给应用启动时所创建的IPC资源的权限。
这为保护BEATUXEDO系统的IPC结构免受非授权访问提供了初级的安全功能。
缺省值是0666，提供读/写访问给所有人。
对于产品应用，必须指定此值。
注意：
如果没有指定UID和GID参数，它们的缺省值是运行tmloadcf命令的用户的ID，除非在MACHINES小节中重载了这两个参数。
【UID、GID和PERM参数的特性】
参数
特性
UID
管理员的用户ID。
缺省值是运行tmloadcf命令的用户ID。
例如：
UID=3002
在WindowsNT上，此参数值始终为0
GID
管理员的组ID。
缺省值是运行tmloadcf的用户的组ID。
例如：
GID=100
PERM
访问IPC结构的权限
缺省值是0666
例如：
PERM=0660
在WindowsNT上，此参数值始终为0
注意：
可以覆盖远程机器上的值。
3.6定义IPC限制
由于大部分IPC和共享内存公告牌表都是静态分配的，以加快处理速度，因此正确调谐它们的取值就很重要。
如果它们过大，内存和IPC资源就会被耗尽；如果它们太小，则当有超过限额的资源需求时，进程就会失败。
下面这些有关IPC大小调整的调谐参数目前在RESOURCES小节中：
·MAXACCESSERS：
BEATUXEDO系统中一个机器上所能允许运行的最大进程数。
这并非所有进程的总和，而是等于拥有最多进程的机器上的进程数。
该参数的缺省值是。
（可以针对每个机器重载这个参数，只需在MACHINES小节中重新设置参数值即可）
·MAXSERVERS：
应用中最大服务器进程数，包括所有的管理服务器（如BBL和TMS）。
它是所有机器上服务器进程的总和。
缺省值为50。
·MAXSERVICES：
应用中可以发布的不同服务的最大值，它是系统中所有服务的总和。
缺省值是100。
（注意缺省值是为系统资源保留的数字）
增加MAXACCESSERS数值带来的开销是，每加一就要多消耗该机器上的一个信号灯。
除了根据MAXACCESSERS增加的信号灯外，还有一小部分固定数目的信号灯用于系统进程。
增加MAXSERVERS和MAXSERVICES参数的开销是需要为每个服务器、服务、客户段分别保留小部分共享内存。
这些参数主要是为应用在未来的扩展准备的，其中对MAXACCESSERS参数要仔细设置。
注意：
另外还有两个参数MAXGTT和MAXCONV也影响共享内存。
【MAXACCESSERS、MAXSERVERS和MAXSERVICES参数的特性】
参数
特性
MAXACCESSERS
运行最多进程的机器上的进程数。
可以在MACHINES小节中为每个机器重载这个参数。
开销是每个accesser要占用一个信号灯。
MAXSERVERS
应用中最大服务器进程数（所有机器上的总和）
开销是一小部分共享内存。
MAXSERVICES
应用中发布的最大服务数（所有机器之和）。
开销是一小部分共享内存。
缺省值为100.
3.7激活负载均衡
你可以控制是否在一个BEATUXEDO系统上整体使用负载均衡算法。
使用负载均衡时，系统中的每个服务都会被赋予一个负载因子，你可以跟踪每个服务器的总负载，而每个服务请求都将被送到负载最轻的合格服务器上。
这种算法虽然有效，但是开销很大，因此只应在需要时使用。
只有当服务是由使用多个队列的服务器提供的情况下才需要负载均衡。
当服务是被单个服务器提供，或被位于MSSQ（multipleserversinglequeue：
多服务器单队列）中的服务器提供时，不需要使用负载均衡。
此时，其LDBAL参数应该被设为N；其他情况下，你可以将LDBAL设置为Y。
如果LDBAL被设置为N，并且多个队列提供同样的服务，第一个可用的队列将被选中。
如果LDBAL被设置为Y，并且应用是网络化的，则TMNETLOAD环境变量可被用于为本地机器提供优先级。
【LDBAL参数特性】
·如果LDBAL被设置为Y，指定的服务器将进行负载均衡。
·如果LDBAL被设置为Y，你可以用TMNETLOAD环境变量来实现本地优先。
·如果LDBAL被设置为N，指定的服务器将成为第一个可用服务器。
·缺省值是N。
·因为LDBAL增加额外开销，因此只在需要时才应使用它。
·当所有服务都是被单个服务器提供时，不要使用负载均衡。
·如果所有服务都是被一个MSSQ服务器集（MSSQserverset）提供时，不要使用负载均衡。
3.8设置缓冲区类型和子类型限制
可以通过MAXBUFTYPE和MAXBUFSTYPE参数来分别控制应用中允许的缓冲区类型和子类型数目。
当前MAXBUFTYPE的缺省值是16。
除非你创建了很多自定义的缓冲区类型，否则你可以忽略MAXBUFTYPE参数。
但是如果你准备使用很多不同的VIEW子类型，可能需要调整MAXBUFSTYPE参数，使它超过其当前缺省值32。
【MAXBUFTYPE和MAXBUFSTYPES参数特性】
参数
特性
MAXBUFTYPE
系统中允许的最大缓冲区类型数。
仅在创建了8个以上自定义缓冲区类型时使用。
缺省值是16。
MAXBUFSTYPE
系统中允许的最大缓冲区子类型数。
缺省值是32。
3.9设置健全检查（SanityChecks）数和阻塞超时值
可以设置管理服务器（BBL）定期检查其本机上服务器健全性的次数。
此外还可以设置阻塞中的消息、事务及其他系统活动的超时时间。
通过SCANUNIT参数可以设置这些检查和超时的数值，参数值（以秒为单位）是5的倍数，缺省值为10。
使用SANITYSCAN参数指定两次服务器健全检查之间的SCANUNIT数。
SANITYSCAN*SCANUNIT之积不能超过300.当前缺省值设置SANITYSCAN*SCANUNIT在120秒左右。
【示例：
设置健全检查和超时值】
SCANUNIT参数值为10，BLOCKTIME参数值为3，允许客户应用有30秒的超时时间。
BLOCKTIME参数缺省值设置为使BLOCKTIME*SCANUNIT之积大约为60秒。
BLOCKTIME的值为以下几个时间之和：
·等候进入队列的时间
·在队列中等待的时间
·服务处理时间
·网络传输时间
【SCANUNIT、SANITYSCAN和BLOCKTIME参数特性】
参数
特性
SCANUNIT
建立检查和超时时间计算单位；
参数值必须为5秒的倍数；
如果没有设置，缺省值为10。
SANITYSCAN
BBL检查服务器的频率（以SCANUNIT为间隔单位）
SCANUNIT*SANITYSCAN不得超过300。
如果没有设置，缺省值使得SCANUNIT*SANITYSCAN大约为120秒。
BLOCKTIME
阻塞消息的超时值；
SCANUNIT*BLOCKTIME不能超过32767；
如果没有设置，缺省值使得SCANUNIT*BLOCKTIME大约为60秒。
3.10设置会话限制
通过MAXCONV参数可以指定在一个机器上的最大会话数目；
【MAXCONV参数特性】
·该参数指每个机器上最大并发会话数；
·参数取值必须大于等于0且小于32,766；
·对于在配置文件SERVERS小节中列有会话服务器的应用，参数的缺省值是10；否则，缺省值为1；
·可以在MACHINES小节中覆盖此值；
3.11设置安全级别
可以设置如下三种安全级别：
·PERM参数：
设置写应用队列的一级（最低级别）权限；
·SECURITY参数：
设置二级权限，要求客户在加入应用时提供口令。
当从UBBCONFIG文件生成TUXCONFIG文件时，这个口令将被和管理员提供的口令进行比较检查。
·AUTHSVC参数：
设置三级权限，将客户加入应用的请求提交给一个认证服务。
本级权限要求二级权限被设置。
认证服务可以是BEATUXEDO系统提供的缺省服务，也可以是如Kerberos服务那样由其他开发商提供的服务。
【SECURITY和AUTHSVC参数特性】
参数
特性
Security
可用的取值有：
NONE（缺省值）、APP_PW、USER_AUTH、ACL、MANDATORY_ACL。
例如：
SECURITYAPP_PW
AUTHSVC
认证服务的名称；
必须指定SECURITYAPP_PW；
缺省为无任何认证服务。
可以用Kerberos服务认证客户端；
例如：
AUTHSVC‘’AUTHSVC’’
3.12设置主动通知参数
通过设置NOTIFY参数可以规定客户端接收主动消息的方法，但是客户端可以在调用tpinit（）时在TPINIT结构中重载这个参数。
下面为可用的几种方法：
·IGNORE-客户端应该忽略主动消息；
·DIPIN-客户端只有在调用tpchkunsol（）或产生ATMI调用时才接收主动消息；
·SIGNALPage:
11
未最后确定
-客户端通过使系统产生一个信号，并借助信号处理函数调用函数获取主动消息，即通过tpsetunsol（）函数设置；
可以产生两种信号：
SIGUSR1和SIGUSR2。
通过设置USIGNAL参数可以选择使用哪种信号，缺省值是SIGUSR2。
在选择通过信号收取主动通知的应用中，所有基于MS－DOS的客户端工作站都自动转换为DIPIN方式。
【NOTIFY和USIGNAL参数的特性】
参数
特性
NOTIFY
取值IGNORE表示客户端应该忽略主动消息；
取值DIPIN表示客户端应该通过dip-In接收主动消息；
取值SIGNAL表示客户段通过信号来接收主动消息；
缺省值是DIPIN。
例如：
NOTIFYSIGNAL
USIGNAL
取值SIGUSR1表示通过此类信号来通知客户段；
取值SIGUSR1表示通过此类信号来通知客户段；
缺省值是SIGUSR2。
例如：
USIGNALSIGUSR1
3.13保护共享内存
可以通过SYSTEM_ACCESS参数来保护存放在共享内存中的系统表免受应用客户端或服务器的破坏。
这个参数对于正在开发的应用很有用，因为不当的应用代码会在无意中使用错误的指针破坏共享内存。
当应用已经全部调试和测试后，可以修改这个参数以获得更快的响应。
下面是本参数的几个可用选项：
·PROTECTED：
和应用代码编译在一起的BEATUXEDO库在执行系统代码时不连接到共享内存；
·FASTPATH：
BEATUXEDO库任何时候都连接到共享内存；
·NO_OVERRIDE：
选中的选项不能被重载，无论是客户端在调用tpinit（）时通过TPINIT结构，还是在配置文件中描述服务器的SERVERS小节中；
【PROTECTED、FAS
升级会员 