如何配置Tuxedo ubbconfig(3)

本部分解释如何为每个处理器（即应用所运行在其上的机器）定义参数

小节中指定机器

应用中的每个机器必须在配置文件的MACHINES小节中有一个入口项，并且该小节必须是配置文件的第二个小节。MACHINES小节中包含应用中每个机器的如下信息：

·         机器地址到逻辑标识（LMID）的映射

·         配置文件的位置（TUXCONFIG）

·         BEA TUXEDO软件的安装位置（TUXDIR）

·         应用服务器的位置（APPDIR）

·         应用日志文件的位置（ULOGPFX）

·         环境文件的位置（ENVFILE）

 

MACHINES小节中必需的几个参数是LMID、TUXCONFIG、TUXDIR和APPDIR。

注意：对于某个特别的机器，可以重载在RESOURCES 小节中指定的UID、GID、PERM、MAXACCESSERS和MAXCONV取值。

 

【示例：MACHINES小节参数说明】

下面的表格中给出一个配置文件中MACHINES小节参数示例以及取值说明。

参数
	机器的名称； 机器名称在UNIX系统中通过uname –n命令得到。在Windows NT systems系统上，参见“控制面板”－>” 网络”->“计算机名称”。
	机器gumby的逻辑机器标识为SITE1；
	用双引号括起的应用目录位置的全路径；
	用双引号括起的配置文件的全路径；
	用双引号括起的包含环境信息的文件的全路径；
	用双引号括起的日志文件的全路径加前缀；
	用100为本机器重载系统范围参数值。
	用15为本机器重载系统范围参数值。

【示例：MACHINES小节】

 

下面给出了一个配置文件中MACHINES小节的示例：

MACHINES

gumby        LMID=SITE1

             TUXDIR="/tuxdir"

             APPDIR="/home/apps/mortgage"

             TUXCONFIG="/home/apps/mortgage/tuxconfig"

             ENVFILE="/home/apps/mortgage/ENVFILE"

             ULOGPFX="/home/apps/mortgage/logs/ULOG"

             MAXACCESSERS=100

             MAXCONV=15

【如何定制MACHINES小节】

你可以通过下面的步骤定制MACHINES小节：

·         将gumby替换为你的机器名

·         将TUXDIR替换为你的BEA TUXEDO软件目录

·         将APPDIR替换为你的应用目录

·         替换ENVFILE、TUXCONFIG和ULOGPFX的全路径

 

最先定义的是地址部分，这是MACHINES小节的一个入口项的基础。入口项中的其他参数都是描述了此地址指定的机器。在UNIX系统上，必须将此地址设置为调用uname –n命令得到的输出结果。在Windows NT systems系统上，参见“控制面板”－>”网络”->“计算机名称”。

LMID参数指定了一个逻辑名称用来识别其地址为上面所得到地址的机器。这个逻辑名称可以是任意的数字或字母，并且必须在应用中的所有机器里唯一。

 

【地址和机器ID，以及LMID参数特性】

·         地址和机器ID用下面的格式指定：

<地址> LMID=<逻辑机器名>

·         地址确定了物理处理器名称；

·         LMID参数的格式是：LMID=<逻辑机器名>

·         LMID是物理处理器的逻辑机器名

LMID是一个字母数字组合出来的名称，并且在MACHINES 小节中唯一

根据TUXCONFIG参数可以识别一个机器上配置文件的路径和文件名，该参数的值在双引号中，代表最多64个字母的全路径。该路径必须和环境变量TUXCONFIG中的一样，否则tmloadcf命令将不编译二进制文件。

 

【TUXCONFIG参数特性】

·         TUXCONFIG参数的格式为TUXCONFIG=""

·         本参数指定本机器的配置文件的路径和文件名（为了和惯例一致，应该保留TUXCONFIG做为文件名）

·         TUXCONFIG参数的全路径名称最大可到64个字母

·         TUXCONFIG参数的值必须与TUXCONFIG环境变量的值一样

应用中的每个机器中必须有一份 BEA TUXEDO系统软件和应用软件的拷贝。根据 TUXDIR参数可以知道系统软件的位置，根据APPDIR可以知道应用服务器的位置。这两个参数必须给出。APPDIR参数成为所有服务器进程的当前工作目录，BEA TUXEDO软件在TUXDIR/bin和APPDIR目录下寻找可执行程序。

 

【TUXDIR和APPDIR参数特性】

	特性
	参数格式要求全路径名包含在双引号中：TUXDIR="<TUXDIR>" TUXDIR指定BEA TUXEDO软件的位置 TUXDIR是必需的参数
	APPDIR指定应用服务器的位置 APPDIR是必需的参数 APPDIR成为所有服务器进程的当前工作目录

应用日志文件包含警告消息和信息，以及描述ATMI错误的错误信息。这些信息带有TPESYSTEM或TPEOS的返回码（表明某种潜在的系统错误）。用户可以利用日志追踪与应用相关的错误。在缺省情况下，文件被命名为ULOG.mmddyy，其中mmddyy表示月份、日期以及2位年份数字。缺省时，文件写到APPDIR目录下。

