Linux下Tuxedo的安装和配置

Tuxedo下载：http://www.oracle.com/technetwork/cn/middleware/tuxedo/downloads/index.html
Oracle Tuxedo 11gR1 (11.1.1.3.0)
适用于 Linux x86-64（64 位）（86,027,903 字节）

1、建用户及目录

campost:/ # groupadd tuxedo
campost:/ # useradd tuxedo -g tuxedo
campost:/ # passwd tuxedo
campost:/ # mkdir /home/tuxedo
campost:/ # chown tuxedo:tuxedo /home/tuxedo
campost:/ # mkdir /opt/tuxedo
campost:/ # chown tuxedo:tuxedo /opt/tuxedo

2、安装 campost:/home/tuxedo # ./tuxedo111130_64_Linux_01_x86.bin -i console
Preparing to install… Extracting the JRE from the installer archive… Unpacking the JRE… Extracting the installation resources from the installer archive… Configuring the installer for this system’s environment… Launching installer…

Preparing CONSOLE Mode Installation… =============================================================================== Choose Locale… ---------------- 1- English CHOOSE LOCALE BY NUMBER: 1 =============================================================================== Tuxedo 11.1.1.3.0 (created with InstallAnywhere by Macrovision) ------------------------------------------------------------------------------- =============================================================================== Introduction

InstallAnywhere will guide you through the Tuxedo 11.1.1.3.0 installation.
It is strongly recommended that you quit all programs before continuing with this installation.
Enter "next’ to proceed to the next screen. Enter “back” to modify the previousscreen.
You may cancel this installation at any time by typing “quit”.

WARNING: “Quitting” creates an incomplete Tuxedo 11.1.1.3.0 installation.You
must re-install Tuxedo 11.1.1.3.0. For more information, see “Preparing to
Install the Oracle Tuxedo System” in the Tuxedo 11.1.1.3.0 Installation Guide.

PRESS TO CONTINUE: =============================================================================== Choose Install Set

Please choose the Install Set to be installed by this installer.
->1- Full Install
2- Server Install
3- Full Client Install
4- Jolt Client Install
5- ATMI Client Install
6- CORBA Client Install
7- Customize…

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS TO ACCEPT THE DEFAULT

1

=============================================================================== Choose Oracle Home

1- Create new Oracle Home

Enter a number: 1
Specify a new Oracle Home directory: /opt/tuxedo

===============================================================================

Choose Product Directory

1- Modify Current Selection (/opt/tuxedo/tuxedo11gR1)
2- Use Current Selection (/opt/tuxedo/tuxedo11gR1)

Enter a number: 2
Install Samples (Y/N): y

=============================================================================== Pre-Installation Summary

Please Review the Following Before Continuing:
Product Name:
Tuxedo 11.1.1.3.0
Install Folder:
/opt/tuxedo/tuxedo11gR1
Link Folder:
/root
Required Space:
187 MB
Available Space:
29631 MB

PRESS TO CONTINUE:

=============================================================================== Ready To Install

InstallAnywhere is now ready to install Tuxedo 11.1.1.3.0 onto your system at the following location:
/opt/tuxedo/tuxedo11gR1

PRESS TO INSTALL: =============================================================================== Installing… ------------- [|||] [------------------|------------------|------------------|------------------] =============================================================================== Configure tlisten Service

Password:
Verify Password:
Password Accepted! Please wait…

=============================================================================== SSL Installation Choice.

Would you like to install SSL Support?

->1- Yes
2- No

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE DEFAULT:

2

============================================================================== Installation Complete

Congratulations. Tuxedo 11.1.1.3.0 has been successfully installed to:
/opt/tuxedo/tuxedo11gR1

