WildFly伺服器部署

1.1 版本

1.2 應用場景

JBoss AS是 JBoss 的開源版本，JBoss EAP 是 JBoss 的企業版本。為了更好地區分兩者，從 JBoss AS8 開始 JBoss AS 更名為 WildFly 。

本文以 Windows + WildFly-10.1.0 + jdk1.8 為例進行示範，其他版本命令可能略有差別，請自行處理。

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

2.1 準備伺服器

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

2.2 安裝JDK

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

2.3 下載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.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.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 工程即可。如下圖所示：