［单机］5.X-6.0.5升级

1.1 功能介绍

帮助用户顺利从 5.1 升级到 6.0 BI工程。

1.2 升级流程

1）阅读 6.0 升级兼容：6.0 兼容说明

FineBI 对产品进行了持续优化升级，2022 年 6.0 版本全新来袭。了解从 5.1 到 6.0 有哪些变化。

2）进行升级前检测：升级前检测

对 5.1 工程进行备份、检测升级风险项和修复。

3）若您是未联系帆软销售经理的个人用户，可致电 400-8118890 转1 与帆软商务联系获取相关资讯；

若您已与帆软销售经理有对接，可前往「服务平台>在线支持」联系 FineBI 技术支持获取升级工具和帮助。

3.1 关闭BI工程

1）关闭BI工程。

常见问题：Windows系统直接关闭工程后，往往防宕机插件进程还在，会导致升级过程替换 jar 失败，从而升级失败。

处理方法：1）进入cmd；2）输入 jps ，查看是否有名字为 Operation 的进程；3）如果有，输入taskkill /f /pid %pid%，杀掉名字为Operation的进程。如下图所示：

验证是否完全关闭的方法：修改%FineBI%\webapps\webroot\WEB-INF下的 lib 文件的文件名称，能修改，则说明工程已经完成关闭。（修改后要记得名字改回来）

3.2 解压升级工具

1）解压升级工具；

2）修改内存

进入fine-bi-upgrade-windows\bin目录下，编辑JvmConfig.properties文件，修改增加 内存 。如果不修改，默认内存是机器内存的 1/4 。

注1：升级工具需要根据 BI 工程实际情况修改内存。升级工具运行内存至少 12 G，最好是 BI 工程配置内存的1.5倍，具体可根据服务器可用内存设置。

注2：修改配置文件，需要将“#”号去掉，否则配置是注释的状态，没有真正生效。

3.3 执行升级

1）双击start-upgrade.bat，运行工具。选择工程「已关闭」后，才能选择「下一步」。如下图所示：

2）选择工程路径：%FineBI%\webapps\webroot（工程路径选到webroot）后，点击「开始检测」。如下图所示：

3）进入检测界面，检测期间「下一步」按钮灰化，检测完成后，点击「下一步」。如下图所示：

4）点击下一步后，进入模式选择界面，选择模式后，点击“开始升级”，模式选择介绍见附录。

5）等待升级完成，升级完成后，点击「下一步」。如下图所示：

注：此过程时长跟配置库大小和配置库性能有关，只要界面上没有报错，可以继续等待。

6）完成升级。界面如下图所示：

3.4 查看升级报告

升级日志：在fine-bi-upgrade-windows\logs路径下的 upgrade.log 文件；

升级过程检测到的风险项：在fine-bi-upgrade-windows\exports下。详情见：升级后导出的风险项说明

3.5 启动工程

1）工程启动后，访问工程自动进入界面如下图所示，必须点击「立即全局更新」。如下图所示：

2）点击后会触发所有配置了随父表更新的自助数据集的更新，等待更新完成。如下图所示：

更新完成之前，访问任何工程 url 都会跳转到此页面，直到更新完成，方可正常访问工程。

注：只更新自助数据集，不会更新基础表。

1）关闭 BI 工程。

2）解压升级工具，进入fine-bi-upgrade-linux\bin目录下，编辑JvmConfig.properties文件，修改增加 内存。如果不修改，默认内存是机器内存的 1/4 。

注：升级工具需要根据 BI 工程实际情况修改内存。升级工具运行内存至少 12 G，最好是 BI 工程配置内存的1.5倍，具体可根据服务器可用内存设置。

3）移动到fine-bi-upgrade-linux\bin目录下，输入命令，运行升级工具；输入 2 并回车，运行升级工具。如下图所示：

./start-upgrade.sh

4）选择工程路径：%FineBI%\webapps\webroot（工程路径选到webroot）后，回车，开始检测。如下图所示：

注：检测进度条可能出现显示异常，可能是连接远程服务器的工具版本导致。但不影响检测，检测完毕后会自动展示下一步。

5）检测完成后，选择模式，输入数字，回车。如下图所示：

6）开始升级，等待升级进度条结束；

注：检测进度条可能出现显示异常，可能是连接远程服务器的工具版本导致。但不影响检测，检测完毕后会自动展示下一步。

7）查看升级报告

升级日志：在fine-bi-upgrade-linux\logs路径下的 upgrade.log 文件；

升级过程检测到的风险项：在fine-bi-upgrade-linux\exports下。详情见：升级后导出的风险项说明

8）启动工程

启动工程后，点击「立即全局更新」。操作同本文 3.5 节。

升级模式有 4 种，选择升级到 6.0 ，直连和抽取业务包的区分策略。详情如下：

模式	模式说明	升级前业务包	升级后业务包
以抽取为主	抽取：业务包结构保留； 直连：业务包收起，在「公共业务包-直连」节点下	抽取数据界面： 直连数据界面：
以直连为主	直连：业务包节构保留； 抽取：业务包收起，在「公共业务包-抽取」节点下
两者都收起	抽取：在「公共业务包-抽取」节点下 直连：在「公共业务包-直连」节点下
两者合并处理	抽取和直连业务包结构保留，合并展示 注：若直连跟抽取重名的分组/业务包，则直连的分组/业务包后加上后缀「直连」