Tuxedo实时接口系统安装手册

文件版本：V1.0目录1 概述 (4)1.1 目的 (4)1.2 适用范围 (4)2 安装环境 (4)2.1 软件环境 (4)2.2 硬件环境 (4)3 系统搭建 (4)4 应用程序安装 (4)4.1 服务端安装 (4)4.2 客户端安装 (6)5 参数配置 (7)5.1 服务端参数配置 (7)5.1.1 XA的配置（RM文件的修改及编译） (8)5.1.2 ubbconfig文件的设置及编译 (8)5.1.3 创建TLOG交易日志 (9)5.2 客户端参数配置 (10)5.2.1 数据库的配置 (10)5.2.2 INI文件的配置 (10)5.2.3 ubbconfig文件的设置及编译............................................. 错误！未定义书签。

5.3 编译服务端可执行程序 (12)5.4 启动服务端程序 (12)5.5 客户端启动指令 (12)5.6 监控配置 (13)5.6.1 注意 (13)5.6.2 Console监控 (13)5.6.3 web监控 (14)6 验证标准 (16)7 注意事项 (16)1概述1.1目的为了使用户掌握Tuxedo实时接口的安装过程，及参数的配置方法，方便用户使用Tuxedo实时接口模块。

1.2适用范围本文档只限于Tuxedo实时接口模块的使用。

2安装环境2.1软件环境LINUX。

2.2硬件环境3系统搭建参见<<Tuxedo系统管理指南.doc>>系统安装节4应用程序安装4.1服务端安装第一步：服务端的应用需要Oracle的支持。

Oracle8i以上版本客户端即可，需要在环境变量中设置ORACLE_HOME，以及在PATH和LD_LIBRARY_PATH加入响应的oracle 部分的内容。

第二步：在主机上建立一个server目录，将源代码放至该目录下。

第三步：设置Tuxedo服务端程序所需要的环境变量，在文件setenv.sh中。

需要修改的项目有：APPDIR；例如：假定服务端的应用放在/home/oracle/tuxedo/server 下，则setenv.sh文件的内容如下：在当前目录下执行：source ./setenv.sh即可使得环境变量生效。

注意：在编译服务端应用时，需要去掉环境变量中的LANG。

执行env| grep LANG，如果存在LANG的设置，执行unset LANG将其去掉，程序编译完成之后再将LANG进行设置。

第四步：执行make all编译服务端的应用。

4.2客户端安装第一步：在主机上建立一个client目录，将原代码放至该目录下。

第二步：设置Tuxedo客户端程序所需要的环境变量，在文件setenv.sh中。

需要修改的项目有：APPDIR和WSNADDR；例如：假定服务端的应用放在/home/oracle/tuxedo/client下，而Tuxedo服务端应用所在的主机IP为192.168.218.210，则setenv.sh文件的内容如下：在当前目录下执行：source ./setenv.sh即可使得环境变量生效。

注意：在编译客户端应用时，需要去掉环境变量中的LANG。

执行env| grep LANG，如果存在LANG的设置，执行unset LANG将其去掉，程序编译完成之后再将LANG进行设置。

第三步：执行make all编译客户端的应用。

第四步：修改/etc/hosts文件执行命令uname –n获取当前客户端的主机名（例：主机名为server210）vi/etc/hosts将名为server210的机器所对应的IP，改为server210这台主机的实际IP。

5参数配置该章的内容参见<< Tuxedo系统管理指南.doc >>的应用指令节5.1服务端参数配置5.1.1XA的配置（RM文件的修改及编译）参见<< Tuxedo系统管理指南.doc >>的7.1节中的“设置Oracle_XA入口”和“编译TMS”5.1.2ubbconfig文件的设置及编译进入TUXEDO服务端路径：cd /home/oracle/tuxedo/server（1）服务端ubbconfig需要修改的设置有*MACHINES节，同客户端设置本节需要增加TLOG（事务日志）的配置（稍后将详细说明如何创建TLOG）TLOGDEVICE=" $TUX_ROOT /server/TLOG"TLOGNAME="TLOG"TLOGSIZE=1024*GROUPS节，要增加对数据库管理的操作OPENINFO 打开数据库的参数设置，可以指定数据库实例名，用户名，密码。

可以将密码写成明文，也可以写成暗文。

