平台配置叢集

Web叢集各組件安裝並運作後，需要在平台配置並開啟叢集，配置好的叢集也可以在平台處進行管理。

存取決策平台，選擇「管理系統>智慧維運>叢集設定」，進入叢集配置介面，如下圖所示：

2.1 開啟狀態伺服器

點選狀態伺服器右側的「開啟」按鈕，可在彈窗中選擇「快取系統」並編輯，如下圖所示：

2.1.1 選擇Redis單機

輸入相應的配置資訊，如下圖所示：

點選「測試連結並儲存」，儲存成功即可。

2.1.2 選擇Redis叢集

選擇「Redis叢集」後，可以手動新增或者刪除主機，主機、埠、密碼填寫規則同單機，如下圖所示：

注：如果配置 Redis 密碼，則要求 Redis 各個節點使用統一的密碼。

配置完畢後，點選「測試連結並儲存」，若無異常則可儲存成功。

2.2 設定檔案自動同步

檔案一致包含 assets、reportlets、resources、schedule、dashboards、treasures、../backup 這些資料夾，當我們使用節點間自動同步時，這些資料夾會為了保持一致會自動同步。當我們使用檔案伺服器時，各個節點將從檔案伺服器中讀取這些檔案內容。 

選擇「檔案伺服器共享」時，可以配置連結檔案伺服器，目前支援FTP、SFTP、HDFS、共享外部目錄（NAS\NFS等）作為檔案伺服器。

注：「節點間自動同步」不適用於新叢集，使用節點間自動同步無法開啟叢集。該功能只適用於歷史已配置該項的叢集工程。

2.2.1 FTP 協定

點選「編輯」，進入設定介面，進行相應的檔案伺服器配置，點選「測試連結並儲存」，如下圖所示：

注：如果 FTP 需要匿名登入（無帳號密碼），帳號和密碼留空或者帳號使用“anonymous”，密碼填入任意信箱。

2.2.2 SFTP 協定

點選「編輯」，進入設定介面，進行相應的檔案伺服器配置，點選「測試連結並儲存」，如下圖所示：

注1：要求使用啟動中的 FTP/SFTP 伺服器，帳號須具備配置路徑的讀寫權限。

注2：如果是 SFTP 金鑰登入，無需要帳號密碼，不填即可，但要點選密碼後面的圖示上傳金鑰檔案。

注3：配置 SFTP 路徑的時候，路徑填寫絕對路徑，為 WEB-INF 資料夾的路徑。

2.2.3 HDFS協定

支援使用HDFS作為檔案伺服器，保證範本等資源檔案分佈式儲存，實現高可用。詳細點選 HDFS資源倉庫

2.2.4 其他說明

• 使用檔案伺服器時，想要手動增刪改範本都需要在檔案伺服器下進行操作， 節點下的 assets、reportlets、resources、schedule、dashboards、treasures、../backup 是沒有作用的。

• 從檔案伺服器切換至「節點間同步」時，需要重啟叢集工程所有節點方可生效，若不重啟則不生效。

2.3 設定快取模式

2.3.1 快取模式介紹

點選「管理系統>系統管理>BI參數」，可進行「直連快取」和「抽取快取」設定，如下圖所示：

2.3.2 抽取快取

抽取快取策略可選擇兩種，選擇設定後，點選「儲存」，立刻生效。如下圖所示：

2.3.3 直連快取

點選「立即清除快取」按鈕，立刻清理系統中的所有實時資料類型的 SQL 資料集和 DB 資料庫表的相關快取。相關查詢都會重新發 SQL 給資料庫。

2.4 設定通訊協定

TCP 和 UDP 是常用的網路傳輸協定，預設選用 TCP 協定。

開啟叢集狀態下可以切換叢集通訊協定，不過重啟工程後方可生效。

注1：如果開啟叢集後只顯示本工程的節點，請更換叢集連結方式，並重啟各節點工程。

注2：阿里雲、AWS 等雲伺服器不允許 UDP 組播方式，叢集連結方式請選擇 TCP。

3.1 開啟/關閉叢集

3.1.1 開啟叢集

狀態伺服器和外接資料庫是開啟叢集的前置條件，若未配置外接資料庫，則參考文檔進行配置：配置外接資料庫

未配置無法開啟的彈窗提示：

配置完畢正常開啟的彈窗提示：

3.1.2 關閉叢集

當我們成功開啟叢集並使用時，若想關閉叢集，可以直接點選按鈕就行關閉，不過關閉狀態在重啟後方可生效。

3.2 重啟工程出現第一個節點

當我們開啟叢集按鈕，並重啟工程後，可以看到節點管理介面出現一個節點，並且當我們選用的是「節點間自動同步」時，第一個加入叢集的節點會作為檔案同步基準節點，若選用的是「檔案伺服器共享」，則不會出現檔案同步基準節點標籤。

