叢集工程部署支援環境及配置

本文簡單介紹：

• 部署帆軟叢集時支援的部署環境

• 部署帆軟叢集時必須滿足的要求

• 叢集組件支援的型別

注1：本文列出的是全量的部署支援環境。建議您參考該文檔選擇最適合的部署環境：工程部署推薦環境

注2：本文列出的是帆軟測試透過的環境。

• 本文未提及的更低版本，一般預設不支援

• 本文未提交的更高版本，使用者可自行測試驗證。如果使用後出現問題，付費使用者可聯絡技術支援獲取幫助。技術支援聯絡方式：帆軟官方服務渠道使用説明 。

注3：對於各類叢集組件（例如Nginx/Redis/外接資料庫等），文檔僅列出支援的版本，具體部署方法建議優先查詢具體廠商文檔。

伺服器工件系統

1）優先推薦使用 Linux 工件系統部署帆軟應用和叢集組件。

• 系統版本：CentOS 7.3 / Ubuntu 18.04.4 及以上

• 系統核心：3.10 及以上

• 系統架構：X86_64

2）帆軟提供「叢集環境檢查工具」，檢查伺服器系統環境是否符合叢集部署的要求。

在部署前，建議在部署叢集的各個伺服器上均運作一遍此工具，檢查報表中會對不符合的項給出建議。

注：Linux和Windows對比分析請參見：Linux和Windows對比分析

伺服器磁碟空間

伺服器埠準備

1）中間軟體、檔案伺服器、狀態伺服器包含多種，請根據選擇的情況自行開放埠。

2）埠是否被佔用請參見：埠占用查看。如果預設埠與其他工程有衝突，需要先修改埠，再開放對應的埠。

3）若同一個伺服器部署多個 Tomcat 工程，需要修改 Tomcat 埠號以防埠衝突，具體可參見：修改Tomcat埠號

4）若防火牆開啓，需要開放相關埠號：

• Windows 系統開放埠步驟請參見：Windows伺服器設定出入站規則 

• Linux 系統開放埠步驟請參見：Linux防火牆使用及配置

5）對於 docker 容器，或者伺服器之間埠嚴格限制的環境，需要對節點的伺服器之間開放埠，用於節點間通訊。

• 選擇 TCP 協定是 7800/7810/7820/7830/7840/7850/7860/7870 八個埠

• 選擇 UDP 協定是 45588～65536 隨機埠

伺服器網路要求

1）公網環境和內網環境均可部署帆軟應用和叢集組件。如下表所示：

2）各個工程節點、叢集組件、外接資料庫間需要支援通訊。

• Linux 系統使用者：可使用 叢集環境檢查工具 對系統環境進行自動檢查，或者使用 ping 語句檢查。

• Windows 系統使用者：使用 ping 或者 telenet 語句進行檢查。

伺服器配置要求

帆軟應用支援單機和叢集部署，叢集則為多個工程節點。

每個節點都是一個可以獨立運作的工程，負責處理使用者的請求，處理生成報表的任務和管理其他組件的工作。

建議按照工程併發數，準備不同數量和配置的工程節點，具體如下表所示：

注1：一個伺服器只能部署叢集的一個工程節點，不支援在一臺伺服器部署叢集的多個工程節點。

注2：每個節點伺服器 JVM 記憶體建議 8G 以上，不超過 32G，過大會導致系統 FullGC 時間過長。

注1：使用者維度說明：

• 註冊使用者數：系統註冊了的使用者。

• 線上使用者數：使用者同時在一定時間段的線上數量（一般註冊人數的 5％ - 20％ 之間）。

• 併發使用者數：同時向伺服器傳送請求的使用者數（一般是線上人數的 10% - 25% 左右)。

注2：配置說明：

• 推薦配置時：70% 場景的平均響應時間低於 3s。

• 最低配置時：70% 場景的平均響應時間低於 5s。

伺服器其他要求

中間軟體要求

容器化部署/部署包部署無需準備本節內容，產品均內建了 JDK 和應用伺服器，內建 JDK 都為 OpenJDK 。

獨立部署需要準備本節內容。需要自備應用伺服器和 JDK 。

FineReport 是純 Java 的 Servlet 應用程式，必須部署在 Tomcat、WebLogic、WebSphere 等中間軟體下。

啟動中間軟體時就會載入 FineReport 這個 Servlet應用程式，工程才能正常運作。

1）中間軟體部署注意事項：

• 如需在docker容器上運作FineReport/FineBI，請確定記憶體大於8G。

• 建議使用解壓版的 Tomcat 和 JDK。

• 同一個中間軟體中不能部署多個 FineReport 工程。

• 使用者環境若安裝多個 Tomcat ，不建議使用者環境變數配置 CATALINA_HOME 或者 TOMCAT_HOME 。否則不論使用者啟動哪個 Tomcat ，啟動的都是 CATALINA_HOME 指定的那個。

• 7.0.100 版本的 Tomcat 需要將 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下，否則會報錯。檔案請參見：web.zip

2）Windows 系統安裝 JDK注意事項：

• 環境變數 JAVA_HOME 一定要有，Path 下一定要有%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

