1. 概述
1.1 版本
| FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0.5 | - |
| 6.0.16 | 新增版本更新推送和问题反馈入口 |
1.2 功能介绍
为满足客户的新需求以及完善之前版本某些功能的不足之处，我们的产品在不断地更新迭代。
本文主要介绍FineBI工程在6.0.x小版本内（例如FineBI6.0.5升级FineBI6.0.9）升级的情况。
本文提供两种升级方式，请任选其一进行。
2. BI版本管理工具升级方案
仅面向购买了技术支持服务的付费用户。
2.1 准备步骤
| 步骤 | 说明 | |
|---|---|---|
| 1 | 了解升级注意事项 | 请在升级前，认真查看升级注意事项，确保了解各个版本的兼容问题：FineBI小版本升级注意事项 |
| 2 | 备份工程 | 在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作 请参考 工程备份还原方案 3.1节，对工程进行备份 |
| 3 | 确认FineReport适配情况（没有可忽略） | 1）集成的FineReport 如为FineBI与FineReport集成工程，升级FineBI即可，其中包含FineReport相关JAR，无需再单独升级FineReport 2）独立匹配使用的FineReport 如有完全独立部署、需要匹配使用的独立FineReport工程，请在升级前确认版本匹配情况：FineReport版本适配说明 |
| 4 | 确认FineDataLink适配情况（没有可忽略） | 1）集成的FineDataLink FineBI6.0.18 版本开始，不再内置 FineDataLink 相关功能依赖的 JAR 包，升级后不再支持两者集成 如为FineBI与FineDataLink集成工程，如需升级至FineBI6.0.18及以上版本，请在升级前联系FineDataLink客户成功，进行FineDataLink独立部署 2）独立匹配使用的FineDataLink 如有完全独立部署、需要匹配使用的独立FineDataLink工程，请在升级前确认版本匹配情况：FineDataLink版本适配说明 |
| 5 | 获取BI版本管理工具 | 付费用户请联系帆软技术支持，索要最新/指定版本的「BI版本管理工具」 请说明你的工程环境（Linux/Linux_arm/Windows） 技术支持联系方式：前往「服务>在线支持」 |
2.2 升级步骤-Linux
| 步骤 | 说明 | |
|---|---|---|
| 1 | 关闭工程 | 请参考 关闭或重启FineBI工程 文档，关闭单机工程节点/集群每一个工程节点 |
| 2 | 使用「BI版本管理工具」执行换JAR升级 | 本步骤操作，需在单机工程节点/集群每一个工程节点服务器均执行一次 1）上传解压工具 请将技术支持提供的BI版本管理工具压缩包，上传至工程所在服务器 请上传至有操作权限的目录下并解压，本示例上传至/home/bi目录下 cd /home/bi unzip fine-bi-version-manager-linux.zip
2）启动工具 进入「BI版本管理工具」bin目录下，执行启动语句 cd /home/bi/fine-bi-version-manager-linux/bin/ ./start-version-manager.sh 3）确认工程是否关闭
4）选择工程路径 请输入待升级工程的webroot路径，请输入绝对路径，敲击回车键继续 5）检测是否存在不兼容JAR包 如检测到待升级工程版本为6.0.18及以上，且当前工程存在fdl有用JAR包 提示「6.0.18及之后版本不支持fdl集成，请确认已拆分fdl独立部署」（即准备步骤中的确认FineDataLink适配情况步骤是否已完成）
6）确认执行升级
请耐心等待，直到出现提示「新版工程准备完毕，请启动工程执行升级」，说明JAR包替换成功
|
| 3 | 启动工程 | 请参考 关闭或重启FineBI工程 文档，启动工程节点 如为集群工程，请确保所有工程节点均执行了上一步的升级操作后再启动工程 如为集群工程，请先启动一个节点，等该节点启动成功后，再启动其他的节点，不可以同时启动 |
2.3 升级步骤-Windows
| 步骤 | 说明 | |
|---|---|---|
| 1 | 关闭工程 | 请参考 关闭或重启FineBI工程 文档，关闭单机工程节点/集群每一个工程节点 |
| 2 | 使用「BI版本管理工具」执行换JAR升级 | 本步骤操作，需在单机工程节点/集群每一个工程节点服务器均执行一次 1）上传解压工具 请将技术支持提供的BI版本管理工具压缩包，上传至工程所在服务器 请上传至有操作权限的目录下，例如D盘 请解压获取「BI版本管理工具」 2）启动工具 双击「BI版本管理工具」bin目录下的「start-version-manager.bat」，即可启动该工具
3）确认工程是否关闭
4）选择工程路径 请详细阅读升级须知（即上一节准备步骤相关内容） 请选择待升级工程的webroot文件夹，点击进入下一步
5）检测是否存在不兼容JAR包 如检测到待升级工程版本为6.0.18及以上，且当前工程存在fdl有用JAR包 提示「6.0.18及之后版本不支持fdl集成，请确认已拆分fdl独立部署」（即准备步骤中的确认FineDataLink适配情况步骤是否已完成）
6）确认版本信息 请确认待升级工程版本，是否与预期相同 如目标版本正确，点击「开始替换」，即进入自动升级环节。
7）自动换JAR升级 请耐心等待出现提示「新版本准备完毕」，即为换JAR成功 点击「下一步」
此时将明确列出工程原版本和新版本，并提示「新版工程准备完毕，请启动工程执行升级」，点击「替换完成」，自动关闭BI版本管理工具
|
| 3 | 启动工程 | 请参考 关闭或重启FineBI工程 文档，启动工程节点 如为集群工程，请确保所有工程节点均执行了上一步的升级操作后再启动工程 如为集群工程，请先启动一个节点，等该节点启动成功后，再启动其他的节点，不可以同时启动 |
3. 手动换JAR升级方案
3.1 准备步骤
| 步骤 | 说明 | |
|---|---|---|
| 1 | 了解升级注意事项 | 请在升级前，认真查看升级注意事项，确保了解各个版本的兼容问题：FineBI小版本升级注意事项 |
| 2 | 备份工程 | 在进行工程升级前，为避免升级失败，导致工程文件丢失无法回退等问题，请务必对原工程进行备份后再进行后续操作 请参考 工程备份还原方案 3.1节，对工程进行备份 |
| 3 | 确认FineReport适配情况（没有可忽略） | 1）集成的FineReport 如为FineBI与FineReport集成工程，升级FineBI即可，其中包含FineReport相关JAR，无需再单独升级FineReport 2）独立匹配使用的FineReport 如有完全独立部署、需要匹配使用的独立FineReport工程，请在升级前确认版本匹配情况：FineReport版本适配说明 |
| 4 | 确认FineDataLink适配情况（没有可忽略） | 1）集成的FineDataLink FineBI6.0.18 版本开始，不再内置 FineDataLink 相关功能依赖的 JAR 包，升级后不再支持两者集成 如为FineBI与FineDataLink集成工程，如需升级至FineBI6.0.18及以上版本，请在升级前联系FineDataLink客户成功，进行FineDataLink独立部署 2）独立匹配使用的FineDataLink 如有完全独立部署、需要匹配使用的独立FineDataLink工程，请在升级前确认版本匹配情况：FineDataLink版本适配说明 |
| 5 | 获取升级JAR包 | 用户可以安装最新版本 FineBI 后，在安装目录 %FineBI_Home%/webapps/webroot/WEB-INF/lib 下拷贝获取最新版本 JAR 包。 |
3.2 升级步骤
| 步骤 | 说明 | |
|---|---|---|
| 1 | 关闭工程 | 请参考 关闭或重启FineBI工程 文档，关闭单机工程节点/集群每一个工程节点 |
| 2 | 删除冗余JAR包 | 请删除单机工程节点/集群每一个工程节点/webapps/webroot/WEB-INF/lib下，以下两类文件：
|
| 3 | 删除impl文件 | 请删除单机工程节点/集群每一个工程节点/webapps/webroot/WEB-INF/classes/com/fr/data下impl文件夹中的所有文件（不存在可忽略） |
| 4 | 替换升级JAR包 | 请将准备步骤获取的JAR包，上传覆盖更新到单机工程节点/集群每一个工程节点/webapps/webroot/WEB-INF/lib下 |
| 5 | 启动工程 | 请参考 关闭或重启FineBI工程 文档，启动工程节点 如为集群工程，需要先启动一个节点，等该节点启动成功后，再启动其他的节点，不可以同时启动 |
4. 升级后操作
4.1 检查升级是否成功
管理员登录FineBI系统，点击「管理系统>注册管理>版本信息」。
可查看当前JAR版本，确认是否是自己所需的工程版本。如下图所示：
4.2 升级插件
工程升级完成后，建议登录FineBI系统，点击「系统管理>插件管理」，对存在新版本的插件一一进行升级。
4.3 更新数据
工程升级完成后，建议登录FineBI系统，点击常用数据集进行数据更新验证数据集更新是否可用以及更新后数据是否准确。
4.4 用户登录
工程升级完成后，建议分别使用超管和普通用户账号，依次登录FineBI系统，查看是否能正常登录，确保升级成功。
上一篇：FineBI版本升级简介
