【熊说星空】基础管理：补丁安装基本流程与常见问题-环境篇2021.10（直播复盘笔记）

主讲老师：向亮亮（金蝶总部技术支持）

课程链接：金蝶云•补丁安装基本流程与常见问题--环境篇

上课时间：2021.10.21 19:00 - 20:00

主要内容：

1、星空补丁介绍

2、星空补丁安装流程

3、补丁安装中的常见问题

一、云星空补丁介绍

背景：金蝶云星空的版本更新迭代都较为迅速，目前已经更新到7.7.0.2021.09版本。

为用户解决之前版本的问题，或是为体验最新版本的特性，都需要升级补丁。

标准补丁和多语言补丁统一的下载地址：金蝶云星空开放平台 (kingdee.com)

二、云星空补丁安装流程

注意：做任何操作前先备份！！！

• 金蝶云补丁安装后无法卸载，若需要还原到安装之前的环境，请卸载金蝶云软件后，重新安装。

• 数据中心升级后是无法返回到低版本的，若考虑要返回低版本，需先对数据中心进行备份再安装补丁。

以下流程主要为公有云补丁安装：

以下流程主要为私有云补丁安装：

Step01：将下载好的补丁拷贝到金蝶云星空服务器（管理中心服务器）上，双击运行补丁程序如图

从2021.05补丁开始不允许管理中心密码为默认的888888

Step02：若有多个应用服务器（文件服务器分开部署），补丁安装可以重复安装，也可以单独更新某个应用服务器或者某个数据中心，只需要在相应的站点列表和数据中心列表中勾选即可。

补丁支持重复安装，但需要勾选【允许重复导入】、【允许重复执行】

Step03：根据自身补丁更新需求选择好后直接点击确认，会弹出如下界面

比如更新的补丁可能会影响到管易云（第三方系统），需要和管易云沟通是否允许更新。

Step04：点击【请联系金蝶获取确认码】会弹出如下界面后，按照要求填写相关信息获取补丁确认码复制到补丁功能升级确认中点击【确认】进行补丁安装即可

Step05：若当前环境是存在多语言，在确认安装补丁的时候会弹出如下界面，需要勾选下面参数才能正常进行最后的补丁安装阶段。

Step06：勾选好相关参数后进入补丁的正常安装过程，安装过程会根据您选择更新的站点和数据中心，安装的时长也会不同，没有报错就请耐心等待，切勿重启IIS，重启电脑或者中止补丁安装。

卡住没报错就耐心等待

Step07：更新完成后会提示安装更新完成

Step08：多语言补丁安装（如有）

• 多语言补丁安装是有前置补丁的

• 多语言补丁的前置补丁可以通过补丁查看详情中查看该补丁对应的前置补丁（补丁下载解压后补丁说明有描述前置补丁）

• 多语言补丁是没有区分标准版和企业版的
  

以PT-146877多语言为例，本多语言补丁适用于V7.6企业版以及V7.6标准版产品环境：

• 此多语言补丁的企业版前置功能补丁：PT-146876（7.6.0.202105）

• 此多语言补丁的标准版前置功能补丁：PT-146875（7.6.0.202105）
  

多语言补丁安装和标准补丁安装类似。

不同的地方：

进入管理中心MC的数据中心列表，选中数据中心-设置-语言设置-启用多语言。

三、补丁安装过程中常见问题

前景概述

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

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

本文档将以星空7.6版本进行示例讲解。

情景一：产品许可控制

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

情景二：补丁版本不符

原因分析：

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

2. 临时补丁也是有对应版本（包括企业版、标准版）同样不能混用。

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

原因分析：无论处于什么原因，管理中心无法访问都是无法进行补丁安装更新的，比如说管理中心站点异常停止了就会出现报错等情况，需要优先处理站点错误问题。

情景四：补丁安装不显示数据中心（业务库），高级里面也不显示业务站点

原因分析：此问题一般都是K3CloudManager服务异常导致

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

2. 若K3CloudManager无法启动或者这个服务没有，参考解决帖子：K3CloudManager服务详解 (kingdee.com)
   

问题扩展：K3CloudManager服务找不到或者无法启动

安装补丁的时候提示“无法连接，需要安装K3CloudManager服务”，该服务怎么卸载安装。

【注意】如果服务有问题需要重新卸载后安装，卸载命令把上述命令中的/i替换为/u，建议卸载后重启服务器再安装。

情景五：K3CloudManager服务的8088被占用导致无法连接；打补丁点击管理中心提示如下图报错

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

解决办法：

• 方法一：找到占用该端口的服务进程，结束占用端口的服务或进程（这里就不详细介绍和截图）

• 具体操作命令如下：

• 1.检查8088默认端口是否正常，命令为：telnet localhost 8088

• 2.如果不正常，进一步确定占用8088的程序的PID，停止K3CloudManager服务，执行命令：netstat -ano|findstr 8088

