備份還原

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

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

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

1.1 版本

1.2 應用場景

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

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

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

1.3 功能簡介

平台提供備份還原的功能，支援對「平台配置」、「報表範本」、「JAR 包」、「插件」進行備份還原。如下圖所示：

1.4 不支援的場景

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

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

2.1 設定備份路徑

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

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

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

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

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

2.2 備份方式

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

2.2.1 手動備份

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

2.2.2 自動備份

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

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

2.3 備份的檔案

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

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

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

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

2.4 備份管理

支援對備份進行重命名和刪除。自動備份和手動備份操作步驟一樣。

1）重命名

勾選需要重命名的備份，點選「重命名」，修改命名，點選「確定」即可。如下圖所示：

2）刪除

勾選需要刪除的備份，點選「刪除」，點選「確定」，即可刪除該備份。如下圖所示：

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 注意事項

3.1.1 被還原版本自動刪除

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

例如在1號零點備份了一次插件，生成備份A。

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

如需還原的內容比較重要，請在還原前再次備份 2.3 節對應資料夾。或聯繫技術支援協助進行還原操作。

技術支援聯繫方式：「服務平台>線上支援」、電話「400-811-8890」。

3.1.2 部分 JAR 在平台配置處不支援還原到某些版本

還原時，部分 JAR 在「平台配置」處不支援還原到某些版本，具體如下表所示：

3.1.3 還原後定時任務可能會立即執行

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

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

3.2 還原方式

點選手動備份/自動備份下備份的檔案，點選「還原」按鈕，點選「確認」按鈕，即可還原備份。如下圖所示：

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

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