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 copy tools.jar

1）將新下載 Java 路徑下%JAVA_HOME%\jdk\lib下的 tools.jar copy到%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 copy tools.jar

1）將新下載 Java 路徑下%JAVA_HOME%\jdk\lib下的 tools.jar copy到%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 重新匯出憑證，參考文檔配置即可：Tomcat配置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伺服器部署