Linux下Tomcat伺服器獨立部署

1.1 版本

注：同一個 Tomcat 伺服器中不能部署多個 FineBI 工程。

1.2 預期效果

使用者希望將 FineBI 報表工程部署到 Linux 系統上的 Tomcat 中，效果如下圖所示

1.3 環境準備

使用者需要提前在 Linux 系統下安裝 JDK 和 Tomcat，具體的安裝方法可以自行查閱資料，文檔和技術支援不負責環境搭建部分的內容。

注：安裝的 JDK 版本一定要與工件系統匹配，64 位工件系統可以安裝 32 位的 JDK ，但是 FineBI 不支援這樣的操作，必須保持統一。

1.4 實現思路

1）將本地工程的 webroot 資料夾以壓縮包形式上傳到 Tomcat 伺服器的%TOMCAT_HOME%\webapps下，並解壓。

2）將 tools.jar 檔案放到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。

3）重啓 Tomcat 伺服器，存取報表工程位址即可。

本文以 CentOS7+JDK1.8+Tomcat9.0.44 為例進行示範，其他版本命令可能略有差別，請自行處理。

2.1 上傳 webroot 檔案至 Tomcat 環境中

1）將本地 FineBI 工程的 webroot 資料夾壓縮，將壓縮包上傳至%TOMCAT_HOME%\webapps下，可以透過 WinSCP／FTP 等軟體上傳。如下圖所示：

注：不推薦直接上傳資料夾，防止檔案出現問題。

2）上傳完成後，解壓壓縮包，代碼如下所示：

cd /usr/BI/apache-tomcat-9.0.44/webapps
unzip webroot.zip

2.2 引入 JDK 中的 tools.jar 檔案

將%JAVA_HOME%\jdk\lib下的 tools.jar copy到部署的伺服器中，copy到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。

代碼如下所示：

cp /usr/java/jdk1.8.0_241-amd64/lib/tools.jar /usr/BI/apache-tomcat-9.0.44/lib

2.3 應答是否修改埠號

若 Linux 系統中有多個 Tomcat 同時運作，需要應答預設 8080 埠號是否被佔用；若 Linux 系統之前沒有部署過工程，可忽略該節內容。

1）查看預設 8080 埠號是否被佔用，下圖為被佔用情況。

netstat  -anp  |grep 8080

2）若被佔用，需要修改 Tomcat 埠號。具體方法請參見 Tomcat 埠配置 

2.4 配置參數

2.4.1 配置 BI 使用記憶體參數

FineBI 對伺服器有一定的配置要求，因此需要配置記憶體參數保證伺服器穩定，詳情參見：修改 FineBI 配置參數 

注：修改 FineBI 配置參數 5.1 節的 headless 參數若不配置，超管 匯出 Excel 時，將會報錯：無匯出權限。

2.4.2 配置 dump JVM 參數

此處需要為工程配置上當機自動生成 dump 日誌的 JVM 參數，配置該參數對工程運作沒有效能損耗的影響，僅用於在伺服器當機時生成 dump 日誌。

進入%TOMCAT_HOME%/bin目錄下，編輯配置檔案 catalina.sh ，增加如下 JVM 參數：

JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError"
JAVA_OPTS="$JAVA_OPTS -XX:HeapDumpPath=/opt/"   

注：其中 /opt/ 路徑表示的是當機檔案生成路徑，可以根據需要修改檔案路徑。修改儲存後，需要重啓 Tomcat 才能使配置生效。

如下圖所示：

2.5 啟動 Tomcat

注：Linux 系統中關閉與重啓部署在 Tomcat 中的 BI 工程，可參見 關閉FineBI工程

執行語句如下所示：

cd /usr/BI/apache-tomcat-9.0.44/bin  # 進入bin目錄
./startup.sh  # 啟動 Tomcat

2.6 效果查看

啟動瀏覽器，在位址欄輸入：http://ip:伺服器埠號/工程名/decision，如下圖所示：