tuxedo

Bea Tuxedo是在企业、Internet 这样的分布式运算环境中开发和管理三层结构的C/S型应用系统的一种中间件系统。除了正在使用中的Bea Tuxedo 8.1版本之外，随着Bea被Oracle并购，现最新Oracle Tuxedo 10gR3的for developers多平台版本以OTN license发布，也可以免费下载（下载地址 ，需要注册为OTN用户）用于开发环境的搭建，并且从目前为止的测试来看，和8.1仍然兼容良好。两者的安装配置方法基本一致，下面详细说明Tuxedo 8.1/10gR3的安装配置过程：
一、安装Tuxedo
•安装前提：
　　对于Windows平台，Tuxedo完整的服务组件只能运行于NT Server上，因此对Windows的要求就是要为2000、2003的Server系列（2008未测试）。而Client端组件可以在XP上安装。 对于UNIX、Linux、Solaris、AIX等平台都有适合各种CPU架构的相应版本。
•安装Windows版本的Tuxedo
　　Windows版的Tuxedo是使用InstallAnywhere构建的安装向导，安装过 程基本就是点"下一步"的循环。安装组件选择可选择Full Install（8.1完全安装需要90MB，10g需要180MB以上磁盘空间，其中均不包括C/C++源码的编译环境）。在选择安装路径（8.1叫 BeaHome；10g叫OracleHome）时，如果曾经没有安装过Bea或Oracle的产品，建议选择使用短文件名的位置，最好是安装在根目录下 （如x:/bea或x:/oracle）。tlisten密码用于远程管理，被问到时根据实际情况设置。被问到LDAP的设置时回答No。其中8.1安装 完后会被要求导入license文件，可选择导入网上搜索的免费SDK lic文件。
•安装Linux 64-bit版本的Tuxedo
　　Oracle官方为Linux提供的下载中只有64位版本，所以要先准备一个64位 版本的Linux系统。这里以ubuntu-8.10-amd64为例，要在32位CPU的电脑上通过VMWare一类软件安装64位的Guest OS需要CPU和主板提供VT（Virtualization Technology）支持。对于Intel的i686架构CPU，如果特性中有EM64T和Intel-VT两项，并且只要主板CMOS设置中能找到 VT相关支持的选项就可以通过开启它们让我们在32位系统中安装64位的虚拟机。Core或Xeon的很多型号已经支持VT，在CMOS中打开VT支持后 要记得冷重启（关闭电源再重开）方可生效。安装好64位的ubuntu后，将下载回来的bin包拷入系统并加上执行权限（chmod +x），直接在终端中运行bin就可以启动InstallAnywhere for Linux的安装向导了（已自带JRE for Linux 64-bit，无需先装。由于有awt界面，所以ubuntu一般要安装有X11的desktop版）。Tuxedo for Linux的安装向导的安装流程和Windows的完全一样。如果没用sudo的话，只需要将OracleHome设置到当前用户有权限访问的位置就可以 正确安装了。之后的配置也大同小异，比如要注意"/"全换"/"之类的问题。
•配置Tuxedo环境变量
　　Tuxedo服务在运行其间需要在系统中设置以下这些环境变量，可以将它们加入到系统注册表的环境变量项中 一劳永逸，也可以编写设置脚本每次需要使用时再调用脚本单独设置。Tuxedo安装好后可以在安装路径/samples/atmi/simpapp目录下 找到最简单最经典的ATMI范例，其中就有一份setenv.cmd脚本样例，可以复制到%APPDIR%参考使用。其中的说明如下：

TUXDIR=<关键的，Tuxedo安装路径> //如D:/bea/tuxedo8.1

WSNADDR=<可选的，WorkStation Server地址，只有WS远程客户端才需要设置> //如//10.108.69.31:3051

APPDIR=<用户自己开发的服务端应用程序所在路径> //如D:/appdir

PATH=<关键的，必须将Tuxedo必要的bin加入PATH搜索列表> //如%TUXDIR%/bin;%APPDIR%;%PATH%

TUXCONFIG=<UBB配置文件tuxconfig的路径> //如%APPDIR%/tuxconfig

BDMCONFIG=<可选的，Domains配置文件dmconfig的路径> //如%APPDIR%/dmconfig

LD_LIBRARY_PATH=<可选的，Tuxedo静态连接库所在路径，和VC的LIB变量不同，在Linux下为必须> //如%LD_LIBRARY_PATH%;%TUXDIR%/LIB