*SERVERS节需要配置监听的地址和端口WSL CLOPT="-A -- -n //192.168.218.210:3060 -m 10 -M 20 -x 10"（此处IP和PORT要与客户端环境变量文件setenv.sh中的WSNADDR的值一致）需要配置每个服务所对应的组SVC_FEECARD SRVID=10 SRVGRP=GROUP1例：*MACHINESserver210 LMID=SITE1APPDIR=" TUX_ROOT /server"TUXCONFIG=" TUX_ROOT /server/tuxconfig"TUXDIR="/bea/tuxedo8.1"TLOGDEVICE=" TUX_ROOT /server/TLOG"TLOGNAME="TLOG"TLOGSIZE=1024*GROUPSGROUP1 LMID=SITE1 GRPNO=1（明文形式：用户名unitele，密码lemontea）OPENINFO="Oracle_XA:Oracle_XA+SqlNet=billdb+Acc=P/unitele/lemontea+SesTm=12 0+MaxCur=5+LogDir=."（暗文形式：用户名unitele，密码改为五个”*”号）OPENINFO="Oracle_XA:Oracle_XA+SqlNet=billdb+Acc=P/unitele/*****+SesTm=120+ MaxCur=5+LogDir=."（两种形式选其中一种即可）TMSNAME="TMS_Ora8i" （即4.2.3节生成的TMS_Ora8i）TMSCOUNT=2*SERVERSSVC_FEECARD SRVID=10 SRVGRP=GROUP1SVC_GET_COUNT SRVID=50 SRVGRP=GROUP5WSL SRVID=90SRVGRP=WSGRPCLOPT="-A -- -n //192.168.218.210:3060 -m 10 -M 20 -x 10"其中：SVC_GET_COUNT，SVC_GETCTRLDATA，SVC_GET_H2INFO，SVC_USER_VERIFY，这四个服务对应的GROUP的OPENINFO所配置的数据库的实例名、用户名和密码应该与客户端建表脚本所刷的数据库的信息一致。

（2）编译ubbconfig文件：执行tmloadcf –y ubbconfig（生成tuxconfig二进制文件）如果OPENINFO用的是明文，则直接编译；如果OPENINFO用的是暗文，则屏幕会提示用户输入OPENINFO的密码: Password for OPENINFO (SRVGRP=GROUP1)：用户输入密码后，编译再继续进行。

5.1.3创建TLOG交易日志这步的操作也要在TUXEDO服务端目录下进行：cd /home/oracle/tuxedo/server参见<< Tuxedo系统管理指南.doc >>的7.3节。

5.2客户端参数配置5.2.1数据库的配置在CRM和Billing库上执行bb_real_tuxedo_create.sql和bb_real_tuxedo_init.sql脚本。

在CRM库上执行bus_real_tuxedo_create.sql和bus_real_tuxedo_init.sql脚本。

[注]表bi_database_control_t表，需要同时在两个数据库（营业库、帐务库）中进行配置。

客户端需要对表bi_verify_info_t中的字段”PROG_PATH”（客户端可执行程序路径），按客户端可执行程序的实际路径进行修改。

5.2.2INI文件的配置客户端需要配置ini配置文件，程序运行时，从配置文件中读出各个变量的值。

Ini文件是按照节进行配置的[MAIN]和[TNS]节，MAIN节一个ini文件中只能有一个，而TNS节至少要有一个。

MAIN节的内容如下：cur_version 版本shm_key 共享内存key每一个TNS的内容如下：。

Name 对应的接口的名称system_id 系统ID（系统ID详见表bi_subsys_info_t中的数据）lsnr_num 子进程数目lsnr_port 端口号out_time 超时时间is_reuse_addr 监听端口重新使用标志（0 不重用等待端口释放1重用不等端口释放）is_rec_follow 是否记录返回后续包标志（0不记录1记录）is_long_link 是否长连接（0短连接1长连接）is_debug 调试开关（0关1开）is_authip 是否进行IP鉴权(0不鉴权1鉴权，默认=1)auth_ip 鉴权IP例：[MAIN]cur_version=00.000.00.07.01.2000 shm_key=1126[TNS]name=缴费卡测试system_id=1lsnr_num=2lsnr_port=8000out_time=10is_reuse_addr=1is_rec_follow=0is_long_link=0is_debug=1is_authip=0auth_ip=130.91.100.88[TNS]name=客服测试system_id=2lsnr_num=2lsnr_port=8001out_time=10is_reuse_addr=1is_rec_follow=0is_long_link=0is_debug=1is_authip=0auth_ip=130.91.100.825.3编译服务端可执行程序在服务端路径下执行make all，生成供客户端调用的服务，例SVC_BANK，SVC_CUS_BILL，SVC_FEECARD等。