• 若環境變數指向的%JRE_HOME%/bin下無 attach.dll 檔案，還需將%JAVA_HOME%/jdk/jre/bin下的 attach.dll copy到此路徑下，否則 Tomcat 啟動後會報錯：fine assist start failed

應用工程準備

容器化部署/部署包部署無需準備本節內容，產品內建了全新工程。全新工程部署後，平台登入的帳號和密碼需要自己設定。

獨立部署需要準備本節內容。

• 部署工程需要準備%FR_HOME%\webapps下的 webroot 資料夾。

• 需提前準備好工程，已有的工程或者重新 下載最新的工程 。

• 若使用已有的工程進行部署，平台登入的帳號和密碼是已有工程的。

數據決策系統中除平台屬性配置以外的所有資訊，包括目錄樹設定、範本定時任務資訊等，均儲存於一個資料庫中。

它管理和儲存了工程節點的各種配置資訊，保證各個節點的配置一致，並方便管理者集中管理工程的元資料。

無論是單機還是叢集，正式工程均建議配置外接資料庫。

伺服器配置要求

佔用空間需要結合使用度進行調整，可以根據webapps/webroot/WEB-INF/embed/finedb資料夾大小配置，並根據實際大小預估未來使用大小，增大1~2倍。

外接資料庫儘量和工程節點在同一網段，避免網路波動等問題。

如有條件，建議負載均衡、狀態伺服器、檔案伺服器、外接配置庫組件分別部署在不同的伺服器上，如條件不足，至少確定有單獨的伺服器部署這些組件。

資料庫型別要求

非容器化部署需要準備本章內容。容器化部署無需準備本節內容，會自動安裝MySQL資料庫並外接。

在帆軟叢集架構中，負載均衡器是連結使用者和叢集節點之間的組件，以確定使用者請求能夠合理分配到不同的叢集節點上。

負載均衡器可以透過各種算法來分配使用者請求到不同的節點上，以獲得更好的效能和負載均衡效果。

伺服器配置要求

負載均衡型別要求

非容器化部署需要準備本章內容。容器化部署無需準備本節內容，會自動安裝Nginx。

高可用叢集推薦使用Keepalived Nginx，標準叢集推薦使用Nginx。

不支援 Apache 負載均衡。

狀態伺服器是一個服務組件，用於儲存叢集節點的狀態資訊，如節點的運作狀態、負載、任務處理情況等。

它可以輔助動態分配任務到合適的節點上，並幫助管理者進行實時監視和調度叢集狀態。

伺服器配置要求

狀態伺服器型別要求

非容器化部署需要準備本章內容。容器化部署無需準備本節內容，會自動安裝Redis單機。

帆軟叢集方案中支援的狀態伺服器有：Redis單機、Redis叢集、Redis哨兵、騰訊雲Redis叢集4.0

高可用叢集推薦使用Redis叢集，標準叢集推薦使用Redis單機。

檔案伺服器是叢集中儲存報表資料和附件的組件，它可以集中管理和共享叢集節點之間的檔案，確定檔案資料的一致和高可用性。

由於各個節點都是從同一個檔案伺服器讀取資源檔案，不涉及到同步，各個節點讀取的資源檔案永遠會保持一致。

伺服器配置要求

檔案伺服器型別要求

非容器化部署需要準備本章內容。容器化部署無需準備本節內容，會自動安裝MinIO。

帆軟支援多種檔案伺服器，下面會對各個型別的檔案伺服器優缺點進行說明。

高可用叢集推薦使用NAS，標準叢集推薦使用SFTP。

推薦級別：SFTP≈MinIO＞NFS＞FTP≈HDFS

快取模式

增加了快取模式，前端可進行選擇，快取和檔案伺服器搭配使用時可以增加檔案伺服器的高可用性，下面介紹一下如何選擇。

1）快取功能

快取的資源檔案：包含報表檔案、儀表板檔案、配置檔案、地圖資料等，目前是"reportlets/" ,"resources/", "assets/"，"dashboards"四個資料夾。

主動快取：啟動工程時會快取所有資源檔案，後續使用和被動快取基本一致。

被動快取：僅對存取到的資源檔案進行快取。

2）快取作用

優點：

• 提高檔案伺服器的高可用性，若使用檔案伺服器時開啓了快取，當檔案伺服器當機時，系統從快取中讀取資源檔案，仍可正常對外提供服務。

• 快取避免了頻繁的檔案讀寫，速度更快，可大幅提高範本的存取效能。

缺點：

• 快取會佔用系統記憶體和硬碟資源。

• 因為叢集分裂等不穩定的情況，快取偶爾也會存在不同步的情況，此時可透過介面手動重新整理快取進行同步
  

總結一下，開啓快取功能可以大幅提高工程的效能，並且配合檔案伺服器使用時，可提高系統的高可用性，建議使用檔案伺服器時考慮開啓快取。

通訊協定

帆軟叢集支援 TCP 和 UDP 兩種通訊協定，目前預設是 TCP 協定，下面列舉兩種協定的差別：

其中需要注意的是，大部分雲伺服器（阿里雲、亞馬遜雲等）都不支援UDP協定，因此只能選擇TCP協定。

若伺服器對TCP/UDP協定均支援，當節點數較少時選擇TCP/UDP協定差異不大， 當節點數較多時，建議選擇UDP協定，通訊效率更高。