Windows下Tomcat嵌入式部署FineReport工程

1.1 版本

1.2 應用場景

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

使用者經常需要將 FineReport 伺服器整合到已有的工程中使用，以便在工程裏直接呼叫 FineReport 伺服器的程式碼。

1.3 功能簡介

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

1.4 注意事項

1）本文方法不適用於 springboot 。

免費使用者建議到 問答 諮詢下。

付費使用者請聯絡技術支援諮詢。技術支援聯絡方式：前往「服務」，選擇「線上支援」、電話「400-811-8890」。

2）不需要在目標系統的 web.xml 中配置 Servlet 。

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

2.1 準備伺服器

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

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

3.2 copy工程檔案

1）關閉Tomcat工程。

2）將/webroot/WEB-INF下的部分檔案copy到%Tomcat_HOME% webapps/examples/WEB-INF下。

3.3 啟動Tomcat

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

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

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

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

3.4 存取工程

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

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

      Tomcat 預設埠號為 8080，工程名預設為webroot。本範例為examples

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

嵌入式部署成功後，一般使用者需要將業務系統的使用者同步到帆軟系統中，再為兩個系統進行單點登入操作。