• 3.通过PID，找到特定进程或服务，使用命令：tasklist|findstr "进程PID"

• 方法二：修改K3CloudManager服务的默认端口，具体方案介绍如下【不推荐】

• 1.打开如下文件：安装目录下：

  /K3Cloud\Services\ManagementService\Kingdee.BOS.Management.ManagementService.exe.config文件进行默认端口修改，为了保证修改后的端口不产生冲突，建议使用高位的端口（如8011）

  
  

• 2.重启K3CloudManager这个服务

  

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

  

• 4.高级里面勾选允许重复导入，允许重复执行进行补丁安装。

情景六：补丁安装提示“Kingdee.Tools.PackageToolUI停止工作”

解决办法：

方法一：检查补丁包的大小是否正常，杀毒软件的主动防御关掉检查补丁是否完好无损：将补丁后缀直接改成zip格式，如果不能正常解压，说明补丁已经损坏了。

方法二：将D:\K3cloud\Tools\PackageTool\Private的目录删掉，重新打补丁

方法三：将补丁解压，替换packagetool目录，再打补丁。

服务器不能联网，二开的补丁需要在金蝶云开放平台做签名。

情景七：数据中心无法登录

• 1.如果数据中心无法正常登陆，无论是处于任何原因，都会导致补丁无法安装

• 2.并且如果安装补丁的管理中心有多个账套，只要一个账套有问题，都会导致补丁安装失败。
  

• 3.一般建议安装补丁暂时只勾选一个数据中心进行安装，其它的数据中心去管理中心的数据中心列表中升级即可，可以大大的减少安装补丁等待时长。
  

解决办法：

1. 数据中心不能登录时安装补丁
   

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

   

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

情景八：补丁安装过程的报错

原因分析：

一般未能正常完成安装，需要通过补丁安装详细报告以及日志显示的错误进行处理，然后重新进行补丁安装；

查看日志操作步骤：

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

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

情景八-1：补丁安装过程中常见问题之“中止线程”错误

原因分析：安装过程中，频繁文件操作，由于IIIS自身的保护机制导致了线程中断，安装失败。

在{安装目录}ManageSite\App_Data\DataBase的日志中会出现Thread Abort或是中止线程的错误提示。

打补丁或者创建账套突然跳到登录页面都有这个中止线程的情况，分析的原因：

一般是因为IIS在升级过程中断掉由于有些IIS设置大批量文件修改时，自动重启IIS的设置，所以需要用其它方法规则这种大文件操作。

处理方案：

步骤1：将安装目录\ManageSite\App_Data\CommonFileServer目录下的所有文件（含子文件夹）复制到【安装目录】\CommonFileServer直接覆盖路径下的文件即可。

步骤2：打开服务器中IIS管理器，在ManageSite站点中创建虚拟目录CommonFileServer

步骤3：修改{安装目录}\ManageSite\App_Data\KDEnvironment.xml，修改完后保存配置文件重启IIS。

以上方法不能解决请检查服务器操作系统：Windows Server 2012上述问题更新微软补丁KB3052480解决：Windows Server2012系统又针对IIS、asp修复的补丁。

情景八-2：补丁安装过程中常见问题之“套接字连接已中止”

解决办法：

方法一：重启K3CloudManager服务，尝试退出杀毒软件，关闭安全策略

方法二：找到对应版本的标准补丁，将Tool/Packagetool里面的组件全部替换

情景八-3：二进制流无效

解决办法：

方法一：如果是低版本的账套（7.0，7.1，7.2）打最新的补丁（7.5最新）在管理中心执行该语句

方法二：登录管理中心是否能正常登录，重启K3CloudManager服务

方法三：如果是Oracle的账套，需要检查Oracle数据库的版本是否是我们支持的版本（Oracle数据库版本不支持，一般都会报“二进制流”49“不包含有效的BinaryHeader”

情景八-4：“扩展包执行失败”其它情况

原因通过安装日志分析

1. 安装过程中，temp文件写入没有权限，将C:\Windows\Temp文件夹授予everyone完全控制权限后再安装补丁

2. 执行更新的数据包是空的，删除【安装目录】\ManageSite\App_Data\CommonFileServer\PackageCollection\目录下空包清理，重新执行补丁包安装

3. 应用服务器分开部署模式下无法解析计算机名（防火墙、杀毒软件、安全防护等组织），可以互相添加hosts解析

场景九：元数据版本不一致（针对二开补丁包）

原因分析：报错的意思是部署包中元数据9338d378-ef69-4440-b011-b9c938031e4b的版本号低于安装的目标环境中该元数据的版本号，所以才导致不会执行二开包中的该内容出现，

这种情况的原因一般都是目标环境（正式环境）中有人直接通过boside去保存过该业务对象，所以才导致版本号升高。

建议下方的方法二