Windows下Tomcat獨立部署FineReport工程

1.1 版本

1.2 應用場景

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

1.3 功能簡介

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

注：

相比於Windows系統，Linux在穩定性、安全性、可客製性和可靠性等方面的優勢，使得它成為推薦的最佳選擇。

因此推薦在Linux系統部署FineReport正式工程：Linux下Tomcat獨立部署FineReport工程

1.4 注意事項

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

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

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

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

• 不支援 Tomcat 10.0 版本。

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

2.1 準備伺服器

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

2.2 安裝JDK

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

2.3 安裝Tomcat

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

3.1 獲取工程檔案

1）付費使用者請聯絡帆軟技術支援獲取對應版本 webroot 工程檔案。技術支援聯絡方式：服務平台>線上支援。

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

3.2 copy工程檔案

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

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

3）解壓壓縮包。

3.3 參數配置（選做）

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

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

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

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

3.4 修改埠號（選做）

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

1）使用語句查看預設 8080 埠號是否被佔用。

netstat -aon|findstr "8080"

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

3.5 啟動Tomcat

1）進入%Tomcat_HOME%\bin目錄。

2）雙擊startup.bat或startup.sh檔案，啟動 Tomcat 伺服器。

注：如果在2.3節安裝Tomcat時，使用exe安裝包而非zip壓縮包進行安裝。

      此時需要雙擊 %Tomcat_HOME%\bin目錄下的 Tomcat.exe檔案啟動 Tomcat 伺服器。

3.6 存取FineReport系統

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

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

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

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

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

問題描述

工程在 Windows 系統中部署成功後，出現卡頓問題，效能較差。

原因分析

Windwos Server 2016 及之後版本中，Windows 對控制台的功能做了一次更新，支援了更多類似於 cmd 視窗的功能。

這些新增的功能，導致在 Server2016 中部署的 Tomcat 以視窗模式啟動的時候，對匯出到控制台的日誌造成了嚴重的效能問題，最終導致效能卡頓。

解決方案一：保留啟動視窗

1）雙擊startup.bat後，在彈出的 Tomcat 視窗上，右鍵點選最上面白色欄，選擇「屬性」，勾選「使用舊版控制台」，點選「確定」。如下圖所示：

2）重啟 Tomcat 工程。

解決方案二：禁用啟動視窗

1）進入%Tomcat_HOME%\bin目錄下，找到setclasspath.bat檔案，將set _RUNJAVA="%JRE_HOME%\bin\java.exe"修改為set _RUNJAVA="%JRE_HOME%\bin\javaw.exe"。如下圖所示：

2）儲存後重啟 Tomcat 工程。

注1：使用 startup.bat 啟動 Tomcat， 命令視窗會一閃而過，但服務已經啟動了。想要存取工程，還需等待 Tomcat 啟動的時間。

注2：這種方式下，想要停止 Tomcat ，只能到工作管理員中殺 java 進程。