1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V1.5.5 | - |
| V2.12.0 | 降低运维项目升级前备份要求，存在24小时内备份即可升级 |
| V2.15.0 | 支持「批量更新」组件功能 |
| V2.41.0 | 新增「7.0升级7.5」前置检查 |
1.2 应用场景
为满足客户的新需求以及完善之前版本某些功能的不足之处，帆软产品（FineReport/FineBI/FineDataLink）在不断地更新迭代。
管理员使用运维平台部署好项目后，需要定期对工程进行更新升级，但是他发现传统的升级方式存在着一些问题。
1）FineReport内网/FineBI的小版本升级需要手动更换JAR包，操作门槛高。
2）由于部分版本的兼容问题，用户需要升级指定版本而非最新版本，只能手动更换JAR包，操作门槛高。
3）FineReport外网升级，需要手动重启工程/集群所有节点，操作麻烦。
4）升级失败后工程无法自动回退，存在风险。
1.3 功能简介
FineOps运维平台提供面向帆软产品（FineReport/FineBI/FineDataLink）的「更新」功能。
1）支持升级最新/指定版本。
2）通过推送镜像方式，支持内网安全更新。
3）任何更新失败均可自动回退。
1.4 适用范围
外网定义：运维平台的镜像仓库，能连接外网，即可进行外网升级运维项目
升级最新版本：运维平台自动获取最新版本镜像号，通过在线获取最新镜像，即可升级指定组件。
升级指定版本：通过联系技术支持获取指定版本镜像号，在线获取指定版本镜像，即可升级指定组件。
注：内网升级项目，请参考 内网升级项目 。
2. 检查升级前提
2.1 确认升级条件
| 检查项目 | 说明 |
|---|---|
| 项目部署方式 | 必须是运维平台部署的项目，非运维平台部署工程不支持本文相关操作
|
| 镜像仓库连通性 | 镜像仓库所在服务器能够访问帆软云端仓库，详情请参见：确认镜像仓库支持连接帆软云端仓库。 不能在线获取镜像时改用内网升级方案，详情请参见：内网升级运维项目 |
| 当前版本与目标版本 | 若项目组件当前已为最新版本，无需更新 本文方案不支持通过输入较低镜像版本号回退到旧版本 |
| 集群连接 | 多应用集群中，各工程节点与文件服务器、状态服务器、数据存储组件及外接配置库的连接必须正常；FineBI 6.1 及以上版本，即使只有 1 个应用节点，也按集群检查 集群组件连接异常或断开时执行升级，可能导致工程文件永久丢失，模板和数据无法找回。请先修复连接，再执行备份和升级
|
| 项目备份 | V2.12.0 及之后版本执行更新时必须检测到 24 小时内的备份；否则系统阻止更新。 备份动作见第 3 节 |
| 维护时间 | 更新会重启组件；存在关联组件时会同时停机更新。 请先确认允许业务中断，再执行更新 |
2.2 确认组件更新范围
组件是项目中的应用、网关、存储等功能单元；一个组件可包含多个容器。
| 限制 | 说明 |
|---|---|
| 更新粒度 | 支持更新单个组件下的所有容器，不支持只更新同一组件下的部分容器，避免容器版本不一致 |
| 组件依赖 | 主组件升级可能触发从属组件升级，例如 bi-web 触发 bi-engine-worker 更新 存在主从依赖时，从属组件的「更新」按钮置灰，应从主组件发起更新 |
| 停机范围 | 根据更新提示核对会同时更新的关联组件；批量更新会使相关组件同时停机 |
2.3 FineBI7.0升级7.5准备
FineBI7.0升级到7.5版本，也可通过本文方案实现，但需要额外注意以下三点。
| 注意事项 | 处理要求 |
|---|---|
| 更换工程授权 | 升级后须更换 FineBI 工程授权，建议升级前联系销售，提前沟通授权更换事宜 |
| 提交未发布的改动 | 运维平台会在升级项目前自动检测尚未发布的改动内容，并在存在改动时提供「未发布的改动内容详情.xlsx」。建议下载清单，联系相关人员逐项确认并提交改动后再升级。 警告：未提交改动就继续升级，可能导致尚未发布的改动内容丢失。 |
| 安排升级时间 | FineBI 7.0 升级至 7.5 时，会升级模型指标和仪表板，因此升级耗时比其他小版本升级更长，请在维护时间中预留升级时间，并耐心等待完成。 |
3. 备份项目
在更新组件前，必须对项目进行整体备份，防止更新过程出现不可控意外。
更新时如检测不到24小时内的备份，则无法更新。提示「组件更新失败，更新前请保证至少有24小时内的备份，请备份后重试」
1）管理员选择项目，进入「维护>备份管理」。
2）建议勾选「备份镜像」，将当前项目组件的镜像一并备份。
3）单击「开始备份」，按页面提示完成备份。
4）检查备份结果，并确认执行组件更新时备份仍在 24 小时有效范围内；若镜像准备或等待维护时间使备份过期，先重新备份。
注意：整体备份并不覆盖项目所有文件和自备组件的数据，例如assets/temp_attach中的部分文件不在备份范围内，升级前请根据项目实际部署方式另行备份未覆盖的内容。备份内容请参见：备份内容
4. 更新项目组件
4.1 获取指定版本号
仅升级指定版本时执行本节。
1）付费用户通过帆软服务平台的「在线支持」或电话 400-811-8890 联系技术支持。
2）提供产品名称、所需小版本号或 JAR 包日期，获取对应的组件镜像版本号。
3）保存镜像版本号，供第 4.2 节填写；存在关联组件时，同时确认配套版本。
4.2 更新单个组件
警告：更新将重启目标组件及提示中列出的关联组件，可能中断项目访问。先确认维护时间及停机范围，再单击「开始更新」。
1）管理员选择项目，进入「维护>组件管理」。
2）找到待升级组件，单击「更新」。从属组件按钮置灰时，从对应主组件操作。
3）根据目标版本填写「更新版本」。
| 目标 | 填写方式 |
|---|---|
| 最新版本 | 无需输入更新版本号 |
| 指定版本 | 输入第 4.1 节获取的镜像版本号 |
4）核对关联组件提示，单击「开始更新」。FineBI 7.0 升级至 7.5 时，如提示存在尚未发布的改动，请先参照清单处理发布，再继续升级。
5）在重启确认提示中单击「确定」，开始更新。
更新过程将重启组件，可能影响项目正常运行，请勿在使用期间操作。
如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。
6）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」
4.3 批量更新到最新版本
V2.15.0 及之后版本支持批量更新，批量更新仅适用于更新到最新版本而非指定版本。批量更新会使相关组件同时停机，应在维护时间执行。
1）管理员登录运维平台，选择运维项目。点击「维护>组件管理」，点击「批量更新」。
2）无需填写「更新版本」。单击「开始更新」。确认停机影响后，单击「确定」。
触发更新后，组件会同时停机更新到最新版本，可能影响项目正常运行，请勿在使用期间操作。
如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。
FineBI 7.0 升级至 7.5 时，如提示存在尚未发布的改动，请先参照清单处理发布，再继续升级。
上一篇：接入已有项目
