B09-11 系統檢查

1

版本。

2

應用場景。

1. 如果記憶體環境配置不合理，非常容易導緻報表系統當機，且此類當機情況很難複現，排查困難。

3

功能簡介。

1. 【系統檢查】，可幫助使用者檢查系統中的各項配置是否合理，以輔助使用者優化環境配置，更好地防止當機情況的發生。

2. 使用者手動檢查/平台定期檢查報表系統各項環境配置是否合理。

3. 當系統環境配置不合理時，派送訊息給使用者。

4. 為使用者提供系統環境配置的合理改進指導。

1. 10.0.16 之前版本的報表工程，需要安裝插件，方可獲得【系統檢查】功能。

2. 10.0.16 及之後版本的報表工程，功能直接內建，無需安裝插件。

1

安裝插件。

點選下載插件：系統檢查插件

伺服器安裝插件方法請參見：A11-18 伺服器-插件管理

2

介面簡介。

1. 管理者登入數據決策系統，點選【管理系統】→【智慧維運】，新增【系統檢查】Tab，如下圖所示。

1

查看各檢查項狀態和修改建議。

1. 系統檢查的內容有以下七項：堆內記憶體、備用記憶體、堆外記憶體、垃圾回收器型別、堆內老年代與新年代比例、磁碟剩餘空間、棧空間。檢查結果包含檢查項、當前配置、修改建議和狀態。具體信息如下表所示。

2. 若無法檢測出當前配置，當前配置為空，修改意見為【暫不支援此項】，點選狀態後面的【詳情】，即可檢視具體原因。

3. 若系統為叢集環境，在【系統檢查】頁面左上角可選擇具體的叢集節點進行檢測。

4. 若所有檢查項均沒有問題時，會提示：此項配置良好，無需調整。如下圖所示。

2

系統檢查處理。

1. 【系統自動檢查】未開啟時為手動檢查，系統重啟後，每小時獲取一次系統的配置情況，當管理員登入資料決策系統，開啟【系統檢查】頁面時，系統進行檢查，獲取最近一次的系統配置，更新檢查結果。

2. 開啟【系統自動檢查】並儲存後，系統在每日凌晨 1 點進行自動檢查。

3. 選擇需要的【通知方式】，支援簡訊提醒、平台訊息、郵件提醒，存在不合理配置時可透過選擇的通知方式提醒管理員。

注1：本文僅介紹10.0.16及之前版本的檢查項，10.0.17 及之後版本的系統檢查項和檢查邏輯請參見：系統檢查擴展内容 。

注2：各檢查項的修改方法請參考：修改FineReport配置參數

注3：若無法檢查出當前配置，當前配置為空，修改意見為【暫不支援此項】，點選狀態後面的【詳情】，即可查看具體原因。

注4：若系統為叢集環境，在【系統檢查】頁面左上角可選擇具體的叢集節點進行檢查。

1. 2022-03-01 及之後版本，支援一鍵配置系統檢查建議值。

1

不支援的環境。

1. 對於以下環境，不支援一鍵配置功能：

   1）非 Tomcat 部署環境，不支援一鍵配置系統檢查建議值，例如was部署、weblogic部署等。

   2）FineReport 和FineBI 整合的環境，不支援一鍵配置系統檢查建議值。

   3）工程系統中若存在自行設定的 setenv 檔案，不支援一鍵配置系統檢查建議值。

   4）服務形式啟動的 Tomcat 工程，不支援一鍵配置系統檢查建議值。

   5）Windows環境下 exe 啟動的 Tomcat 工程，不支援一鍵配置系統檢查建議值。

   6）設計器環境下的 FineReport 工程，不支援一鍵配置系統檢查建議值。

   7）系統物理記憶體為 16 GB及以下的環境，不支援一鍵配置系統檢查建議值。

   8）叢集工程環境，不支援一鍵配置系統檢查建議值。

2

配置方法。

1. 若當前工程環境滿足一鍵配置的要求，且存在需要一鍵配置的檢查項，在【系統檢查】頁面左上角出現按鈕【查看建議配置】。

2. 點選【查看建議配置】，即可勾選需要配置的檢查項，點選【應用配置】，即可一鍵配置異常項的值。配置成功後，跳出提示【應用配置成功，重啓伺服器後生效】。

3. 報表工程重啓後，可以發現剛剛的異常項均已成功配置。

注1：支援一鍵配置的檢查項為：堆內記憶體、堆外NIO記憶體、堆外FineIO記憶體、垃圾回收器型別、老年代與新生代比例、棧空間。

注2：若沒有檔案讀寫權限或者無法修改配置檔案時，提示【應用配置失敗：沒有配置檔案讀寫權限】，點選【確定】，則修改失敗，傳回系統檢查介面。

1. 記憶體檢查項的檢查邏輯如下表所示。

1

修改垃圾回收器型別。

1. 本節以工程部署在 Tomcat 上為例， 介紹設定垃圾收集器為 Parallel Scavenge（並行收集器）的方法。

2. Windows 系統：打開 %Tomcat%/bin 目錄下的 catalina.bat 檔案進行配置，配置完成後重啓工程即可生效：set JAVA_OPTS= -XX:+UseParallelGC。

3. Linux：打開 %Tomcat%/bin 目錄下的 catalina.sh 檔案進行配置，配置完成後重啓工程即可生效：JAVA_OPTS="$JAVA_OPTS -XX:+UseParallelGC"。

2

修改堆內記憶體。

1. 堆內記憶體的修改方法，請參見下方表格文檔。

3

修改堆外記憶體。

1. 堆外記憶體由 【-XX:MaxDirectMemorySize】 這個參數來設定。本文以工程部署在 Tomcat 上為例介紹修改方法。如下圖所示。

