升级前我们需要准备升级工具及升级文件等，准备如下：

1.1 升级工程

在升级前，我们需要确保使用的版本为 FineBI4.1 ，建议使用最新版本的 jar 包，若版本不一致可参考FineBI升级指南升级；

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

1.2 准备5.1工程

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

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

1.3 安装JDK

在 Linux 系统中 安装JDK1.8版本，因 FineBI5.1 支持的 JDK 版本如下：JDK1.8 （32 位：Oracle；64 位：Oracle、IBM J9）

1.4 其他说明

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

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

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

1.5 使用升级工具进行检测

1）联系帆软技术支持（QQ：800049425）获取 Linux 版本升级工具 FineBIUpgrade_v5_1_linux.sh，如下图所示：

2）进入升级工具文件所在目录，先给文件赋权限，使用命令如下：

chmod 777 FineBIUpgrade_v5_1_linux.sh

3）使用如下命令执行升级工具：

./FineBIUpgrade_v5_1_linux.sh 2>&1 | tee mylog.log

注：此处升级日志将重定向至文件，建议使用该命令。

4）选择一种语言，此处我们选择中文（简体），输入 1 并按回车键，如下图所示：

5）选择升级工程所在目录，输入第一章节准备的升级工程所在目录。需要是包含 WEB-INF 的文件夹，通常为 WebReport ，如下图所示：

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

6）是否选择升级，输入 n 并按回车键，如下图所示：

7）系统自动在已选择的升级工程目录下方生成 Excel 文件「upgrade-report.xlsx 」，在%FineBI4.1%\webapps\WebReport\WEB-INF里生成「embed」文件。

8）查看「upgrade-report.xlsx 」的检测结果，由帆软技术支持（QQ：800049425）评估是否可以平滑升级。

2.1 使用升级工具进行升级

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

1）关闭 FineBI。

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

3）重新双击打开升级工具，执行本章 1.5 节1前五步步骤，在是否执行升级配置下并输入 y 并按回车键，如下图所示：

4）输入工程备份文件夹，可以为任意的路径备份。如下图，输入想要备份的目录并敲击回车键。

5）随即进入工程备份及升级阶段，在升级过程中会输出日志（使用第二步骤重定向的命名，该日志将直接打印至 mylog.log 中），如下图所示：

注：此处在升级过程中，不能关闭升级程序，且不能对升级工程做任何修改。

6）在升级快结束阶段会进行环境检查，并提示环境检查结果。比如检测端口占用等，需要手动关闭占用端口的程序后续才能成功启动升级后的工程；

升级成功后，会提示升级完成，如下图所示：

7）升级后的工程WEB-INF文件夹如下图所示：

且升级后的WebReport目录下会生成升级日志：mylog.log

2.2 替换5.1工程

进入升级好的 4.1工程下，将 WEB-INF 文件夹拷贝至安装好的 5.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 启动工程验证升级是否成功，若能成功启动进入数据决策系统，则表示升级成功。

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

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

升级工具日志：

Linux系统中执行升级工具若不使用重定向，日志会直接输出在终端中；而在上述介绍命令./FineBIUpgrade_v5_1_linux.sh 2>&1 | tee mylog.log将其重定向到文件中，升级日志即为mylog.log。

工程日志：

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

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

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

2）Q：Linux下执行检测/升级工具报错sun.font.CompositeFont.getSlotFont，如下图：           

      A：该报错与Linux字体有关，可参考此处数组越界异常增加字体解决；

3）Q：Linux下执行升级工具报错 getVersion，如下图：

     A：出现该报错，需首先确认该Linux系统中的JDK版本，需要为JDK1.8版本，若不是需要参考安装JDK1.8版本安装；

          其次需要确认系统环境变量的配置是否正确，包括JAVA_HOME、JRE_HOME、CLASSPATH、JAVA_PATH、PATH等；

          此外，export LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/amd64 类似这样的链接库path也需要配置。

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

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

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