BEA TUXEDO安装手册

BEA TUXEDO安装手册

BEA 系统有限公司

产品手册

目录

关于 (3)

使用者 (3)

手册构成 (3)

安装前的准备工作 (3)

检查你的软件包 (3)

必备的硬件和软件 (4)

管理文档和数据库 (4)

选择TUXEDO的安装目录 (4)

配置好UNIX系统 (5)

在UNIX系统上安装TUXEDO SYSTEM (5)

在WINDOWS系统上安装TUXEDO (9)

调试运行simpapp程序 (11)

准备simpapp 的文件和资源 (11)

复制simpapp 例子的相关文件 (12)

检查并编译客户程序 (13)

检查并编译服务程序 (13)

编辑并加载配置文件 (13)

编辑配置文件 (13)

加载配置文件 (14)

启动应用程序 (15)

执行tmboot 启动应用程序 (15)

如何执行运行时应用程序 (15)

如何监视运行时应用程序 (15)

如何关闭应用程序 (16)

建立TUXEDO与数据库的连接 (17)

ORACLE XA (17)

SYBASE XA (18)

INFORMIX XA (18)

关于

BEA TUXEDO SYSTEM是一个分布是联机事务处理平台应用软件。本手册具体讲述了如何安装BEA TUXEDO SYSTEM 和联机文档。

本手册基于BEA TUXEDO SYSTEM 7.1，如有不清楚之处请参考联机文档《BEA TUXEDO Installation Guide》

使用者

本手册假定阅读本手册的人员已经具备在UNIX和WINDOWS环境下的系统管理和应用程序开发基础。

手册构成

本手册分为五个部分：

●安装前的准备工作

●在UNIX上安装TUXEDO

●在WINDOWS上安装TUXEDO

●安装LICENSE

●建立TUXEDO与数据库的连接

●调试例子程序

●附录

安装前的准备工作

检查你的软件包

两张CD:

●The BEA Tuxedo System and BEA Jolt product software CD

●The BEA Tuxedo System Online Documentation CD

同时里边或者装在BEA TUXEDO产品盒的一张3.5软磁盘上有邮寄给您的产品许可证（license）。

必备的硬件和软件

BEA TUXEDO SYSTEM 必须安装到每一台使用TUXEDO SYSTEM的机器之上。

在将BEA TUXEDO SYSTEM安装在UNIX平台之前,你需要下列的信息和资源.

?使用超级用户登陆系统并MOUNT 上CDROM.

?确定系统是否有足够的空间用于安装和使用BEA TUXEDO SYSTEM ?安装CC编译器

在将BEA TUXEDO SYSTEM安装在WINDOWS系统之前,你需要下列的资源: ?一符合硬件和软件在站台数据表中描绘要求的系统.

?确定系统是否有足够的空间用于安装和使用BEA TUXEDO SYSTEM ?WINDOWS NT 或WINDOWS2000的Administrator权限

?安装C++编译器

注意：WINDOWS 95/98系统只支持TUXEDO workstation，不支持

TUXEDO core（服务器）。

管理文档和数据库

如果你把BEA TUXEDO SYSTEM安装在一UNIX站台,我们强烈建议你为BEA TUXEDO管理人员建立一个独立帐户并将BEA TUXEDO SYSTEM的所有权赋予该帐户

选择TUXEDO的安装目录

在安装BEA TUXEDO SYSTEM 时需要为TUXEDO建立一个安装目录：?该目录必须是空的.

?BEA TUXEDO 系统管理员必须具有对该目录的读、写和执行应用程序等权限。

注意:在整个BEA TUXEDO系统文档中,应该把这个目录称作：

●在UNIX平台上$TUXDIR

●在WINDOWS平台上%TUXDIR%.

配置好UNIX系统

如果您将BEA TUXEDO SYSTEM（core）安装到UNIX系统平台之上，请根据应用的需要为TUXEDO分配好IPC资源。

在UNIX系统上安装TUXEDO SYSTEM

1.使用已建立的BEA TUXEDO 系统管理员帐户登陆UNIX系统

2.将TUXEDO的安装CD插如CD-ROM中

3.如果CD-ROM没有被MOUNT请重新MOUNT。下表是在不同平台上的

安装文件所对应的CD上的目录：

4.改变当前目录到CD-ROM

To mount a CD, enter the following commands:

su

mkdir /cdrom

mount -F cdfs -o cdcase /dev/dsk/cdrom_device /cdrom

where cdrom_device is listed in the output of the ioscan -f -n command; cdrom (literal) is the mounting point.

To unmount the CD, enter the following command:

