系统升级使用说明

功能简介

系统升级用于上传并应用新的 MDP 安装包。系统会在正式升级前自动检查升级包和当前环境，并展示本次升级涉及的配置及服务变更，帮助您完成版本升级或日常维护。

页面同时保留升级历史，便于查看以往升级记录、执行状态和相关日志。

注意：大版本升级可能会更新数据表结构，升级会涉及到配置变更、服务重启、功能接口变化等，存在影响用户使用的风险，应在业务低峰时进行。

进入页面

登录管理后台后，在左侧导航中选择 系统升级 即可进入页面。

系统升级仅对管理员开放。如果未看到该菜单，请联系系统管理员确认当前账号权限。

升级前准备

开始升级前，建议确认以下事项：

使用官方提供且与当前产品类型、部署方式匹配的升级包。

升级包格式为 .tar.gz，请勿解压或修改包内文件。

建议在业务低峰期或维护窗口内执行升级。

确认当前服务运行正常，并提前通知相关使用人员。

如果升级涉及 License 变更，请提前准备新的 License 内容。

升级步骤

1. 上传升级包

在系统升级页面单击上传区域，或将升级包拖入上传区域。上传完成后，系统会自动解析并校验升级包。

校验内容主要包括：

安装包格式和内容完整性。

安装包签名是否合法。

升级包版本及升级方案。

产品类型和部署架构是否匹配。

当前 License 是否支持本次升级。

校验结果分为以下状态：

通过：校验正常，可以继续。

变更：本次升级存在可预期的变化，请确认内容后继续。

不匹配：存在阻止升级的问题，需要更换升级包或处理相关配置后重新上传。

2. 写入 License

如果系统判断本次升级需要更新 License，页面会提示需要更新的产品，并展示当前服务器机器码等信息。

粘贴新的 License 内容后，单击 校验并暂存。只有 License 校验通过后才能继续升级。暂存的 License 会在应用更新成功后自动生效。 License参考【授权管理】

如果页面显示无需更新 License，可直接进入下一步。

3. 确认升级包内容

页面会展示升级包中的配置文件和服务资源。可以选择具体文件查看内容，确认升级包与本次升级目标一致。

4. 确认变更

系统会对比当前环境与升级包，展示本次升级将新增、修改、删除或重启的资源。

请重点确认：

是否包含预期之外的资源删除。

是否有重要服务需要重启。

配置文件的修改内容是否符合预期。

5. 应用更新

确认以上信息无误后，单击 确认开始更新。系统会创建升级前快照，并开始应用升级包。

升级期间页面会持续展示执行日志，包括资源更新、服务重启和运行状态检查等信息。部分组件重启时，管理页面可能暂时无法访问，请稍候后重新打开页面查看进度。

如果执行失败，可以根据日志处理问题后单击 重新应用。

6. 完成升级

当升级任务执行成功后，单击完成结束本次升级流程。

升级完成页面会显示升级包名称和版本，并提供以下操作：

查看执行日志：查看本次升级的完整过程。

回滚到升级前的版本：进入升级前快照，按页面提示进行回滚。

返回应用更新：返回系统升级首页。

升级历史

系统升级首页下方会展示历史升级记录，包括升级包名称、版本、创建时间和执行状态。

单击升级记录可以重新进入对应流程，查看升级进度或历史执行结果。

常见情况

升级包校验失败：请确认升级包来源、文件完整性、产品类型及部署架构是否正确。

版本不匹配：请检查当前系统版本和升级包版本，确认是否使用了正确的升级路径。

要求更新 License：请获取与目标版本和当前运行环境匹配的新 License，校验并暂存后继续。

升级过程页面暂时不可访问：可能是 MDP 服务正在更新或重启，请等待片刻后刷新页面。

升级任务失败：查看执行日志定位原因，问题处理完成后使用 重新应用。

升级后服务异常：先查看执行日志和服务状态；如需恢复，可以通过升级前快照进行回滚。

系统升级会修改服务配置并可能触发服务重启，请在确认升级包和变更内容无误后执行。

系统升级

系统升级使用说明#

功能简介#

进入页面#

升级前准备#

升级步骤#

1. 上传升级包#

2. 写入 License#

3. 确认升级包内容#

4. 确认变更#

5. 应用更新#

6. 完成升级#

升级历史#

常见情况#