1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
1.2 應用場景
JBoss AS是 JBoss 的開源版本，JBoss EAP 是 JBoss 的企業版本。為了更好地區分兩者，從 JBoss AS8 開始 JBoss AS 更名為 WildFly 。
本文以 Windows + WildFly-10.1.0 + jdk1.8 為例進行示範，其他版本命令可能略有差別，請自行處理。
2. 環境搭建
使用者需要提前在 Windows 系統下安裝 JDK 和 WildFly，具體的安裝方法可以自行查閱資料，技術支援不負責解答環境搭建部分的內容。
2.1 準備伺服器
請根據工程「使用者數」維度，準備合適的伺服器環境：叢集工程部署支援環境及配置
2.2 安裝JDK
獨立部署時，使用者需要單獨準備 JDK 。
| 操作步驟 | 說明 |
|---|---|
| 版本要求 | 支援JDK 1.8 且小版本需在 JDK8u102 以上 安裝的 JDK 版本一定要與作業系統匹配，64 位作業系統可以安裝 32 位的 JDK ，但是 FineReport 不支援這樣的操作，必須保持統一 |
| 下載JDK | 下載連結：JDK 將下載的 JDK 安裝包上傳到 Windows 伺服器 |
| 安裝JDK | 安裝教程請參考 JDK 官方文檔 範例：將安裝包解壓到/data目錄即可 |
2.3 下載WildFly
| 操作步驟 | 說明 |
|---|---|
| 版本要求 | JBoss6 及以上 已驗證版本： JBoss-EAP-6.4 WildFly--8.2.1 WildFly-10.1.0 WildFly-20.0.1 WildFly-24.0.1 |
| 下載WildFly | 下載連結：wildfly
|
| 安裝WildFly | 將下載的壓縮包解壓到某個資料夾下 |
2.2 配置環境變數
1）建立系統變數JBOSS_HOME，變數值為 WildFly 解壓縮路徑。如下圖所示：
2）編輯變數 Path，新增值%JBOSS_HOME%\bin。如下圖所示：
3）啟動服務，驗證是否配置成功。進入 bin 目錄下，雙擊運作standalone.bat檔案，看到如下日誌，代表啟動成功。如下圖所示：
4）瀏覽器存取http://localhost:8080（WildFly 的 http 協定預設埠是 8080），出現下圖所示畫面代表伺服器配置成功。
5）關閉已開啟的 cmd 視窗。
2.4 配置 WildFly 支援 IP 地址存取
修改%JBOSS_HOME%\standalone\configuration\standalone.xml，原始的配置如下：
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>
</interfaces>
改成以下配置，就能透過IP存取了
<interfaces>
<interface name="management">
<any-address/>
</interface>
<interface name="public">
<any-address/>
</interface>
</interfaces>
3. 部署步驟
3.1 獲取工程檔案
1）付費使用者請聯絡帆軟技術支援獲取對應版本 webroot 工程檔案。技術支援聯絡方式：服務平台>線上支援。
2）免費使用者請參考 設計器安裝，安裝設計器後，%FR_HOME%\webapps目錄下的 webroot 資料夾即為所需的工程檔案。
3.2 打war包
1）使用命令 cmd 進入上一節webroot所在的目錄。
2）鍵入命令jar cvf webroot.war *，將webroot資料夾壓縮成webroot.war包。
注：系統中需要安裝 JDK 才能使用命令 jar cvf webroot.war *
3.3 copy工程檔案
將上一節webroot下生成的webroot.war上傳至JBoss伺服器%JBoss_HOME%\standalone\deployments目錄下。
3.4 生成dodeploy檔案
1）使用命令 cmd 進入%JBoss_HOME%\standalone\deployments下
2）鍵入命令type nul > webroot.war.dodeploy，生成webroot.war.dodeploy檔案。
3.5 參數配置
FineReport工程部署到應用伺服器上時，對應用伺服器有一定的配置要求。
如果應用伺服器不能滿足工程使用時，會出現當機風險。
建議在部署工程前，對參數進行配置，詳情請參見：JBoss伺服器記憶體修改
3.6 存取FineReport系統
1）雙擊%JBoss_HOME%\bin\standalone.bat，啟動伺服器。
2）在瀏覽器中輸入存取地址http://IP:埠號/工程名/decision，開啟FineReport初始化配置頁面，即部署成功。如下圖所示：
注1：存取地址由「伺服器 IP+ 埠 + 工程檔案名稱 +decision」組成。
預設埠號為 8080，工程名預設為webroot。
注2：平台登入的帳號和密碼是3.1節copy的工程的。若該工程從未登入過，則直接進入初始化配置介面。
4. 注意事項
4.1 修改埠號
修改 JBoss 伺服器埠號請參見：JBoss 伺服器埠號修改
4.2 登入失敗
問題描述
JBoss 伺服器部署成功後，登入平台時輸入正確的帳號和密碼，提示：登入失敗。如下圖所示：
原因分析
JBoss 對 JDK 類選擇性載入的問題，導致的登入失敗。
解決方案
在%JBoss_HOME%\modules\system\layers\base\sun\jdk\main的 module.xml 加上<path name="com/sun/management"/>，重啟 FineReport 工程即可。如下圖所示：
4.3 一些類找不到
問題描述
服務啟動程式中會報一些類找不到，載入出現報錯Error：找不到sun.net.www.protocol.file
解決方案
在%JBoss_HOME%\modules\system\layers\base\sun\jdk\main的 module.xml 加上<path name="sun/net/www/protocol/file"/>，重啟 FineReport 工程即可。如下圖所示：
