EASV7.5下载更新配置方案EASV7.5下载更新配置方案金蝶软件（中国）有限公司2015年5月请注意：本文件只作为产品介绍之用，不属于您与金蝶签署的任何协议。本文件仅包括金蝶既定策略、产品及功能方面的信息不能以本文件作为要求金蝶履行商务条款、产品策略以及开发义务的依据。本文件内容可能随时变更，恕不另行通知。EAS下载更新配置方案前言概述介绍EAS部署模型以及更新架构，EAS所采用的主要更新技术及其优缺点，在实际客户场景下，如何通过部署以及实施等手段避免更新引发的网络阻塞和性能问题。适用范围现场实施同事、总部研发。本解决方案适用版本：金蝶EASV7.0。约定符号约定在本文中可能出现下列标志，它们所代表的含义如下。符号说明表示有潜在风险，如果忽视这些文本，可能导致操作错误、数据丢失、设备性能降低或不可预知的结果。表示可以帮助您获取更多相关信息或提示您通过其它方式也可以获得相同结果。强调或补充说明所描述的信息。内容约定本处对文中通用信息作如下约定$EAS_HOME表示EAS服务器安装的根目录，即安装过程中输入的本地路径。$BOS_HOME表示BOS工具的安装根目录，即安装过程中输入的本地路径。2/17EAS下载更新配置方案目录概述..................................................................................................................................................................................2适用范围..........................................................................................................................................................................2约定..................................................................................................................................................................................21背景.........................................................................................................................................................................42目标.........................................................................................................................................................................43解决方案.................................................................................................................................................................43.1EAS部署模型.............................................................................................................................................................43.2EAS更新架构.............................................................................................................................................................73.3更新方案选型建议....................................................................................................................................................93.4打开和关闭按需更新..............................................................................................................................................113.5打开和关闭差异更新..............................................................................................................................................123.6调整APUSIC相关参数..............................................................................................................................................123.7启用服务器更新代理..............................................................................................................................................133.8二级更新代理方案..................................................................................................................................................153.9启用CDN更新.........................................................................................................................................................153.10人工分发更新........................................................................................................................................................173.10.1安装并更新客户端.........................................................................................................................................173.10.2分发客户端.....................................................................................................................................................183.10.3升级生产环境.................................................................................................................................................183.10.4切换到新的客户端.........................................................................................................................................193/17EAS下载更新配置方案1背景每当EAS做大的升级或者打较多补丁后，由于大量客户端需要更新组件，容易引发网络阻塞，系统整体性能变慢等情况，甚至出现“与服务器意外失去联系”等问题。如果该客户用户数较多，而且有许多广域网客户端的时候，比较容易发生类似问题。产生此现象的主要原因是：1.当升级到新的版本后，所有客户端都需要自动更新到新版本，导致大量文件需要从服务器下载，网络出现塞车现象，引起通讯延迟，进而导致性能下降。2.由于同时更新的客户端过多，导致负责更新的EAS实例HTTP线程达到500个的上限，导致大面积出现更新失败错误。且此时管理控制台由于无法连接实例（通过HTTP端口），会认为实例出现故障而自动重启。为了解决更新可能引发的性能和稳定性问题，EAS提供了多种手段，可以根据客户的应用规模和场景灵活选择。2目标通过实施以及部署调整等手段，有效解决EAS更新可能导致的网络阻塞和性能问题。3解决方案3.1EAS部署模型了解EAS部署模型，可以帮助大家理解EAS基本运作原理、自动更新机制，明白本文所述方法的实质。下图是EAS网络图，可以看到EAS是典型的三层模型。4/17EAS下载更新配置方案数据库服务器EAS客户机EAS客户机EAS客户机EAS服务器1EAS服务器2EAS服务器n。。。集群前端机（LoadBalancer）EAS应用服务器集群状态服务器数据库端主要运行各种DBMS系统，如Oracle、DB2、SQLServer等，可能会采用单台处理能力很强的服务器来运行，也可以组成集群，具体组建方式取决于DBMS本身的架构和能力。在应用服务器层，金蝶EAS提供了灵活的可扩展模型以满足从中小规模到大规模的应用需求，并发用户不多的客户可以采用单实例的方式，只需部署一个EAS，而对于更大规模的客户，则应该采用EAS集群来满足对并发处理能力、可靠性、可扩展性的需要。EAS采用J2EE作为基础架构，因此可以在多种操作系统平台上运行，包括Linux、AIX、HP-UX、Windows等。客户端和服务器之间则通过局域网或者广域网连接在一起，采用标准的TCP/IP协议进行通讯。5/17EAS下载更新配置方案ClusterServerAppServerEASServer1RPCServerRPCClusterHTTPServer单例服务状态数据EAS业务组件调度服务、银企直联等单例服务Session状态数据集群配置数据ormrpc_loadbalance.propertiesClusterControlerRClientEASClientRPCClient服务器连接信息/eas/client/set-client-env.batR自动更新组件EAS业务组件TCPReasclientfilesRbosconfig.xmlAppServerEASServer2RPCServerRHTTPServerEAS业务组件Session状态数据bosconfig.xmlAppServerEASServer3RPCServerRHTTPServerEAS业务组件Session状态数据bosconfig.xmlHTTP1、一些在集群环境下只能有一个运行实例的服务称之为单例服务，为了提升可靠性，可以设置备用单例服务器。2、除了单例服务器外，其他服务器实例都是对等关系，没有主次之分。3、节点失效后，会自动迁移到正常节点并重建状态信息，客户端业务不会中断。4、集群将做为EAS基本部署形态以提升整体可用性。HTTPClustereasclientfilesReasclientfilesR上图是进一步分解的EAS部署模型1，其中展示了一个EAS集群控制器和三个EAS运行实例。下面对这些概念做一下解释：集群控制器（ClusterController）：又称集群前置机、负载均衡器。对于客户端而言唯一可见的EAS服务器，当其接收到客户端的连接请求后，会根据某种负载均衡算法将调用转发到后端的EAS实例，并将结果返回给客户端。可以为每个实例指定一个静态权重。主节点（Master）：又称主实例。EAS的某些基础服务，如调度服务、网络控制、License管理等在整个集群环境中只能有一个运行实例，我们称之为单例服务。运行了这些单例服务的EAS节点称之为主节点。一个集群只能有一个主节点。从节点（Slaver）：又称从实例。集群环境下可以有一个或者多个从实例，运行除了基础服务以外的所有EAS组件。当其中的程序需要访问基础服务的时候，会自动调用主节点中的基础服务，这种调用关系是在从节点的bosconfig.xml中配置的，部署工具会自动完成此工作。EAS服务器端口：由上图中的RPCServer组件监听的TCP端口，默认为11034，运行期客户端的所有服务请求通过此端口完成。EASHTTP端口：由上图中的HTTPServer组件监听的TCP端口，如果应用服务器采用Apusic，默认为6888。其为Portal的访问端口，同时也是客户端进行自动更新的服务端口。如果启用了HTTP群集（EAS网络代理NAP或者Apache等），则由群集相应的端口接管，并会负载均衡到后端的EAS实例HTTP端口处理。1从EASV6.0开始还支持更加可靠的高可用集群，能有效降低server1宕机的影响，但由于目前还没有客户实际应用，所以未进一步展开说明。6/17EAS下载更新配置方案3.2EAS更新架构EAS业务系统部分采用SmartClient架构，部分采用B/S架构，采用SmartClient架构的业务系统其客户端组件是自动升级的，当服务器上更新了相关组件后，客户端在连接服务器时会自动将所需组件更新到和服务器匹配的版本。EAS的升级和打补丁工作只需要在服务器端完成，每当服务器升级或者打补丁后，如果相应的客户端组件有变化，会更新相应的组件列表，其中用组件的MD5值标识每个组件。客户端每次登陆之前会检查服务器上的这个组件列表，并和本地保存的组件列表进行比对，确定需要更新的文件列表，用于后续的组件更新。下图是EAS7.0SP1更新架构：EAS补丁及组件服务器EAS客户机EAS客户机EAS客户机网络服务商B网络代理、局域网CDN镜像LANEAS客户机EAS服务器集群P2PP2P网络服务商C网络服务商ACDN节点CDN节点EAS客户机CDN节点发布终端补丁及组件发布根据组件的更新时机不同，自动更新存在两种模式：#更新模式说明1按需更新登录前会更新登陆过程所依赖的基础组件，进入系统后，当访问某个业务功能时，系统后检测该业务组件服务器上是否有更新的版本，若有，则更新下载后加载新版本的业务组件并运行。这时会出现点击某个功能等待较长时间的情况发生。EAS默认使用按需更新。7/17EAS下载更新配置方案2完全更新登录前将所有服务器上更新过的组件下载完成后，才开始登陆过程，进入系统后不会再发生自动更新的动作。这种模式会导致首次登陆更新流量很大，即使根本不会用到的模块组件也可能被下载，对网络会造成更大的压力。但更新完成后，后续不会再有更新流量。根据实际下载文件和原始文件的差异，分为如下两种：#更新内容说明1标准更新下载更新的组件的原始文件。2差异更新服务器在打补丁的时候会先生成新的组件和之前若干个版本的组件的差异包。客户端在更新的时候，根据已有版本查找和最新版本组件的差异包，如果找到，则下载。下载差异包后，和已有组件合并，从而创建一个和服务器上最新版本组件一致的版本。如果打补丁的操作比较频繁，组件的最新版本和之前版本的差异可能就非常小，生成的差异包也就很小。此时采用差异更新机制就能显著降低下载量。EAS7.0默认开启此选项。根据组件更新来源不同，自动更新有如下几种：#更新来源说明1直接更新组件直接从EAS服务器某个实例更新。2服务端更新代理服务器部署EAS网络代理（NAP）或者Apache等下载代理接管EAS组件更新请求，其他HTTP请求则转发到后端实例处理。EAS在集群部署环境下默认启动NAP代理，端口8080，可修改。3二级更新代理通常部署在异地下属机构的局域网中，代理自身会保持组件版本和服务器的一致。局域网内的EAS客户端则直接从二级更新代理更新组件。可显著降低对服务器出口的带宽占用。4局域网P2P更新当EAS客户端更新组件时，会尝试从局域网内其他已经更新过相同组件的机器上获取组件。可显著降低对服务器出口带宽占用，但网络安全设置可能会阻止这种机制发挥作用。EAS默认启用P2P，无法使用时自动切换到其他方式。8/17EAS下载更新配置方案5CDN更新CDN，是ContentDeliveryNetwork的缩写，即内容分发网络，是一种基于Internet的快速内容分发技术。启用CDN更新后，组件会从分布在Internet上的CDN节点上下载，能保证在复杂的网络条件下，获得较高的下载速度，且会显著降低对源服务器出口带宽的占用。CDN网络会根据客户端位置，寻找能提供最佳下载性能的CDN节点为客户端提供下载服务。3.3更新方案选型建议不同的更新技术有不同的适用场景和优缺点，参考下表：#更新技术优点缺点1按需更新只下载会用到的组件，减少带宽占用。业务组件更新后第一次访问会较慢（后台下载）。2完全更新一次更新完成，后续不再产生任何更新流量。如果客户端较多，网络阻塞和延迟会比较严重。更新期间对EAS使用性能影响较大。3标准更新部署简单更新流量消耗较大。4差异更新打补丁较频繁时，更新流量相对标准更新会显著降低。偶尔打补丁的情况下，效果不明显。切换回标准更新时，可能触发大量更新。5直接更新部署简单。更新流量大，网络阻塞。更新期间影响EAS使用性能。6服务器更新代理减少后端实例的压力。更新阻塞时可快速重启。部署复杂度稍有增加。7二级更新代理显著降低网络流量。对Portal应用有加速效果。局域网用户越多，效果越明显。需要新增机器，部署复杂度较高。增加维护成本。8局域网P2P更新有效降低局域网用户的更新流量。客户分散时效果不明显。网络安全设置会屏蔽此机制。9/17EAS下载更新配置方案9CDN更新配置简单显著降低源服务器的带宽要求客户端非常分散时效果明显要求客户端能直接访问Internet。局域网客户较多时，可能导致Internet出口阻塞。10人工分发更新客户端无更新流量实施复杂度较高在实际客户场景下，可能需要采用多种更新技术相结合的方式来保证组件的高效更新，减少对EAS性能的影响。请参考下表进行选择：#应用场景完全更新差异更新直接更新服务器更新代理二级更新代理CDN更新人工更新1局域网应用，客户端数量<50√√√2局域网应用，客户端数量>50√√3广域网异地局域网客户端，客户端数量超过20个。√√√√4广域网较分散的客户端。或者客户端和服务器连接在不同的ISP供应商线路上。√√√√按需更新和完全更新互相排斥的选项，所以这里只列示完全更新，没有打√的，就是采用按需更新。关闭差异更新时，自动使用标准更新，打开差异更新，但服务器没有找到增量包时也会自动切换到标准更新。因此这里只列示差异更新选项。局域网P2P是默认启用的选项，若该机制不能生效，会自动使用其他机制，所以这里不再列示该选项。10/17EAS下载更新配置方案3.4打开和关闭按需更新打开客户端的“EAS服务器连接设置”功能，其中有一个“按需更新”选项，打√则表示使用按需更新，否则使用完全更新。使用安装包安装的客户端默认启用“按需更新”选项。3.5打开和关闭差异更新EAS7.0开始提供差异更新机制，默认为启用状态，如果需要关闭此特性，请修改EAS服务器上的$EAS_HOME/server/profiles/<实例名>/config/portalConfig/oddsConfig.properties文件。#oddsProperties#SatMay0116:12:25CST2010oddsdemand_resPaths=lib/sp/,lib/patch/,metas/sp-bim-metas.jar,metas/sp/,metas/patch/maxOddsJarCount=10useOddsJarFunction=true将最后一行修改为：useOddsJarFunction=falseEAS集群环境下，需要修改每个实例的相应配置文件，此配置文件没有和实例相关的选项，因此可以保存后复制到其他实例。此选项重启EAS后生效。3.6调整Apusic相关参数Apusic的HTTP端口是一个多协议端口，可以支持多种协议同时连接。接收到的数据会首先送到一个叫MuxHandler的装置进行协议识别，确定协议类型后会直接转到对应的装置处理，如果是HTTP请求（自动更新属于此类），则转HTTPHandler处理。11/17EAS下载更新配置方案MuxHandler的处理线程数默认为最大10个，大多数情况都够用了，但碰到网络状况复杂，大并发访问，以及可能存在蠕虫病毒的情况下，就不够用了。同样的，当客户端数量很多，加上网络阻塞导致更新很慢，可能出现大量HTTP更新请求，默认最多500个的HTTPHandler线程同样会存在不够用的情况。建议修改Apusic的MuxHandler最大线程数为50，HTTPHandler的最大线程数为1000甚至更高。方法：修改apusic/domains/server*/config/apusic.conf中的相应参数，具体位置请参见下图所示。如果server1的更新端口是给客户端更新用的，则修改server1的配置文件，如果是其他实例负责自动更新，则请修改对应实例的配置文件。在大并发访问以及复杂网络情况下，如不同供应商之间互联，网通连电信，教育网连网通等情况时，网络很容易发生拥塞的情况，最终可能导致实例故障，如果关闭nio（Java网络通讯的一种机制）,此时使用传统的bio，虽然有一定的效率损失，但通讯过程会更可靠。请修改每个apusic实例下的apusic/domains/<实例名>/config/vm.options。设置如下选项为true。com.apusic.net.bio=true3.7启用服务器更新代理EAS集群环境中，server1的作用非常重要，默认的集群部署方式下，server1一旦出现故障，会导致整个集群不可用，只能通过重启整个集群解决。因此，如果因为自动更新导致server1出现故障就得不偿失了。从EASV6.0版本开始，系统增加了一个EAS网络代理程序（NAP），能够同时代理EAS服务器端口（RPC）以及HTTP端口（自动更新）。当启用RPC代理时，它可以取代EAS集群前置机的职责；当启用HTTP代理时，它会识别静态请求（如组件更新）以及动态请求（如Portal页面访问）并做不同的处理，如果是前者，NAP会直接从服务器目录或者本地更新缓存中获取文件并返回，如果是后者，则将请求转发给后端的EAS实例处理。12/17EAS下载更新配置方案NAP代理经过测试可以承受高并发的下载请求，并支持EASPortal集群，建议EAS的客户总是启用服务器端的NAP负责组件更新。默认NAP只启用HTTP代理，不会启用RPC代理，EAS服务器端也无需启动RPC代理。启动EAS管理控制台后，有一个“网络代理”页签，可以对NAP的端口进行配置，以及启动和停止NAP服务。【启用HTTPS代理】由于EAS自动更新目前都是基于HTTP协议，因此请勿勾选此选项，否则会导致更新报错。【HTTP端口】HTTP代理端口，对应EAS客户端设置的自动更新端口，不能和同一台服务器上的任何EAS实例的端口相同。调整设置后，请点击“保存”按钮将设置的信息保存到配置文件。在假定EAS对外更新和RPC端口分别为6888和11034时，不同场景下EAS实例以及集群控制器、NAP端口设置如下。13/17EAS下载更新配置方案EAS部署形态端口配置说明1单实例server1的HTTP/RPC端口分别设置为6890和11034，NAP端口设置为6888。注：启动EAS的过程除了启动server1外，还要切换到“网络代理”页签启动NAP，停止亦然。2集群（多实例）NAP端口设置为6888，集群控制器端口设置为11034，每个实例分别设置各自端口，不能与NAP以及集群控制器端口冲突，实例之前也不能出现相同的端口。注：在集群环境下启动和停止EAS集群会自动启动和停止NAP。3多机集群主机的配置方法同上面的集群（多实例）配置，从机的端口设置只要保证机器内部不冲突即可。如果生产环境升级后正式启用时仍然出现更新阻塞的情况，可以单独重启一下NAP即可，已经登录系统的用户不会受到影响，无法更新的客户端重新进入一次即可开始正常更新。3.8二级更新代理方案在广域网客户端数量较多，但又有一定集中度的情况下，可以考虑部署镜像代理以有效降低自动更新流量，理论上某机构部署了镜像代理后，该机构自动更新流量将会降低到只有一个客户端时的更新流量，如果客户端数量很多，效果将会非常显著。如果一个机构的客户端数量超过30，则建议配置镜像代理解决更新问题。镜像代理需要额外的硬件投入，使用开源软件实现。详细方案请参考《EAS镜像代理方案》，作者：郭立春3.9启用CDN更新要启用CDN更新，首先需要在服务器端做必要的配置，请打开服务端的$EAS_HOME/server/profiles/<实例名>/config/portalConfig/resourceSet.properties，增加如下两行内容：CDN_URL=http://cdn.kingdee.com/easwebcache/CDN_FORCE_ENABLE=false需要逐一修改每个EAS实例下的相应配置文件增加上述选项，由于此配置文件是和实例相关的，因此不能采用修改一个配置文件，然后复制到其他实例下的方法。14/17EAS下载更新配置方案CDN_URL，EASCDN服务器的访问地址，金蝶EAS统一使用cdn.kingdee.com域名做CDN更新用，因此请保持和上面的URL一样。如果企业自己配置了EASCDN的本地镜像，则请设置成镜像的URL。CDN_FORCE_ENABLE，是否强制为所有客户端启用CDN更新，默认是false，具体是否使用CDN更新取决于客户端的相应配置；如果此选项设置为true，则所有的客户端都将强制从CDN服务器上更新，包括局域网用户，如果局域网用户很多，可能会导致Internet出口出现严重阻塞的情况。如果希望除了局域网用户以外其他客户端全部强制使用CDN更新，一种可行的方法是配置局域网的DNS，屏蔽对cdn.kingdee.com的解析，这样局域网用户在无法解析cdn.kingdee.com的时候，会自动切换到其他可用的更新机制。如果服务器的CDN_FORCE_ENABLE=false，可以为单个客户端配置启用或者关闭CDN更新。打开客户端的“EAS服务器连接设置”功能，其中有一个“CDN下载”选项，打√则表示启用CDN更新。也可以通过修改client/bin/set-client.env.bat中的ENABLE_CDN选项为true或者false开启和关闭CDN下载。3.10人工分发更新为了避免版本升级以及打比较大的补丁时出现网络堵塞的情况，实施控制是一种必不可少的手段，主要方法是事先准备一个已经完全更新好的客户端，然后打包分发给所有广域网客户端。15/17EAS下载更新配置方案3.10.1安装并更新客户端这个步骤在搭建测试环境进行验证的时候就应该要开展了，客户端会由于没有关闭“按需更新”选项，导致并不是所有组件都是最新的。我们需要开启完全更新，一次性更新完所有的组件。请打开“EAS服务器连接设置”，关闭“按需更新”选项，即开启完全更新，并连接到已经升级或者打过补丁的测试环境，进入EAS登录界面，等待自动更新完成。若出现更新失败或者不完整的情况，请检查原因并解决。在将客户端整个目录用压缩工具打包之前，请不要忘记做如下工作：打开“EAS服务器连接设置”，打开“按需更新”选项，避免以后总是完全更新。最后用压缩工具将整个EAS客户端目录打包，以便分发。3.10.2分发客户端将打包好的客户端放到公网上供广域网用户下载，或者通过刻录光盘的方式分发，一个机构只需要一份拷贝，机构内可以通过局域网复制。拿到新版本的客户端压缩包后，解压缩到指定的路径待用。如果路径和原始压缩路径不一样，则需要修改client/bin/set-client-env.bat中的EAS_HOME和JAVA_HOME路径指向新的目录。请特别知会业务人员不要立即使用新的客户端登录系统，等待邮件通知可以切换后再使用，避免新的客户端连接还没有升级的EAS，将组件更新到旧的版本。16/17EAS下载更新配置方案3.10.3升级生产环境邮件通知所有业务人员停机升级计划以及系统可以正常使用的时间，并根据升级计划开展正式环境的升级工作。升级工作通常会涉及较多的数据被修改，因此有必要在升级完成后做一次数据库统计分析，保证数据库生成执行计划的效率。3.10.4切换到新的客户端通知所有用户正式切换使用新的客户端，并根据需要设置新的端口，如果生产环境的升级步骤和补丁与测试环境完全相同，应该不会产生自动更新流量。如果存在大量文件更新，很可能是在使用旧的客户端连接服务器，此时应立即关闭EAS客户端并按照前面步骤检查并重新配置客户端。17/17
