MBFE安装维护手册.docx

1、MBFE安装维护手册中国现代化支付系统商业银行前台系统安装维护手册 版本号：1.00中国人民银行二二年九月1. 概述本系统维护手册是中国现代化支付系统商业银行前台（MBFE）系统管理员的维护手册。内容包括：MBFE系统初装、MBFE系统启动、MBFE系统关闭、MBFE系统较时、日常维护、常见故障维护及异常处理。编写本手册的目的是为了商业银行技术人员能够了解MBFE商行前台的结构，能够正确的安装、运行和进行基本的维护工作。2.MBFE系统初装CNAPS商业银行前台系统的安装分为服务端安装、客户端安装、数据库的创建与数据初始化几个部分，下面一一加以介绍。2.1.MBFE服务器端安装与配置2.1.1

2、.安装前须知1. 系统环境（1）. 运行环境SCO UNIXWARE 7.1.1(或AIX 4.3.3)。（2）. 建议使用root用户进行安装。（3）. 安装文件需要占用10MB的磁盘空间， 安装时还需要10MB的临时缓冲磁盘空间。 （4）中间件：CICS Client for Unixware（或CICS Client for AIX）（5） 密押卡（或密押服务器）（6） 网络环境：与CCPC、MB相连（7） 其他：GB-2312汉字支持环境（8） 为了确保CICS CLIENT的正常运行，建议将root用户的缺省sh设置为ksh。2. 数据库环境（1） 数据库：Sybase11.9.2

3、for Unixware（或Sybase12.012.5 for Unixware）（2）建立MBFE所需要的数据库裸设备3说明2.1.2.安装步骤1.提供的安装程序包括三个文件 install.txt: 安装执行文件(AIX 4.3.3环境下为installaix.txt) mbfe.tar: 安装包 mbfereadme: MBFE服务器端文件安装说明2服务端应用软件的安装（1）安装文件拷贝到一个目录下。（2）将install.txt(或installaix.txt)的属性改为可运行。（3）. 用root用户执行安装程序进行开始安装， 操作如下： #./install.txt（或./ins

4、tallaix.txt）（4） 屏幕提示输入安装目录， 这时输入想要安装的目录（绝对路径），如果不输入缺省安装在/mbfe下， 然后回车。（5） 程序将自动进行以后的安装， 直到屏幕提示安装完毕。2.1.3.配置文件说明 在安装好MBFE服务端的应用软件后，需要对MBFE的相关配置文件加以调整1、bankcom.ini文件MBFE -MBFE数据区SYSTEM = SCO -系统名称CCPCLOGNUM = 5 -系统所保存的与CCPC通讯文件日志的最大个数MBLOGNUM = 5 -系统所保存的与MB通讯文件日志的最大个数CCPCLOGDIR = /mbfe/ccpclog -保存CCPC通

5、讯文件日志的目录MBLOGDIR = /mbfe/mblog -保存MB通讯文件日志的目录EBCDIC = NDEBUG = Y -是否显示DEBUG信息DELAY = 1( DELAY = 0 - 9 second )DATABASE -DATABASE数据区SYBASE = /home/sybase -SYBASE安装路径INTERFACES = /home/sybase/interfaces - interfaces文件路径及文件名SERVER = SYBASE -数据库服务器名DBNAME = MBFEWKDB -数据库名USER = appuser -数据库登录用户PASSWD =

6、appuser -数据库登录密码SECURE = 08TIME_MINUTE = 2 -守护进程变更时间（单位为分钟）MACOLDMACINDEX = 1023 -密押卡旧密钥序号 NEWMACINDEX = 511-密押卡新密钥序号MACALGFLAG = 2-密钥算法标志SERVERTCP = 168.33.112.58 -服务器IP地址PORT = 5004-sealsrv进程的SOCKET端口号TESTBUGPRINTMSG = TRUE -是否打印信息标志在配置此文件时，主要注意 SERVER-TCP ，即服务器IP地址一项，它应为为当前MBFE服务器的工作地址。2、cacfg.in

7、i 文件eciuser = CICSUSER -CICS CLIENT登录用户ecipassword = -CICS CLIENT登录密码eciserver = CCPC -CICS SERVER名asendsvr = asendsvr -异步发文服务名sendsvr = sendsvr -同步发文服务名recvsvr = recvsvr -收文服务名logfile = /mbfe/tmp/cics_logfile.txt -与CCPC的通讯日志文件（操作用户要定时删除该文件）logallmsg = false -日志文件是否记录传送的报文mbfpath = /mbfe/tmp -临时文件路径