umount /cdrom

5.执行命令“sh install.sh ”您将看到一系列的提示

The following installation options are available:

1 Tuxedo Install Tuxedo

2 Jolt Install Jolt 1.2.1 for Tuxedo

6.选择1进入安装TUXEDO SYSTEM进程。如果选择2你将可以安装

JOLT。

注意：在安装JOLT之前必须安装TUXEDO SYSTEM。

7.根据提示信息选择适合的选项，并依据提示逐步执行：

下面这个例子是在SUN Solaris 上的安装过程

The following installation options are available:

1 Tuxedo Install Tuxedo

2 Jolt Install Jolt 1.2.1 for Tuxedo

Select an option (default: Tuxedo) [?, ??, 1]:1

** You have chosen to install software for Tuxedo**

______________________________________________

1) Compaq Tru64 UNIX v4.0f

2) Linux Redhat v6.1

3) NCR MP-RAS v3.0.2

4) HP-UX v11.00

5) IBM AIX v4.3.2

6) Sun Solaris 7

Install which platform's files? [01- 7, q to quit, l for list]: 6

** You have chosen to install software for **

___________________________________________________

BEA Tuxedo System Release 7.1

This directory contains the BEA Tuxedo System for Sun Solaris 7

on Sun SPARC.

Is this correct? [y,n,q]: y

___________________________________________________ To terminate the installation at any time

press the interrupt key,typically , , or .

The following packages are available:

1 tuxcore BEA Tuxedo System

Select the package(s) you wish to install (or 'all' to install

all packages) (default: all) [?,??,q]: 1

___________________________________________________ BEA Tuxedo System

(sparc) Release 7.1

Copyright (c) 2000 BEA Systems, Inc.

All Rights Reserved.

Distributed under license by BEA Systems, Inc.

Tuxedo is a registered trademark in the U.S. and other countries. The following installation options are available:

1 both Install the full Tuxedo Core System - client and server

2 client Install the client only

Select an option (default: both) [?,??,q]: 1

-------------------------------------------------------------------------------------- Directory where Tuxedo files are to be installed [?,q]: /usr/tuxedo Determining if sufficient space is available ...

66744 blocks are required

11482056 blocks are available to /usr/tuxedo

Using /usr/tuxedo as the Tuxedo base directory

Directory where BEA Administration Console documents and images are to be

installed (default: /usr/tuxedo/udataobj/webgui) [?,q]:

Creating /usr/tuxedo/udataobj/webgui

Using /usr/tuxedo/udataobj/webgui as the BEA Administration Console

document tree

Directory where BEA Administration Console java applets are to be

installed (default: /usr/tuxedo/udataobj/webgui/java) [?,q]: Creating /usr/tuxedo/udataobj/webgui/java

Using /usr/tuxedo/udataobj/webgui/java as the BEA Administration Console

document tree

Directory where BEA Administration Console CGI programs are to be

installed (default: /usr/tuxedo/udataobj/webgui/cgi-bin) [?,q]: Creating /usr/tuxedo/udataobj/webgui/cgi-bin

Using /usr/tuxedo/udataobj/webgui/cgi-bin as the BEA Administration

Console CGI directory

Web server client prefix for CGI directory. /cgi-bin is a good choice for most web servers. (default: /cgi-bin) [?,q]:

Using /cgi-bin as the BEA Administration Console CGI prefix Unloading /Tuxedo/spsol7/tuxcore/WS.Z ...

bin/CBLDCLNT

bin/CBLVIEWC

bin/CBLVIEWC32

bin/uninstall.sh

lib/registry.so

lib/registry.so.71 linked to lib/registry.so

lib/registry.so.71

samples/atmi/secsapp/README

samples/atmi/secsapp/README.as400

samples/atmi/secsapp/cert/TOUPPER.pvk

samples/atmi/secsapp/cert/TOUPPER.x59

.

. (Files being installed are listed here)

.

39790 blocks

... finished

Changing file permissions...

... finished

Moving BEA Administration Console files to their proper location...

... finished

Processing default license file...

... finished

___________________________________________________

Install tlisten password? [y/n]: y

Please enter the tlisten password:

Please verify the password:

tlistpwd: INFO: Password appended to file

"/usr/tuxedo/udataobj/tlis

ten.pw".

Please don't forget to manually copy the contents of the license file

from the enclosed floppy to '/usr/tuxedo/udataobj/lic.txt'.

Installation of BEA Tuxedo System was successful

Please consult the Installation Guide and Release Notes for

further

information concerning the installation of this software.