SHLIB_PATH=<HP-UX系统专用，用于取代LD_LIBRARY_PATH，指向$TUXDIR/lib>
　　还有一种方法是写一个Tuxedo专用的TUXEDO.ENV配置文件，并用ENVFILE/WSENVFILE变量指向它，令Tuxedo自动配置那些非关键的，常常变动的环境变量。

•配置Tuxedo编译环境
　　对于Windows平台，Tuxedo应用的C/C++编译可以借助Visual C++，因此如果需要在服务器端编译服务应用还需要事先安装Visual C++（8.1建议安装Visual Studio 6.0，10gR3支持Visual Studio .NET 2005）。VS的安装过程就不在此一一描述，下面说明在安装好VS后，需要针对Tuxedo进行哪些配置。UNIX/Linux平台下通常已有GCC编 译环境，无需另外安装，配置也只要加上Tuxedo用的PATH即可。 ◦设置控制台环境变量
　　要在控制台下编译C/C++源程序也需要设置一组环境变量，这些设置通常已经在安装VS时由安装程序创建了一份脚 本，只要在上文Tuxedo环境变量的设置脚本中加上这些脚本即可顺便完成编译环境的设置。对于VS6，脚本是%MSVCDir%/Bin /VCVARS32.BAT文件；对于VS2005，脚本的实现被移到了%VS80COMNTOOLS%vsvars32.bat。根据你安装的 Visual Studio版本，只要将脚本拷贝到%APPDIR%下，在setenv.cmd中加入call vcvar32.bat（或vsvar32.bat）即可完成调用。
◦设置UBB配置
　　关于Tuxedo开发相关的UBB配置请先参考下节有关配置说明后再来确认，此外编译还有一些环境变量可以设置，详情都可以参考官方文档（英文） 的说明。

•设置UBB配置文件tuxconfig
　　名词解释：要启动Tuxedo中间件服务需要先给服务的各种行为做配置，而配置描述文件就是变 量%TUXCONFIG%所指向的文件（通常名为tuxconfig，放在%APPDIR%目录下）。但tuxconfig是一个二进制文件，要产生这个 文件需要通过编写文本版的配置描述文件（通常名为ubbconfig，为Windows平台使用方便加上后缀.txt），然后使用Tuxedo提供的配置 加载工具将该文本文件"编译"成二进制文件作为Tuxedo的配置文件。
　　在上文提到的simpapp范例中也有一份UBB配置文件的样例叫 ubbsimple，可以将它复制到%APPDIR%下并更名为ubbconfig.txt作为参考模板。UBB文本配置是由若干小节组成的，小节的名称 由*号开头，共有9种小节：RESOURCES、MACHINES、GROUPS、NETGROUPS、NETWORK、SERVERS、 SERVICES、INTERFACES、ROUTING。除了RESOURCES小节，其它小节都是类似于INI/properties配置一样由 KEY=VALUE的格式构成。下面就参考ubbsimple来一一解释其中的主要含意。

#资源小节用于描述系统级别的参数
*RESOURCES
#6位数字，用于在Tuxedo公告板中区别于其它RESOURCE的主键
IPCKEY 123456
#服务器所在DOMAIN的ID名，用于在DOMAIN中的其它节点提供唯一性标识
DOMAINID simpapp
#TUXCONFIG配置的主标识，MP模式中的主配置
MASTER simple
#能访问Tuxedo的总的最大访问者数值，范围0至32768，应大于下面设置的所有有关访问的数值
MAXACCESSERS 50
#最大服务器（程序）数，范围0至8192
MAXSERVERS 15
#最大服务（函数）数，范围0至32768
MAXSERVICES 20
#单机模式或多机模式，取值为SHM或MP
MODEL SHM
#是否使用负载平衡
LDBAL N

#机器小节用于配置物理机器的逻辑名称
*MACHINES
#DEFAULT标识用于说明以下设置内容为所有机器共通配置
DEFAULT:
APPDIR="D:/appdir"

TUXCONFIG="D:/appdir/tuxconfig"

TUXDIR="D:/bea/tuxedo8.1"

#以上3项同环境变量的含意相同
#使用工作站服务时才需要设置，最大工作站客户端数，0至32768
MAXWSCLIENTS=10

#格式是：逻辑地址 必须参数 可选参数
#逻辑地址是本地机器的计算机名称，Windows下就是NBTSTAT -N命令中显示的名称，UNIX系统用uname -n查询。如果名称中有特殊符号需要用双引用将整个名称括起来。
"LIU-CSN"

#必须参数，设置用于在其它设置小节标识该逻辑地址的名称。小于30个字符，不能包括逗号，通常和MASTER值匹配。
LMID=simple
#必须的参数还有DEFAULT中设置的那3个路径，不过已经在DEFAULT中配置就不必再重复

