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

集群升级

升级存算一体集群​

升级前检查

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

选择目标版本

点击“集群升级”

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

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

  • 目标安装包不需要 license

    图片展示的是SelectDB Enterprise Manager中集群升级的界面。界面中显示了集群升级相关参数，包括目标版本为selectdb-doris - 4.0.4 - m1 - arm - a64，升级方式为在线版本升级。下方有“在线版本升级”说明，提示在升级过程中，部分节点的IP可能会有变化，但不会影响集群正常运行。该图片与文档中“执行升级检查”及“提交升级任务”内容相关，是集群升级操作中确认升级参数的页面示例。

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

    图片展示的是SelectDB Enterprise Manager集群升级时的“集群升级”弹窗界面。弹窗中显示当前版本为selectdb - doris - 3.14.0 - bin - x64，目标版本为selectdb - doris - 4.0.0 - bin - x64。关键信息是“上传License”部分，包含License文件和Public Key文件的“选择文件”按钮，用于上传集群升级所需的License文件和Public Key文件。该图片与文档中“提交升级任务”步骤相关，是提交集群升级任务前需完成的文件上传操作界面。

    执行升级检查

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

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

    图片展示的是SelectDB Enterprise Manager集群升级中执行升级检查后的页面。页面上方有“升级模式”选项，选中“全量停服升级”。下方有“在线滚动升级”选项。页面中部列出检查项目及结果，如集群状态、硬盘可用空间、集群副本数等，均显示“通过”。底部有“取消”和“确认”按钮。该图片与文档中“执行升级检查”内容相关，呈现了检查结束后的页面情况。

    提交升级任务

    确认升级范围和页面显示的前置检查项后提交任务。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、状态、角色及各类端口信息，整体是存算一体集群升级后的验收操作相关的系统界面。

升级存算分离集群​

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

图片展示的是SelectDB Enterprise Manager中存算分离集群的集群升级界面。界面左侧为导航栏，中间上方显示集群状态为“运行中”，下方有FE节点、BE节点、FDE节点列表。右侧弹出“集群升级”窗口，显示当前版本为doris - 5.1.0 - rc07 - 35052902a60，可选择升级版本，有“在线逐台升级”和“在线并行升级”两种升级模式，下方有“取消”和“开始升级”按钮。该图与文档中存算分离集群升级操作上下文对应，直观呈现了升级操作的界面和关键选项。