需要強調的是：

1）選用的是「節點間自動同步」時，如果想手動變更節點下的資源檔案（assets、reportlets、resources、schedule、dashboards、treasures、../backup ），則需要在基準節點下進行變更，增刪改動作會自動同步至其他非基準節點。對應非基準節點下的資源檔案變動操作，不會生效。

2）基準節點一旦選出後，預設不會變動。若想重置基準節點，可參考以下兩種方法：

• 方法一

滑鼠懸浮在前端非基準節點的左上角，可點選「設為基準節點」進行基準節點的切換。如下圖所示：

注1：僅在非節點編輯模式下顯示該按鈕。切換實時生效，即點選按鈕後當前節點顯示為「檔案同步基準節點」。

注2：如果切換失敗會彈出提示框資訊：基準節點切換失敗，請稍後重試 。

• 方法二

可以關閉叢集並重啟工程後，再開啟叢集，基準節點即可重置，重置邏輯還是選擇叢集開啟後第一個加入叢集的節點為基準節點 。

3.3 增加節點

注：一個工程即一個節點資訊。

3.3.1 方法一：複製 webroot 資料夾到其他伺服器下

當第一個節點出現後，就可以將第一個節點的工程包（webroot）copy到其他伺服器下，然後啟動這些伺服器，新的節點就會加入節點管理了，如下圖所示：

3.3.2 方法二：複製 db.properties 檔案到其他伺服器下

當第一個節點出現後，可以將第一個節點%BI_HOME%\webapps\webroot\WEB-INF\config下的db.properties檔案複製貼上到其他伺服器相同檔案路徑下，然後啟動這些伺服器，新的節點就會加入節點管理中。

3.4 修改節點資訊

使用 Tomcat、Weblogic 容器時，叢集開啟後可以自動識別容器埠，對於 WAS 叢集，暫時不支援自動識別埠，埠預設為58312，需要修改每個節點的埠為實際埠。

滑鼠劃到節點資訊處，右上角出現編輯按鈕，點選可編輯修改節點名稱、IP 及埠資訊，如下圖所示：

至此叢集配置就設定成功。

3.5 節點異常

節點與非協調者通訊異常則會標紅，節點標紅提示如下圖所示：

3.6 重新整理快取

使用「檔案伺服器共享」並且開啟快取時，節點管理介面會出現「重新整理快取」的按鈕。若我們開啟快取後，有手動在檔案伺服器下增刪改檔案的情況，快取層是無法感知到的，需要手動重新整理快取。「節點間自動同步」模式下可以自動感知到節點下的檔案變動情況，因此無須重新整理快取，因為也不會顯示「重新整理快取」的按鈕。

「主動快取」模式下：點選重新整理快取按鈕，則更新快取；

「被動快取」模式下：點選重新整理快取按鈕，則清空快取；

重新整理快取成功和失敗會有彈窗提醒：

3.7 Web 叢集重啟工程

1）「檔案一致設定」中若選擇節點間同步，關閉所有工程後，先啟動基準節點，再啟動其他節點。

2）「檔案一致設定」中若未選擇節點間同步，關閉所有工程後，依次啟動工程即可。

注：關閉和重啟部署在不同容器下的 FineBI 工程方法，可參見：關閉FineBI工程

4.1 開啟異常提醒

開啟「叢集異常提醒」功能，可以在叢集發生異常時即時提醒維運人員。

點選「全局設定」按鈕設定提醒方式，比如勾選「簡訊提醒」、「平台訊息」、「郵件提醒」，設定完成後點選儲存即可。預設全不開啟，如下圖所示：

4.2 前置條件

1）簡訊：需要開啟簡訊平台，詳細點選 簡訊

2）郵件提醒：需要配置郵件伺服器，詳細點選 信箱

3）平台訊息：需要在負載均衡層面配置websocket埠並且開放，相關文檔：WebSocket連結失敗

5.1 其他說明

1）叢集推薦使用私有雲的授權方式，不用關心維護多個節點 License 。

2）各個節點儲存自己的日誌各個節點儲存自己的日誌（方便某節點出錯快速找到其原因）。

5.2 更換FTP路徑

問題描述：

叢集工程搭建好後，由於磁碟空間不足需要更換 FTP 檔案伺服器路徑。

解決方案：

1）把原路徑下的所有檔案都copy到新的目錄下，並給新資料夾賦權限。詳情請參見：Linux 系統安裝配置 FTP、Windows 系統配置 FTP 服務
2）修改平台上的檔案伺服器路徑並儲存。

3）重啟叢集的每一個節點，重啟叢集工程注意事項請參見本文的 3.7 節內容。