外网升级运维项目

1.1 版本

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.1 使用前提

2.1.1 运维平台部署

使用运维平台更新帆软项目，仅面向运维平台部署的项目，非运维平台部署工程不支持本文相关操作。

2.1.2 确认镜像仓库支持连接帆软云端仓库

如需使用运维平台在线更新项目组件，需要有新版本的组件镜像包用于替换安装。

因此要支持镜像仓库从云端拉取镜像，镜像仓库所在服务器，必须确保连接外网的帆软云端仓库。

详情请参见：确认镜像仓库支持连接帆软云端仓库

2.1.3 检查工程版本

管理员登录运维平台，选择运维项目。点击「维护>组件管理」。找到bi6/fr/fdl组件，检查是否存在可更新版本。

若显示「当前已为最新版本」，则说明暂无更高版本发布，无需执行更新操作。

2.1.4 注意事项

1）运维项目组件，不支持一键全部更新，仅支持对同一个组件下的所有容器进行更新。

• 此设定主要是为了满足用户对项目的稳定性要求。

• 但帆软仍然建议在升级时，将项目下的所有组件都更新到最新版本，以便提升项目安全性。

2）部分组件之间存在关联关系（例如升级bi-web组件，会触发bi-engine-worker组件的更新）

• 如有关联更新组件，会出现提示「触发更新后，xxx组件会同时停机更新至对应版本」

2.2 备份工程

在更新组件前，必须对项目进行整体备份，防止更新过程出现不可控意外。

更新时如检测不到24小时内的备份，则无法更新。提示「组件更新失败，更新前请保证至少有24小时内的备份，请备份后重试」

管理员登录运维平台，选择运维项目。点击「维护>备份管理」。

建议勾选「备份镜像」，点击「开始备份」，运维平台即会对该项目进行整体备份。

2.3 更新版本

1）管理员登录运维平台，选择运维项目。点击「维护>组件管理」。

2）找到fr/fdl/FineBI应用节点组件，点击「更新」。

如有关联更新组件，会出现提示「触发更新后，xxx组件会同时停机更新至对应版本」

3）升级最新版本，无需输入更新版本号，直接点击「开始更新>确定」，即可进行工程更新。

• 更新过程将重启组件，可能影响项目正常运行，请勿在使用期间操作。

• 如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。
  

4）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」

本方案仅支持升级，不支持通过本方案回退指定版本。

3.1 获取镜像版本号

付费用户请联系帆软技术支持，告知所需产品和小版本号，或大概的JAR包日期。

技术支持会告知您具体的镜像版本号。

技术支持联系方式：前往「服务」，选择「在线支持」、电话「400-811-8890」。

3.2 使用前提

3.2.1 运维平台部署

使用运维平台更新帆软项目，仅面向运维平台部署的项目，非运维平台部署工程不支持本文相关操作。

3.2.2 配置镜像仓库

如需使用运维平台更新项目组件，需要有新版本的组件镜像包用于替换安装。因此要支持从云端拉取镜像。

详情请参见：确认镜像仓库支持连接帆软云端仓库

3.2.3 注意事项

1）运维项目组件，不支持一键全部更新，仅支持对同一个组件下的所有容器进行更新。

• 此设定主要是为了满足用户对项目的稳定性要求。

• 但帆软仍然建议在升级时，将项目下的所有组件都更新到最新版本，以便提升项目安全性。

2）部分组件之间存在关联关系（例如升级bi-web组件，会触发bi-engine-worker组件的更新）

• 如有关联更新组件，会出现提示「触发更新后，xxx组件会同时停机更新至对应版本」

3.3 备份工程

在更新组件前，必须对项目进行整体备份，防止更新过程出现不可控意外。

更新时如检测不到24小时内的备份，则无法更新。提示「组件更新失败，更新前请保证至少有24小时内的备份，请备份后重试」

管理员登录运维平台，选择运维项目。点击「维护>备份管理」。

建议勾选「备份镜像」，点击「开始备份」，运维平台即会对该项目进行整体备份。

3.4 更新版本

1）管理员登录运维平台，选择运维项目。点击「维护>组件管理」。

2）找到fr/fdl/FineBI应用节点组件，点击「更新」。如有关联更新组件，会出现提示「触发更新后，xxx组件会同时停机更新至对应版本」

3）在「更新版本」处手动输入3.1节获取的镜像版本号，点击「开始更新>确定」，即可进行工程更新。

• 更新过程将重启组件，可能影响项目正常运行，请勿在使用期间操作。

• 如不存在24小时内的备份，则更新终止，请对项目进行备份后再进行更新。

4）更新完毕后，自动刷新组件管理界面，提示「更新完成」，组件版本显示：「当前已为最新版本」