Linux下Tomcat獨立部署FineReport工程

1.1 版本

1.2 應用場景

Tomcat 是免費且效能相對穩定的 Web 應用伺服器，在許多中小型企業中深受歡迎。

1.3 功能簡介

本文介紹在 Linux 系統中，如何將 FineReport 工程部署到 Tomcat 容器中。

注：相比於傳統部署架構，容器化部署具有隔離性、可攜性、靈活性、可伸縮性和可控性等優點，可大幅降低企業的維護成本和資源成本。

       推薦使用更具優勢的容器化部署方案：部署新項目-FineReport

1.4 注意事項

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

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

• 同一個 Tomcat 伺服器中不能部署多個 FineReport 工程

• JDK 版本需為 1.8 且小版本需在 JDK8u102 以上。

• 不支援 Tomcat 10.0 版本。

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

2.1 準備伺服器

請根據工程「使用者數」維度，準備合適的伺服器環境：工程部署推薦環境及配置

2.2 安裝JDK

獨立部署時，使用者需要單獨準備 JDK 。

2.3 安裝Tomcat

獨立部署時，使用者需要單獨準備 Tomcat 。

1）下載安裝Tomcat

3.1 獲取工程檔案

1）付費使用者請聯絡帆軟技術支援獲取對應版本 webroot 工程檔案。技術支援聯絡方式：帆軟官方服務渠道使用説明 。

2）免費使用者請參考 設計器安裝，安裝設計器後，%FR_HOME%\webapps目錄下的 webroot 資料夾即為所需的工程檔案。

3.2 copy工程檔案

1）壓縮上一節 webroot 資料夾。

2）將壓縮包上傳至伺服器%Tomcat_HOME%\webapps目錄下。

3）解壓壓縮包。

cd /data/tomcat/webapps

unzip webroot.zip

3.3 參數配置（選做）

FineReport工程部署到應用伺服器上時，對應用伺服器有一定的配置要求。

如果應用伺服器不能滿足工程使用時，會出現當機風險。

建議在啟動 Tomcat 伺服器前，對參數進行配置，詳情請參見：維運監視指導手冊 。

注：重點是「Java 虛擬機檢查」相關的配置項，其他內容建議在啟動工程後逐一確認。

3.4 修改埠號（選做）

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

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

netstat  -anp  |grep 8080

2）若被佔用，需要修改 Tomcat 埠號。詳情請參見 修改Tomcat埠號

3.5 啟動Tomcat

1）進入bin目錄（根據目錄自行修改）

cd /data/tomcat/bin

2）啟動 Tomcat

./startup.sh

3）查看實時日誌，實時日誌中出現重啟耗時則意味着啟動成功。

cd /data/tomcat/logs

tail -f catalina.out

注：啟動 Tomcat 後，如果報錯「Database is not initialized」，請檢查下使用者讀寫權限，可使用命令chmod -R 777 tomcat配置權限。

3.6 存取FineReport系統

在瀏覽器中輸入存取地址http://IP:埠號/工程名/decision，開啟FineReport初始化配置頁面，即部署成功。如下圖所示：

注1：存取地址由「伺服器 IP+ 埠 + 工程檔案名稱 +decision」組成。

      Tomcat 預設埠號為 8080，工程名預設為webroot。

注2：平台登入的帳號和密碼是3.1節copy的工程的。若該工程從未登入過，則直接進入初始化配置介面。

部署常見問題請參見：Tomcat部署問題匯總