2. Windows：修改 %Tomcat%/bin 目錄下的 catalina.bat 檔案，增加配置，配置完成後重啓工程：set JAVA_OPTS=%JAVA_OPTS% -XX:MaxDirectMemorySize=2g。

3. Linux/Unix：修改 %Tomcat%/bin 目錄下的  catalina.sh  檔案，增加配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -XX:MaxDirectMemorySize=2g"。

4

修改 fineIO 讀記憶體。

1. fineIO 讀記憶體由【-Dfineio.read_mem_limit】這個參數來設定。請根據自身工程部署情況選擇修改方法。本節展示 Tomcat 環境下設定 fineIO讀記憶體的步驟。

2. 讀記憶體的預設單位為 GB，支援小數，但不支援使用 g、m 等。建議讀記憶體為寫記憶體的2-3倍，快取大小建議與寫記憶體大小一致。

3. Windows：在 %Tomcat%/bin 目錄下的 catalina.bat 檔案中新增配置，配置完成後重啓工程：set JAVA_OPTS=%JAVA_OPTS% -Dfineio.read_mem_limit=2。

4. Linux：在 %Tomcat%/bin 目錄下的 catalina.sh 檔案中新增配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -Dfineio.read_mem_limit=2"。

5

修改 fineIO 寫記憶體。

1. fineIO 寫記憶體由【-Dfineio.write_mem_limit】這個參數來設定。請根據自身工程部署情況選擇修改方法。本節展示 Tomcat 環境下設定 fineIO寫記憶體的步驟。

2. 寫記憶體的預設單位為 GB，支援小數，但不支援使用 g、m 等。建議讀記憶體為寫記憶體的2-3倍，快取大小建議與寫記憶體大小一致。

3. Windows：在 %Tomcat%/bin 目錄下的 catalina.bat 檔案中新增配置，配置完成後重啓工程：set JAVA_OPTS=%JAVA_OPTS% -Dfineio.write_mem_limit=1。

4. Linux：在 %Tomcat%/bin 目錄下的 catalina.sh 檔案中新增配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -Dfineio.write_mem_limit=1"。

1. 檢查結果和改進建議具體如下表所示。

1

設定堆內老年代與新生代大小比例。

1. 堆內老年代與新生代大小比例建議為 2（-XX:NewRatio=2，JVM的預設值）；NewRatio 大小正常生效需要使用者不限制新生代大小。

2. 在設定【-Xmx】、【-Xms】參數的位置，新增 NewRatio 的值即可，本節展示 Tomcat 環境下設定 NewRatio 的步驟。

3. Windows：在 %Tomcat%/bin 目錄下的 catalina.bat 檔案中新增配置，配置完成後重啓工程：set JAVA_OPTS= -Xms512M -Xmx1024M -XX:NewRatio=2。

4. Linux：在 %Tomcat%/bin 目錄下的 catalina.sh 檔案中新增配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -XX:NewRatio=2"。

2

設定單執行緒使用堆疊空間。

1. 建議單執行緒使用堆疊空間不超過1024KB，即 【-Xss】 的值不超過 1024 。

2. 在設定【-Xmx】、【-Xms】參數的位置，新增 【-Xss】 的值即可，本節展示 Tomcat 環境下設定 【-Xss】 的步驟。

3. Windows：在 %Tomcat%/bin 目錄下的 catalina.bat 檔案中新增配置，配置完成後重啓工程：set JAVA_OPTS= -Xms512M -Xmx1024M -Xss1024K。

4. Linux 系統：在 %Tomcat%/bin 目錄下的 catalina.sh 檔案中新增配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -Xss1024K"。

3

設定 【DisableExplicitGC】 參數。

1. 【-XX:+DisableExplicitGC】參數的作用是禁用 System.gc()。

2. System.gc() 是一種保護機制，例如堆外記憶體滿時清理它的堆內引用物件，使用者需要根據實際情況選擇是否使用該參數。

3. 本節展示 Tomcat 環境下設定 【DisableExplicitGC】 參數的步驟。

4. Windows：在 %Tomcat%/bin 目錄下的 catalina.bat 檔案中新增配置，配置完成後重啓工程：”set JAVA_OPTS=%JAVA_OPTS% -XX:+DisableExplicitGC。

5. Linux：在 %Tomcat%/bin 目錄下的 catalina.sh 檔案中新增配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"。

4

修改 headless 模式參數。

1. headless 模式是系統的一種工作模式，如果系統屬性 java.awt.headless=true ，那麼headless工具包就會被使用。

2. 本節展示 Tomcat 環境下啟用 headless 模式的步驟。

3. Windows：在 %Tomcat%/bin 目錄下的 catalina.bat 檔案中新增配置，配置完成後重啓工程：set JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true。

4. Linux：在 %Tomcat%/bin 目錄下的 catalina.sh 檔案中新增配置，配置完成後重啓工程：JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"。

1

手動檢查。

1. 系統重啓後，每小時獲取一次系統的配置情況。

2. 當管理者登入資料決策系統，打開【系統檢查】頁面時，系統自動進行檢查，獲取最近一次的系統配置，更新檢查結果。

2

自動檢查。

1. 在【系統檢查】頁面，管理者可開啓【系統自動檢查】。如下圖所示。

2. 開啓後，系統在每日凌晨 1 點進行自動檢查，存在不合理配置時可透過【簡訊提醒】、【平台訊息】、【郵件提醒】 三種形式通知管理者。

3. 注1：【簡訊提醒】需要開啓簡訊平台，詳細點擊 簡訊 。

4. 注2：【郵件提醒】需要配置郵件伺服器，詳細點擊 郵箱 。

5. 注3：【平台訊息】需要在負載均衡層面配置websocket埠並且開放，詳細點擊 Websocket埠被佔用/無法使用 。