Tuxedo实时接口系统安装手册.docVIP

系统安装手册 V1.0P-17/17（Tuxedo实时接口）系统安装手册（System Install Manual）文件编号：TD-E03T07文件版本：V1.0文档编号版本号1.0分册名称第册/共册编制审批生效日期东软软件股份有限公司电信事业部（版权所有）修改记录版本号变更控制报告编号更改条款及内容更改人审批人更改日期东软软件股份有限公司电信事业部目录1 概述41.1 目的41.2 适用范围42 安装环境42.1 软件环境42.2 硬件环境43 系统搭建44 应用程序安装44.1 服务端安装44.2 客户端安装65 参数配置75.1 服务端参数配置75.1.1 XA的配置（RM文件的修改及编译）85.1.2 ubbconfig文件的设置及编译85.1.3 创建TLOG交易日志95.2 客户端参数配置95.2.1 数据库的配置95.2.2 INI文件的配置105.2.3 ubbconfig文件的设置及编译125.3 编译服务端可执行程序125.4 启动服务端程序125.5 客户端启动指令135.6 监控配置135.6.1 注意135.6.2 Console监控135.6.3 web监控146 验证标准167 注意事项171 概述1.1 目的为了使用户掌握Tuxedo实时接口的安装过程，及参数的配置方法，方便用户使用Tuxedo实时接口模块。1.2 适用范围本文档只限于Tuxedo实时接口模块的使用。2 安装环境2.1 软件环境LINUX。2.2 硬件环境3 系统搭建参见系统安装节4 应用程序安装4.1 服务端安装第一步：服务端的应用需要Oracle的支持。Oracle8i以上版本客户端即可，需要在环境变量中设置ORACLE_HOME，以及在PATH和LD_LIBRARY_PATH加入响应的oracle部分的内容。第二步：在主机上建立一个server目录，将源代码放至该目录下。第三步：设置Tuxedo服务端程序所需要的环境变量，在文件setenv.sh中。APPDIR服务端的应用程序所在路径TUXCONFIGTuxedo服务端的应用配置文件所在路径及二进制文件名VIEWDIR32View文件所在路径VIEWFILES32View文件名FLDTBLDIR32Fml文件所在路径FIELDTBLS32Fml文件名需要修改的项目有：APPDIR；例如：假定服务端的应用放在/home/oracle/tuxedo/server下，则setenv.sh文件的内容如下：APPDIR=/home/oracle/tuxedo/serverexport APPDIRTUXCONFIG=$APPDIR/tuxconfigexport TUXCONFIGVIEWDIR32=$APPDIR/viewexport VIEWDIR32VIEWFILES32=user_verify.V,ctrl_data.V,h2_info.V,trade.Vexport VIEWFILES32FLDTBLDIR32=$APPDIR/viewexport FLDTBLDIR32FIELDTBLS32=ctrldataexport FIELDTBLS32在当前目录下执行：source ./setenv.sh即可使得环境变量生效。注意：在编译服务端应用时，需要去掉环境变量中的LANG。执行env| grep LANG，如果存在LANG的设置，执行unset LANG将其去掉，程序编译完成之后再将LANG进行设置。第四步：执行make all编译服务端的应用。4.2 客户端安装第一步：在主机上建立一个client目录，将原代码放至该目录下。第二步：设置Tuxedo客户端程序所需要的环境变量，在文件setenv.sh中。APPDIR服务端的应用程序所在路径TUXCONFIGTuxedo服务端的应用配置文件所在路径及二进制文件名WSNADDRWorkStation监听地址即Tuxedo服务所在的主机的IP和端口VIEWDIR32View文件所在路径VIEWFILES32View文件名FLDTBLDIR32Fml文件所在路径FIELDTBLS32Fml文件名需要修改的项目有：APPDIR和WSNADDR；例如：假定服务端的应用放在/home/oracle/tuxedo/client下，而Tuxedo服务端应用所在的主机IP为10，则setenv.sh文件的内容如下：APPDIR=/home/oracle/tuxedo/clientexport APPDIRTUXCONFIG=$APPDIR/tuxconfigexport TUXCONFIGWSNADDR=/10:3060export WSNADDRVIEWDIR32=$APPDIR/viewexport VIEWDIR32VIEWFILES32=user_verify.V,ctrl_data.V,h2_info.V,trade.Vexport VIEWFILES32FLDTBLDIR32=$APPDIR/viewexport FLDTBLDIR32FIELDTBLS32=ctrldataexport FIELDTBLS32在当前目录下执行：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 参数配置该章的内容参见的应用指令节5.1 服务端参数配置5.1.1 XA的配置（RM文件的修改及编译）参见的7.1节中的“设置Oracle_XA入口”和“编译TMS”5.1.2 ubbconfig文件的设置及编译进入TUXEDO服务端路径：cd /home/oracle/tuxedo/server（1）服务端ubbconfig需要修改的设置有*MACHINES节，同客户端设置本节需要增加TLOG（事务日志）的配置（稍后将详细说明如何创建TLOG） TLOGDEVICE= $TUX_ROOT /server/TLOG TLOGNAME=TLOGTLOGSIZE=1024*GROUPS节，要增加对数据库管理的操作OPENINFO 打开数据库的参数设置，可以指定数据库实例名，用户名，密码。可以将密码写成明文，也可以写成暗文。*SERVERS节 需要配置监听的地址和端口 WSL CLOPT=-A - -n /10:3060 -m 10 -M 20 -x 10（此处IP和PORT要与客户端环境变量文件setenv.sh中的WSNADDR的值一致）需要配置每个服务所对应的组SVC_FEECARDSRVID=10SRVGRP=GROUP1例：*MACHINES server210LMID=SITE1APPDIR= TUX_ROOT /serverTUXCONFIG= TUX_ROOT /server/tuxconfigTUXDIR=/bea/tuxedo8.1 TLOGDEVICE= TUX_ROOT /server/TLOG TLOGNAME=TLOGTLOGSIZE=1024*GROUPS GROUP1LMID=SITE1GRPNO=1（明文形式：用户名unitele，密码lemontea）OPENINFO=Oracle_XA:Oracle_XA+SqlNet=billdb+Acc=P/unitele/lemontea+SesTm=120+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_FEECARDSRVID=10SRVGRP=GROUP1SVC_GET_COUNTSRVID=50SRVGRP=GROUP5WSLSRVID=90SRVGRP=WSGRP CLOPT=-A - -n /10: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参见的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.2 INI文件的配置客户端需要配置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例：MAINcur_version=00.000.00.07.01.2000shm_key=1126TNSname=缴费卡测试system_id=1lsnr_num=2lsnr_port=8000out_time=10is_reuse_addr=1is_rec_follow=0is_long_link=0is_debug=1is_authip=0auth_ip=8TNSname=客服测试system_id=2lsnr_num=2lsnr_port=8001out_time=10is_reuse_addr=1is_rec_follow=0is_long_link=0is_debug=1is_authip=0auth_ip=25.3 编译服务端可执行程序在服务端路径下执行make all，生成供客户端调用的服务，例SVC_BANK，SVC_CUS_BILL，SVC_FEECARD等。如果要清除所有可执行程序，执行make clean即可。5.4 启动服务端程序在服务端可执行程序生成后，启动服务端的应用，执行：tmboot y （启动信息请见下图）停止服务端的应用执行：tmshutdown y客户端不需要启动或停止，即不需要执行任何tmboot/tmshutdown命令。5.5 客户端启动指令启动参数说明start将INI配置的所有端口进程全部启动Start port将INI配置配置的制定的端口进程启动Stop将INI配置的所有端口进程全部停止Stop port将INI配置配置的制定的端口进程停止Refresh客户端允许ini配置中关于IP鉴权的配置动态刷新Refresh指令时通知所有启动的进程获取最新的ini中IP鉴权参数Refresh port通知指定端口的进程获取最新的ini中IP鉴权参数5.6 监控配置5.6.1 注意5.6.2 Console监控相关命令tmadmin，psr，psc 执行命令tmadminpsr （显示可执行程序名称，见下图）psc （显示所有的服务名，见下图）5.6.3 web监控位置：$TUXDIRudataobjwebguiwebgui.ini文件中有NADDR参数，值为：/nodename:4003 注意：nodename应为本机的IP地址或者是uname -n的值tuxwsvr -l /10:4004 -i $TUXDIR/udataobj/tuxwsvr.ini启动webservicewlisten -i $TUXDIR/udataobj/webgui/webgui.ini 同tmadmin通讯的监听进程HTTP:/nodename:port/webguitop.html10:4004/webguitop.html注意：如果上述配置中采用nodename的方式不好用，则直接采用IP的方式第一次运行WEBGUI的界面如下所示：此时需要对监控的目标进行设置在菜单：Domain/open中，弹出对话框：在Domain Name中输入UBB文件RESOURCES节中配置的DOMAIN的数值，TUXCONFIGfile中输入要监控的应用程序编译生成的UBB文件的全路径名称以及文件名。如下所示OK之后在主界面上即可显示被监控的目标信息。Webgui下一次运行时系统会自动显示上次设置的监控目标。6 验证标准参数配置完成，可执行程序编译完成之后，在服务端执行tmboot y，如果所有的服务都能成功启动，即说明安装成功。7 注意事项1上传源程序时，要用二进制方式上传。2