金蝶EASV7.5教学版BOS银企平台升级指南金蝶软件（中国）有限公司2013年3月目录1环境配置.31.1金蝶BOS银企平台可支持性环境说明..31.2系统配置要求..32升级准备.32.1环境准备..43升级步骤.43.1数据备份..43.2软件安装..53.2.2安装前准备..53.2.3银企平台安装文件.53.2.4银企平台启动..53.2.5银企平台系统初始化.63.2.6银行前置机部署.103.2.7业务向导..113.3功能菜单说明..153.3.2系统管理..153.3.3业务管理..203.3.4用户管理..223.3.5左侧业务菜单..224业务功能升级影响.244.1银企互联设置..254.2账户管理..254.3其他事项说明..255银企版本支持银行列表对比..256帮助与支持.271/28金蝶EASV7.5教学版BOS银企平台升级指南2/28前言本文档提供计划以及正式升级到EASV7.5版的相关信息，包括：升级准备、升级步骤、新增或改进功能对用户的影响。适用于原使用金蝶EASV5.3版本、EASV5.4版本、EASV5.9版本、EAS6.0版本和EAS7.0.3，准备升级到EASV7.5的用户。不适用于K3任何版本产品用户。金蝶EASV7.5教学版BOS银企平台升级指南3/281环境配置1.1金蝶BOS银企平台可支持性环境说明金蝶BOS银企平台是基于JAVA开发的独立系统，独立部署，可部署在windows、linux和unix等操作系统。1.2系统配置要求2升级准备1.了解新产品升级前，请仔细阅读《金蝶EASV7.5发版说明》中的发版说明，了解您当前版本已应用的补丁的功能是否包括在金蝶EASV7.5版本中。如果有补丁功能未能包括在新版本的功能中，请及时联系您的代理商或金蝶公司的技术支持部门以获取新的补丁。2.制定升级计划在详细了解新产品的功能、性能、可用性等方面内容后，如果确认需要升级到新版本上，则需要制定周详的测试计划，包括确定升级方案，制定升级项目计划，明确人员、时间、费硬件平台PC机最低要求：双核2G以上，2G内存，100M带宽操作系统UnixAIXHPUXSolarisLinuxRedHatEnterpriseLinuxAdvancedServerSuseLinuxEnterpriseWindowsXP2000server2003server2008中间件jetty6.1.23平台自带数据库Oracle10g企业版,10.2.0.４以上11g企业版,11.２.0.１以上DB29.5企业版，Fixpack4以上MSSQLServer2000企业版，sp4以上2005企业版，sp1以上2008企业版MySql5.0不推荐金蝶EASV7.5教学版BOS银企平台升级指南4/28用预算、以及对现有系统运行平台进行评估。银企平台升级与其它业务系统升级不同，升级本版本银企平台，EAS需要预先升级到7.5.0版本，如果EAS版本不对或者未升级，则无法使用银企平台7.5.0版本。需要在正式升级前做好与银行测试联调工作，确保查询、付款等常用接口正常应用。3.升级准备升级系统的软、硬件准备，包括硬件系统的升级或更新，新版本软件的预定，开发、测试环境与生产环境的同步以及明确升级项目组人员、职责分工，工作场地安排等。并针对操作人员进行新产品的相关培训。2.1环境准备 检查操作系统、磁盘空间、内存、网络、数据库版本等是否满足金蝶EASV7.5版的环境要求，针对Unix系统，还需要关注执行安装程序的用户权限，避免这些因素导致金蝶BOS银企平台安装配置发生问题。 请检查您目前所做的二次开发功能，及时与开发人员联系并确认所做的二次开发是否会因升级而受到影响。特别需要关注数据库中的触发器。如果您同时将数据库升级到SQL2005，需要注意检查二次开发的内容是否存在不符合SQL2005语法的情况，如果不能确定可以将数据库设置为兼容80的模式。如果使用的是SQL2005必须安装最新的SP2补丁，并且下载微软支持和帮助中KB934459对应的补丁，否则维护计划将可能有问题。关于二次开发功能的元数据升级，请参见《ＥASV7.0二次开发升级帮助》的详细说明。3升级步骤3.1数据备份从老版本升级到BOS63sp3银企平台，不需要对老版银企进行备份，但是在升级前，请务必记录银行前置机配置信息，方便在新版本中进行设置。从银企平台7.0.3升级到银企7.5.0的客户，由于银企这两个版本的数据库数据是通用的，升级前需要备份银企7.0.3版的数据库数据。金蝶EASV7.5教学版BOS银企平台升级指南5/283.2软件安装3.2.2安装前准备为了防止升级过程发生意外情况，避免客户因升级而发生大面积无法使用银企的现象，在正式升级前必须做好平台与银行的联调测试工作，测试验证通过后方可上线。由于此版银企平台与之前版本产品在架构上发生重大变化，正式升级需要进行严格测试。3.2.3银企平台安装文件BOS银企平台支持windows、linux、unix操作系统。目前银企平台安装文件以压缩包方式提供，请联系总部银企平台获取。3.2.4银企平台启动1、点击对应系统平台下的脚本启动银企服务。AIX系统：aix_debug_in_console.sh（debug模式启动服务器）aix_ebg_db_init.sh（手动运行数据库初始化脚本，前提是server.properties已经配置好）aix_shutdown.sh（关闭银企平台）aix_startup_in_console.sh（启动服务器）aix_startup.sh（在后台启动服务器）Linux系统：linux_debug_in_console.sh（debug模式启动服务器）linux_ebg_db_init.sh（手动运行数据库初始化脚本，前提是server.properties已经配置好）linux_shutdown.sh（关闭银企平台）linux_startup_in_console.sh（启动服务器）linux_startup.sh（在后台启动服务器）Windows系统：windows_debug_in_console.bat（debug模式启动服务器）windows_ebg_db_init.bat（手动运行数据库初始化脚本，前提是server.properties已经配置好）windows_shutdown.bat（关闭银企平台）金蝶EASV7.5教学版BOS银企平台升级指南6/28windows_startup_in_console.bat（启动服务器）server.properties（服务器配置信息。不推荐手动配置，若要手动配置，配置时须保留state.port=5288一行）2、点击apache-tomcat-6.0.20\bin下的startup.sh(aixlinux平台)或者startup.bat启动tomcat银企平台客户端。成功启动后，会自动弹出浏览器访问http://127.0.0.1:5389/system/ebserver-config/(安装有默认浏览器的linux及windows系统)。如果不能自动弹出，请手工把地址拷贝到浏览器进行访问。如下图：3.2.5银企平台系统初始化银企平台7.0.5版本使用界面向导方式进行系统初始化，向导一共分为5步支持的数据库类型，请参考1.2接系统配置要求。建议单独分配数据库用户供银企使用。数据库访问用户建议需要具有管理员权限，银企数据库初始化过程中，需要建表，需要使用到对表内容的的增、删、改、查和索引权限。数据库和数据库用户的创建可请客户方数据库管理员协助处理。 以SQL2005为例1、创建数据库进入SQL2005新建数据金蝶EASV7.5教学版BOS银企平台升级指南7/28新建的数据在【选项】中选择【排序规则】Chinese_PRC_CI_AI2、银企服务器设置银企服务器设置配置的是从tomcat客户端访问银企服务器的ip及端口信息（允许两者分开部署，但通常放在一起即可）。金蝶EASV7.5教学版BOS银企平台升级指南8/283、License导入选择license文件，然后点击“上传”，上传结果如下图：测试license允许使用5个前置机，超过5个时，会出现业务异常。4、数据库配置数据库配置是配置银企平台服务器使用的数据库，tomcat客户端无需使用数据库。注：选择正确的“数据库类别”；在执行本向导前应该先创建好数据库、用户及赋予DBA权限（可以执行数据库脚本）金蝶EASV7.5教学版BOS银企平台升级指南9/285、管理员设置管理员设置用于设置登陆web客户使用的用户名及密码。6、完成向导根据配置好的银企服务器、数据库等信息，系统将在后台执行初始化。如果是从6.x升级过来的，所有建表脚本将会执行；如果是从7.0.3升级的，将会执行部分建表脚本，并更新些付款方面的安全信息，所以所花费时间可能需金蝶EASV7.5教学版BOS银企平台升级指南10/28要多几分钟。初始化成功后，点击“业务向导”，会跳到登陆页面，输入刚才“管理员设置”的信息即可登陆，然后进入到“业务向导”。3.2.6银行前置机部署由客户方联系银行电子银行部或现金管理部，获取银行前置机软件和安装部署指南，并安装在客户的电脑上，需要保证该电脑能够访问外网。一般银行前置机部署在企业DMZ区。 测试阶段金蝶EASV7.5教学版BOS银企平台升级指南11/28从银行获取测试用的客户证书或KEY，银行测试服务器信息，测试用账号（一般需要三个，其中两个属于集团内部账号，另外一个是外部账号）。对某些银行需要询问服务器时间，如工行，在做具体业务的时候需要修改ERP系统的系统时间。获取访问端口，银企前置机一般都会开放某个端口由外部系统来访问，此端口在银企互联设置中使用。一般情况下前置机的部署都是由银行人员到现场进行部署。 正式上线测试完成后，需要在正式环境部署银行前置机。3.2.7业务向导业务向导提供用户配置银行前置机、银行账户信息、测试前置机连通性及业务可操作性的能力。 银行版本选择一个银行可能有多个版本的接口，对应金蝶银企中间件的多个插件版本，使用时需要明确账户需要使用的插件版本。 前置机配置根据银行提供的信息进行填写，工行推广版的设置如下图：金蝶EASV7.5教学版BOS银企平台升级指南12/28 账号设置账号设置时，目前只有中行、农行、工行、建行、招行需要“地区码”；“机构号”只有建行需要。进行设置的时候，不需要该项的银行，填不为空的字符即可。工行推广版的设置如下图：金蝶EASV7.5教学版BOS银企平台升级指南13/28 余额查询测试余额测试异常情况：金蝶EASV7.5教学版BOS银企平台升级指南14/28异常情况可以点击“查看日志”查看异常原因。如果是前置机问题，可以在右上角“系统管理”->“前置机”中进行修改；如果是账号户信息配置问题，可以在“业务管理”->“账号管理”中进行修改后刷新页面测试即可。余额测试正常情况：正常的情况也可以通过“查看日志”来看中间发出的报文，以及银行返回的报文信息。金蝶EASV7.5教学版BOS银企平台升级指南15/283.3功能菜单说明3.3.2系统管理 前置机配置银行的前置机信息配置完成后先“保存”再“测试前置机连接”（测试银企平台到银行前置机的连接性，使用telnet方式）。需要实现“前置机集群”功能的客户，可以添加多个“登陆配置”，添加银行账号时，分配到各个“登陆配置”上。 License管理打开License管理页面，可以看到当前配置的License状态。对于有异常的情金蝶EASV7.5教学版BOS银企平台升级指南16/28况，需要重新导入License文件。对于提示“该License文件不适用于该服务器”，可能是许可已经过期、或者是正式License没有使用在指定的申请License的机器上。上传成功后，可以看到License的“许可数量”及“过期时间”。 定时任务对于普通业务都可以进行定时任务配置，例如：付款（对公对私等，操作名为pay）、付款状态查询（操作名为queryPay）、余额（操作名为balance）、明细（操作名为detail）。对于联动支付业务，可能需要多个业务的定时任务配置才能进行。1、定时任务列表，可以查看当前已经配置的定时任务。2、付款定时任务配置如果前置机没有启动、网络不通、服务器意外关闭，或者其他导致付款信息未正常提交的情况，付款信息存在在数据库中，处于“准备提交”状态。当环境恢复后，付款定时任务配置会在后台完成提交付款操作（只针对提交异常的付款）。金蝶EASV7.5教学版BOS银企平台升级指南17/283、查询付款状态定时任务配置操作名对应queryPay，定时时间间隔推荐5分钟或以上。对于联动支付，这个很重要，需要同步为“交易成功”后，才进行下一步的支付。4、余额定时任务配置操作名对应为balance，对于某些银行存在登陆超时的情况，可以使用明细定时任务的方式定时发送查询指令。5、明细定时任务配置操作名对应为detail，需要定时在后台查询明细的银行，可以配置定时查询。由于明细查询会有缓存记录，“强制从银行下载所有”指查询指定时间范围内的明细时，忽略缓存记录，到银行取最新数据。 日志文件系统列举出银企平台logs目录下的目录树，以web方式查询日志文件，所有目录与文件按时间倒序排序：金蝶EASV7.5教学版BOS银企平台升级指南18/28 业务日志搜索根据设定的业务条件，搜索日志信息。点击某条目，可以查看具体的客户端请求信息（request）、银企的响应信息（response）、银行报文日志(有银企平台发送的封装报文，及银行的响应报文，如balance_20120903110035_7651500s.ICBC_CMP-1)，切换文件名即可查看。金蝶EASV7.5教学版BOS银企平台升级指南19/28 日志备份由于银企平台会保留比较多的日志记录，且有单文件大小较小，文件数较多的特点。所以当银企平台运行较长的时间后，日志占用的磁盘空间会比较多，需要进行压缩或转存。用户可以备份指定时间范围内的日志文件，可以选择“备份后同时删除原日志文件”（压缩转存），但是后台控制“当前日期30天内的文件不允许删除”。如果需要指定范围内的日志信息分析业务，也可以通过备份后下载这种方式来提取。备份后，可以通过列表查看备份的文件信息。金蝶EASV7.5教学版BOS银企平台升级指南20/283.3.3业务管理 全局业务配置全局业务配置与具体的银行无关，配置项影响的范围为整个银企平台。目前配置项较少。 银行业务配置银行业务配置为各家银行除了“前置机配置”外的业务配置项，在7.0.5之前都使用配置文件方式，目前以界面方式展示配置项。以建行现金管理平台为例： 账号管理账号的添加必须添加在某“银行版本”下面。账号可能会有些“附加属性”，设置后才可以做相应的业务，如建行现金管理平台“虚拟现金池”业务、批量代发业务等，这些配置项都是关联“账号”的：金蝶EASV7.5教学版BOS银企平台升级指南21/28 币别管理系统初始化时，会初始化一些常用银行的币种映射。对于没有配置的银行插件或者币别，需要手动进行配置（币种对应的映射信息联系相关银行获取），方可进行业务；否则会报币种配置错误，无法进行业务操作。配置币种映射：金蝶EASV7.5教学版BOS银企平台升级指南22/283.3.4用户管理管理登陆web客户端的用户，目前有两种角色：“管理员”、“普通用户”。有只“管理员”有操作右上角管理菜单的权限，“普通用户”只能操作左树业务菜单。3.3.5左侧业务菜单 余额列表所有的银行账号，选择“币别”后，点击账号对应的“查询余额”即可查询。查询完毕后，点击即可查看日志信息，包括客户端请求、响应信息以及请求前置机的请求、响应报文。鼠标移到红色字段上面，即可快速知道异常消息，如：金蝶EASV7.5教学版BOS银企平台升级指南23/28 交易明细选定银行账号，点击“查询”“强制从银行下载所有”选中时，该账号指定时间范围内的明细都到银行重新获取（忽略缓存）。 付款记录查询所有客户端提交的付款信息，并可以同步每一笔的付款状态，以及提供同步状态的相关日志。金蝶EASV7.5教学版BOS银企平台升级指南24/28 联动支付记录联动支付是银企平台7.0.5才添加的功能，有些银行可能提供了联动支付接口，会优先使用；对于银行没有提供的，银企平台会拆分成两步进行支付，一是划拨，一是对外支付。点击即可查看联动支付每一步的执行过程以及结果。为查看日志。4业务功能升级影响为便于您更准确的评估升级风险并制定更完善的升级方案，下面我们将列示出升级后，金蝶EASV7.5教学版BOS银企平台升级指南25/28可能会影响您原使用业务流程或操作习惯的一些主要变动项。如果您希望了解更多本版新功能或功能变动，请您查阅《金蝶EAS705发版说明》。4.1银企互联设置原先在EAS中设置的银行前置机信息都需要在银企管理控制台中进行设置，在升级前，需要预先记录银企互联设置功能各银行前置机的信息，以免升级过程中丢失数据。详细功能见银企信息维护功能。4.2账户管理本版本需要在银企平台中设置账户信息，开通银企互联的账户都需要在银企平台中重新设置，可通过EAS账户同步功能完成，也可在银企平台管理控制台中手工完成。4.3其他事项说明5银企版本支持银行列表对比银行名称版本名称银企6.0银企7.0.5中国兴业银行中国兴业银行直联版本支持支持东亚银行东亚银行直联支持支持浙江商业银行浙江商业银行直联版支持支持中信银行中信银行直联版本V3.0支持支持中信银行直联版本V2.0不支持很少用户使用，已不再维护不支持中国工商银行中国工商银行专业版不支持很少用户使用，已不再维护不支持中国工商银行普通版支持很少用户使用，已不再维护不支持中国工商银行推广版支持支持汇丰银行汇丰银行直联版本V1.13支持不支持未迁移至705版本中国交通银行中国交通银行直联版本支持支持中国交通银行银企通版本不支持很少用户使用，已不再维护不支持深圳发展银行深圳发展银行直联版支持支持金蝶EASV7.5教学版BOS银企平台升级指南26/28齐鲁银行齐鲁银行直联版支持不支持未迁移至705版本中国银行（香港）中国银行（香港）直联版支持支持东莞银行东莞银行直联版支持不支持未迁移至705版本上海农商银行上海农商银行直联版支持不支持未迁移至705版本上海银行上海银行直联版支持支持中国华夏银行中国华夏银行直联版本支持支持江苏银行江苏银行直联集团版支持不支持未迁移至705版本江苏银行直联版支持不支持未迁移至705版本光大银行光大银行银企通V1.10支持支持宁波银行宁波银行直联版支持支持中国招商银行中国招商银行V1.7支持支持上海浦东发展银行上海浦东发展银行直联版本支持支持平安银行平安银行直联版支持不支持未迁移至705版本渣打银行渣打银行H2H版本支持不支持未迁移至705版本中国民生银行中国民生银行3.0支持支持厦门商业银行厦门商业银行银企支持不支持未迁移至705版本贵阳银行贵阳银行直联版支持不支持未迁移至705版本广东发展银行广东发展银行直联版本支持支持中国银行中国银行BOCNET5.0标准版支持支持中国银行银企对接版本不支持很少用户使用，已不再维护不支持哈尔滨商业银行哈尔滨商业银行银企支持不支持未迁移至705版本内蒙古银行内蒙古银行直联版支持不支持未迁移至705版本徽商银行徽商银行直联版支持不支持未迁移至705版本金蝶EASV7.5教学版BOS银企平台升级指南27/28中国建设银行中国建设银行直联版本支持支持中国建设银行佛山版本不支持无用户使用，已不再维护不支持中国建设银行现金管理平台支持支持中国建设银行重客版本支持很少用户使用，已不再维护不支持江苏农信社江苏农信社直联版支持不支持未迁移至705版本支付宝支付宝直联版支持支持中国农业银行中国农业银行企业银行平台3.0版本支持很少用户使用，已不再维护不支持农业银行公网版支持支持农业银行网银版不支持支持705新增6帮助与支持您可就近联系当地的金蝶营销服务机构以获取服务和技术支持。如您需要查询金蝶营销服务机构联系方式，可登录金蝶网站http://www.kingdee.com详细查询。想了解您购买的金蝶软件是否是正版产品，可登录http://www.kingdee.com/genuine/index.jsp进行校验。
