金蝶知识库文档金蝶软件（中国）有限公司客户成功部第1页共15页K/3WISE补丁安装指南本文档适用于K/3Wise各版本本文档针对补丁安装进行讲解，通过本文档的学习可以了解补丁安装的过程2021年5月11日V1.0编写人：孙志强2023年8月21日V2.0修改人：孙志强审核人：杨创亮本文件使用须知著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。著作权声明著作权所有2023金蝶软件（中国）有限公司。所有权利均予保留。本期概述版本信息版权信息金蝶知识库文档金蝶软件（中国）有限公司客户成功部第2页共15页目录1.概要......................................................................32.安装前准备................................................................32.1下载补丁................................................................................................................................32.2查看补丁说明........................................................................................................................52.3账套备份................................................................................................................................63.补丁安装..................................................................73.1服务器客户端正常联网........................................................................................................83.1.1服务器安装补丁.................................................................................................................83.1.2客户端安装补丁.................................................................................................................93.2离线验证安装......................................................................................................................104.补丁安装常见问题.........................................................124.1怎么查看K/3Wise安装了哪些金蝶补丁........................................................................124.2安装金蝶K/3补丁时，一直卡在补丁服务验证界面或者提示：本地缓存的验证结果文件已超过其有效期限或获取中间层服务器时间失当败，需重新对当前补丁进行服务期有效性验证.................................................................................................................................124.3安装补丁过程部分组件注册失败，手动注册补丁更新文件报错（0x80004005）......134.4安装补丁提示：当前服务器已成功安装过当前补丁，如需进行重新安装，请至控制面板中卸载当前补丁后尝试重新安装.....................................................................................144.5安装补丁提示：获取产品序列号失败，当前产品尚未进行正版注册或未能连接至中间层服务器.................................................................................................................................144.6其他问题..............................................................................................................................15金蝶知识库文档金蝶软件（中国）有限公司客户成功部第3页共15页1.概要K/3Wise产品补丁包含零散补丁和整合补丁，同时补丁又分为服务器补丁和客户端补丁，需要具体根据补丁说明来进行安装。其中Wise14.2及以前版本均以零散补丁发布，需要注意补丁说明中是否有前置和后置，需要根据说明顺序安装相关补丁；Wise14.3有发布一个整合补丁PT146768，该补丁之前的零散补丁已包含，如有安装该整合补丁，其包含的零散补丁均可不用再单独安装，其后发布的补丁需正常安装；对于Wise15.0/15.1，官方以整合补丁形式发布，对于重装或新装Wise，补丁只需要安装相对最新的那个整合补丁即可，新的整合补丁均包含其前发布的所有零散补丁和整合补丁（特殊专项补丁除外），建议安装最新整合补丁。关于补丁验证的问题，2022年7月及之后发布的补丁正常均不需要进行有效期验证，可自行自由安装；之前已发布的补丁大部分仍需要验证有效期，请根据原来流程处理。安装前准备事项：下载补丁文件，查看补丁说明确保是有管理员组（administrators）权限的用户操作服务器安装补丁，需注意先备份好账套安装注意事项：服务器联网状态下确保能访问api.kingdee.com安装时注意使用有本地管理员权限的用户运行安装安装时先临时退出安全软件，安装完成后注意重新开启2.安装前准备2.1下载补丁1、打开网址https://vip.kingdee.com，登录金蝶云社区帐号（如没有可输入手机号注册登录）；2、点击右下角的服务工具：金蝶知识库文档金蝶软件（中国）有限公司客户成功部第4页共15页图2-1-13、进入后，选择补丁下载：4、选择产品-金蝶K/3，如果是确定的补丁编号，版本和模块可以不用选择，直接输入需要查找到补丁编号（区分大小写）,点击“放大镜”图标查询，如图，查询到补丁后，点击“下载”即可：金蝶知识库文档金蝶软件（中国）有限公司客户成功部第5页共15页2.2查看补丁说明补丁下载后，解压，里面有“补丁自述说明”，里面包含了补丁的安装方法，如：是否有前置补丁，在哪里安装。如下载的PT156453中，说明补丁无前置补丁，需要在中间层、web服务器、客户端上安装，并升级数据库。注意：15.0，15.1为整合补丁，当安装了多个整合补丁时，新装的客户端仅安装已装补丁中比较新的整合补丁即可（可根据补丁号判断，一般补丁号比较大的补丁为较新的补丁。14.3及以下版本，多为对应功能的补丁，查阅补丁说明时，请注意是否有前置补丁，前置补丁也是需要安装。金蝶知识库文档金蝶软件（中国）有限公司客户成功部第6页共15页2.3账套备份服务器安装补丁前，必须进行账套备份，因补丁更新升级账套数据后，不支持回退。账套备份操作步骤可参考如下操作说明：（1）在服务器上打开【开始】→【程序】→【金蝶K3】→【金蝶K3服务器配置工具】→【账套管理】，输入admin的密码（默认管理员用户），单击【确定】登录账套管理；（2）在【金蝶K/3账套管理】界面，单击选中需要备份的账套，单击【备份】按钮或者【数据库】→【备份账套】；（3）在弹出的【账套备份】界面，选择备份方式：“完全备份”（则完整备份整个账套），并选择备份所要存放的路径，输入文件名称，点击【确定】即可。金蝶知识库文档金蝶软件（中国）有限公司客户成功部第7页共15页3.补丁安装补丁安装可支持在线验证和离线验证，如果服务器可以正常联网，则建议进行在线验证进行补丁安装即可；如无法联网或验证失败，建议使用离线验证方式安装补丁。下面就两种方式分别作操作说明。金蝶知识库文档金蝶软件（中国）有限公司客户成功部第8页共15页3.1服务器客户端正常联网3.1.1服务器安装补丁在服务器安装，建议先重启一下中间层服务器器，确保没有其他人连入服务器中操作，并以管理员身份登录系统，临时关闭杀毒软件。如果是多服务器分开部署，需要再各服务器上分别安装相同的补丁。操作步骤如下：1、鼠标右键补丁安装文件，选择“以管理员身份运行”。；2、待补丁自动安装，安装完成后提示重启，安装提示进行重启即可；3、重启后，会提示正在注册com+组件，请不要重启或关闭计算机，等待COM+组件安装注册完成；4、待注册完毕后，会弹出账套升级窗口，点击连接，会显示所有账套管理中注册的账套信息，默认自动选中了所有未进行补丁升级的账套，如果有不希望此次补丁升级的账套，手动取消勾选即可（如无特殊情况，建议都进行升级，未升级的账套在当前环境下无法正常使用），点击“升级”，等待账套升级完成即可。注意：如果之前未备份账套，请先不要进行补丁升级，在数据库中进行相关账套数据库备份后，再继续！金蝶知识库文档金蝶软件（中国）有限公司客户成功部第9页共15页5、待升级完毕后关闭账套升级窗口退出即可。3.1.2客户端安装补丁服务器上安装的补丁，除补丁说明特别说明了只需服务器安装外，所有补丁均需所有客户端安装，确保客户端和服务器系统环境的一致性，方便系统运行维护。客户端安装注意事项：确保使用具有管理员组权限的用户登录操作系统；安装前先临时关闭安全软件和杀毒软件，Win7及以上操作系统，使用鼠标右键补丁安装文件，选择“以管理员身份运行”进行安装。安装后重启电脑，验证功能是否正常。安装步骤：下载补丁-右键“以管理员身份运行”-等待安装完成即可。金蝶知识库文档金蝶软件（中国）有限公司客户成功部第10页共15页3.2离线验证安装当服务器或者客户端无法正常联网需使用离线验证方式安装。1、同样先备份账套，再服务器安装着最好先重启服务器确保没有其他用户连入，并临时关闭杀毒软件。2、右键以管理员身份运行补丁程序此时会弹出”补丁离线验证工具“界面，单击第一步中的【生成】。3、此时电脑桌面会产生一个PTXXXXXX（补丁编号）的文件夹，该文件夹下有“金蝶产品服务期验证辅助工具”和“PTXXXXXX.dat文件，将此文件夹考到正常联网的电脑上，如截图中的PT156453，拷贝到正常电脑上后，右键以管理员身份运行“金蝶产品服务期验证辅助工具”。4、将上一步中的文件夹拷贝到WIN7或以上操作系统，且没有网络限制的电脑上，然后运行“金蝶产品服务期验证辅助工具”，在弹出的界面直接点击【导入】，此时系统将产生金蝶知识库文档金蝶软件（中国）有限公司客户成功部第11页共15页PTXXXXXX_validated.dat文件。5、将上一步产生的PTXXXXXX_validated.dat拷贝到需安装补丁的电脑上，在”补丁离线验证工具“界面中第二步【导入】，选择”PTXXXXXX_validated.dat文件“后按照提示安装补丁即可，后续待验证通过后，即可正常安装。金蝶知识库文档金蝶软件（中国）有限公司客户成功部第12页共15页4.补丁安装常见问题4.1怎么查看K/3Wise安装了哪些金蝶补丁服务器或客户端安装金蝶补丁后，补丁文件源文件均会释放和备份在如下目录：64位操作系统：C:\ProgramFiles(x86)\CommonFiles\Kingdee\K3\KDPatchs32位操作系统：C:\ProgramFiles\CommonFiles\Kingdee\K3\KDPatchs其中Backup目录保存补丁更新替换下来的旧文件及补丁安装更新时间；PT******为补丁编号。操作系统的控制面板-程序和功能-卸载程序的程序列表中，K/3Wisexxxxx-PT******或PT******，即为当前安装的补丁。4.2安装金蝶K/3补丁时，一直卡在补丁服务验证界面或者提示：本地缓存的验证结果文件已超过其有效期限或获取中间层服务器时间失当败，需重新对当前补丁进行服务期有效性验证原因该客户端上组件k3common.dll异常引起的报错。操作步骤1、找到c:\windows\system32\cmd.exe，右键【以管理员身份运行】，打开CMD命令窗口，反注册K3Common.dll,执行命令：regsvr32/u"C:\ProgramFiles(x86)\Kingdee\K3ERP\KDSYSTEM\K3Common.dll"2、反注册完成之后，将k3common.dll文件重命名为其他，例如K3Common1.dll,然后进行安装补丁即可3、安装完补丁后，若想要将文件还原，可将文件重命名为原名，然后，使用regsvr32注册该文件即可。金蝶知识库文档金蝶软件（中国）有限公司客户成功部第13页共15页4.3安装补丁过程部分组件注册失败，手动注册补丁更新文件报错（0x80004005）原因从手动注册错误代码：0x80004005可以看出该为权限异常导致，即补丁安装时和手动注册时管理员对注册表的访问写入权限出现异常。正常的administrator管理员权限为什么会不足？当然想到的就是功能强大的安全软件了！解决方案1、退出安全软件之前可以先将安装金蝶目录（%安装目录%\Kingdee\K3ERP和C:\Program金蝶知识库文档金蝶软件（中国）有限公司客户成功部第14页共15页Files(x86)\CommonFiles\Kingdee）添加白名单；2、然后临时退出安全软件（如360安全卫士、电脑管家、金山毒霸等等），再以管理员身份运行安装补丁；3、如果上述步骤操纵还存在部分组件注册异常，请先卸载当前安全软件，重启电脑后，检查确保安全软件的主动防御等服务卸载完全了，再以管理员身份运行安装补丁，一般上述权限异常问题均能正常解决。4.4安装补丁提示：当前服务器已成功安装过当前补丁，如需进行重新安装，请至控制面板中卸载当前补丁后尝试重新安装原因如提示所描述，顾名思义就是已经安装过这个补丁未卸载，或卸载不干净导致。解决方案1、如果没卸载，打开控制面板-程序和功能-卸载程序中，选择对应补丁卸载后，重启电脑即可。2、如果卸载了，还是提示，说明卸载后注册表未卸载干净，请使用补丁清理工具清理处理即可。补丁清理工具操作说明：解压后，需要鼠标右键“以管理员身份运行”，打开软件，搜索补丁号，清理，再点搜索，确认GUID框中不出现内容。4.5安装补丁提示：获取产品序列号失败，当前产品尚未进行正版注册或未能连接至中间层服务器原因从提示已经说明了问题，如果是服务器上安装提示，说明没有导入正确的许可文件，如果是客户端安装提示，说明客户端未能正确连接到服务器获取许可信息解决方案若服务器上安装补丁有此提示，则进行以下操作：打开登录到“账套管理”，打开【系统】→【系统使用状况】，查看当前的K3授权许可状态，若显示为“检测失败，-1”，则说明当前服务上未导入许可或未能识别授权许可；金蝶知识库文档金蝶软件（中国）有限公司客户成功部第15页共15页软加密许可用户，可新下载license并重新导入许可，智能卡用户可重新安装智能卡驱动重新插拔智能卡确保正常识别授权许可即可；若是客户端上安装补丁有此提示，需要先通过远程组件配置工具连接服务器通过加密组件，即获取到服务器的产品许可才能正常运行安装补丁：打开远程组件配置工具勾选“按模块设置中间层服务器”，在“加密服务”一行点击“测试”，确认连接中间层正常；加密服务测试通过后，点击右上角“确定”直接完成注册。再重新运行补丁安装。4.6其他问题如果上述补丁提示异常或其他异常，仍无法处理，建议联系您的服务商协助处理，或提单反馈处理。