8、在配置此文件时，主要注意eciserver ，即CICS SERVER名一项，它应与中间件配置文件中的CICS SERVER名称一致。3、中间件的配置在/opt/K/SCO/cics/bin目录 找到CICSCLI.INI文件（或/usr/lpp/cicscli/bin下的CTG.INI文件 AIX），查看文件中的以下几行，根据具体需要做相应的修改Server = CCPC /*Arbitrary name for the server*/Description = TCP/IP Server ;/*Arbitrary description for the server*/Protocol

9、= TCPIP/*Matches with a Driver section below*/NetName = 168.33.112.69 /*The servers TCP/IP address*/Port = 1435/* Use the default TCP/IP CICS port*/InitialTransid = CESN在配置过程中，主要注意NetName一项，它指向要连接的CCPC地址。2.1.4.其他环境变量说明MBFE服务端将使用到一环境变量BANKCOM，所以需要在系统培植文件中做相应的设置，方法如下：#cd /etc #vi profile(AIX 6000环境下为e

10、nvironment) 在profile文件中加入以下两行BANKCOM=/mbfe export BANKCOM 其中/mbfe为安装程序的目录，操作员根据安装路径进行改动。2.1.5.其他注意事项1. 如果中途安装失败， 建议手工删除安装目录中的文件。 如果没有删除以前安装的文件， 那再安装到该目录时， 要保证有覆盖原文件的权限。2. 如果中途安装失败， 请根据提示的信息检查安装文件是否齐全， 安装的用户权限是否足够。3. 安装完毕后， 可以使用文件列表文件检查安装的文件是否齐全。4. 系统配置文件bankcom.ini在安装目录下；中间件配置文件cacfg.ini和可执行程序在bin子目

11、录下；子目录tmp用于存放中间件文件日志；子目录include存放API开发包；子目录ccpclog用于存放与CCPC通讯文件日志，其中机器日期加“.slog”为发送程序的文件日志，机器日期加“.rlog”为接收程序的文件日志；子目录mblog用于存放与MB通讯文件日志，其中机器日期加“.mbsend”为向MBFE发送程序的文件日志，机器日期加“.mbrecv”为从MBFE接收程序的文件日志。5. 安装目录结构：有一个文件bankcom.ini和五个子目录“bin”，“tmp”，“include”，“ccpclog”，“mblog”。在子目录bin下有如下文件：中间件配置文件：cacfg.in

12、i 发送报文程序：sendccpc 接收报文程序：recvccpc 来账业务处理程序：dealccpcmsg异常报文处理程序：dealerrmsg密押服务程序：sealsrv 守护进程：watchpro主启动进程：startmbfe 主退出进程：stopmbfe在子目录include下有如下文件：API静态库：libmbfeapi.a;API头文件：API.hpp;在编译程序时还需连接SYBASE数据库提供的库文件。2.1.6.MBFE安装程序包含的文件列表1、运行程序文件名说明recvccpc 从CCPC接收报文进程dealccpcmsg来账业务处理进程sendccpc向CCPC发送报文进程

13、watchpro守护进程dealerrmsg异常报文处理进程sealsrv密押服务进程startmbfe主启动进程stopmbfe主终止进程2、配置文件文件名说明Bankcom.ini MBFE配置文件Cacfg.iniCICS中间件配置文件3、API开发包文件名说明Libmbfeapi.aMBFE提供给MB的APIAPI.hppMBFE提供给MB的API头文件2.2.MBFE客户端安装与配置2.2.1.安装运行环境硬件: PC机: 10G硬盘,128M内存,10/100M网卡软件: Windows 2000; Sybase 11.9.2 Client。2.2.2.运行环境运行SYBASE客户

14、端的DSEIDT程序,配置连接字:连接字:MBFE IP地址:168.33.43.10(根据实际的前置机服务器IP地址作更改) PORT号:5000(根据实际的SYBASE服务PORT号作更改)2.2.3.安装步骤运行CNAPS商业银行前台安装目录中的安装文件setup.exe，将显示以下信息，按提示和默认步骤可完成安装：1、欢迎信息选“下一步”继续安装；2、安装协议选“是”继续安装；3、软件信息 选“下一步”继续安装； 4、注册信息（*序列号为“cnaps”） 输入序列号“cnaps”，选“下一步”继续安装； 5、目标路径 选“浏览”可自选目标安装路径，选“下一步”继续安装； 6、程序文件夹

