EASC_建筑_V8.8部署升级指南金蝶软件（中国）有限公司2022年11月目录1环境配置........................................................................................................12升级准备........................................................................................................12.1环境准备.............................................................................................................................................13升级步骤........................................................................................................23.1数据备份.............................................................................................................................................23.2软件安装.............................................................................................................................................23.2.1安装前准备..................................................................................................................................23.2.2EASCloud8.8平台安装和部署..................................................................................................23.2.3升级数据中心..............................................................................................................................33.2.4下载建筑产品行业补丁..............................................................................................................83.2.5设置局部补丁白名单................................................................................................................123.2.6安装建筑产品行业补丁............................................................................................................133.2.7配置子系统树文件....................................................................................................................153.2.8配置子系统和组织类型映射....................................................................................................163.2.9配置参数信息............................................................................................................................173.2.10产生子系统树..........................................................................................................................183.2.11客户端安装与更新（含大批量用户同时更新办法）..........................................................193.2.12系统数据初始化......................................................................................................................213.2.13开始使用建筑产品..................................................................................................................244帮助与支持..................................................................................................24EASC_建筑_V8.8升级指南前言本文档提供计划以及正式升级到EASC_建筑_V8.8版本的相关信息，包括：升级准备、升级步骤、新增或改进功能对用户的影响。适用于原使用金蝶EAS7.0版本，EAS7.5版本，EAS8.0版本，EAS8.1版本，EAS8.2版本，EAS8.6.0版本,EAS8.6.1版本准备升级到EASCLOUDV8.8的建筑行业产品用户。EASC_建筑_V8.8升级指南1环境配置金蝶EASCloudV8.8环境配置的详细说明，请参见《金蝶EASCloudV8.8系统管理员手册》文档相关说明。2升级准备1.了解新产品升级前，请仔细阅读《金蝶EASCLOUDV8.8发版说明》中的“新增和完善功能”，了解您当前版本已应用的全局和局部补丁的功能是否包括在EASCLOUDV8.8版本中。如果有补丁功能未能包括在新版本的功能中，请及时联系您的代理商或金蝶公司的技术支持部门以获取新的补丁。2.制定升级计划在详细了解新产品的功能、性能、可用性等方面内容后，如果确认需要升级到新版本上，则需要制定周详的测试计划，包括确定升级方案，制定升级项目计划，明确人员、时间、费用预算、以及对现有系统运行平台进行评估。3.升级准备升级金蝶EASCLOUDV8.8系统的软、硬件准备，包括硬件系统的升级或更新，新版本软件的预定，开发、测试环境与生产环境的同步以及明确升级项目组人员、职责分工，工作场地安排等。并针对操作人员进行新产品的相关培训。2.1环境准备检查操作系统、磁盘空间、内存、网络、数据库版本等是否满足金蝶EASCLOUDV8.8版的环境要求，针对Unix系统，还需要关注执行安装程序的用户权限，避免这些因素导致金蝶EAS安装配置发生问题。详细请参见《金蝶EASCLOUDV8.8系统管理员手册》的详细说明。请检查您目前所做的二次开发功能，及时与开发人员联系并确认所做的二次开发是否会因升级而受到影响。特别需要关注数据库中的触发器。关于二次开发功能的元数据升级，请参见《金蝶EASCLOUDV8.8元数据升级指南》的详细说明。请与实施或服务人员确认本次升级是否需要增加一些硬件，如CPU或内存的空间是否足够。1/28EASC_建筑_V8.8升级指南3升级步骤3.1数据备份在确认升级前，请事先备份好您以前的业务账套，具体操作步骤可以按以下步骤进行：查询并记录数据库名称及对应的表空间名称。为保证数据的完整性，建议在备份时断掉所有相关数据库连接。Sqlserver数据库使用完整备份，对oracle数据库则建议使用数据泵进行数据备份。3.2软件安装3.2.1安装前准备为了防止升级过程发生意外情况，避免客户因升级而发生大面积无法使用EAS的现象，在升级前必须备份EAS服务端。EASCloud8.8平台相关的安装包联系您的代理商或金蝶公司的客户服务支持或者技术支持部门。3.2.2EASCloud8.8平台安装和部署EASCloud平台的安装和部署过程具体请参见《金蝶EASCloudV8.8系统管理员手册》文档相关说明，主要包括以下步骤。数据库系统的安装与配置金蝶EASCloud服务端安装金蝶EASCloud客户端安装金蝶EASCloud系统配置：新建，配置部署实例；新建，注册与部署数据中心；配置群集License管理：EASCloudlicense申请与导入；Apusiclicense申请与导入3.2.3升级数据中心注意1：在升级前请做好账套备份安装和部署完成EASCLOUDV8.8后，升级原有的数据中心到EASCLOUDV8.8版本是必须的步骤。进入管理控制台，选择要升级的数据中心，然后点升级，在弹出的界面选择对应的功能即可。这里以升级V8.6.1为例，注册V8.6.1的数据中心，选中点击升级。2/28EASC_建筑_V8.8升级指南注意2：升级数据中心的时候如果遇到提示需要安装建筑兼容补丁，可以先安装建筑补丁，然后在服务端以下文件eas\server\properties\canupgrade_ec.properties中，修改version=后面的值为正确的升级目标版本号，然后再升级数据中心即可下面为升级过程中的一些截图：3/28EASC_建筑_V8.8升级指南4/28EASC_建筑_V8.8升级指南5/28EASC_建筑_V8.8升级指南6/28EASC_建筑_V8.8升级指南注意3：升级过种中如果出现中断错误时，请查看对应安装目录“*/admin/logs/admin.log”文件进行分析。7/28EASC_建筑_V8.8升级指南正常升级完成后，在管理控制台的数据中心点“刷新”，即可显示数据中心已经更新到V8.8版本。启动EASCloud应用服务器，客户端或portal登陆测试一下是否正常。3.2.4下载建筑产品行业补丁补丁下载方式一：在金蝶云客服网站http://ksm.kingdee.com:8000/下载建筑EASCloudV8.8版本补丁PT168831以及依赖的许可补丁PT168904。建筑行业补丁PT168831需要在高级中查询并下载如下图：许可补丁PT168904直接在搜索框中填写补丁号即可查询出来并下载：8/28EASC_建筑_V8.8升级指南补丁下载方式二：通过管理控制台，点击“补丁下载”，在输入正确的客户号以后在补丁列表中下载需要的补丁9/28EASC_建筑_V8.8升级指南通过方式一下载的补丁下载后需要拷贝到服务端以下路径eas\admin\patch\patchlist拷贝好以后，在管理控制台刷新后可见，注意建筑行业补丁是以局部补丁形式，要点击局部补丁才能看到，许可补丁是全局补丁，直接选中后安装即可，建筑行业补丁安装前则需要设置白名单，见下一步说明“设置局部补丁白名单”。10/28EASC_建筑_V8.8升级指南11/28EASC_建筑_V8.8升级指南3.2.5设置局部补丁白名单建筑行业补丁安装前需要设置局部补丁白名单，没有设置好白名单安装会提示如下：白名单配置文件在服务器端eas\admin\config\localPath_whiteList.xml12/28EASC_建筑_V8.8升级指南将以下内容粘贴在文件中
中即可，注意name为“EC”代表是建筑产品，注意不要填到绿色区域里面去了
PT1688313.2.6安装建筑产品行业补丁现在正式安装建筑行业补丁，提示如下，选择确定即可13/28EASC_建筑_V8.8升级指南补丁安装成功，点击完成即可14/28EASC_建筑_V8.8升级指南3.2.7配置子系统树文件在服务器端路径eas\server\properties下，找到文件SubSystem_industry_ec.xml，将里面建筑相关的配置信息粘贴至另一个文件SubSystem_industry.xml中的前面位置。配置好以后的情况如下图，位置在标签前面。15/28EASC_建筑_V8.8升级指南3.2.8配置子系统和组织类型映射在服务器端eas\server\profiles\server1\config下，找到文件EAS_subSysIdToOrgTypeMaps_ec.xml，将里面的建筑相关的配置信息粘贴到EAS_subSysIdToOrgTypeMaps.xml中之前配置好以后如下图，在之前16/28EASC_建筑_V8.8升级指南注意：如果是群集配置，则要在每个server下都要配置EAS_subSysIdToOrgTypeMaps.xml，可以之前把前面在server1下配置好的EAS_subSysIdToOrgTypeMaps.xml直接复制到其他eas\server\profiles\serverX\config下（X代表实际的server实例可能是2,3,4.。。）。3.2.9配置参数信息在服务器端eas\server\profiles\server1\config下，找到文件EAS_ParamRel_ec.xml，将里面的建筑相关的配置信息粘贴到EAS_ParamRel.xml中name是“paramafter”的之前的位置配置好以后如下图，在name是“paramafter”的之前17/28EASC_建筑_V8.8升级指南注意：如果是群集配置，则要在每个server下都要配置EAS_ParamRel.xml，可以之前把前面在server1下配置好的EAS_ParamRel.xml直接复制到其他eas\server\profiles\serverX\config下（X代表实际的server实例可能是2,3,4.。。）。3.2.10产生子系统树配置好以上信息后，在管理控制台工具菜单中选择“产生子系统树”18/28EASC_建筑_V8.8升级指南子系统树产生以后，启动eas服务，开展后续操作。3.2.11客户端安装与更新（含大批量用户同时更新办法）为了避免版本升级以及打较大的补丁时出现网络堵塞的情况，实施控制是一种必不可少的手段，主要方法是事先准备一个已经完全更新好的客户端，然后打包分发给所有广域网客户端。1.安装并更新客户端此步操作应在搭建测试环境进行验证的时候就要开展，客户端会由于没有关闭“按需更新”选项，导致并不是所有组件都是最新的。我们需要开启完全更新，一次性更新完所有的组件，操作内容如下：19/28EASC_建筑_V8.8升级指南请打开“EAS服务器连接设置”，关闭“按需更新”选项，即开启完全更新，并连接到已经升级或者打过补丁的测试环境；进入EAS登录界面，等待自动更新完成。若出现更新失败或者不完整的情况，请检查原因并解决。注：在将客户端整个目录用压缩工具打包之前，请不要忘记做如下工作：打开“EAS服务器连接设置”，打开“按需更新”选项，避免以后总是完全更新。最后用压缩工具将整个EAS客户端目录打包，以便分发。2.分发客户端将打包好的客户端放到公网上供广域网用户下载，或者通过刻录光盘的方式分发，一个机构只需要一份拷贝，机构内可以通过局域网复制。拿到新版本的客户端压缩包后，解压缩到指定的路径待用。如果路径和原始压缩路径不一样，则需要修改client/bin/set-client-env.bat中的EAS_HOME和JAVA_HOME路径指向新的目录。20/28EASC_建筑_V8.8升级指南请特别知会业务人员不要立即使用新的客户端登录系统，等待邮件通知可以切换后再使用，避免新的客户端连接还没有升级的EAS，将组件更新到旧的版本。3.升级生产环境邮件通知所有业务人员停机升级计划以及系统可以正常使用的时间，并根据升级计划开展正式环境的升级工作。升级工作通常会涉及较多的数据被修改，因此有必要在升级完成后做一次数据库统计分析，保证数据库生成执行计划的效率。4.切换到新的客户端通知所有用户正式切换使用新的客户端，并根据需要设置新的端口。如果生产环境的升级步骤和补丁与测试环境完全相同，应该不会产生自动更新流量；如果存在大量文件更新，很可能是在使用旧的客户端连接服务器，此时应立即关闭EAS客户端并按照前面步骤检查并重新配置客户端。3.2.12系统数据初始化详细的系统数据初始化可以参考《金蝶EASCloudV8.8初始化指南》的说明，包括组织架构，角色，用户，职位，职员，权限，主数据以及财务相关的基础数据，这里仅列出和建筑行业产品相关的一些关键的系统初始化操作。3.2.12.1配置客户化菜单建筑产品菜单出厂设置在系统菜单中，是一个大而全的菜单，需要根据客户实际的需要导入到客户化菜单中，然后再做适当的裁剪。21/28EASC_建筑_V8.8升级指南3.2.12.2同步权限数据位置：企业建模-安全管理-权限管理-用户管理，在菜单文件中找到“同步权限数据”点击3.2.12.3设置组织单元类型建筑产品单据主业务组织类型是发运组织，涉及到的组织类型主要有财务组织，发运组织，销售组织，成本中心，行政组织，采购组织。22/28EASC_建筑_V8.8升级指南3.2.12.4参数设置项目期间类型建筑产品使用了期间类型，使用前必须设置好项目期间类型，引用会计期间类型基础资料该参数位置：系统平台-系统工具-系统配置-参数设置，项目综合管理-基础资料-其他参数建筑产品中其他的参数设置默认可以不用调整，使用出厂设置的即可，有需要再做调整。3.2.13开始使用建筑产品完成上述步骤以后，就可以正常使用建筑产品了。建筑产品是以工程项目为核心管理对象，所以使用建筑产品的第一步就是要建立工程项目。其他详细的使用说明参见相关的建筑产品实施文档和指导手册，就不在这里一一赘述了。23/28EASC_建筑_V8.8升级指南4帮助与支持您可就近联系当地的金蝶营销服务机构以获取服务和技术支持。如您需要查询金蝶营销服务机构联系方式，可登录金蝶网站http://www.kingdee.com详细查询。想了解您购买的金蝶软件是否是正版产品，可登录http://www.kingdee.com/genuine/index.jsp进行校验。24/28
