4.1-5.1版本升级指南（Windows）

1.1 升级工程

升级版本确认及每个版本对应的文档索引参见：FineBI 版本说明

在升级前，我们需要确保使用的版本为 FineBI4.1，建议使用最新版本的 jar 包。

升级所需 4.1 工程目录为%FineBI%/webapps/WebReport下的WEB-INF文件夹，如下：（具体为 biReport、finedb、resources 文件夹下全部内容）

注1：升级工程不要放在 C 盘里，因为后续的升级工具无法在 C 盘里创建文件夹。 

注2：升级前需要进行全局更新操作，否则可能出现仪表板、业务包中数据集丢失现象。

注3：升级前建议删掉部分不使用的仪表板，否则可能出现升级后无法启动BI的现象。

1.2 准备5.1工程

若升级的 FineBI4.1 为 exe 安装版本，则需要准备一个单独安装的 5.1exe 工程，5.1 的安装可参考FineBI安装与启动；

若升级的 FineBI4.1 为 Web 容器部署，则不需要另外安装 5.1，此步骤不需准备。

1.3 其他说明

若工程为从低版本先升级为的 4.1 版本，建议使用该版本启动一次，正常关闭后再开始后续的升级操作。

1.4 使用升级工具进行检测

联系帆软技术支持请前往 【服务平台>在线支持】，获取升级工具FineBIUpgrade_v5_1_windows_x64.exe，如下图所示：

1）双击执行升级工具 FineBIUpgrade_v5_1_windows_x64.exe，进入语言选择界面，如下图，选择语言：中文（简体）并点击「确定」。

2）选择升级工程所在目录，通常为%FineBI4.1%\webapps\WebReport，取消勾选「是否升级配置」，点击「下一步」，如下图所示： 

注：如果非 Tomcat 部署或 WebReport 名称有修改，则路径指定为包含 WEB-INF 的上级目录。

3）进入升级提示界面，点击「下一步」，如下图所示：

4）结束点击「完成」，生成检测报告，如下图所示：

5）系统自动在安装升级时选择的目录下方生成 Excel 文件「升级检测报告」，并在%FineBI4.1%\webapps\WebReport\WEB-INF里生成「embed」文件。

6）点击查看「升级检测报告」的检测结果，由帆软技术支持评估是否可以平滑升级。

2.1 使用升级工具进行升级

若是查看「升级检测报告」后可以升级，则可以进行升级步骤。

1）删除%FineBI4.1%\webapps\WebReport\WEB-INF下检测时生成「embed」文件。

2）重新双击打开升级检测工具 FineBIUpgrade_v5_1_windows_x64.exe 。同本文 1.4 节选择升级工程所在目录，勾选「是否执行升级配置 」，如下图所示：

3）点击「下一步」进入工程备份路径选择。选择任意的路径备份即可，选择一个文件夹备份。如下图所示：

注：备份会将WebReport目录下所有的文件全部进行备份，通常情况下长时间使用的系统，WebReport下的cubes文件夹、backup文件夹以及WEB-INF/resources/backup文件夹都会很多，建议删除或者移除之后进行升级可以加快升级速度。

4）点击「下一步」即出现升级前的提醒，在升级过程中不要关闭升级程序，且不要对原工程做任何编辑修改。如下图所示：

5）确定后点击下一步，即进入备份升级界面。升级工具会先将工程备份到上述设置的备份目录，随即再开始工程的升级，如下图所示：

6）升级完成后，点击完成按钮退出升级程序。如下图所示：

7）至此，升级工具的升级操作全部完成。升级后的工程 WEB-INF 文件夹，如下图所示：

2.2 替换5.1工程

进入升级好的 4.1工程下，将 WEB-INF 文件夹拷贝至安装好的 5.1 工程目录%FineBI5.1%/webapps/webroot/下替换，如下图所示：

注：此处若为Tomcat服务器下的升级，还需要将环境上安装的JDK目录lib下面的tools.jar拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置后，再启动。否则会启动不成功。  

2.3 启动验证

进入5.1工程目录%FineBI%/bin下，双击 finebi.exe 启动工程验证升级是否成功，若能成功启动进入数据决策系统，则表示升级成功。

升级成功后，需要针对 4.1 升级到 5.1 不兼容的部分做一些效果调整。具体可根据升级后获取的升级检测报告中详细兼容问题列表进行调整，如下图所示：

详细兼容说明可参考4.1升级到5.1兼容说明。

4.1 升级日志

Windows系统下执行升级工具后，在升级工具所在目录下会生成error.log，为执行升级过程的日志。如下图所示：

4.2 工程日志

5.1工程的执行日志为：%FineBI%/logs/fanruan.log，且 Windows 和 Linux 系统均为该日志。若升级后，工程无法启动等情况时，可查看该日志。

1）Q：在执行升级工具时，提示该工程已经升级过，但实际并未升级？

     A：可进入升级工程目录../WebReport/WEB-INF下，将 embed 文件夹删除，再执行升级工具；

2）Q：升级过程中遇到分布式ContextManager初始化失败，报错为  java.lang.NoClassDefFoundError: Could not initialize class com.finebi.spider.cluster.spark.ContextManager？

     A：检查是否升级工具运行的环境没有配置 hostname ，这里分布式初始化失败了。Windows 和 Linux 均可以使用命令hostname查看，若没有配置，为其配置 hostname 后，再重新升级。

注：除上述所列问题外，若在升级过程中有其他问题，请联系帆软技术支持请前往 【服务平台>在线支持】并提供升级日志；若在升级后有问题，请联系帆软技术支持并提供升级日志及工程日志。