Tuxedo实时接口系统安装手册.docx
- 文档编号:11424236
- 上传时间:2023-03-01
- 格式:DOCX
- 页数:17
- 大小:395.44KB
Tuxedo实时接口系统安装手册.docx
《Tuxedo实时接口系统安装手册.docx》由会员分享,可在线阅读,更多相关《Tuxedo实时接口系统安装手册.docx(17页珍藏版)》请在冰豆网上搜索。
Tuxedo实时接口系统安装手册
(Tuxedo实时接口)
系统安装手册
(SystemInstallManual)
文件编号:
TD-E03T07
文件版本:
V1.0
文档编号
版本号
1.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.1XA的配置(RM文件的修改及编译)8
5.1.2ubbconfig文件的设置及编译8
5.1.3创建TLOG交易日志9
5.2客户端参数配置9
5.2.1数据库的配置9
5.2.2INI文件的配置10
5.2.3ubbconfig文件的设置及编译12
5.3编译服务端可执行程序12
5.4启动服务端程序12
5.5客户端启动指令13
5.6监控配置13
5.6.1注意13
5.6.2Console监控13
5.6.3web监控14
6验证标准16
7注意事项17
1概述
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
服务端的应用程序所在路径
TUXCONFIG
Tuxedo服务端的应用配置文件所在路径及二进制文件名
VIEWDIR32
View文件所在路径
VIEWFILES32
View文件名
FLDTBLDIR32
Fml文件所在路径
FIELDTBLS32
Fml文件名
需要修改的项目有:
APPDIR;例如:
假定服务端的应用放在/home/oracle/tuxedo/server下,则setenv.sh文件的内容如下:
APPDIR=/home/oracle/tuxedo/server
exportAPPDIR
TUXCONFIG=$APPDIR/tuxconfig
exportTUXCONFIG
VIEWDIR32=$APPDIR/view
exportVIEWDIR32
VIEWFILES32=user_verify.V,ctrl_data.V,h2_info.V,trade.V
exportVIEWFILES32
FLDTBLDIR32=$APPDIR/view
exportFLDTBLDIR32
FIELDTBLS32=ctrldata
exportFIELDTBLS32
在当前目录下执行:
source./setenv.sh即可使得环境变量生效。
注意:
在编译服务端应用时,需要去掉环境变量中的LANG。
执行env|grepLANG,如果存在LANG的设置,执行unsetLANG将其去掉,程序编译完成之后再将LANG进行设置。
第四步:
执行makeall编译服务端的应用。
4.2客户端安装
第一步:
在主机上建立一个client目录,将原代码放至该目录下。
第二步:
设置Tuxedo客户端程序所需要的环境变量,在文件setenv.sh中。
APPDIR
服务端的应用程序所在路径
TUXCONFIG
Tuxedo服务端的应用配置文件所在路径及二进制文件名
WSNADDR
WorkStation监听地址[即Tuxedo服务所在的主机的IP]和端口
VIEWDIR32
View文件所在路径
VIEWFILES32
View文件名
FLDTBLDIR32
Fml文件所在路径
FIELDTBLS32
Fml文件名
需要修改的项目有:
APPDIR和WSNADDR;例如:
假定服务端的应用放在/home/oracle/tuxedo/client下,而Tuxedo服务端应用所在的主机IP为192.168.218.210,则setenv.sh文件的内容如下:
APPDIR=/home/oracle/tuxedo/client
exportAPPDIR
TUXCONFIG=$APPDIR/tuxconfig
exportTUXCONFIG
WSNADDR=//192.168.218.210:
3060
exportWSNADDR
VIEWDIR32=$APPDIR/view
exportVIEWDIR32
VIEWFILES32=user_verify.V,ctrl_data.V,h2_info.V,trade.V
exportVIEWFILES32
FLDTBLDIR32=$APPDIR/view
exportFLDTBLDIR32
FIELDTBLS32=ctrldata
exportFIELDTBLS32
在当前目录下执行:
source./setenv.sh即可使得环境变量生效。
注意:
在编译客户端应用时,需要去掉环境变量中的LANG。
执行env|grepLANG,如果存在LANG的设置,执行unsetLANG将其去掉,程序编译完成之后再将LANG进行设置。
第三步:
执行makeall编译客户端的应用。
第四步:
修改/etc/hosts文件
执行命令 uname–n 获取当前客户端的主机名(例:
主机名为server210)
vi /etc/hosts 将名为server210的机器所对应的IP,改为server210这台主机的实际IP。
5参数配置
该章的内容参见<
5.1服务端参数配置
5.1.1XA的配置(RM文件的修改及编译)
参见<
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节需要配置监听的地址和端口
WSLCLOPT="-A---n//192.168.218.210:
3060-m10-M20-x10"(此处IP和PORT要与客户端环境变量文件setenv.sh中的WSNADDR的值一致)
需要配置每个服务所对应的组
SVC_FEECARD SRVID=10SRVGRP=GROUP1
例:
*MACHINES
server210LMID=SITE1
APPDIR="TUX_ROOT/server"
TUXCONFIG="TUX_ROOT/server/tuxconfig"
TUXDIR="/bea/tuxedo8.1"
TLOGDEVICE="TUX_ROOT/server/TLOG"
TLOGNAME="TLOG"
TLOGSIZE=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
*SERVERS
SVC_FEECARDSRVID=10SRVGRP=GROUP1
SVC_GET_COUNTSRVID=50SRVGRP=GROUP5
WSL SRVID=90 SRVGRP=WSGRP
CLOPT="-A---n//192.168.218.210:
3060-m10-M20-x10"
其中:
SVC_GET_COUNT,SVC_GETCTRLDATA,SVC_GET_H2INFO,
SVC_USER_VERIFY,这四个服务对应的GROUP的OPENINFO所配置的数据库的实例名、用户名和密码应该与客户端建表脚本所刷的数据库的信息一致。
(2)编译ubbconfig文件:
执行tmloadcf–yubbconfig(生成tuxconfig二进制文件)
如果OPENINFO用的是明文,则直接编译;
如果OPENINFO用的是暗文,则屏幕会提示用户输入OPENINFO的密码:
PasswordforOPENINFO(SRVGRP=GROUP1):
用户输入密码后,编译再继续进行。
5.1.3创建TLOG交易日志
这步的操作也要在TUXEDO服务端目录下进行:
cd/home/oracle/tuxedo/server
参见<
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=1
lsnr_num=2
lsnr_port=8000
out_time=10
is_reuse_addr=1
is_rec_follow=0
is_long_link=0
is_debug=1
is_authip=0
auth_ip=130.91.100.88
[TNS]
name=客服测试
system_id=2
lsnr_num=2
lsnr_port=8001
out_time=10
is_reuse_addr=1
is_rec_follow=0
is_long_link=0
is_debug=1
is_authip=0
auth_ip=130.91.100.82
5.3编译服务端可执行程序
在服务端路径下执行makeall,生成供客户端调用的服务,例SVC_BANK,SVC_CUS_BILL,SVC_FEECARD等。
如果要清除所有可执行程序,执行makeclean即可。
5.4启动服务端程序
在服务端可执行程序生成后,启动服务端的应用,
执行:
tmboot–y(启动信息请见下图)
停止服务端的应用执行:
tmshutdown–y
客户端不需要启动或停止,即不需要执行任何tmboot/tmshutdown命令。
5.5客户端启动指令
启动参数
说明
start
将INI配置的所有端口进程全部启动
Startport
将INI配置配置的制定的端口进程启动
Stop
将INI配置的所有端口进程全部停止
Stopport
将INI配置配置的制定的端口进程停止
Refresh
客户端允许ini配置中关于IP鉴权的配置动态刷新
Refresh指令时通知所有启动的进程获取最新的ini中IP鉴权参数
Refreshport
通知指定端口的进程获取最新的ini中IP鉴权参数
5.6监控配置
5.6.1注意
5.6.2Console监控
相关命令tmadmin,psr,psc
执行命令tmadmin
>psr(显示可执行程序名称,见下图)
>psc(显示所有的服务名,见下图)
5.6.3web监控
位置:
$TUXDIR\udataobj\webgui\webgui.ini
文件中有NADDR参数,值为:
//nodename:
4003
注意:
nodename应为本机的IP地址或者是"uname-n"的值
tuxwsvr-l//192.168.218.210:
4004-i$TUXDIR/udataobj/tuxwsvr.ini
启动webservice
wlisten-i$TUXDIR/udataobj/webgui/webgui.ini
同tmadmin通讯的监听进程
HTTP:
//nodename:
port/webguitop.html
http:
//192.168.218.210:
4004/webguitop.html
注意:
如果上述配置中采用nodename的方式不好用,则直接采用IP的方式
第一次运行WEBGUI的界面如下所示:
此时需要对监控的目标进行设置
在菜单:
Domain/open中,弹出对话框:
在DomainName中输入UBB文件RESOURCES节中配置的DOMAIN的数值,TUXCONFIGfile中输入要监控的应用程序编译生成的UBB文件的全路径名称以及文件名。
如下所示
OK之后在主界面上即可显示被监控的目标信息。
Webgui下一次运行时系统会自动显示上次设置的监控目标。
6验证标准
参数配置完成,可执行程序编译完成之后,在服务端执行tmboot–y,如果所有的服务都能成功启动,即说明安装成功。
7注意事项
1.上传源程序时,要用二进制方式上传。
2.安装服务端时,需要有Oracle9i数据库支持。
3.在编译服务端的ubbconfig文件之前,必须修改RM文件,并编译TMS(全局交易管理服务)
4.如果Tuxedo的客户端和服务端在同一主机上,启动时,在服务端的可执行程序路径下,执行tmboot–y即可。
5.只需要在服务端执行tmboot/tmshutdown,启动/停止程序;而客户端直接调用服务端的服务就行,不需要执行tmboot进行启动。
6.在对客户端数据库进行配置时,表bi_database_control_t需要同时在两个数据库中配置(营业库和帐务库),并且表中的数据要保持一致。
7.只要服务端路径更改,就必须在新的路径下重新创建TLOG。
8附录—编译时的问题解决
1)、编译之前要根据所在主机的类型修改tools/socket_api.h中最上部的宏定义:
#defineSUNOS_HOST
以下是不同主机系统类型所对应的宏:
AIX_HOST,HPUX_HOST,LINUX_HOST,OSF_HOST,SUNOS_HOST
2)、编译时如果出现如下问题:
undefinedreferenceto`sqlca'
那么首先检查连接时是否导入了libclntsh.so库文件。
如果未导入或导入的不正确请修改后再做尝试。
如果上一步是正确的,则请检查配置文件$ORACLE_HOME/precomp/admin/pcscfg.cfg中的sys_include参数中是否包含了如下串:
/usr/include.如果是的话将该字符串去掉。
然后将如下字符串加入到那个参数中:
$ORACLE_HOME/precomp/public。
然后请重新编译。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Tuxedo 实时 接口 系统 安装 手册