#分组小节用于将本地服务分组，每个Tuxedo至少配置1个分组
*GROUPS
#配置格式：分组名称 必须参数 可选参数
#名称类命名规则都一样，1至30字符，不能以星号开头，不能包含逗号、分号等，LMID和GRPNO是必须参数，分别用于将组关联到机器和设置分组ID号
DMGROUP LMID=simple GRPNO=10
GWGROUP LMID=simple GRPNO=20
GROUP1 LMID=simple GRPNO=1
WSLGROUP1 LMID=simple GRPNO=2

#服务器小节用于提供系统中提供服务的初始条件
*SERVERS
#公共设置
DEFAULT:
CLOPT="-A"

#配置格式：服务程序名 必须参数 可选参数
#服务程序名是tmboot在启动时将要调用的实际程序文件名，通常存放于%APPDIR%或%TUXDIR%/bin下，也会PATH中搜索。
#必须参数有SRVGRP和SRVID，前者设置服务所属分组，后者为服务ID号
#REPLYQ为可选参数，设置服务是否需要建立一个应答队列
DMADM SRVGRP=DMGROUP SRVID=1 REPLYQ=N
GWADM SRVGRP=GWGROUP SRVID=1 REPLYQ=N
GWTDOMAIN SRVGRP=GWGROUP SRVID=2 REPLYQ=N
simpserv SRVGRP=GROUP1 SRVID=1
#CLOPT为可选参数，设置需要传递给服务程序的命令行参数，如果不设置默认就是"-A"

WSL SRVGRP=WSLGROUP1 SRVID=1 CLOPT="-A -- -n //10.108.69.31:3051 -w WSH -m 1 -M 10 -x 2"



#服务小节用于描述用户应用提供的服务信息
*SERVICES
#格式是：服务名称 可选参数，服务名称就是用户的服务应用中将要暴露的服务函数名。
TOUPPER
　　关于其它小节和各种可选参数的详细信息可以参考官方文档（英文） 的说明。
　　如上文解释中提到的，文本配置文件编辑好后还需要使用Tuxedo提供的工具"编译"成Tuxedo能识别的格式，方法是：


tmloadcf -y ubbconfig.txt
　　其中-y开关是可选参数，表示对是否覆盖原配置文件的提问自动回答Yes。

•服务应用的编译
　　在UBB配置中的SERVERS小节中除了配置Tuxedo提供的一些固有服务组件之外，最根本的需要就是将用户编写 的业务服务加入Tuxedo中间件。用户服务的程序源码编写好后在编译连接时需要加入必要的Tuxedo库文件，通常可以借助Tuxedo提供的编译工具 来编译产生Client和Server的可执行文件。
编译服务器通常用：

buildserver -o 输出文件名 -s 服务名称 -f 源程序文件名
//输出文件是服务程序的可执行文件名，对于Windows会自动加上.exe扩展名。

//服务名称是程序提供的服务，该名称将被用于SERVICES小节的配置。

//源程序文件可以指定多个。

编译客户端通常用：


buildclient -o 输出文件名 -f 源程序文件名 [-w]
//-w开关用于编译工作站专用的远程客户端，关于"工作站"
请参考相关说明。

　　使用Tuxedo的buildserver和buildclient如果需要专递定制参数给编译器和连接器，需要使用环境变量（如CFLAGS），详情需要参考编译器的有关说明。

•启动、停止和管理服务
　　在正确设置好环境并将UBB配置转换为tuxconfig后使用tmboot命令就可以启动Tuxedo中间件了。启动命令形如：

tmboot -y
　　其中可选开关-y开关为自动应答Yes。
　　要停止Tuxedo中间件服务只需执行：


tmshutdown -y
　　其中可选开关-y开关也为自动应答Yes。通常重新配置Tuxedo时都需要先停止服务，配置完成并重新转换后再重启服务器。不停止服务器的情况下修改配置需要用tmconfig命令，tmconfig会调用EDLIN工具动态修改指定的单项配置。有关tmconfig 和EDLIN 的用法可以参考相关文档说明。
　　在Tuxedo服务运行期间有一些管理工具可以对正在运行的服务进行维护。常用的有控制台工具tmadmin：


tmadmin
　　tmadmin是一个命令行子系统，进入后使用help命令可以查看可用命令的简单说明。使用quit命令可以退出tmadmin控制台。常用的tmadmin有：


printserver //可以缩写为psr，列出正在运行的所有服务程序

printservice //可以缩写为psc，列出当前可用的所有服务