1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
1.2 應用場景
Tomcat 是免費且效能相對穩定的 Web 應用伺服器，在許多中小型企業中深受歡迎。
使用者經常需要將 FineReport 伺服器整合到已有的工程中使用，以便在工程裏直接呼叫 FineReport 伺服器的程式碼。
1.3 功能簡介
本文介紹在 Windows 系統中，如何將 FineReport 工程嵌入部署到 Tomcat 工程中。
1.4 注意事項
1）本文方法不適用於 springboot 。
免費使用者建議到 問答 諮詢下。
付費使用者請聯絡技術支援諮詢。技術支援聯絡方式：前往「服務」，選擇「線上支援」、電話「400-811-8890」。
2）不需要在目標系統的 web.xml 中配置 Servlet 。
2. 環境搭建
使用者需要提前在 Windows 系統下安裝 JDK 和 Tomcat，具體的安裝方法可以自行查閱資料，技術支援不負責解答環境搭建部分的內容。
2.1 準備伺服器
請根據工程「使用者數」維度，準備合適的伺服器環境：單機工程部署支援環境及配置
2.2 安裝JDK
獨立部署時，使用者需要單獨準備 JDK 。
1）下載安裝JDK
| 操作步驟 | 說明 |
|---|---|
| 版本要求 | 支援JDK 1.8 且小版本需在 JDK8u102 以上 安裝的 JDK 版本一定要與作業系統匹配，64 位作業系統可以安裝 32 位的 JDK ，但是 FineReport 不支援這樣的操作，必須保持統一 |
| 下載JDK | 下載連結：JDK 將下載的 JDK 安裝包上傳到 Windows 伺服器 |
| 安裝JDK | 安裝教程請參考 JDK 官方文檔 範例：將安裝包解壓到/data目錄即可 |
2）檢查JDK是否安裝成功
按住「Win+R」鍵，輸入「cmd」，呼叫命令終端。
輸入 java -version 和javac ，出現如下則表示 JDK 安裝成功：
2.3 安裝Tomcat
獨立部署時，使用者需要單獨準備 Tomcat 。
1）下載安裝Tomcat
| 操作步驟 | 說明 |
|---|---|
| 版本要求 |
|
| 下載Tomcat | 下載連結：Tomcat ，請選擇「64-bit Windows zip」
|
| 安裝Tomcat | 安裝教程請參考 Tomcat 官方文檔
|
2）檢查Tomcat是否安裝成功
%Tomcat_HOME%\bin 目錄下雙擊 startup.bat，啟動 Tomcat 伺服器，在瀏覽器輸入命令http://localhost:8080，出現如下圖所示的網頁則表示安裝成功：
注：平台自帶的日誌管理不能清理%TOMCAT_HOME%/logs資料夾下的日誌檔案，catalina.out 檔案長久運作會佔用很大磁碟空間，建議定時清理 catalina.out 檔案。
3. 部署步驟
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下。
| 來源資料夾 | 目標資料夾 | 說明 |
|---|---|---|
| /webroot/WEB-INF/assets | %Tomcat_HOME%/webapps/examples/WEB-INF/assets | 儲存通用的共享持久化目錄、FineReport範本備份檔案、工程讀寫（圖片）快取 |
| /webroot/WEB-INF/assist | %Tomcat_HOME%/webapps/examples/WEB-INF/assist | 存放一些輔助工具，比如圖表要使用 phantom 等 |
| /webroot/WEB-INF/classes | %Tomcat_HOME%/webapps/examples/WEB-INF/classes | 工程呼叫的預設和自訂class檔案 |
| /webroot/WEB-INF/embed | %Tomcat_HOME%/webapps/examples/WEB-INF/embed | 存放着工程曾經/現在使用的內建finedb資料庫（即使現在使用着外接配置庫，也建議copy，方便回退） |
/webroot/WEB-INF/lib | %Tomcat_HOME%/webapps/examples/WEB-INF/lib | 工程原有/客製/外部引入的JAR包，提供工程所有基礎功能，是工程的關鍵檔案 |
| /webroot/WEB-INF/dpworks | %Tomcat_HOME%/webapps/examples/WEB-INF/dpworks | FineDataLink任務相關的配置檔案（如不存在該資料夾，說明工程沒有使用FDL相關功能，略過） |
| /webroot/WEB-INF/plugins | %Tomcat_HOME%/webapps/examples/WEB-INF/plugins | 插件相關檔案 |
| /webroot/WEB-INF/reportlets | %Tomcat_HOME%/webapps/examples/WEB-INF/reportlets | FineReport範本存放目錄，如不copy會導致工程所有範本丟失 |
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的工程的。若該工程從未登入過，則直接進入初始化配置介面。
