Windows下Tomcat容器獨立部署BI工程

1.1 版本

1.2 應用場景

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

1.3 功能簡介

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

注：

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

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

因此推薦在Linux系統使用更具優勢的容器化部署方案部署FineReport正式工程：部署新項目-FineBI

1.4 注意事項

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

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

• 不支援 32 位的作業系統。

• 不支援 Tomcat 10.0 版本。

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

2.1 準備服務器

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

不支援部署在 Windows32 位作業系統上。

2.2 安裝JDK

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

1）下載安裝JDK

2）檢查JDK是否安裝成功

按住「Win+R」鍵，輸入「cmd」，呼叫命令終端。

輸入 java -version 和javac ，出現如下則表示 JDK 安裝成功：

2.3 安裝Tomcat

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

1）下載安裝Tomcat

2）檢查Tomcat是否安裝成功

%Tomcat_HOME%\bin 目錄下雙擊 startup.bat，啟動 Tomcat 伺服器，在瀏覽器輸入命令http://localhost:8080，出現如下圖所示的網頁則表示安裝成功：

注：平台自帶的日誌管理不能清理%TOMCAT_HOME%/logs資料夾下的日誌檔案，catalina.out 檔案長久運作會佔用很大磁碟空間，建議定時清理 catalina.out 檔案。

3.1 獲取工程檔案

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

2）免費使用者請參考 FineBI安裝與啟動，安裝本地FineBI後，%BI_HOME%\webapps目錄下的 webroot 資料夾即為所需的工程檔案。

3.2 copy工程檔案

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

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

3）解壓壓縮包。

3.3 參數配置（選做）

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

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

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

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

3.4 修改埠號（選做）

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

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

netstat -aon|findstr "8080"

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

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 存取FineBI系統

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

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

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

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

問題描述

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

原因分析

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

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

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

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 進程。