学习目标

通过本单元学习，您将能够：

了解产品星空补丁更新常见问题分析处理方法；

以下描述以金蝶云星空企业版7.6为例，标准版或早期版本产品的需求建议查看发版说明。

前景概述

在使用金蝶云星空(以下简称星空〉产品过程中，经常会遇到安装补丁的要求。因为补丁对于过往问题的修复，新功能的添加都至关重要。因为客户的环境有很大差异，这就使得即使经过严格测试的补丁，安装过程中也会出现各种各样的错误。

在这里，针对一些常见的补丁安装错误给出一些常见的解决方法，以方便处理补丁安装过程中遇到的常见问题。

以下内容整理自金蝶产品论坛，并经过测试验证。这里只讨论单一因素导致的补丁安装问题。本文档将以Cloud 7.6版本进行示例讲解。

星空补丁无法安装的原因分析

情况一：产品许可控制

星空补丁控制研发计划从Cloud 6.0开始，如果Cloud V6.0过了试用期或正式客户过了服务期，那么将无法安装补丁。但对于Cloud 5.1及之前的所有版本即使过了试用期都可以正常安装补丁。

情况二：补丁版本不符

金蝶云星空从7.5开始推出企业版、标准版，两个版本补丁不通用。

注：1、7.5以前的产品属于企业版

2、多语言补丁是通用的，安装前安装对应的前置综合补丁。

情况三：管理中心无法访问

无论出于什么原因，管理中心无法访问都是无法进行补丁安装更新的，比如说管理中心站点异常停止了就会出现如下情况：

情况四：补丁安装不显示数据中心（业务库）和站点

补丁安装不显示数据中心，高级里面也不显示业务站点；

此问题一般都是K3CloudManager服务异常导致，

1、检查服务运行状态。先通过查看【控制面板-管理工具-服务】里面的“K3CloudManager”是否正常启动，若没有启动请设置自动启动。如下图就是该服务没有启动。

2、若K3CloudManager无法启动或者这个服务没有，参考解决连接: K3CloudManager服务详解

情况五：K3CloudManager服务的8088被占用导致无法连接

打补丁点击管理中心提示如下报错：

在这里需要明确，8088端口是默认的，出现冲突可能是被防火墙拦截，或者被其他软件调用导致。无论是什么原因，只要该端口无法正常通信，补丁安装就会有问题。

解决方法有两种：

找到占用该端口的服务进程，结束占用端口的服务或进程（这里就不详细介绍和截图）；
1、检查8088（默认端口）是否正常，命令为“telnet localhost 8088”；
2、如果不正常，进一步确定占用8088的程序的PID,停止K3CloudManger服务，
执行命令令: “netstat -aonlfindstr "8088"”；
3、通过PID，找到特定进程或服务，使用命令“tasklistlfindstr "进程PID""。
修改K3CloudManager服务的默认端口，具体方案介绍如下。
1、打开如下文件:

【安装目录】 k3cloud\Services\ManagementService\Kingdee.BOS.Management.ManagementService.exe.config 文件进行默认端口修改，为了保证修改后的端口不产生冲突,建议使用高位的端口(比如8011)。

2、重启K3CloudManager这个服务；

3、每次在执行补丁安装的时候需要指定管理中心服务端口进行补丁安装，如下所示：

QQ截图20210809124857.png

【emoji】【扩展内容】

若希望修改过的端口能后续默认带到安装补丁的界面，而不需要手动进行输入填写，并且分开部署多应用服务器
参考下面方案：

步骤一：

k3cloudManager 8088端口变更之后，需要进行一下两步处理 1）在管理中心服务器运行里面输入 regedit 修改注册表 HKEY_CLASSES_ROOT\.kdpkg\shell\open\command 默认值是："C:\Program Files (x86)\Kingdee\K3Cloud\Tools\PackageTool\Kingdee.Tools.PackageTool.Shell.exe" "%1" 修改为："C:\Program Files (x86)\Kingdee\K3Cloud\Tools\PackageTool\Kingdee.Tools.PackageTool.Shell.exe" "%1" "/s=net.tcp://localhost:{新端口号}/" 如图：

注册表添加配置参数.png 修改完成后，安装补丁时，会自动加载新端口的服务地址，不需要进行手动填写修改的端口。

步骤二：

2）管理中心【安装目录】\k3cloud\ManageSite\App_data下的KDEnvironment.xml文件变更，在对应的WebServer 添加xml节点 ManagementServiceURL，如果原来8087端口也有改动，需要添加ProxyManagementServiceURL 节点，
如果存在多APP，APP的K3Cloudmanager的端口有改动也需要对应改动，也需要在对应WebServer节点添加对应配置。如下图：

更改完上述配置保存后，重启IIS再运行补丁即可。

情况六：数据中心无法登录

如果数据中心无法正常登陆，无论是出于任何原因，都会导致补丁无法安装。并且如果安装补丁的管理中心有多个账套，只要一个账套有问题，都会导致补丁安装失败。，一般建议安装补丁暂时只勾选一个数据中心进行安装，其他的数据中心去管理中心的数据中心列表中升级即可，可以大大的减少安装补丁等待时长。

例如：当如下图蓝海机械无法正常登录的情况下进行补丁安装

单击【确定】后，会出现报错日志，这里显示的报错日志和登陆的报错日志是一致的，

这个情况下就需要下解决上面数据中心不能登录的情况，比如数据库密码修改了导致账套无法登录，或者是数据库里面的数据中心实体脱机，可疑，恢复状态等情况。

情况七、补丁安装过程的报错

一般未能正常完成安装，需要通过补丁安装详细报告日志解决安装的问题，然后重新进行安装；

【查看日志操作步骤】

1、安装补丁的错误日志：
{安装目录}\K3Cloud\Services\ManagementService\Log；

2、数据库升级相关日志：
{安装目录}\K3Cloud\ManageSite\App_Data\DataBase\Log

补丁安装常见问题解决方案

恭喜您！