金融通用交换平台v1.0.2-系统安装用户手册

金融通用交换平台v1.02适配器及调度器用户使用手册金融研发部2009年12月编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册版本修订人修订说明批准人发布日期1.0.1.0陈达辉编写2009-7-1011..00..22..00陈陈达达辉辉11．．00．．22版版本本更更新新22000099--99--9911..00..22..11陈陈达达辉辉11..00..22版版本本修修正正22000099--1122--44……说明本文文件中所包含的信息属于商业机密信息，如无恒生电子股份有限公司的书面许可，任何人都无权复制或利用。编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第1页共13页（机密）1引言1.1编写目的本文文件为使用金融交换平台用户提供对系统安装指南，本文文件预期的读者为平台用户以及平台安装及维护技术人员。1.2背景产品名称金融通用交换平台产品简称交换平台英文缩写GXP项目编号P20080003版本号v1.0任务提出者金融研发部开发者金融研发部用户金融产品部同其它系统的关系1.3法律法规和参考数据《金融通用交换平台v1.0-需求规格说明书》《金融通用交换平台v1.0-适配器及调度器概要设计说明书》2GXP系统环境要求2.1软硬件要求硬件要求：PCserver：CPU主频1Ghz、内存1GIBMp5系列小型机：CPU主频0.5Ghz、内存1GHP安腾rx系列小型机：CPU主频1Ghz、内存1G操作系统：RedhatLinuxAS/4，内核版本V2.6；AIX5.3HP-UXB.11.23编译器：Linux：gccversion3.4.3，libtool1.5.6AIX：gccversion4.2.0、xlCV8.0HP-UX:gcc(GCC)4.2.3存储建议：本模块会对所有出入平台的报文进行记录，存储根据平台每日交易量、交易报文大编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第2页共13页（机密）小、备份清理策略来规划，比如每日最大交易量50万笔，交易报文平均1k/笔，每月定时清理备份日志，交易日志空间大小约为：1k*4*500000*30*1.1≈64GLinux系统下，需要支持Posix消息队列解决办法：使用root权限修改/etc/sysctl.conf文件添加下列内容fs.mqueue.msg_max=1000fs.mqueue.msgsize_max=8192保存后执行命令sysctl–p2.2环境准备建立用户，使用该用户登录系统根据操作系统类型，（此处以Linux为例如果为AIX系统，则红色字体替换为AIX）根据安装的版本（此处以1.0.0为例）上传GXP平台依赖包GXP_DEPEND_Linux.tar.gz到$HOME目录上传GXP平台安装包GXP_RUN_Linux-1.0.2.tar.gz到$HOME目录上传GXP配置信息包GXP_RUN_CFG-1.0.2.tar.gz到$HOME目录3平台依赖库的安装3.1ACE、Openssl、sqlite、libevent的安装如果不使用SSL相关适配器或已经安装，则跳过此步在$HOME下执行命令gunzipGXP_DEPEND_Linux.tar.gztarxvfGXP_DEPEND_Linux.tar编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第3页共13页（机密）3.2管理台的安装参考《金融通用交换平台v1.0-管理台用户手册.doc》4GXP系统安装配置4.1安装步骤A、安装GXP运行包在$HOME下解开安装包，使用命令：gunzipGXP_RUN_Linux-1.0.2.tar.gztarxvfGXP_RUN_Linux-1.0.2.tar建立临时目录mkdirtmp建立日志目录mkdirlogmkdirlog/.tmpblog设置执行权限cd$HOME/binchmod+x*重新建立库文件连接buildsoB、安装配置信息包在$HOME目录下解开配置包gunzipGXP_RUN_CFG-1.0.2.tar.gztarxvfGXP_RUN_CFG-1.0.2.tar4.2配置环境在etc/setenv文件中将GXP_NODE_ID更改为实际的节点值（由GXPMaster配置界面上可以获得）修改.bash_profile(AIX为.profile),添加下列内容：.~/etc/setenv退出系统，重新登录编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第4页共13页（机密）4.3初始化A、初始化MCMI可以简单跳过此步骤，如需详细配置，可参考《GXP之内存缓存消息接口(MCMI)子系统开发手册.doc》B、初始化管理台用户信息(注意：此步骤后才能使用管理台登陆)在$HOME/cfg目录下执行命令：sqlite3MCMI.DBgxp_user.sql注意：首次运行此命令出现以下提示信息属于正常现象：AIX：[SQLerrornearline1:nosuchtable:t_roleSQLerrornearline2:nosuchtable:t_userSQLerrornearline3:nosuchtable:t_role_purvSQLerrornearline4:nosuchtable:t_user_roleSQLerrornearline5:nosuchtable:t_user_warrant]Linux:DROPTABLEt_role;SQLerror:nosuchtable:t_roleDROPTABLEt_user;SQLerror:nosuchtable:t_userDROPTABLEt_role_purv;SQLerror:nosuchtable:t_role_purvDROPTABLEt_user_role;SQLerror:nosuchtable:t_user_roleDROPTABLEt_user_warrant;SQLerror:nosuchtable:t_user_warrantC、初始化GXP运行环境启动datasvrdatasvr在windows端启动GXPMaster使用用户：admin密码：1登录系统编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第5页共13页（机密）在节点配置界面配置GXP族及节点,并记录节点ID用于设置GXP_NOD_ID环境变量节点配置完成后可以直接退出，继续后面步骤；(如需要配置业务逻辑则选择一个节点，配置文件位置选远程配置文件，按配置节点按钮进入业务逻辑配置。增加应用资源组增加应用编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第6页共13页（机密）参考：《金融通用交换平台v1.0-管理台用户手册.doc》)4.4公共资源导入使用GXPMaster管理台登录,在文件管理中选择数据导入将安装包中config目录下的三个资源包PUBLIC.gxpv1、C8583.gxpv1、编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第7页共13页（机密）UPACK_SOAP_METHOD.gxpv1覆盖导入到公共资源中。4.5插件编译环境的安装如需在编写自定义插件，则需要安装此步骤上传GXP_Plugin_Compile-1.0.2.tar.gz到$HOME目录gunzipGXP_Plugin_Compile-1.0.2.tar.gztarxvfGXP_Plugin_Compile-1.0.2.tar安装完毕后，src/plugin/ebperl下有示例以下步骤不要在64位Linux操作系统下执行在src/plugin/ebperl下执行makeall编译成功表示安装成功4.6gapsxml模块的安装(64位Linux操作系统不做此步骤)gapsxml模块目的用于在perl环境下使用GXP的内部XML树，如需使用此功能，则要安装gapsxml模块1、perl模块gapsxml的安装上传安装包pack-20091214-perl-gapsxml.tar.gz到$HOME目录执行下列命令步骤：gunzippack-20091214-perl-gapsxml.tar.gztarxvfpack-20091214-perl-gapsxml.tarcdgapsxml执行perlMakefile.PLPREFIX=$HOME将gapsxml应用安装到用户根目录继续执行:make注意，有的linux系统默认的编译器版本较低，会出现编译不过的情况，如下：gcc-c-I.-I../xml-D_REENTRANT-D_GNU_SOURCE-DDEBUGGING-fno-strict-aliasing-pipe-I/usr/local/include-D_LARGEFILE_SOURCE-D_FILE_OFFSET_BITS=64-I/usr/include/gdbm-O2-g-pipe-m32-march=i386-mtune=pentium4-DVERSION=\0.01\-DXS_VERSION=\0.01\-fPIC-I/usr/lib/perl5/5.8.5/i386-linux-thread-multi/COREgapsxml.ccc1:invalidoption`tune=pentium4'make:***[gapsxml.o]Error1需要重新安装，并在参数中提供版本较高的编译器，例如perlMakefile.PLPREFIX=$HOMECC=gcc4重新执行make进行编译。编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第8页共13页（机密）makeinstall安装完毕后：AIX系统下，在.profile中添加下列行：PERL5LIB=$PERL5LIB:$HOME/lib/site_perl;exportPERL5LIBLINUX系统下，在.bash_profile中添加PERL5LIB=$PERL5LIB:$HOME/lib/site_perl;exportPERL5LIB重新登陆系统4、在$HOME/etc/GXP_PERLEMBED.PL文件中，加入usegapsxml;4.764位Linux操作系统32位perl及gapsxml的安装上传pack-20100603-Linux64-perl32.tar.gz安装包到$HOME目录执行下列命令序列gunzippack-20100603-Linux64-perl32.tar.gztarxvfpack-20100603-Linux64-perl32.tar4.8启动系统执行命令startgxp4.9停止系统执行命令stopgxp5验证安装如果系统安装成功1.系统启动无错误提示，屏幕没有打印任何error信息，查看日志,golog进入日志目录，没有error日志。使用ps-fugxp查看进程状态是否正常，正常如下：ps-fugxptUIDPIDPPIDCSTIMETTYTIMECMD编制部门EPG批准日期2007/9/12金融通用交换平台v1.0.2-适配器及调度器用户手册受控第9页共13页（机密）gxpt1967921009:05:36-0:00gxp_lbs67gxpt225376590086009:05:35-0:00cpm_server/home/gxpt/.cpm_stream.815216gxpt233606590086009:05:35-0:00cpm_server/home/gxpt/.cpm_stream.815216gxpt262182590086009:05:35-0:00