對於維運平台部署的帆軟項目，維運平台提供「備份管理」功能。支援一鍵備份，支援自動備份，可實現異地備份。
對於維運平台部署的帆軟項目，無法使用本文的平台備份還原功能，進行相關內容還原。
1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
1.2 應用場景
使用者需要使用舊版本的插件，但插件管理中只能搜到最新版本插件。
使用者誤刪重要的報表範本。
使用者更新 JAR 後，基於某些原因想要回退。
1.3 功能簡介
平台提供備份還原的功能，支援對「平台配置」、「報表範本」、「JAR 包」、「插件」進行備份還原，以及線上對伺服器工程進行更新升級。如下圖所示：
1.4 不支援的場景
War 包壓縮部署不支援備份還原，War 包非壓縮部署支援備份還原。
WebLogic 下 War 包部署時，預設是壓縮部署的，WebSphere、Tomcat 下 War 包部署時，預設是非壓縮部署的。
2. 備份
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 自動備份
超級管理者在「全局設定」中可設定自動備份的「備份頻率」、「份數上限」、「備份容量」、「備份失敗提醒」等。如下圖所示：
各設定項介紹如下表所示：
| 設定項 | 說明 | 注意事項 |
|---|---|---|
| 備份頻率 | 預設為「每週」，自動備份時間是凌晨兩點 | - |
| 份數上限 | 每個模組自動備份上限預設為 5 份 當份數已滿上限後，在做新的自動備份時，刪除最早一份自動備份 | 份數上限修改後，不立刻生效 下一次觸發備份時自動進行檢查，並生效 |
| 備份容量 | 每個模組自動備份可佔磁碟預設為 1024 M 當磁碟容量已滿後，在做新的自動備份時，刪除最早一份自動備份 | 備份容量修改後，不立刻生效 下一次觸發備份時自動進行檢查，並生效 |
| 備份失敗提醒 | 若自動備份失敗後，系統可透過「簡訊提醒」、「平台訊息」、「郵件提醒」 | 簡訊提醒需要「開啟簡訊功能」，詳情請參見 簡訊 郵件提醒需要「配置信箱服務」，詳情請參見 信箱 |
2.3 備份的檔案
備份的檔案預設存放在%FR_HOME%\webapps\webroot\backup目錄下，具體位置如下表所示：
注1：超級管理者可修改備份檔案的存放位置，請參見本文 2.1 節。
注2：為提高安全性，自動備份的檔案名稱後面會加上隨機字元，並非亂碼。
| 備份內容 | 簡介 | 備份生成的資料夾 |
|---|---|---|
| 平台配置 | 備份系統的平台設定項 | config |
| 報表範本 | 備份%FR_HOME%\webapps\webroot\WEB-INF\reportlets資料夾中的範本 | reportlets |
| JAR 包 | 備份%FR_HOME%\webapps\webroot\WEB-INF\lib資料夾中的 JAR 包 | jar |
| 插件 | 備份系統安裝的插件 | plugins |
以平台配置舉例，備份的檔案在 %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參數值，來調整最大長度限制，重啟伺服器後設定生效。如下表所示：
| 配置項 | 修改規則 |
|---|---|
| BackupConfig.customValueLength | 參數值需為正整數型態 預設值為65536 |
3. 還原
3.1 注意事項
1）還原某個版本的備份後，被還原版本不會被自動刪除，自動對當前版本進行備份。
例如在1號零點備份了一次插件，生成備份A。2號零點還原備份A時，會自動將2號零點工程使用的插件進行備份，生成備份B。且還原操作完成後，備份A仍然存在。
2）還原操作可能會對定時任務（例如排程管理、定時備份等）產生影響。
還原後，工程對比當前系統時間，可能會判定定時任務執行遺漏，導致系統定時任務在還原成功後立即執行一次。
3.2 還原方式
點選手動備份／自動備份下備份的檔案，點選「還原按鈕」，點選「確認」按鈕後彈出「還原完成，請重啟」，重啟伺服器即可生效，如下圖所示：
不同內容還原生效的方式略有不同，詳情如下表所示：
| 還原內容 | 描述 |
|---|---|
| 平台配置 | 重啟工程後，還原生效 |
| 報表範本 | 無需重啟，立即生效
|
| JAR 包 | 重啟工程後，還原生效 |
| 插件 | 無需重啟，立即生效 |
注：重啟伺服器時要保證伺服器正常關閉，不能暴力關閉伺服器比如直接叉掉 Tomcat 伺服器的運作視窗。
4. 更新升級
注：由於工程所在伺服器環境可能存在隱患，例如記憶體不足、網路通訊異常，因此不推薦在正式工程使用本節方案。
建議正式工程使用手動升級方案，詳情請參考：工程小版本手動升級方案 。
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 則是開啟該功能。配置修改成功會傳回 ：
