1、升级前准备编辑
升级前我们需要准备升级工具及升级文件等，准备如下：
a. 升级工具：
联系帆软技术支持获取升级工具FineBIUpgrade_v5_1_windows_x64.exe，如下图：
b. 升级工程：
在升级前，我们需要确保使用的版本为FineBI4.1，建议使用最新版本的jar包，若版本不一致可参考FineBI升级指南升级。
升级所需4.1工程目录为%FineBI%/webapps/WebReport下的WEB-INF文件夹，如下：（具体为biReport、finedb、resources文件夹下全部内容）
注1：升级工程不要放在C盘里，因为后续的升级工具无法在C盘里创建文件夹。
注2：升级前需要进行全局更新操作，否则可能出现仪表板、业务包中数据集丢失现象。
注3：升级前建议删掉部分不使用的仪表板，否则可能出现升级后无法启动BI的现象。
c. 5.1工程：
若升级的FineBI4.1为exe安装版本，则需要准备一个单独安装的5.1exe工程，5.1的安装可参考FineBI安装与启动；
若升级的FineBI4.1为Web容器部署，则不需要另外安装5.1，此步骤不需准备；
d. 其他说明：
若工程为从低版本先升级为的4.1版本，建议使用该版本启动一次，正常关闭后再开始后续的升级操作；
2、升级工具操作编辑
a. 使用升级工具：
1）双击执行升级工具FineBIUpgrade_v5_1_windows_x64.exe，进入语言选择界面，如下图，选择语言：中文（简体）并点击确定;
2）进入工程文件夹选择界面，选择第一章节准备的升级工程所在目录。需要是包含WEB-INF的文件夹，通常为WebReport，如下图：
注：如果非Tomcat部署或WebReport名称有修改，则路径指定为包含WEB-INF的上级目录。
3）点击下一步进入工程备份路径选择。选择任意的路径备份即可，如下图，我们选择一个文件夹备份。
注：备份会将WebReport目录下所有的文件全部进行备份，通常情况下长时间使用的系统，WebReport下的cubes文件夹、backup文件夹以及WEB-INF/resources/backup文件夹都会很多，建议删除或者移除之后进行升级可以加快升级速度。
4）点击下一步即出现升级前的提醒，在升级过程中不要关闭升级程序，且不要对原工程做任何编辑修改；
5）确定后点击下一步，即进入备份升级界面。升级工具会先将工程备份到上述设置的备份目录，随即再开始工程的升级，如下图：
6）升级完成后，点击完成按钮退出升级程序。
7）至此，升级工具的升级操作全部完成。升级后的工程WEB-INF文件夹如下图所示：
且升级后的WebReport目录下会生成升级检测报告，如下图：
b. 替换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任一位置后，再启动。否则会启动不成功。
c. 启动验证：
进入5.1工程目录%FineBI%/bin下，双击finebi.exe启动工程验证升级是否成功，若能成功启动进入数据决策系统，则表示升级成功。
3、升级核对和调整编辑
4、日志说明编辑
Windows：
Windows系统下执行升级工具后，在升级工具所在目录下会生成error.log，为执行升级过程的日志。如下图：
工程日志：
5.1工程的执行日志为：%FineBI%/logs/fanruan.log，且Windows和Linux系统均为该日志。若升级后，工程无法启动等情况时，可查看该日志。
5、升级常见问题编辑
1）Q：在执行升级工具时，提示该工程已经升级过，但实际并未升级？
A：可进入升级工程目录../WebReport/WEB-INF下，将embed文件夹删除，再执行升级工具；
7）Q：升级过程中遇到分布式ContextManager初始化失败，报错为 java.lang.NoClassDefFoundError: Could not initialize class com.finebi.spider.cluster.spark.ContextManager？
A：检查是否升级工具运行的环境没有配置hostname，这里分布式初始化失败了。Windows和Linux均可以使用命令hostname查看，若没有配置，为其配置hostname后，再重新升级；
注：除上述所列问题外，若在升级过程中有其他问题，请联系帆软技术支持并提供升级日志；若在升级后有问题，请联系帆软技术支持并提供升级日志及工程日志。