PRESS TO EXIT THE INSTALLER:
安装说明：
（1）安装使用root和tuxedo用户都可以，实际上，不建tuxedo用户也可以，只是为了使用tuxedo用户操作才创建了tuxedo；
而oracle数据库必须需要使用oracle用户安装，PostgreSQL数据库必须使用root用户安装。
（2）安装之后，把安装目录直接拷贝到另一台机器即可直接使用tuxedo，例如上面安装的/opt/tuxedo/tuxedo11gR1；
windows下的安装软件一般情况下是不可以这样做的
3、部署例子
安装完成后，/opt/tuxedo/tuxedo11gR1/samples目录下为例子，/opt/tuxedo/tuxedo11gR1/samples/atmi为atmi例子，以下使用最简单的例子：simpapp。
为了部署该例子，可以在/opt/tuxedo/tuxedo11gR1/samples/atmi/simpapp下进行配置，配置tux.env和ubbsimple；
也可以把simpapp拷贝到tuxedo的home目录/home/tuxedo下进行配置，我使用第二种。
配置步骤如下图：

（1）配置应用的环境变量
可以在tux.env中配置（临时环境变量）：
tuxedo@campost:~/simpapp> cat tux.env

TUXDIR=/opt/tuxedo/tuxedo11gR1; export TUXDIR
JAVA_HOME=$TUXDIR/jre; export JAVA_HOME
JVMLIBS=$JAVA_HOME/lib/amd64/server:$JAVA_HOME/jre/bin
PATH=$TUXDIR/bin:$JAVA_HOME/bin:$PATH; export PATH
COBCPY=:$TUXDIR/cobinclude; export COBCPY
COBOPT="-C ANS85 -C ALIGN=8 -C NOIBMCOMP -C TRUNC=ANSI -C OSEXT=cbl"; export COBOPT
SHLIB_PATH=$TUXDIR/lib:$JVMLIBS:$SHLIB_PATH; export SHLIB_PATH
LIBPATH=$TUXDIR/lib:$JVMLIBS:$LIBPATH; export LIBPATH
LD_LIBRARY_PATH=$TUXDIR/lib:$JVMLIBS:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH
WEBJAVADIR=$TUXDIR/udataobj/webgui/java; export WEBJAVADIR
LANG=C; export LANG
APPDIR=/home/tuxedo/simpapp; export APPDIR
TUXCONFIG=/home/tuxedo/simpapp/tuxconfig; export TUXCONFIG
**（注意示例路径和自己的路径）**

里面的环境变量有些不是必须的，例如SHLIB_PATH用于HP-UX，LIBPATH用于IBM AIX，而LD_LIBRARY_PATH用于linux。
配置完之后执行：
tuxedo@campost:~/simpapp> . ./tux.env
也可以在tuxedo用户的.profile中添加以上环境变量，是它们在进入tuxedo时自动生效（本人采用第二种）
（2）配置ubbconfig，编译程序
先修改文本形式的ubbconfig：
vi ubbsimpapp
仅修改以下几个地方即可：
*RESOURCES
IPCKEY 123456
*MACHINES
DEFAULT:
APPDIR="/home/tuxedo/simpapp"
TUXCONFIG="/home/tuxedo/simpapp/tuxconfig"
TUXDIR="/opt/tuxedo/tuxedo11gR1"
campost LMID=simple

注意：RESOURCES节点的MASTER值 应该是MACHINES节点的LMID的值 ； campost用uname -n 获取

1.tuxedo需要二进制形式的ubbconfig，需要使用tmloadcf得到二进制的ubbconfig：
tuxedo@campost:~/simpapp> tmloadcf -y ubbsimple
可以使用tmunloadcf命令从二进制形式的ubbconfig得到文本形式的ubbconfig。
注意：生成的二进制文件路径和文件名 是ubbconfig配置文件里配置的TUXCONFIG设置的值。

2.编译服务端程序：
tuxedo@campost:~/simpapp> buildserver -o simpserv -f simpserv.c -s TOUPPER
服务端程序及服务名不能任意命名，因为在配置文件中有配置。

3.编译客户端程序：
tuxedo@campost:~/simpapp> buildclient -o simpcl -f simpcl.c
客户端可执行程序可任意命名。

