工程備份還原

1.1 版本

1.2 應用場景

備份工程的必要性在於保護資料、確定業務連續性和提供靈活性。

1）資料保護：透過備份，管理者可以恢複丟失或損壞的業務資料，確定資料的完整性和可用性。

2）業務連續性：透過備份，在發生災難性事件時，管理者可以將工程恢複到之前的狀態以繼續營運業務，減少停機時間和資料損失。

3）版本控制和回退：透過備份，管理者可以建立不同時間點的工程快照，記錄工程的狀態和變更，便於版本控制、回退到舊版本或尋找問題的更改。

4）環境遷移和部署：備份工程有助於在不同的環境中遷移和部署項目。透過備份，可以在新環境中恢複項目的完整結構和配置，簡化遷移程式並減少錯誤。

5）安全性和合規性：透過備份，管理者可以將工程還原到之前的安全狀態，保護資料的機密性和完整性，以遵守法規和安全標準。

總結而言，備份工程是確定資料安全、業務連續性和靈活性的關鍵步驟。無論是面臨意外事件、需求變更還是災難恢複，備份工程都是保護和恢複項目的可靠手段。

1.3 功能簡介

本文主要介紹普通部署方式下的工程備份方案。

相比於普通部署方式，容器化部署的工程，可透過FineOps維運平台，一鍵、異機、完整備份工程。

維運平台備份還原功能優勢請參考：最佳實踐-備份還原

非容器化工程遷移容器化方案請參考：非容器化單機遷移容器化單機

應用場景：遠端設計時，操作使用者對某張範本進行編輯，應當備份範本曆史版本。

2.1 備份方案

備份內容：工程中的任意範本的曆史版本

備份頻率：建議每60分鍾每個使用者同個範本保留一個版本

備份操作：設計器「檔案>選項>版本管理」下開啟相關配置。

儲存位置：工程%FR_HOME%\webapps\webroot\WEB-INF\assets\vcs目錄下

2.2 還原方案

設計器中選中目標範本，點選「版本管理」，對指定版本進行「還原」即可。

應用場景：定期自動對工程關鍵業務資料進行備份，防止工程出現意外，便於還原。

3.1 備份方案

備份內容：工程中的範本、插件、JAR包、平台配置

備份頻率：建議每1週備份1次，保留最近5份備份

備份操作：管理者登入數據決策系統，點選「管理系統>智慧維運>備份還原>全局設定」，開啟自動備份。

儲存位置：工程%FR_HOME%\webapps\webroot\backup目錄下

3.2 還原方案

管理者登入數據決策系統，點選「管理系統>智慧維運>備份還原」，依次對「平台配置、報表範本、jar包、插件」中同一時間的自動備份進行還原。

由於這四個項互相存在影響（比如插件和jar包配套、範本和平台目錄配套、範本功能和jar包功能聯動），因此一定要把同時生成的四者備份一起還原，不可只還原某一項，或還原不同時間節點的備份內容。

應用場景：遷移/升級前，手動對工程進行整體異機備份，便於遷移/升級失敗後快速回退。

4.1 備份方案

1）準備備份內容存放的伺服器

建議額外準備一個伺服器，用於存放工程備份檔案（若本機備份，伺服器出現意外時無法確定備份檔案的安全）

2）檢查finedb配置庫資訊

管理者登入工程，點選「管理系統>系統管理>標準」，檢查外接資料庫是否已配置。

• 已配置：說明工程已配置外接資料庫，點選「已配置」，記錄下該工程的配置庫位置資訊。

• 未配置：說明工程未配置外接資料庫，使用內建配置庫。

3）關閉工程節點

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

4）檢查工程路徑

一般來說，工程路徑為%Tomcat_HOME%/webapps/webroot，但是為了配置短鏈，可能配置了外掛目錄，工程路徑就會發生變化。

檢查方法：查看%Tomcat_HOME%/conf/server.xml檔案，查看是否配置了docBase，若配置了，那麼該路徑即為工程外掛目錄的路徑

5）備份工程檔案

請將上節確定的工程路徑webroot資料夾，備份到第一節準備的伺服器中。

若配置了叢集檔案伺服器，請單獨完整備份。

若伺服器資源不足，webroot資料夾過大，請至少備份工程和檔案伺服器中以下檔案：

6）備份外接資料庫

若第二節檢查出工程已配置外接資料庫，需要對該資料庫進行單獨備份：

自行使用第三方工具，將該資料庫傾印一份，並將備份檔案上傳至第一節準備的伺服器中。

7）重啟工程節點

至此，工程備份完成。可參考 關閉或重啟FineReport工程 文檔，重啟單機工程節點/叢集每一個工程節點，恢複正常運作。

4.2 還原方案

1）關閉工程節點

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

2）恢複外接資料庫

將備份的外接資料庫，恢複到目標資料庫中。

3）恢複工程檔案

將備份的工程檔案，copy到工程目錄/外掛目錄中。

注意：若為叢集工程，需要copy到每個工程節點伺服器中。

4）重啟工程節點

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