4.1-5.1升级操作(Windows)

编辑
  • 文档创建者:doreen0813
  • 浏览次数:10259次
  • 编辑次数:15次
  • 最近更新:doreen0813 于 2019-04-15
  • 1、升级前准备

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

    a. 升级工具:

        联系帆软技术支持获取升级工具FineBIUpgrade_v5_1_windows_x64.exe,如下图:

        

    b. 升级工程:

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

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

        

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

    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.1升级到5.1不兼容的部分做一些效果调整。具体可根据升级后获取的升级检测报告中详细兼容问题列表进行调整,如下图:

              

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

    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后,再重新升级;


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


    附件列表


    主题: 入门指南
    标签: 暂无标签 编辑/添加标签
    如果您认为本文档还有待完善,请编辑

    文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
    关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
    若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

    此页面有帮助吗?只是浏览 [ 去社区提问 ]