備份還原

對於維運平台部署的帆軟項目，維運平台提供「備份管理」功能。支援一鍵備份，支援自動備份，可實現異地備份。

對於維運平台部署的帆軟項目，無法使用本文的平台備份還原功能，進行相關內容還原。

請透過維運平台完成：備份專案、還原專案。支援一鍵備份、自動備份、異地備份。支援一鍵還原、當機還原。

1.1 版本

1.2 應用場景

• 使用者需要使用舊版本的插件，但插件管理中只能搜到最新版本插件。

• 使用者誤刪重要的報表範本。

• 使用者更新 JAR 後，基於某些原因想要回退。

1.3 功能簡介

平台提供備份還原的功能，支援對「平台配置」、「報表範本」、「JAR 包」、「插件」進行備份還原，以及線上對伺服器工程進行更新升級。如下圖所示：

1.4 不支援的場景

War 包壓縮部署不支援備份還原，War 包非壓縮部署支援備份還原。

WebLogic 下 War 包部署時，預設是壓縮部署的，WebSphere、Tomcat 下 War 包部署時，預設是非壓縮部署的。

2.1 設定備份路徑

注：僅超級管理者可設定該路徑。

超級管理者登入數據決策系統，點選「管理系統>智慧維運>備份還原」，點選「全局設定」按鈕，設定備份路徑，如下圖所示：

預設備份路徑為../backup，備份檔案儲存在工程的%FR_HOME%/webapps/webroot/backup資料夾下。

使用者可修改 backup 資料夾為其他資料夾，但是不支援儲存到非工程路徑下。

若修改備份路徑時去掉前面的../，那麼備份檔案儲存在工程的%FR_HOME%/webapps/webroot/WEB-INF資料夾下

2.2 備份方式

在「平台配置」、「報表範本」、「JAR 包」、「插件」Tab 頁面，均支援手動備份和自動備份兩種方式。如下圖所示：

2.2.1 手動備份

點選「手動備份」，彈出對話框，可自訂名稱，點選「確定」，手動備份完成。如下圖所示：

2.2.2 自動備份

超級管理者在「全局設定」中可設定自動備份的「備份頻率」、「份數上限」、「備份容量」、「備份失敗提醒」等。如下圖所示：

各設定項介紹如下表所示：

2.3 備份的檔案

備份的檔案預設存放在%FR_HOME%\webapps\webroot\backup目錄下，具體位置如下表所示：

注1：超級管理者可修改備份檔案的存放位置，請參見本文 2.1 節。

注2：為提高安全性，自動備份的檔案名稱後面會加上隨機字元，並非亂碼。

以平台配置舉例，備份的檔案在 %FR_HOME%\webapps\webroot\backup\config 下，其中manual: 手動備份；auto: 自動備份。如下圖所示：

2.4 刪除備份

勾選需要刪除的備份，點選「刪除」，確認刪除，即可刪除之前的備份，自動備份和手動備份操作步驟一樣，如下圖所示：

2.5 注意事項

問題描述：

備份失敗，報錯「java.sql.SQLDataException: data exception: string data, right truncation;  table: FINE_CONF_ENTITY column: VALUE」

原因分析：

fine_conf_entity 表中存在資料長度超長，導致備份失敗。

解決方案：

方案一：將超長的資料欄位篩選出來刪掉 。

方案二：僅支援mysql類型的外接資料庫使用該方案。

超級管理者可透過「fine_conf_entity視覺化配置插件」，修改BackupConfig.customValueLength參數值，來調整最大長度限制，重啟伺服器後設定生效。如下表所示：

3.1 注意事項

1）還原某個版本的備份後，被還原版本不會被自動刪除，自動對當前版本進行備份。

例如在1號零點備份了一次插件，生成備份A。2號零點還原備份A時，會自動將2號零點工程使用的插件進行備份，生成備份B。且還原操作完成後，備份A仍然存在。

2）還原操作可能會對定時任務（例如排程管理、定時備份等）產生影響。

還原後，工程對比當前系統時間，可能會判定定時任務執行遺漏，導致系統定時任務在還原成功後立即執行一次。

3.2 還原方式

點選手動備份／自動備份下備份的檔案，點選「還原按鈕」，點選「確認」按鈕後彈出「還原完成，請重啟」，重啟伺服器即可生效，如下圖所示：

不同內容還原生效的方式略有不同，詳情如下表所示：

注：重啟伺服器時要保證伺服器正常關閉，不能暴力關閉伺服器比如直接叉掉 Tomcat 伺服器的運作視窗。

注：由於工程所在伺服器環境可能存在隱患，例如記憶體不足、網路通訊異常，因此不推薦在正式工程使用本節方案。

      建議正式工程使用手動升級方案，詳情請參考：工程小版本手動升級方案 。

4.1 自動推播更新

「自動推播更新」按鈕預設開啟，當有更高版本的JAR 包發佈時，系統將自動推播至平台。如下圖所示：

4.2 更新升級

1）新版本發佈後，登入伺服器，查看並處理推播資訊，如下圖所示：

2）點選「立即更新」，進行版本更新，如下圖所示：

4.3 重啟伺服器

注：更新完成後，為確定工程的正常使用，必須立即重啟伺服器。

更新完成後，重啟伺服器生效。

4.4 注意事項

問題描述：點選「立即更新」後，F12查看，發現報錯「414 Request-URL too large」

原因分析：出現該報錯，並生成一個很長的地址，是雲端健檢分析插件中報表服務的產品配置資訊與雲中心交互的流程，可忽略。

解決方法：

如不希望顯示該報錯，可使用超級管理者帳號登入數據決策系統，存取http://ip:port/webroot/decision/v1/cloud/feature/config/recordFineMarkId/false即可

從 false 改為 true 則是開啟該功能。配置修改成功會傳回 ：

{

"data": true

}