银企对接企业前置机bocnet22安装手册.docx

1、银企对接企业前置机bocnet22安装手册银企对接企业前置机应用安装手册部门： 电子渠道开发部网上银行项目组文档编号: BOCNET_V02.00_IG_01版本号: V2.0目 录一、 银企对接企业前置机系统运行环境 31 硬件环境： 32 软件环境： 3二、 系统安装配置 31 操作系统的安装 32 Sun JDK 运行环境的安装及配置 43 应用服务器安装配置 43.1 设置JAVA_HOME环境变量。 43.2 安装Apache Tomcat 6.0.16 44 usb安全模块安装及系统配置 54.1 安装usb key的驱动程序 54.2 有关usk key的配置和注意事项 55 应

2、用程序发布 66 系统配置 66.1 系统配置文件configure.properties 66.2 生成网银服务器证书Base64格式文件 66.3 修改HOSTS配置文件 864请补充口令加密工具 pass.bat说明 8三、 附录 81 附录A - Sun JDK1.6.0_07安装手册 82 附录B - Apache Tomcat 6.0.16安装手册 93 附录C - configure.properties配置文件范例 94 附录D - 查看usbkey颁发者 105 附录F - hosts文件参照 11 本手册是根据中国银行网上银行银企对接前置机系统1.1编写的应用系统安装手册

3、。 由于编者水平有限，错误和疏漏在所难免，敬请读者谅解。随着银企对接系统的更新和发展，本手册的内容将不断修改和完善。一、银企对接企业前置机系统运行环境1 硬件环境： PC服务器或PC机一台 建议配置：cpu（处理器） 双核Xeon（至强）或 酷睿2双核 2.0G以上 Memory（内存） 1024M以上 USB接口 V2.0或以上，至少1个 USB-Key 一个（按照中行要求定制的带编号的key）2 软件环境： WINDOWS2000 server,Windows XP，Windows 2003server 通讯协议：TCP/IP Sun jdk1.5.0(推荐) 应用服务器：(必须) Apa

4、che Tomcat 6.0.16(推荐) 其他应用服务器3 网络环境通过IE浏览器查看网络情况 公网方式：测试地址（ 专线方式：具体地址需网络定义。二、系统安装配置本安装手册中的几个约定： 约定以 %System_path% 表示 操作系统 安装路径 约定以 %JAVA_HOME% 表示JDK安装路径 约定以 % CATALINA _HOME% 表示Apache Tomcat安装路径1 操作系统的安装 安装WINDOWS2000 server 及补丁PACK 4（或WindowsXP SP2或Windows2003 Server），尽量将所有补丁全部安装2 Sun JDK 运行环境的安装及配

5、置 详细安装过程请参照Sun JDK1.5安装文档及附录A。 3 应用服务器安装配置3.1 设置JAVA_HOME环境变量。 设置环境变量：鼠标右击我的电脑-属性-高级-环境变量-系统变量（新增）-弹出新建系统变量对话框，在变量名框中填入JAVA_HOME；在变量值框中填入JDK的安装目录3.2 安装Apache Tomcat 6.0.16 安装过程请参照Apache Tomcat6.0.16安装文档及附录B 重要提示:启动tomcat服务一定使用权限最高的用户。在安装时注意正确输入。如未设置，其安装后改动在： 控制面板服务Apache Tomcat-属性登录 ，在此账户中输入，例如.Admi

6、nistrator 及密码。 检查Tomcat是否能正常运行:启动tomcat服务，方法见用户手册。在IE浏览器地址栏中输入 http:/localhost:8080 (端口:8080 在安装过程中默认端口),若出现内容成功页面则安装成功。4 usb安全模块安装及系统配置4.1 安装usb key的驱动程序 现使用usb key 在插入电脑后可自动安装加载驱动 如因电脑设置问题（如：禁止自动运行）导致usb key 无法正常安装，可右键打开usb驱动器，双击setup.exe手动安装该key的驱动程序。4.2 有关usk key的配置和注意事项 请尽量保证usb key正确完成安装后，再发布和

7、启动应用。 Usb key在安装和使用过程中，请尽量避免人为断开，拔出和意外松动。 如果发生key断开情况，请重新正确插入key，并重启前置机应用。 Congifure.properties中有关usbkey的配置样板参照附录C。5 应用程序发布程序发布前建议先停止Tomcat系统服务 解压B2EC, 把程序安装包(B2EC)拷贝到% CATALINA _HOME% 安装目录下的webapps目录下。6 系统配置应用系统文件及系统配置文件存放路径 % CATALINA _HOME%webappsB2ECWEB-INFclasses注：以下列出的均为配置文件需修改或可修该的项目，若非说明或特别需

