JDK 升级及注意事项

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

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

2.1 检查当前 JDK 版本

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

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

注：要求 JDK 大版本为 1.8 的前提下，小版本需在 JDK8u102 以上；需下载 64 位的 JDK 。

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

2）关闭工程。

2.3 Tomcat 指定 JDK

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

2.4 检测 JDK 是否升级

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

2.5 拷贝 tools.jar

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

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

2）重启工程即可。

3.1 检查当前 JDK 版本

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

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路径，根据实际值修改

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路径，根据实际值修改

3.4 检测 JDK 是否升级

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

3.5 拷贝 tools.jar

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

2）重启工程即可，具体步骤请参见：重启部署在 Tomcat 容器中的工程

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

问题描述

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

原因分析

外接数据库（MySQL）无法连接，ssl 安全验证问题。

解决方案

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

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 即可正常连接。如下图所示：

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

问题描述

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

解决方案

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