跳到主要内容
版本：4.x

集群升级

升级存算一体集群​

升级前检查

确认集群健康、容量、备份策略和维护窗口满足要求，且没有部署、扩缩容、重启或配置变更等冲突任务正在执行。

选择目标版本

点击“集群升级”

图片展示的是集群升级页面。页面上方有“集群部署成功”及“查看日志”选项。左侧有“总览”“节点”“主机”“运行中”等标签，当前选中“节点”。右侧显示节点信息，包括IP、状态、角色、Http Port等，如IP为172.20.17.107的FE节点状态为活跃，角色是Master，Http Port为8033等。页面右侧有“集群伸缩”“重启”“参数配置”“集群升级”等操作选项，其中“集群升级”被红色框突出显示。该图片与文档中“选择目标版本”步骤对应，用于说明进入集群升级页面后选择目标内核版本的操作位置。

进入集群升级页面，选择与当前集群兼容的目标内核版本。目标版本要求 License 时，按页面提示准备或上传对应 License 文件。

  • 目标安装包不需要 license

    无需 License 的集群升级页面。

  • 目前安装包需要 licenese （如果当前的集群已经是配置了 license 的，那么即使升级到后续的需要 license 的版本，也不会出现下图红框标注的内容）

    需要 License 的集群升级页面。

    执行升级检查

    这张图片是SelectDB Enterprise Manager中升级存算一体集群时的升级检查界面，界面顶部显示当前版本为selectdb-doris-3.1.4-bin-x64，目标版本已选中selectdb-doris-4.0.6-bin-x64。界面标注了需上传的两个授权文件cluster_guard.lic与cluster_guard.key，均显示可正常使用，右侧带有重新上传按钮。升级模式提供“全量停服升级”和“在线滚动升级”两个选项，其中“在线滚动升级”已处于勾选状态。界面右下角有一个蓝色的“升级检查”按钮，被红色方框突出标注，是本次升级流程中执行升级检查的核心操作按钮。

    升级检查结束会出现此页面

    升级检查完成页面。

    提交升级任务

    确认升级范围和页面显示的前置检查项后提交任务。Manager 按任务阶段执行预检查、节点升级和必要的组件重启。

    任务执行中，点击左侧的IP/Host，可以查看对应 Agent 的任务执行日志；

    图片展示的是SelectDB Enterprise Manager集群升级任务执行日志界面。左侧为任务列表，其中“下载JDK”任务被红色框突出显示。右侧是该任务的执行日志，记录了从2026 - 07 - 15 15:48:25到2026 - 07 - 15 15:48:30的下载JDK操作日志，包括下载文件、解压文件等步骤。该图片与文档中“任务执行中，点击左侧的IP/Host，可以查看对应Agent的任务执行日志”内容相关，直观呈现了任务执行日志查看方式。

    需要注意的是，新版本的 Manager 目前支持在升级之前先把安装包分发到对应的 Agent 机器上

    图片展示的是SelectDB Enterprise Manager集群升级任务执行日志界面。左侧为任务列表，显示了任务名称、状态、开始时间等信息，如“下载SelectDB Core安装包”任务已成功。右侧是任务日志，记录了各阶段的执行情况，如“下载SelectDB Core安装包”阶段的下载进度、时间等。界面右下角有“获取日志”按钮，点击可下载日志文件。该图与文档中“查看任务并验收”内容相关，用于说明在任务执行中查看任务日志的操作。

    查看任务并验收

    在任务详情中查看阶段进度和节点结果。任务成功后，检查集群概览、节点状态、License 状态和业务访问；如任务失败，先依据失败节点和阶段信息处理根因。

    图片展示的是SelectDB Enterprise Manager集群升级后的任务成功界面。界面左侧为导航栏，有“集群”“监控”“日志”“任务”“Studio”等选项。右侧上方显示“集群升级”成功，下方有“集群概览”“节点状态”“License状态”“业务访问”等选项。中间区域呈现了升级各节点的详细日志，如“启动FE节点”“启动FE节点”等，日志内容包含时间、操作、状态等信息，如“2026-07-18 10:15:36.852 [manager-async-0] INFO c.s.s.compass.agent.biz.dpsignature.AgentBiz - update db at node [ClusterId=0,clusterId=0,customId=0,resourceId=0,syncId=0,formatId=0,platformId=0,modalityId=0,feHost=fe01,fePort=3306,publicKey=...]”。该图片与文档中集群升级任务成功后的检查内容相关。

    点击“立即验收”；根据集群的实际情况确认是否正常，如异常情况可以选择回滚

    这张图片展示了存算一体集群升级完成后的验收界面，页面顶部提示集群升级成功的结果，中部弹出红色标题的验收确认窗口，内容提示集群升级完成后需检查业务是否正常，提供“验收正常”“异常回滚”两个选项，窗口设有“取消”和“确定”按钮；页面右上角有“立即验收”按钮，下方是FE节点和BE节点的列表，显示节点IP、状态、角色及各类端口信息，整体是存算一体集群升级后的验收操作相关的系统界面。

升级存算分离集群​

类似存算一体的升级操作，页面直接选择可升级的版本即可

存算分离集群升级页面。

升级失败处理​

全量升级失败处理​

全量升级失败处理页面

  • 重试：重试当前报错的任务运行阶段。

  • 恢复选项 - 核对并恢复集群状态：适用于用户在后台手动升级成功后，Manager 根据集群实际状态验证是否已完成升级。

    核对并恢复集群状态

  • 恢复选项 - 回滚升级：适用于需要回滚到升级操作前版本的场景。

    创建升级回滚任务

    点击“创建回滚任务”后，Manager 会自动生成新的回滚任务。在新任务页面点击“查看源升级任务”可以跳转到原始升级任务；源升级任务会被锁定，不再支持重试和恢复操作。

    集群升级回滚任务

    查看源升级任务

滚动升级失败处理​

滚动升级失败不支持回滚，仅支持重试和后台人工恢复并核对集群状态两种操作。

滚动升级失败处理页面