4.启动tuxedo应用，运行程序
tuxedo@campost:~/simpapp> tmboot -y
Booting all admin and server processes in /home/tuxedo/simpapp/tuxconfig
INFO: Oracle Tuxedo, Version 11.1.1.3.0, 64-bit, Patch Level (none)
Booting admin processes …
exec BBL -A :
process id=22679 … Started.
Booting server processes …
exec simpserv -A :
process id=22680 … Started.
2 processes started.

5.发起tuxedo服务请求
tuxedo@campost:~/simpapp> ./client “Hello, world”
Returned string is: HELLO, WORLD

6.关闭tuxedo应用
tmshutdown -y

使用tmadmin进入tuxedo的监控管理

1.以下是tmadmin命令的printserver（简写为psr）的简单输出。
列号 描述

1. 服务的可执行文件名
2. 服务连接的队列名
3. 组名
4. 服务的数字id
5. 服务已经处理的请求数
6. 服务处理的全部请求的参数和
   服务正在处理的交易，若为IDLE则服务当前是空闲
   Prog Name Queue Name Grp Name ID RqDone Load Done Current Service

以下是tmadmin命令的printservice（简写为psc）的简单输出。
列号 描述

1. 交易名
2. 交易函数名
3. 服务可执行文件名
4. 服务所在组名
5. 服务的数字id
6. 提供交易的机器的LMID
7. 交易已经执行的次数
8. 交易当前状态
   Service Name Routine Name Prog Name Grp Name ID Machine # Done Status

以下是tmadmin命令的printqueue（简写为pq）[qaddress]的简单输出。如果不指定address，所有队列信息将被输出。
列号 描述

1. 队列连接的服务的可执行文件名
2. 字符队列名，是RQADDR参数或一个随机值
3. 连接的服务数
4. 当前队列的所有请求的参数和
5. 实际请求数
6. 平均队列长度
7. 队列所在机器的LMID
   1Prog Name 2Queue Name # 3Serve Wk Queued # Queued Ave. Len 7Machine

4、常见错误处理
就是两个配置文件（环境变量和ubb）一个日志（ULOG），问百度不行的话就问google大叔。
（1）执行tmadmin命令,出现如下错误
tuxedo@campost:~/simpapp> tmadmin
tmadmin - Copyright © 1996-2010 Oracle.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by Oracle.
Tuxedo is a registered trademark.
NLS:4: Cannot open message catalog TMADMIN_CAT, set 1, num 188; check TUXDIR=/opt/tuxedo/tuxedo11gR1, LANG=zh_CN.GB2312
解决办法：
设置如下环境变量：export LANG=C
（2）执行tmboot -y，出现如下错误
tuxedo@campost:~/simpapp> tmboot -y
Booting all admin and server processes in /home/tuxedo/simpapp/tuxconfig
INFO: Oracle Tuxedo, Version 11.1.1.3.0, 64-bit, Patch Level (none)
Booting admin processes …
exec BBL -A :
Failed.
tmboot: WARN: No BBL available on site simple.
Will not attempt to boot server processes on that site.
Booting server processes …
0 processes started.
解决办法：
tuxedo@campost:~/simpapp> tmadmin
tmadmin - Copyright © 1996-2010 Oracle.
Portions * Copyright 1986-1997 RSA Data Security, Inc.
All Rights Reserved.
Distributed under license by Oracle.
Tuxedo is a registered trademark.
No bulletin board exists. Entering boot mode.
crdl -b 500 -z /home/tuxedo/simpapp/TLOG
Device created: /home/tuxedo/simpapp/TLOG
也可能是配置文件错误：
我的就是： TUXDIR="/opt/tuxedo/tuxedo11gR1"写成了TUXDIR="/opt/tuxedo"

tmboot -y 启动服务时，报错：Duplicate server.
检查服务是否已经启动，tmadmin（查看），或者tmshutdown -y(停服务)
不存在上诉情况时，即服务没有启动，且报重复的服务时，尝试修改tuxedo的ubbconfig配置文件，修改IPCKEY值，然后再使用tmloadcf -y 配置文件名，重新生成二进制的ubbconfig文件，再启动服务。