8.以上操作结束后，您需要安装license文件。请将license文件(lic.txt)拷

贝到tuxedo安装目录下的$TUXDIR/udataobj/ 目录中覆盖愿有文件。

如果该license文件有效，系统将自动激活。

9.如果您需要安装JOLT请重复第4步。

在WINDOWS系统上安装TUXEDO

1、使用具有安装权限的帐户登陆WINDOWS系统。（如果是WINDOWS

NT 或WINDOWS200系统，请使用具有Administrator权限的帐户登

陆系统）。

2、进入CD 的setup_windows目录，并运行setup.exe。

3、根据提示选择安装TUXEDO或JOLT。

4、根据需要选择安装TUXEDO SERVER和CLINET

5、选择TUXEDO的安装路径。

6、以上操作结束后，您需要安装license文件。您可以根据提示安装，

也可以请将license文件(lic.txt)拷贝到tuxedo安装目录下

的%TUXDIR%\udataobj\ 目录中覆盖愿有文件。如果该license

文件有效，系统将自动激活。

7、如果您需要安装JOLT请重复以上步骤。

调试运行simpapp程序

本章介绍了BEA Tuxedo 的一个简单例子，用C 语言编写的simpapp敭摡獨它包含了一个客户程序和一个服务器，服务器只执行一个服务：从客户程序接收小写字母，将其转换成大写后，返回给客户程序。在使用这个例子之前，需要在系统中安装C 语言编译器。

准备simpapp 的文件和资源

在准备simpapp 例子之前，系统中必须安装了BEA Tuxedo 软件，而且要设置$TUXDIR 环境变量，NT 平台下为%TUXDIR%，并把%TUXDIR%\bin 加到PATH 中，最后还要确保你的工作目录要有写权限。完成这些工作后，请按如下步骤来准备simpapp 程序：

●复制simpapp 所需要的所有文件，它们位于

$TUXDIR/samples/atmi/simpapp 目录下；

●检查并编译客户程序；

●检查并编译服务程序；

●编辑并加载配置文件；

●启动应用程序；

●执行运行时应用程序；

●监视运行时应用程序；

●关闭应用程序。

完成这个例子后，你应该理解客户程序和服务器所执行的任务，根据你的环境编写一个配置文件，通过tmadmin 检查应用程序的活动。同时，你应该理解BEA Tuxedo 应用程序的基本组成部分：客户程序、服务器程序、配置文件，通过BEA Tuxedo 系统的哪些命令来管理你的应用程序。

复制simpapp 例子的相关文件

1、创建目录：

●mkdir simpdir

●cd simpdir

2、设置并导出环境变量

●TUXDIR= BEA Tuxedo 系统的根目录，如UNIX 系统下可以设

置为：TUXDIR="/usr/tuxedo"，NT 系统下可以设置为：

TUXDIR="G:\Program Files\BEA System\Tuxedo"

●TUXCONFIG=当前工作目录加上/tuxconfig，如UNIX 系统下可以

设置为：TUXCONFIG="/usr/me/simpdir/tuxconfig"，NT 系统下可以设

置为：TUXCONFIG="G:\simpdir\tuxconfig"

●PATH= $PATH:$TUXDIR/bin

●LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TUXDIR/lib

●export TUXDIR TUXCONFIG PATH LD_LIBRARY_PATH

注意：TUXDIR和PATH 用于访问BEA Tuxedo 系统的文件和执行命令，在Sun Solaris系统中，必须把/usr/bin 放在PATH 中的第一个，在

RS6000 中的AIX 上，将LD_LIBRARY_PATH 替换成LIBPATH ，

在HP9000 中的HP-UX 上，将LD_LIBRARY_PATH 替换为

SHLIB_PATH

设置TUXCONFIG 的目的是用于加载配置文件。

