1. 升级前准备编辑
1.1 升级工程
在升级前,我们需要确保使用的版本为 FineBI4.1,建议使用最新版本的 jar 包,若版本不一致可参考 FineBI升级指南 升级。
升级所需 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 使用升级工具进行检测
联系帆软技术支持(QQ:800049425)获取升级工具FineBIUpgrade_v5_1_windows_x64.exe,如下图所示:
1)双击执行升级工具 FineBIUpgrade_v5_1_windows_x64.exe,进入语言选择界面,如下图,选择语言:中文(简体)并点击确定 。
2)选择升级工程所在目录,通常为%FineBI4.1%\webapps\WebReport,不勾选是否升级配置,点击下一步,如下图所示:
注:如果非Tomcat部署或WebReport名称有修改,则路径指定为包含WEB-INF的上级目录。
3)系统自动在上一步选择的目录下方生成 Excel 文件「升级检测报告」,在%FineBI4.1%\webapps\WebReport\WEB-INF里生成「embed」文件。
4)查看「升级检测报告」,查看检测结果,由帆软技术支持评估是否可以平滑升级。
2. 升级操作编辑
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 启动工程验证升级是否成功,若能成功启动进入数据决策系统,则表示升级成功。
3. 升级核对和调整编辑
4. 日志说明编辑
Windows:
Windows系统下执行升级工具后,在升级工具所在目录下会生成error.log,为执行升级过程的日志。如下图所示:
工程日志:
5.1工程的执行日志为:%FineBI%/logs/fanruan.log,且Windows和Linux系统均为该日志。若升级后,工程无法启动等情况时,可查看该日志。
5. 升级常见问题编辑
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 后,再重新升级;
注:除上述所列问题外,若在升级过程中有其他问题,请联系帆软技术支持(QQ:800049425)并提供升级日志;若在升级后有问题,请联系帆软技术支持并提供升级日志及工程日志。