你可以通过设置ULOGPFX参数来重载日志文件的缺省目录和文件前缀，该参数的值是日志文件名的绝对路径，但是不包含日期。例如，可以将参数值设为APPDIR/logs/ULOG，这样日志文件将被放置到一个特定目录中。在网络化的应用中，通过指定一个安装（mount）到所有机器上的远程目录，可以维护一个中心日志文件。

 

【ULOGPFX参数的特性】

·         ULOGPFX参数的格式是包含在双引号中的字符串：ULOGPFX=""

·         应用日志文件中包含所有TPESYSTEM和TPEOS错误的解释

·         可以用应用记录应用错误

·         ULOGPFX参数的缺省值是<APPDIR>/ULOG

·         例如：ULOGPFX="/usr/appdir/logs/ULOG" ULOGPFX="/mnt/usr/appdir/logs/BANKLOG"

通过ENVFILE参数，你可以指定一个包含为所有要被BEA TUXEDO系统启动的进程设定环境变量的文件。由于系统为每个进程设置TUXDIR和APPDIR，因此文件中不应设置这两个值。下面这些参数影响应用的执行，它们可以在文件中被设置：

·         FIELDTBLS、FLDTBLDIR

·         VIEWFILES、VIEWDIR

·         TMCMPLIMIT

·         TMNETLOAD

【ENVFILE参数的特性】

·         ENVFILE参数的格式是包含在双引号中的字符串：ENVFILE=""

·         ENVFILE是为所有要被BEA TUXEDO系统启动的进程设定环境变量的文件

·         文件中可以设置FIELDTBLS、FLDTBLDIR等等，但是不要设置TUXDIR和APPDIR

·         ENVFILE参数是可选的，文件中的所有变量设置都必须是硬编码，不允许使用赋值，如：FLDTBLDIR=$APPDIR

·         文件中环境变量设置的格式为：VARIABLE=string

你可以为某个机器重载以下系统范围的参数：

·         UID

·         GID

·         PERM

·         MAXACCESSERS

·         MAXCONV

·         MAXGTT

 

）

通过GROUPS小节可以指定从逻辑上分组的服务器集，这些服务器组以后可被用来访问资源管理器（resource managers）,并且便于服务器组迁移。配置文件的GROUPS小节包含对服务器组的定义。你必须为有应用服务器运行其上的机器定义至少一个服务器组。

对于无事务、非分布式系统，组非常简单，只需定义组名到组号的基本映射及各组的逻辑机器即可。此外还有更多灵活选项以支持分布式的带事务的系统。

 

组名是GROUPS小节入口项的基础，它是一个字母数字混合名称，通过它来识别一个组。一个组必须有一个唯一的组号（GRPNO），并且必须位于一个逻辑机器（LMID）上，LMID也是必须的。

 

）

本部分解释用来配置服务器进程所需要定义的SERVERS小节参数。

小节中指定服务器信息

配置文件的SERVERS小节包含某个服务器进程的信息。虽然本小节并非必需，但是一个配置文件中没有本小节的应用将没有应用服务器，因此将没有实际功能。本小节的每个入口项代表一个要在应用中被启动的服务器进程，包含如下信息：

·         一个服务器名称、组别以及数字标识（SRVGRP、SRVID）

·         命令行选项（CLOPT）

·         执行服务器启动顺序和启动个数的参数（SEQUENCE、MIN、MAX）

·         一个服务器专用的环境文件（ENVFILE）

·         与服务器队列有关的信息（RQADDR、RQPERM、REPLYQ、RPPERM）

·         重启动信息（RESTART、RCMD、MAXGEN、GRACE）

·         服务器被指定为一个会话服务器（CONV）

·         重载系统范围的共享内存访问设置（SYSTEM_ACCESS）

 

【SERVERS小节参数示例及说明】

下面表格中给出了一个示例配置文件中SERVERS小节中参数的取值及说明。

	说明
（缺省值）
（缺省值）	MAXGEN参数控制服务器在GRACE参数指定的周期内可以被启动的次数，它的取值必须大于0且小于256，缺省值是1。如果服务器被设为可重新启动，则MAXGEN必须>=2。重新启动的次数最大为MAXGEN–1。如果要使MAXGEN参数生效，必须将RESTART参数设为Y，否则系统将忽略MAXGEN参数
（缺省值）	RESTART参数设置为Y，则GRACE 参数指定以秒为单位的时间周期，在此周期内这个服务器可以被启动MAXGEN–1次。GRACE的取值必须大于等于0，最大值为2,147,483,648秒（略大于68年）。如果没有显式指定，GRACE的缺省值是86,400秒（24小时）。当一个GRACE周期结束后，另一个周期开始。将GRACE周期设为0将去掉所有的限制，服务器将可以被重新启动无限次。
（缺省值）
（缺省值）	-A 选项
（缺省值）	ENVFILE读取环境设置
）缺省值）
SRVGRP=GROUP1 SRVID=1 MIN=3   RQADDR="ring1"	组GROUP1中将启动示例服务器的三个实例，其服务器标识（Server ID）分别为1、2、3。三个服务器将形成一个MSSQ集并从队列ring1中读取请求。 注意：RQADDR给本服务器的请求队列赋予了一个符号名称。MSSQ集通过让多个服务器使用同一个符号名称（通过将MIN参数值设为大于1的整数）而建立起来