8、要，请勿随意改动。6.1 系统配置文件configure.properties 样板参照附录C。配置字段说明1、 limitIp 为企业内部允许接入IP （以,号隔开），安装时需要修改。2、 url 为连接网银服务器的URL (注:https 为加密通道接入)，测试和投产时需要修改。Internet测试环境url=https:/22.1.116.201/B2EP/XmlServletInternet生产环境url=https:/22.1.120.76/B2EP/XmlServleturl=https:/B2Ehttp:/26.152.253.57:9082/B2EP/XmlServlet专线地

9、址需网络配合。3、 keyStorePath key的配置文件路径（根据USBKey品牌使用（握奇）watch.cfg或（飞天）feitian.cfg ）4、 keyStorePassword key的访问密码。需要可以运行pass.bat加密，安装时需要修改。5、 trustStorePath 为网银服务器证书Base64格式文件 (注:默认文件为trustedcerts,jks，生成方法见下一节介绍) 目前已经生产好的6、 trustStorePassword为密钥库密码，生成网银服务器证书时输入。密码需要运行pass.bat加密，安装时需要修改。7、 addToken 是否需要由前置机补

10、上token（交易令牌）8、 filter 日志中需要过滤的字段，如签名信息等（以”,”隔开）。6.2 网银服务器证书的替换根据生产环境或测试环境的不同选择不同的服务器证书。trustedcerts.jks.pre（(准生产)）；trustedcerts.jks.product(生产)；替换成trustedcerts.jks文件。6.3 63口令加密工具 pass.bat说明此步骤为变更USBKEY密码时采用。如USBKEY密码设置为1111111a则不需改变1， 工具存放路径：% CATALINA _HOME%webappsB2ECWEB-INFclassespass.bat(% CATAL

11、INA _HOME% 表示tomcat安装目录，需要根据具体环境替换之)2， 鼠标点击 开始-运行 输入cmd 启动命令运行窗口，输入命令，进入工具存放目录。例如输入：cd D:B2ECWEB-INFclasses3， 运行 pass mypassword （“mypassword” 为需要加密原始口令），口令加密工具会自动执行并返回加密结果。（示例返回“mypassword”的加密结果“rQ4TBqDlfiM76QcrjCKRjrPJHoCTxrtjBU3f4CZuSKzj8uIV”）4， 示例操作如图所示： 三、附录1 附录A - Sun JDK1.5安装手册请按照以下的步骤进行, 如果执

12、行的过程中出现了错误的提示信息, 或者任何的未指定的信息.请参阅服务器附带文档 1、 目前我们选用的JDK版本为 1.5, 安装文件在/软件发布包/ J2DK1.5 目录下2、 进入 /软件发布包/ J2DK1.5 服务器 目录,双击其可执行EXE.3、 按照安装提示向导,即可完成安装. 建议安装在非系统盘下2 附录B - Apache Tomcat 6.0.16安装手册请按照以下的步骤进行, 如果执行的过程中出现了错误的提示信息, 或者任何的未指定的信息.请参阅服务器附带文档 1、 目前我们选用的是较新版本的 Apache Tomcat 6.0.16, 至本手册完成时 Apache Tomc

13、at 最新稳定版本为 6.0.16, 我们的安装文件在/软件发布包/ Apache tomcat6.0.16 服务器 目录下2、 在硬盘里面创建一个新的文件夹,作为Apache tomcat的安装目录(建议安装在非系统安装目录下) 3、 进入 /软件发布包/Apache tomcat6.0.16 服务器 目录,双击其可执行EXE.4、 按照安装提示向导,即可完成安装. 建议安装在非系统盘下。5、 设置登录服务用户时使用最高权限的用户，例如：Administrator。3 附录C - configure.properties配置文件范例#交易配置trncfg=transcfg.xml#允许接入I

14、P ,号隔开limitIp=127.0.0.1#允许交易包数据最大长度xmlMaxSize=2097152#企业接入报文检查，不需要时注释掉，一般在调试时使用xsd=datagramc.xsd#错误过滤器xmlfilter=errfilter.properties#总行对接平台连接地址#测试环境url= #生产环境#url=#连接网银对接超时时间，单位毫秒timeout=300000provider=mon.ssl.SunPKCS11SSLContextProvidersigner=mon.cert.SunCertToolprotocol=SSL#TLSv1prot=443#私钥证书库keyS

15、torePath=watch.cfgkeyStorePassword=Ye6pywADjHUN7NxYfXrsr62vaFlYHIc3soiuJmYe6yRJ+pP/#信任证书库trustStorePath=trustedcerts.jkstrustStorePassword=Ph4g213ySp7bzN9HDWA5QOo8iiuLB99NrnfjTQ=#企业前置机方式时是否需要由前置机补上token, 填true 或 falseaddToken=falsefilter=ceitinfo4 附录D - 查看usbkey颁发者1. 依次选择 我的电脑控制面板Internet属性内容证书 即可进入查看证书2、DN为颁发者，顺序必须从后至前，逗号后须有空格一个，如下为CN=INTERNET BANKING BANK OF CHINA, O=BANK OF CHINA, L=BEIJING, S=BEIJING, C=CN