15、 输入程序文件夹名称，选“下一步”继续安装； 7、拷贝文件 10、完成 选“完成”完成程序文件的安装。2.2.4.卸载过程如果需要卸载支付系统商业银行前台，在MBFE客户端平台上依次点击开始程序中国现代化支付系统卸载CNAPS商业银行前台，按提示和默认步骤可完成卸载：点击“是”进入下一步，点击“确定”完成卸载。2.2.5.环境配置说明1 MBFE客户端配置文件在安装客户端系统的目录下（具体目录由客户端软件安装步骤确定）修改配置文件mbfe.ini： Database DBMS=ODBC Database=MBFEWKDB UserId= DatabasePassword= LogPasswor

16、d=appuser ServerName=MBFE LogId=appuser Lock= DbParm=Connectstring=DSN=Mbfe Prompt=0 SoundPlay=FALSE SybInit=c:sybaseinisql.ini /*修改为sybase客户端实际安装的全路径文件名*/ Serveripaddress=168.33.56.176 /*修改为支付密押服务器的IP地址*/ Serverportno=5004 /*修改为支付密押服务器的PORT号*/Timeout=5 /*根据网络实际情况修改支付密押编超时设置,单位:秒*/此配置文件中，需要注意的是与密押服务

17、器相关的两项。分别将起修改为MBFE服务器工作地址和密押服务进程侦听端口（确省为5004）。2打印机格式配置设置屏幕分辨率800X600凭证打印格式mbfe_voucher。宽： 24.20cm左：1.50cm上：0cm高： 14.20cm右：0 cm上：0cm清单打印格式mbfe_list宽： 41.00cm左：0cm上：0cm高： 28.00cm右：0cm上：0cm2.3.MBFE数据库的创建与设置2.3.1.SYBASE客户端的登录在MBFE客户端WIN2000平台桌面上依次点击开始程序SybaseSQL Advantage进入sybase客户端，然后连接到MBFE服务器。2.3.2.M

18、BFE数据库的创建过程1检查SYBASE数据库服务是否正确安装（1）以sybase用户登录MBFE服务器（2）执行下列语句，查看数据库服务进程情况$cd install$showserver（3）如果数据库未启动，则启动数据库$startserver RUN_SYBASE（4）以sa用户通过isql方式登录数据库，并shutdown数据库$isql Usa P1shutdown2go（5）重新启动数据库$startserver RUN_SYBASE2建立应用数据库以sybase用户登录系统。以sa用户进入SQL Advantage，修改并运行安装盘mbfe/db/creat目录下的mbfe_d

19、b.sql脚本。具体步骤如下：（1）修改mbfe_db.sql文件。针对具体情况，修改如下路径，将其指向系统为MBFE建立的裸设备：/home/sybase/mbfe/tempdb/home/sybase/mbfe/wkdatadb/home/sybase/mbfe/wkindexdb/home/sybase/mbfe/wkindexdb/home/sybase/mbfe/hisdatadb/home/sybase/mbfe/hisindexdb/home/sybase/mbfe/hisdblog（2）运行mbfe_db.sql数据初始化脚本，创建应用数据库。3创建应用数据库表以sybase用

20、户登录系统。以sa用户进入SQL Advantage，运行安装盘mbfe/db/creat目录下的mbfe_tb.sql数据初始化脚本创建应用数据库表。4创建应用数据库索引以sybase用户登录系统。以sa用户进入SQL Advantage，运行安装盘mbfe/db/creat目录下的mbfe_index.sql数据初始化脚本创建应用数据库索引。5数据库初始化数据在安装的目录下运行程序mbfe_init.exe，出现如下界面：根据实际资料数据,修改界面上的数据,确认无误后用鼠标点击”导出”按钮。输入要保存初始化数据的文件名mbfe_init.sql后, 用鼠标点击”保存”按钮，此时生成初始化数

21、据脚本。运行SYBASE客户端的SQL Advantage程序, 并以sa数据库用户登录SYBASE服务。将生成的初始化数据文件mbfe_init.sql的内容,拷贝到程序区后执行脚本：6创建应用存储过程以sybase用户登录系统。以sa用户进入SQL Advantage，按顺序运行安装盘mbfe/db/creat/sp目录下如下数据初始化脚本：step1_public.sqlstep2_payment.sqlstep3_manager.sqlsp_mbfe_hvps.sqlsp_mbfe_maginfo.sqlsp_mbfe_sysinfo.sql2.4.MBFE数据初始化这里只介绍和MBF

