反馈已提交

网络繁忙

您好,只有最新版本的6.X支持在线编辑修改,如果想创建/编辑文档,请移步到 *最新版本*

JDK 升级及注意事项

  • 文档创建者:Wendy123456
  • 历史版本:8
  • 最近更新:Leo.Tsai 于 2022-07-04
  • 1. 概述

    FineBI 在 Tomcat 中部署时,要求 JDK 大版本为 1.8 的前提下,小版本需在 JDK8u102 以上。部分用户升级 JAR 时可能需要同时升级 JDK 版本,可参考本文方法。

    注1:所有帆软产品内置的 JDK 都为 OpenJDK 。

    注2:本文适用于已安装配置 JDK ,需要升级 JDK 的情况。

    2. Windows 系统

    2.1 检查当前 JDK 版本

    cmd 命令行进入%Tomcat_home%\bin路径下,输入:version,如下图所示:

    1631929336583423.png

    2.2 下载 JDK8u102 以上版本并关闭工程

    注:要求 JDK 大版本为 1.8 的前提下,小版本需在 JDK8u102 以上;需下载 64 位的 JDK 。

    1)用户根据实际情况下载合适的 JDK 版本,进行安装,具体安装步骤请自行百度,无需配置环境变量。

    2)关闭工程。

    2.3 Tomcat 指定 JDK

    进入%TOMCAT_HOME%\bin路径下,修改catalina.batsetclasspath.bat文件,指定 JAVA_HOME、JRE_HOME 路径。如下图所示:

    注:JAVA_HOME、JRE_HOME 值为新下载的 JAVA_HOME、JRE_HOME 路径。

    set JAVA_HOME=E:\Java\jdk1.8.0_152 #JDK 路径,根据实际情况修改
    set JRE_HOME=E:\Java\jre1.8.0_152 #JRE 路径,根据实际情况修改

    1631949969681371.png

    1631949912155116.png

    2.4 检测 JDK 是否升级

    cmd 命令行进入%Tomcat_home%\bin路径下,输入:version,如下图所示:

    1631929854937159.png

    2.5 拷贝 tools.jar

    1)将新下载 Java 路径下%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%\lib%Tomcat_home%\webapps\webroot\WEB-INF

    \lib任一位置下。如下图所示:

    1631858160750682.png

    2)重启工程即可。

    3. Linux 系统

    3.1 检查当前 JDK 版本

    进入%TOMCAT_HOME%\bin路径下,输入:./version.sh,可查看当前工程使用的 JDK 版本。如下图所示:

    1631928012155855.png

    3.2 下载 JDK8u102 以上版本并关闭工程

    注:要求 JDK 大版本为 1.8 的前提下,小版本需在 JDK8u102 以上;需下载 64 位的 JDK 。

    1)用户根据实际情况下载合适的 JDK 版本,进行解压,具体安装步骤请自行百度。

    2)关闭工程,具体步骤请参见:关闭部署在 Tomcat 容器中的工程

    3.3 Tomcat 指定 JDK

    1)进入%TOMCAT_HOME%\bin路径下,修改catalina.sh文件,指定 JAVA_HOME、JRE_HOME 路径。如下图所示:

    注:JAVA_HOME 的值,为新下载的 JDK 路径。

    cd /opt/BIduli/apache-tomcat-9.0.53/bin #进入Tomcat的bin路径下,根据实际情况修改
    vi catalina.sh #修改catalina.sh文件
    export JAVA_HOME=/usr/java/jdk1.8.0_281 #指定JDK路径,JAVA_HOME对应的值根据实际情况修改
    export JRE_HOME=/usr/java/jdk1.8.0_281/jre #指定JRE路径,根据实际值修改

    1631950563447737.png

    2)进入%TOMCAT_HOME%\bin路径下,修改setclasspath.sh文件,指定 JAVA_HOME、JRE_HOME 路径。如下图所示:

    cd /opt/BIduli/apache-tomcat-9.0.53/bin #进入Tomcat的bin路径下,根据实际情况修改
    vi setclasspath.sh #修改setclasspath.sh文件
    export JAVA_HOME=/usr/java/jdk1.8.0_281 #指定JDK路径,JAVA_HOME对应的值根据实际情况修改
    export JRE_HOME=/usr/java/jdk1.8.0_281/jre #指定JRE路径,根据实际值修改

    1631950799371832.png

    3.4 检测 JDK 是否升级

    进入%TOMCAT_HOME%\bin路径下,输入:./version.sh,可查看当前工程使用的 JDK 版本。如下图所示:

    1631928763853281.png

    3.5 拷贝 tools.jar

    1)将新下载 Java 路径下%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%\lib%Tomcat_home%\webapps\webroot\WEB-INF\lib任一位置下。如下图所示:

    1631929054669046.png

    2)重启工程即可,具体步骤请参见:重启部署在 Tomcat 容器中的工程

    4. 注意事项

    4.1 升级 JDK 后,BI 无法启动,报错 No appropriate protocol

    问题描述

    JDK 升级后,FineBI 无法启动,报错:javax.net.ssl.SSLHandshakeException: No appropriate protocol

    原因分析

    外接数据库(MySQL)无法连接,ssl 安全验证问题。

    解决方案

    在部署向导页面中修改 jdbcUrl ,在其后面加useSSL=false后运行正常。

    1631930705119666.png

    4.2 升级 JDK 后,https 配置失败

    问题描述

    JDK 升级后,之前配置的 https 失败。

    原因分析

    客户的证书不是和 Tomcat 的 JDK 同版本的 JDK 导出的。

    解决方案

    用 Tomcat 依赖的 JDK 重新导出证书,参考文档配置即可:配置 SSL 证书实现 HTTPS 访问

    4.3 JDK 升级后,配置 SQLServer 外接数据库失败

    问题描述

    配置外接数据库连接失败,提示:驱动程序无法通过使用安全套接字层(SSL)加密与 SQL Server 建立安全连接

    原因分析

    JDK 新版本增加加密套件导致。

    解决方案

    打开%JAVA_HOME%\jre\lib\security\java.security文件,将3DES_EDE_CBC删除或者注释掉,保存重启 FineBI 即可正常连接。如下图所示:

    1631931479271306.png

    4.4 升级 JDK 后,新部署的 Weblogic 启动失败

    问题描述

    升级 JDK 后,新部署的 Weblogic 启动失败。

    解决方案

    按照帮助文档删除需要的 jar 包,列如 org.slf4j.jdk*.jar,具体请参见:Weblogic服务器部署

    附件列表


    主题: 部署集成
    已经是第一篇
    已经是最后一篇
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    在线QQ(将在2023.01.03关停):800049425

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