3、复制simpapp 文件，cp $TUXDIR/samples/atmi/simpapp/* .

4、查看文件

$ls

README env simpapp.nt ubbmp wsimpcl

README.as400 setenv.cmd simpcl.c ubbsimple

README.nt simpapp.mk simpserv.c ubbws

文件说明：

simpcl.c 客户程序的源代码

simpserv.c 服务程序的源代码

ubbsimple 应用程序配置文件的纯文本形式

检查并编译客户程序

使用命令$buildclient -o simpcl -f simpcl.c

-o指明输出目标文件名，-f 指出源文件名

检查并编译服务程序

使用命令$buildserver –o simpserv –f simpserv.c –s TOUPPER –s TOUPPER 指明了在服务器启动时需要提供的服务

编辑并加载配置文件

编辑配置文件

#ident "@(#) apps/simpapp/ubbsimple $Revision: 1.1.10.1 $"

#Skeleton UBBCONFIG file for the TUXEDO Simple Application.

# 将<>里而的内容替换成实际值.

*RESOURCES

IPCKEY

#Example:

#IPCKEY 123456

DOMAINID simpapp

MASTER simple

MAXACCESSERS 10

MAXSERVERS 5

MAXSERVICES 10

MODEL SHM

*MACHINES

DEFAULT:

APPDIR=""

TUXCONFIG=""

TUXDIR=""

#Example:

# APPDIR="/home/me/simpapp"

# TUXCONFIG="/home/me/simpapp/tuxconfig"

# TUXDIR="/usr/tuxedo"

# 对于NT 平台，可以替换成如下值

# APPDIR="G:\JQEJB\simpapp"

# TUXCONFIG="G:\JQEJB\simpapp\tuxconfig"

# TUXDIR="G:\Program Files\BEA System\Tuxedo"

LMID=simple

#Example:

#JQ LMID=simple

*GROUPS

GROUP1

LMID=simple GRPNO=1 OPENINFO=NONE

*SERVERS

DEFAULT:

CLOPT="-A"

simpserv SRVGRP=GROUP1 SRVID=1

*SERVICES

TOUPPER

加载配置文件

$ tmloadcf ubbsimple

Initialize TUXCONFIG file: /usr/me/simpdir/tuxconfig [y, q] ? y $

启动应用程序

执行tmboot 启动应用程序

$tmboot

Boot all admin and server processes? (y/n): y

Booting all admin and server processes in

/usr/me/simpdir/tuxconfig

Booting all admin processes ....

exec BBL -A:

process id=24223 ... Started.

Booting server processes ...

exec simpserv -A :

process id=24257 ... Started.

2 processes started.

BBL 是应用程序中监视共享内存结构的管理进程，simpserv 是连续运行的simpapp 服务程序，它等待着处理请求。

如何执行运行时应用程序

$ simpcl “hello, world”

Returned string is: HELLO, WORLD

如何监视运行时应用程序

作为管理者，你可以使用tmadmin 命令解释器来检测一个应用程序，并作一些动态的改变，要运行该命令，你必须设置TUXCONFIG 环境变量。tmadmin 可以解释超过50 个命令，要看完整的列表，请看tmadmin(1)，这里我们使用了两个tadmin 命令。

1、输入如一命令：

$tmadmin

显示：

tmadmin - Copyright (c) 1999 BEA Systems, Inc. All rights

reserved.

>

2、输入printserver(psr)命令，显示：

> psr

a.out Name Queue Name Grp Name ID RqDone Load Done Current Service

-------------- --------------- ------------- -- --------- -------------- ------------------

BBL 531993 simple 0 0 0 ( IDLE )simpserv 00001.00001 GROUP1 1 0 0 ( IDLE )

3、输入printservice(psc)命令，显示：

Service Name Routine Name a.out Name Grp Name ID Machine # Done Status

------------ --- ------------------ ------------- ------------ --- ---------- --------- ---------

TOUPPER TOUPPER simpserv GROUP1 1 simple - AV AIL

>

如何关闭应用程序

1、运行tmshutdown 命令来关闭应用程序

$ tmshutdown

Shutdown all admin and server processes? (y/n): y

Shutting down all admin and server processes in

/usr/me/simpdir/tuxconfig

Shutting down server processes ...

Server Id = 1 Group Id = GROUP1 Machine = simple: shutdown

succeeded.

Shutting down admin processes ...

Server Id = 0 Group Id = simple Machine = simple: shutdown

succeeded.

2 processes stopped.

$

2、检查ULOG 文件

$ cat ULOG*

$

113837.tuxmach!tmloadcf.10261: CMDTUX_CAT:879: A new file system

has been created. (size = 32 4096-byte blocks)

113842.tuxmach!tmloadcf.10261: CMDTUX_CAT:871: TUXCONFIG file/usr/me/simpdir/tuxconfig has been created

113908.tuxmach!BBL.10768: LIBTUX_CA T:262: std main starting

113913.tuxmach!simpserv.10925: LIBTUX_CA T:262: std main starting

113913.tuxmach!simpserv.10925: Welcome to the simple server

114009.tuxmach!simpserv.10925: LIBTUX_CA T:522: Default tpsvrdone() function used.

114012.tuxmach!BBL.10768: CMDTUX_CA T:26: Exiting system

建立TUXEDO与数据库的连接

ORACLE XA

1、在附件中提供了rm 文件,外建议运行oracle 的demo 文件获得要连接的

所有lib 库的名称.后将这些名称全部写在RM 文件中.

如：Oracle 8i for NT

Oracle_XA;xaosw;%ORACLE_HOME%RDBMSXAORAXA8.LIB

%ORACLE_HOME%PRECOMPLIBMSVCORASQL8.LIB

%ORACLE_HOME%PRECOMPLIBMSVCORASQX8.LIB

%ORACLE_HOME%OCILIBMSVCOCI.LIB

%ORACLE_HOME%OCILIBMSVCOCIW32.LIB

2、ubb 文件中*GROUP 节加上

TMSNAME=TMS_ORA

TMSCOUNT=3

OPENINFO="Oracle_XA:Oracle_XA+Acc=P/scott/tiger+SesTM=120+LogDir=.+Sq lNet=abcde"

具体在Oracle 联机文档Application Development->oracle8 ApplicationDevelopment's Guild->Oracle XA->Defining the xa_open String 中提供了解释

3、oracle 一侧需运行xaview.sql,且scott 用户有操作权限,行结果会记录trc

文件里.(oracle8.0.5 这一步不是必须的)

4、行buildtms -o $(TUXDIR)/bin/TMS_ORA -r Oracle_XA

5、在tpsvrinit()EXEC SQL CONNECT ...成tpopen(),

tpsrvdone()EXECSQL DISCONNECT... 改成tpclose(); 实际可拷贝$TUXDIR/apps/bankapp/appinit.c

6、在ubb 文件中MACHINE 节指定TLOGDEVICE,TLOGSIZE

例:TLOGDEVICE="/home/usr1/TLOGDEV"TLOGSIZE=100

7、立TLOG 文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.定相关的环境

变量后运行该shell 文件.

8、启动事务用tpbegin(3,0),交回滚用tpcommit/tpabort.

SYBASE XA

1.RM 文件,行sybase 获得要连接的所有lib 库的名称.后将这些名称全部

写在RM 文件中:Sybase_XA:???????.

2.ubbconfig 文件中*GROUP 节TMS_NAME=TMS_SYB

TMSCOUNT=3 OPENINFO="?????" 具体察看Sybase 文当中

xa_open String 中提供了解释

3.行buildtms -o $(TUXDIR)/bin/TMS_SYB -r Sybase_XA

4.在tpsvrinit()EXEC SQL CONNECT ...成tpopen, tpsrvdone()EXEC

SQL DISCONNECT...成tpclose(); 实际可查看

$TUXDIR/apps/bankapp/appinit.c

5.在ubb 文件中MACHINE 节指定TLOGDEVICE,TLOGSIZE

例:TLOGDEVICE="/home/usr1/TLOGDEV"

6.TLOGSIZE=100

7.立TLOG 文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.定相关的环

境变量后运行该shell 文件.

8.动事务用tpbegin(3,0),交回滚用tpcommit/tpabort.

INFORMIX XA

1、行esql -lib 获得要连接的所有lib 库的名称.后将这些名称全部加到

RM 文件中

INFORMIX-OnLine:infx_xa_switch:${INFORMIXDIR}/lib/esql/libinfxxa.a

/usr/informix/lib/esql/libixos.a /usr/informix/lib/esql/libixgen.a

/usr/informix/lib/esql/libixsql.a /usr/informix/lib/libixasf.a

/usr/informix/lib/esql/libixos.a /usr/informix/lib/esql/libixgen.a

/usr/informix/lib/esql/libixgls.a -lnsl_s -lm -lV3 -lcl -lsec

/usr/informix/lib/esql/libixglx.a

2、ubbconfig 文件中

*GROUP 节TMS_NAME=TMS_INFO TMSCOUNT=3

OPENINFO="INFORMIX-OnLine:test_tux"

具体察看Sybase 文当中xa_open String 中提供了解释

3、运行buildtms -o $(TUXDIR)/bin/TMS_INFO -r INFORMIX-OnLine

4、在tpsvrinit()EXEC SQL CONNECT ...改成tpopen, tpsrvdone()EXEC SQL

DISCONNECT...改成tpclose();实际可查看$TUXDIR/apps/bankapp/appinit.c

5、在ubb 文件中MACHINE 节指定TLOGDEVICE,TLOGSIZE

例:TLOGDEVICE="/home/usr1/TLOGDEV"

TLOGSIZE=100

6、建立TLOG 文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.定相关的环

境变量后运行该shell 文件.

7、启动事务用tpbegin(3,0),交回滚用tpcommit/tpabort.