历史版本4 :JDK 升级及注意事项 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

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

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

2. Windows 系统编辑

2.1 检查当前 JDK 版本

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

1631929336583423.png

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

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

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

2)关闭工程。

2.3 Tomcat 指定 JDK

进入%TOMCAT_HOME%\bin路径下,修改catalina.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 路径,根据实际情况修改

1631929631464130.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 以上。

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

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

3.3 Tomcat 指定 JDK

进入%TOMCAT_HOME%\bin路径下,修改catalina.sh文件,指定 JAVA_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对应的值根据实际情况修改

1631928466525015.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 后,BI 启动一闪而过

问题描述

升级 JDK 后,无法启动 FineBI 。

解决方案

用户下载的是 32 位的 JDK ,更换 64 位的即可。

4.3 升级 JDK 后,https 配置失败

问题描述

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

原因分析

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

解决方案

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

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

问题描述

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

原因分析

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

解决方案

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

1631931479271306.png

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

问题描述

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

解决方案

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