還原專案

1.1 版本

1.2 應用場景

維運平台對專案進行備份後，支援透過備份檔案還原專案。

維運平台部署的專案，支援透過前端介面化一鍵還原。

2.1 還原專案

1）管理者登入維運平台，選擇待還原的專案，點選「維護>備份管理」。

2）在「全部備份」中，找到待還原的檔案，點選「還原」按鈕。

3）提示「還原程式將持續一段時間，期間被還原專案無法使用，是否確定還原？」，點選「確認」按鈕後開始還原

2.2 異常情況

正常情況下，使用者只需要耐心等待專案還原成功即可。但如出現以下情況，將無法正常還原，需要進行排查/額外配置。

2.2.1 缺失24小時內備份

問題描述：還原失敗，提示：還原前請保證至少有24小時內的備份，當前專案最近備份時間為XXXXX，請備份後重試

原因分析：若還原時專案可用，必須存在24小時內的備份，方可使用其他備份進行還原，避免還原出現問題。

解決方案：請在還原前，對專案進行完整備份操作。詳情請參見：備份專案

2.2.2 缺失組件鏡像

問題描述：還原失敗，提示：未找到所需要xxx鏡像，請獲取對應鏡像並推播至鏡像倉庫後重試

原因分析：還原時，檢查發現不存在備份對應版本的鏡像，則還原失敗

解決方案：

1）付費使用者請交握帆軟技術支援，獲取指定版本鏡像包。技術支援交握方式：前往「服務」，選擇「線上支援」、電話「400-811-8890」。

2）參考文檔推播至倉庫：手動推播鏡像入庫

2.2.3 缺失專案節點

問題描述：還原失敗，提示：當前專案節點數少於備份節點數。請確認各節點ops_agent是否啟動，或透過新增節點進行還原

排查步驟1：專案中部分節點的ops_agent組件未啟動，則無法正常還原

• 在維運平台中選擇該專案，點選「維護>組件管理」。

• 找到「ops_agent」組件，透過點選「重啟」，確定容器狀態全部「running」。

排查步驟2：當前專案節點數量少於備份時的專案節點數量，需要新增節點方可還原。

• 點選「新增節點」，進入節點配置介面，會提示「當前缺失x個主應用類型節點、x個組件類型節點」

• 點選「+新增節點」，按照需求增加足夠的節點數量。點選「確定」。此時即可繼續還原。

注1：新增的伺服器，與部署專案時的伺服器要求一致，可參考：部署新專案

注2：新增的伺服器，必須是乾淨的伺服器，若檢查到該伺服器中存在ops_agent組件，則收信確認該伺服器中已部署了其他專案。

        還原失敗，提示：還原失敗，指定節點已存在此專案的ops_agent，請啟動後還原

注3：若缺失的節點，包含叢集組件所在的節點，還原成功後需要重新配置叢集。可參考：配置開啟叢集

2.2.4 多餘專案節點

問題描述：還原失敗，提示：當前專案節點數多於備份節點數，無法透過此備份進行還原，請停用多餘節點或使用其他備份重試

原因分析：在備份之後，專案新增了節點，導致備份與當前狀態不一致，無法直接還原

解決方案：建議不要採用此備份進行還原。

如果非常需要進行還原，付費使用者請交握帆軟技術支援協助。技術支援交握方式：前往「服務」，選擇「線上支援」、電話「400-811-8890」。

非維運平台部署的專案，不支援透過前端介面化一鍵還原。本章講述手動還原的方法。

3.1 還原前備份

由於備份的檔案，依賴專案以外的一些配置，因此可能會還原失敗。（例如embed還原前提，必須確定原始外置庫可用）

因此建議在還原前，對專案進行完整備份操作，或對伺服器打快照。詳情請參見：備份專案

3.2 尋找備份檔案

1）管理者登入維運平台，選擇待還原的專案，點選「維護>備份管理」。

2）在「全部備份」中，找到待還原的檔案，點選複製「備份目錄名」。

3）使用終端登入維運平台所在伺服器，進入/維運平台掛載目錄/ops/resources/backup資料夾，找到上文的備份目錄。

其中儲存的，即為該備份的專案檔案。

3.3 還原專案

1）關閉工程節點

請參考 關閉或重啟FineReport工程 文檔，關閉單機工程節點/叢集每一個工程節點。

2）還原工程檔案

請將上節找到的檔案，還原到每個工程節點/檔案伺服器。

3）重啟工程節點

參考 關閉或重啟FineReport工程 文檔，重啟單機工程節點/叢集每一個工程節點，恢復正常運作。