22、E系统数据初始化相关的有关操作。详细内容请查阅中国现代化支付系统商业银行前置机系统操作手册。2.4.1.客户端登录系统初装后只有下面两个初始用户可用，sysinit用于创建用户，maginit用户用于给创建的用户授权，当建立了一个系统管理员和一个分行级的业务主管后，两个初始用户将被自动注销，新创建的用户初始口令均为六个1。系统管理员：sysinit 口令：111111业务主管：maginit 口令：1111112.4.2.新建用户以预置系统管理员身份增加一名系统管理员、二名业务主管、二名操作员，均授予相应级别的所有权限；以预置业务主管审批新增的统管理员、业务主管、操作员；详细操作方法，参见用户

23、操作手册-中国现代化支付系统商业银行前置机系统操作手册第二部分“操作流程”第九章“安全管理”第二节“用户管理”。2.4.3.导入基础数据以业务主管的用户名和口令登录客户端，从在CCPC生成的导出文件中导入行号、行别码等数据。CCPC生成的导出文件名称：*.xml详细操作方法，参见用户操作手册-中国现代化支付系统商业银行前置机系统操作手册第二部分“操作流程”第十章“系统维护”第四节“数据载入”。2.4.4.设置连接模式根据商业行运行模式将MBFE设置为主机直连模式或非主机直连模式。以系统管理员身份登录MBFE客户端，执行801：系统参数维护功能度修改连接模式。 3.系统启动系统正常启动请遵循以下

24、顺序：1 以root用户登录MBFE服务器2 确保MBFE服务器与CCPC网络连同性正常#ping ccpc_id （ccpc_id是连通的CCPC地址）如果网络不连通或丢包率过高，请联系网络管理人员做相应处理。3启动CICS CLIENT#cicscli /S=SERVERNAME注意，此处的SERVERNAME应该换成实际的CCPC名。启动以后，请用以下命令查看CICS状态#cicscli /lCCL8001I CICSCLI - CICS Client Control ProgramCCL0002I (C) Copyright IBM Corporation 1994,1996. All

25、 rights reserved.CCL8041I The CICS client is using the following servers:CCL8042I Server CCPC (using TCPIP to 168.33.112.69) is available当状态为available的时候说明CICS Client状态正常。4启动SYBASE数据库将用户切换到sybase用户，并启动数据库#su -sybase$cd install$startserver RUN_SYBASE$exit5启动MBFE服务器服务进程进入MBFE安装目录，启动MBFE服务进程#cd /mbfe/b

26、in#./startmbfestartmbfe会自动依次启动MBFE SERVER的几个应用进程，包含sendccpc、recvccpc、dealccpcmsg、sealsrv、dealerrmsg、watchpro 如果想单独启动某一个进程，请照如下方式后台启动 #./sendccpc mbfeprogram& #./recvccpc mbfeprogram& #./dealccpcmsg mbfeprogram&#./watchpro mbfeprogram&#./dealerrmsg mbfeprogram&#./sealsrv mbfeprogram&6查看MBFE SERVER 进程

27、MBFE SERVER进程是以后台进程的方式运行，因此可用系统命令ps查看几个进程的状态，ps命令格式如下： #ps ef | grep mbfeprogram在正常情况下，应该能够看到如下的几个进程root 6671 1 TS 80 0 09:45:04 ? 0:00 ./recvccpc mbfeprogramroot 6683 1 TS 80 0 09:45:10 ? 0:00 ./sealsrv mbfeprogramroot 6675 1 TS 80 0 09:45:06 ? 0:00 ./watchpro mbfeprogramroot 6667 1 TS 80 0 09:45:0

28、2 ? 0:00 ./sendccpc mbfeprogramroot 6679 1 TS 80 0 09:45:08 ? 0:00 ./dealerrmsg mbfeprogramroot 6680 1 TS 80 0 09:45:08 ? 0:00 ./dealccpcmsg mbfeprogram4.系统关闭如果需要关闭MBFE服务器，请遵循以下顺序：1关闭MBFE服务进程进入MBFE安装目录，关闭MBFE服务进程#cd /mbfe/bin#./stopmbfestopmbfe会自动依次终止MBFE SERVER的几个应用进程，包含sendccpc、recvccpc、dealccpcmsg、sealsrv、dealerrmsg、watchpro，如下：stop procid : 16953process name : ./dealerrmsgdealerrmsg程序正常关闭!stop procid : 16941process name : ./sendccpcsendccpc程序正常关闭!stop procid : 16954process name : ./dealccpcmsgdealccpcmsg程序正常关闭!stop procid : 16945process name : ./recv