tuxedo配置和服务部署.doc

TUXEDOTUXEDO应用服务配置、部署手册应用服务配置、部署手册 第 2 页 共 20 页 1. WINDOWS 环境下环境下 TUXEDO 服务端应用程序的服务端应用程序的 部署和配置部署和配置 1.1 tuxedo 的安装的安装 确定安装介质（Tuxedo 安装程序） 运行 Setup 图表 -1 Tuxedo 安装向导 第 3 页 共 20 页 图表-2 Tuxedo 安装向导 点击“Next”，继续 图表 -3 许可证协议 选择“YES”，继续 第 4 页 共 20 页 图表 -4：选择安装类型 选择“Full Installation”，继续 图表 -5 制定安装路径 路径设为“d:bea”，继续 第 5 页 共 20 页 图表 -6 产品路径 6.路径设为“d:beatuxedo”，继续 图表 -7 安装程序开始拷贝文件 等待安装程序拷贝文件。 第 6 页 共 20 页 图表 -8 输入 Listen password 输入 Listen password，输入两个相同的密码，“lp”，继续 图表 -9 安装 SSL 选择“NO”，继续 图表-10：安装 LDAP 第 7 页 共 20 页 取安装程序的默认值，继续 图表 -11：安装 License 选择“no”，继续 图表 -12：Tuxedo 安装完毕 安装完毕 第 8 页 共 20 页 注意事项注意事项 LIC 的安装 假设 TUXEDO 安装在 d:beatuxedo，在 udataobj 子目录中考入 lic.txt 1.2 应用程序的配置应用程序的配置 关于环境变量的配置，setenv.bat 文文件件格格式式如如下下： rem Copyright (c) 1995 Novell, Inc. rem All Rights Reserved rem THIS IS UNPUBLISHED PROPRIETARY SOURCE CODE OF rem Novell, Inc. rem The copyright notice above does not evidence any rem actual or intended publication of such source code. rem Copyright (c) 1995 Novell, Inc. rem All rights reserved rem ident“(#) apps/simpapp/setenv.cmd$Revision: 1.1 $“ set TUXDIR=d:beatuxedo set WSNADDR=/8:8888 set APPDIR=d:ydlw set PATH=%TUXDIR%bin;%APPDIR%;%PATH% set LIB=%LIB%;d:OracleOra9precomplibmsvc; set TUXCONFIG=%APPDIR%tuxconfig set FIELDTBLS32=qqdata,fhdata,yhfymx,comfld set FLDTBLDIR32=%APPDIR%;%TUXDIR%udataobj 第 9 页 共 20 页 call %APPDIR%VCVARS32.BAT 需要注意的地方用红色标记，其中 TUXEDO 为 tuxedo 的安装主目录， APPDIR 为应用程序主目录，根据实际情况进行修改。 关于环境变量的配置，ubbconfig 配配置置文文件件内内容容如如下下： *RESOURCES IPCKEY223357 DOMAINIDhnapp MASTERhn MAXACCESSERS1500 MAXSERVERS 800 MAXSERVICES1000 MODELSHM SECURITYAPP_PW LDBALY SCANUNIT10 BLOCKTIME30 *MACHINES WANGXJLMID=hn APPDIR=“d:ydlw“ TUXCONFIG=“d:ydlwtuxconfig“ TUXDIR=“d:beatuxedo“ MAXWSCLIENTS=600 *GROUPS 第 10 页 共 20 页 GROUP1 LMID=hnGRPNO=1 *SERVERS DEFAULT: RESTART=Y GRACE=3600 MAXGEN=100 interfaceSRVGRP=GROUP1 SRVID=1 MIN=1 MAX=20 CLOPT=“-A r“ retobankSRVGRP=GROUP1 SRVID=21 MIN=1 MAX=20 CLOPT=“-A r“ sfcxsvrSRVGRP=GROUP1 SRVID=41 MIN=1 MAX=20 CLOPT=“-A r“ sfbcsvrSRVGRP=GROUP1 SRVID=61 MIN=1 MAX=20 CLOPT=“-A r“ dypjsvrSRVGRP=GROUP1 SRVID=81 MIN=1 MAX=20 CLOPT=“-A r“ sfzfsvrSRVGRP=GROUP1 SRVID=101 MIN=1 MAX=20 CLOPT=“-A r“ zffpsvrSRVGRP=GROUP1 SRVID=121 MIN=1 MAX=20 CLOPT=“-A r“ zedzsvrSRVGRP=GROUP1 SRVID=141 MIN=1 MAX=20 CLOPT=“-A r“ mxdzsvrSRVGRP=GROUP1 SRVID=161 MIN=1 MAX=20 CLOPT=“-A r“ pkqqsvrSRVGRP=GROUP1 SRVID=181 MIN=1 MAX=20 CLOPT=“-A r“ pkxysvrSRVGRP=GROUP1 SRVID=201 MIN=1 MAX=20 CLOPT=“-A r“ 第 11 页 共 20 页 pkbcsvrSRVGRP=GROUP1 SRVID=221 MIN=1 MAX=20 CLOPT=“-A r“ delaypkxysvrSRVGRP=GROUP1 SRVID=241 MIN=1 MAX=20 CLOPT=“-A r“ delaypkbcsvrSRVGRP=GROUP1 SRVID=261 MIN=1 MAX=20 CLOPT=“-A r“ yhcxsvrSRVGRP=GROUP1 SRVID=281 MIN=1 MAX=20 CLOPT=“-A r“ wdfpcxsvrSRVGRP=GROUP1 SRVID=301 MIN=1 MAX=20 CLOPT=“-A r“ WSLSRVGRP=GROUP1 SRVID=400 CLOPT=“ -A -t - -n /07:8888 -H /8:8888 -p 41076 -P 41080 -m 5 -M 20 -x 10 “ *SERVICES 需要注意的地方用红色标记，其中 APPDIR 为应用程序主目录， TUXCONFIG 为 txuedo 的主配置文件位置，TUXDIR 为 tuxedo 安装目录。含义与 setenv.bat 中的一致。 需要修改的地方用红色标记，即*MACHINES 下的计算机名与 WSL 选项 *MACHINES 下面字符改为当前银联服务器的名字，注意要大写。 WSL 为工作站相关配置，工作站配置主要是配置-p P n H 参数，具体 解释如下： -p P 指定端口序列，-p 为最小端口值，-P 为最大端口值。如果电业局方 有防火墙，与电业局方协商，约定防火墙开放一个端口序列，例如：电业局开 方端口序列为 41076 至 41086，文件配置为-p 41076 P 41086。如果电业局 第 12 页 共 20 页 方无防火墙，省略两个参数。 -n H 为内网与外网的 IP 地址 -n 为内网的 IP 地址，即本地银联服务器的地址及 TUXEDO 的监听端口。格 式为/:port_number， 为本地银联服务器的 IP 地址， port_number 为本地银联服务器 tuxedo 监听端口，默认值为 8888。 -H 为外网的 IP 地址，如果电业局方有防火墙而且又作了地址映射的话，需 要配置-H 参数，-H 参数为被防火墙映射后的外网地址。格式与-n 后面的一致， 注意 tuxedo 的监听端口为 8888。 编编译译配配置置文文件件 编译配置文件使用 tmloadcf 命令，使用 tuxedo 命令之前，先设置环境变 量。 即在控制台模式下，先转到 d:ydlw 目录下 执执行行 s se et te en nv v 命命令令。 执行 tmloadcf ubbconfig，命令，当出现提示 Enter New Application Password:，输入 lp，回车后，再输入 lp，回车后，出现 Really overwrite TUXCONFIG file: d:ydlwtuxconfig y, q ？，输入 y，回车。配置文件编 译完成。如果编译过程中出现错误，根据错误提示，检查 ubbconfig 文件的内 容。 配配置置 y yd dl lw wc cf fg g 文文件件 文件内容如下： username=ld_data| password=ld| connname=newtest| filepath=c:bank| 第 13 页 共 20 页 remotefprestrict=0| tshrestrict=0| 每一行都以一个|结尾，文件末没有回车。各项参配置意义如下： connname数据库连接的服务名，即 oracle 的服务名 username数据库的登陆名 password数据库的登陆密码 filepath电子托收文件及批量代扣文件以及相应的返回文件的路径 remotefprestrict异地发票控制选项，如果是 0 代表不控制异地发票的 打印，即发票可以给任意一个用户使用，如果为 1 代表，某一个局的发票只能被 那个局的用户使用。 tshrestrict托收户代收控制选项，如果是 0 代表不限制托收户银 行代收，如果为 1 代表控制托收户在银行代收，即托收用户不充许在银行交费。 1.3 应用程序的编译应用程序的编译 当 C 语言的交易程序编码完后，需要连接正确的库并编译。使用 buildserver 可以使该过程容易一点。该命令引用了 C 语言编译器并按正确的 次序连接 TUXEDO 系统的库,连接 TUXEDO 生成的 main（）等。buildserver 还用 -s 参数产生合适的交易名/函数名映射表。要使用 buildserver，必须先正确设 定环境变量 TUXDIR，PATH，LD_LIBRARY_PATH。命令语法如下： b bu ui il ld ds se er rv ve er r - -v v o o e ex xe ec cu ut ta ab bl le e - -s s s se er rv vi ic ce e2 2, ,s se er rv vi ic ce e3 3: :f fu un nc c - -f f s so ou ur rc ce e/ /o ob bj je ec ct t - -l l o ob bj je ec ct t/ /l li ib br ra ar ry y f fi il le e 例： buildserver s DEPOSIT o TLR f TLR.o f appinit.o 参参数数解解释释如如下下： -o生成的可执行文件名 -f需要在连接 TUXEDO 库之前传给编译器的文件名。如有多于一个的文件名， 名字应用空格分隔并用引号引起。也可以使用多个-f 参数。 第 14 页 共 20 页 -l需要在连接 TUXEDO 库之前传给编译器的文件名。语法同上。 -v编译过程显示。 -b指定 SHM 或 MP 模式。如无此项，两种模式都包括；使用此项可以使生成 的可执行文件小一点 -r连接此处指出的 RM 库。该 RM 的名字必须含在$TUXDIR/udataobj/RM 文件 中。 1.4 启动程序启动程序 输入 tmboot y，回车。出现启动画面，如果一个服务正常启动出现如： process id=544 . Started.的提示，否则的话出现错误提示，如果出现 初始化失败等错误，检查 ydlwcfg 的数据库连接参数是否正确。 1.5 测试程序测试程序 如果启动正常完成，执行 tmadmin，在出现的交互命令界面内，敲入 printserver，回车。出现的服务列表即为当前已经启动的服务列表，如果能正 确的显示列表而且前面启动也未出现错误的话，说明当前服务已经正确的被启 动。 1.6 关闭程序关闭程序 输入 tmshutdown y，回车，关闭所有服务。 查看当前 TUXEDO 版本信息， 输入 tmadmin v，回车 第 15 页 共 20 页 2. LINUX 环境下环境下 TUXEDO 的部署和配置的部署和配置 2.1 Tuxedo 的安装的安装 安装很简单，在 linux 下注意加参数 -i console 主要就是配置环境了，在环境变量中加： TUXDIR=/home/bea/tuxedo9.1; export TUXDIR PATH=$TUXDIR/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:$SHLIB_PATH; export SHLIB_PATH LIBPATH=$TUXDIR/lib:$LIBPATH; export LIBPATH LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TUXDIR/lib:$ORACLE_HOME/lib;export LD_LIBRARY_PATH TUXCONFIG=/home/bea/tuxedo9.1/samples/atmi/simpapp/tuxconfig;export TUXCONFIG CLASSPATH=$CLASSPATH:TUXDIR/udataobj/jolt;export CLASSPATH WEBJAVADIR=$TUXDIR/udataobj/webgui/java;export WEBJAVADIR FLDTBLDIR32=$TUXDIR/samples/atmi/simpapp;export FLDTBLDIR32; FIELDTBLS32=tt.fml;export FIELDTBLS32; APPDIR=$TUXDIR/samples/atmi/simpapp;export APPDIR export NLS_LANG=American_America.ZHS16GBK（这个需要的，否则 TMS 可能启 动不起来） 2.2 常用命令常用命令 编译服务器：buildserver -f simpserv.c -o simpserv -s TOUPPER 编译客户端：buildclient -v o executable f first-file -f first- file -l last-file(没有用过，我是用 JAVA 写客户端的) 载入配置文件：tmloadcf ubbsimp 启动服务：tmboot -y 第 16 页 共 20 页 停止服务：tmshutdown -y 管理服务：tmadmin 2.3 定义配置文件定义配置文件 修改 sample 中的 simpserv 项目的，所以怎么建服务不是很清楚，就是改 服务。 主要看 ubbsimple 配置文件 *RESOURCES IPCKEY 123456 DOMAINID simpapp MASTER simple MAXACCESSERS 100()（这个以及一下几个数字都是改大了点） MAXSERVERS 50 MAXSERVICES 100 MODEL SHM（单机方式，多机方式是 MP，不会） LDBAL N *MACHINES DEFAULT: APPDIR=“/home/bea/tuxedo9.1/samples/atmi/simpapp“ TUXCONFIG=“/home/bea/tuxedo9.1/samples/atmi/simpapp/tuxconfig“ TUXDIR=“/home/bea/tuxedo9.1“ MAXWSCLIENTS=50 TLOGDEVICE=“/home/bea/TLOG“（这行以及下面三行是配置连 接 ORACLE 数据库时才加上去的） TLOGNAME=TLOG TLOGSIZE=200 devsvr LMID=simple （机器名，很重要） *GROUPS GROUP1 LMID=simple GRPNO=1 OPENINFO=“Oracle_XA:Oracle_XA+Acc=P/yn_paygo_1_1/yn_paygo_1_ 1+SqlNet=orcl_20+SesTm=600+MaxCur=5+LogDir=.“ TMSNAME=“TMS_ORA9i“ TMSCOUNT=2（这行也是连数据库时才加的， 否则原来是 OPENINFO=NONE） WSGRP LMID=simple GRPNO=4 OPENINFO=NONE 第 17 页 共 20 页 JSLGRP LMID=simple GRPNO=5 OPENINFO=NONE JREPGRP LMID=simple GRPNO=6 OPENINFO=NONE *SERVERS DEFAULT: CLOPT=“-A“ simpserv SRVGRP=GROUP1 SRVID=1 JSL SRVGRP=JSLGRP SRVID=5 CLOPT=“-A - -n /:7777 -m 5 -M 10 -x 5“ JREPSVR SRVGRP=JREPGRP SRVID=6 CLOPT=“-A - -W -P /home/bea/tuxedo9.1/samples/atmi/simpapp/jrepository“ WSL SRVGRP=WSGRP SRVID=8888 CLOPT=“-A - -n /:8888 -x 5 -m 5 -M 10“ *SERVICES DEFAULT: LOAD=50 AUTOTRAN=Y TRANTIME=30 TOUPPER PRIO=50 ROUTING=INSTR *ROUTING INSTR FIELD=INSTR BUFTYPE=“FML32“ RANGES=“*:GROUP1“（这部分是把参数改成 FML32 缓冲区时改的，否则只要 在上面 SERVICES 中写 TOUPPER，其他就不需要了） 2.4 修改服务的参数修改服务的参数 可以用 JREPSVR 增加服务，修改服务的参数等： JREPSVR is Jolt Repository Server 定义如： JREPSVR SRVGRP=JREPGRP SRVID=6 CLOPT=“-A - -W -P /usr/bea/tuxedo9.1/udataobj/jolt/repository/jrepository“ 一个主机上可以有多个 JREPSVR，但 -W 的只能有一个，这是指可写，但只有一 个 jrepository 文件可写 -P 指 jrepository 文件的路径，是必须有的。 如果要修改 appletviewer -J- Djava.security.policy=d:jdk1.5.0_06jrelibsecurityjava.policy RE.html 可以连上主机。 要先用 policytool.exe 编辑 java.policy 文件，当然也可以另外创建一个 policy 文件的，需要在 policy 文件中有 socket 的 connect 权限 第 18 页 共 20 页 2.5 连接连接 oracle XA 方式： 2.5.1ORACLE 方面改动方面改动 必须要装 oracle 客户端中的 PROC *C/C+模块，因为 tuxedo 服务程序中连 接 oracle 是用嵌入 SQL 实现的，也有其他方式的，不熟悉了。而且这个模块在 oralce 的服务端一般是没有的，不是默认安装的。 $ORACLE_HOME/rdbms/admin/xaview.sql grant select on v$xatrans$ to public with grant option; grant select on v$pending_xatrans$ to public with grant option; grant select any table to public; 2.5.2TUXDO 方面改动方面改动 修改$TUXDIR/udataobj/RM 文件 把原来的 Oracle_XA:xaosw 打头的一行注释掉，加： Oracle_XA:xaosw:-L$ORACLE_HOME/lib -lclntsh 在 TUXDIR/bin 目录下 buildtms -o TMS_ORA9i -r Oracle_XA 创建 TMS 文 件 （RM 文件包含所有的资源管理器的入口，它们被 tuxedo 应用访问。RM 文件在 $TUXDIR/udataobj 目录下。每一个入口使用冒号分隔。 第一个字段是资源管理器的唯一名字。你可以使用任何指定的名字，通常启 比较被人容易理解的名字。 第二个字段是 xa_switch_t 结构名字。Oracle 叫做 xaosw，oracle7 引用的 是静态注册。从 oracle 后使用另外一个结构 xaoswd 用来动态注册。（具体的 查看 the Oracle8i Application Developers Guide - Fundamentals 获得 更多信息) 第三个字段是使用空格分隔的建立 TM 所需要的 lib 库文件列表。这些库文件 通过访问 RM 文件建立 tuxedo server 还是需要的。 一旦资源管理器入口正 确建立到该 RM 文件中，就可以 build 事务管理 server 了。 第 19 页 共 20 页 RM 的例子如下： 如果你没有使用 cobol，oracle 的 RM 使用： Oracle_XA:xaosw:-L$ORACLE_HOME/lib -lclntsh 如果使用 cobol： Oracle_XA:xaosw:-L$ORACLE_HOME/lib $ORACLE_HOME/precomp/lib/cobsqlintf.o -lclntsh ） 2.5.3 配置配置 UBBCONFIG 在*MACHINES 节中增加 TLOGDEVICE=“/home/cuiying/temp/simpdb/TLOG“ TLOGNAME=TLOG TLOGSIZE=200 在*GR