正在準備AEM Forms以進行備份

本檔案中的範例和範例僅適用於JEE環境上的AEM Forms 。

關於備份與還原服務

備份和還原服務可讓您將AEM Forms放入 備份模式，以執行熱備份。 備份和還原服務實際上不會執行AEM Forms的備份或還原您的系統。 而是讓伺服器處於一致且可靠的備份狀態，同時允許伺服器繼續執行。 您負責備份「全域檔案儲存體」(GDS)和連線至表單伺服器的資料庫的動作。 GDS是用來儲存長期處理程式中所使用檔案的目錄。

備份模式是伺服器進入的狀態，這樣在執行備份程式時就不會清除GDS中的檔案。 而是在GDS目錄下建立子目錄，以在儲存備份模式結束後維護要清除的檔案記錄。 檔案可在系統重新啟動後繼續儲存，且可能持續數天或甚至數年。 這些檔案是表單伺服器整體狀態的關鍵部分，可能包含PDF檔案、原則或表單範本。 如果任何這些檔案遺失或損毀，表單伺服器上的程式可能會變得不穩定，資料可能會遺失。

您可以選擇執行快照備份，通常會在備份模式進入一段期間後，在完成備份活動後離開備份模式。 需要離開備份模式，以便從GDS清除檔案，確保檔案不會變得不必要地大。 您可以明確離開備份模式，或等待備份模式工作階段到期的時間。

您也可以讓伺服器處於永久備份模式，這是進行捲動備份或持續系統覆蓋的備份策略的典型方式。 滾動備份模式表示系統永遠處於備份模式，一旦釋放上一個工作階段，就會起始新的備份模式工作階段。 當處於連續備份模式時，檔案會在兩個備份模式工作階段之後清除，且不再參考。

您可以使用「備份與還原」服務，將您建立之現有應用程式或新應用程式，新增至執行連線至表單伺服器之GDS或資料庫的備份。

注意

和AEM Forms實作的其他任何方面一樣，您的備份與復原策略應在開發或中繼環境中開發及測試，然後才用於生產環境，以確保整個解決方案如預期般運作且不會遺失資料。

您可以使用「備份與還原」服務執行下列工作：

  • 進入備份模式。
  • 離開備份模式。
注意

如需執行AEM Forms備份時考量哪些事項的詳細資訊，請參閱 管理說明.

注意

如需有關備份和還原服務的詳細資訊，請參閱 AEM Forms的服務參考.

在表單伺服器上進入備份模式

您進入備份模式，允許表單伺服器的熱備份。 進入備份模式時，您可以根據組織的備份程式指定下列資訊：

  • 用於識別備份模式工作階段的唯一標籤，可能對您的備份程式有用。
  • 備份程式完成的時間。
  • 表示是否處於連續備份模式的旗標，只有在執行滾動備份時才有用。

在寫入應用程式以進入備份模式之前，建議您瞭解將表單伺服器置於備份模式後所使用的備份程式。 如需執行AEM Forms備份時考量哪些事項的詳細資訊，請參閱 管理說明.

注意

如需有關備份和還原服務的詳細資訊，請參閱 AEM Forms的服務參考.

步驟摘要

若要建立進入備份模式的應用程式，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立BackupService使用者端物件。
  3. 決定唯一標籤、執行備份的時間長短，以及是否處於連續備份模式。
  4. 進入備份模式。
  5. （可選）擷取伺服器上備份模式工作階段的相關資訊。
  6. 執行GDS （全域資料存放區）和資料庫的備份。

包含專案檔案

在您的開發專案中包含必要的檔案。 這些檔案必須包含在專案中，才能正確編譯程式碼並使用備份與還原服務API。

如需有關這些檔案位置的資訊，請參閱 包含AEM Forms Java程式庫檔案.

建立BackupService使用者端API物件

若要以程式設計方式離開備份模式，請建立BackupService使用者端物件，以使用備份和還原服務API。

決定唯一標籤、決定執行備份的時間長度，以及決定是否處於連續備份模式

在進入備份模式之前，您應該決定要有一個唯一的標籤、決定要配置多少時間來執行備份，以及是否要將表單伺服器維持在備份模式。 這些考量事項對於整合貴組織建立的備份程式非常重要。 (請參閱 管理說明.)

進入備份模式

使用與貴組織的備份程式一致的引數進入備份模式。

擷取伺服器上備份模式工作階段的相關資訊

進入備份模式後，您可以擷取有關工作階段的資訊。 此資訊可用於與備份程式整合

執行GDS和資料庫的備份

成功進入備份模式後，您可以執行全域檔案儲存(GDS)及表單伺服器所連線之資料庫的備份。 此步驟特定於您的組織，因為您可以手動執行此步驟，或執行其他工具來執行備份程式。

使用Java API進入備份模式

使用備份和還原服務API進入備份模式：

  1. 包含專案檔案

    在您的Java專案的類別路徑中包含必要的使用者端JAR檔案，例如adobe-backup-restore-client-sdk.jar。 若要建立Java使用者端應用程式，必須將下列JAR檔案新增至專案的類別路徑：

    • adobe-backup-restore-client-sdk.jar
    • adobe-livecycle-client.jar
    • adobe-usermanager-client.jar
    • adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
    • jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

  2. 建立BackupService使用者端API物件

    您使用 ServiceClientFactory 物件與BackupService使用者端API物件在一起。

    • 建立 ServiceClientFactory 包含連線屬性的物件。 (請參閱 設定連線屬性.)
    • 建立 BackupService 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件。

  3. 決定唯一標籤、決定執行備份的時間長度，以及決定是否處於連續備份模式

    決定唯一標籤、決定要配置多少時間執行備份，以及是否要將表單伺服器維持在連續備份模式。

  4. 進入備份模式

    透過叫用 enterBackupMode 方法搭配下列引數：

    • A String 指定可識別備份模式工作階段之唯一可讀取標籤的值。 建議您不要使用無法編碼為XML格式的空格或字元。

    • 一個 int 指定在備份模式中保留的分鐘數的值。 您可以指定下列專案的值： 1 至 10080 （一週的分鐘數）。 使用連續備份模式時，此值會被忽略。

    • A Boolean 指定是否處於連續備份模式的值。 值 True 指定處於連續備份模式。 當處於連續備份模式時，您為保留在備份模式的分鐘數指定的值會被忽略。

      連續備份模式表示新的備份模式工作階段會在目前工作階段完成後啟動。 值 False 表示不使用連續備份模式，而且在離開備份模式後，會繼續從GDS清除檔案。

  5. 擷取伺服器上備份模式工作階段的相關資訊

    使用擷取資訊 BackupModeEntryResult 叫用後傳回的物件 enterBackupMode 方法。 在進入備份模式後，您可以擷取的資訊對於與備份程式整合可能很有用。 例如，標籤、備份ID和開始時間可能很適合用來作為備份程式檔名的輸入。

  6. 執行GDS和資料庫的備份

    備份全域檔案儲存(GDS)和您的表單伺服器所連線的資料庫。 執行備份的動作並不是AEM Forms SDK的一部分，甚至可能包括組織中備份程式特有的手動步驟。

使用Web服務API進入備份模式

使用備份與還原服務API提供的Web服務進入備份模式：

  1. 包含專案檔案

    • 建立使用備份和還原服務API WSDL的Microsoft .NET使用者端元件。
    • 參考Microsoft .NET使用者端元件。

  2. 建立BackupService使用者端API物件

    使用Microsoft .NET使用者端元件，建立 BackupServiceService 物件，方法是叫用其預設建構函式，並使用 Credentials 方法。

  3. 決定唯一標籤、決定執行備份的時間長度，以及決定是否處於連續備份模式

    決定唯一標籤、決定要配置多少時間執行備份，以及是否要將表單伺服器維持在連續備份模式。

  4. 進入備份模式

    若要進入備份模式，請叫用enterBackupMode方法並傳遞下列值：

    • A String 指定可識別備份模式工作階段之唯一可讀取標籤的值。 建議您不要使用無法編碼為XML格式的空格或字元。

    • A Uint32 指定在備份模式中保留的分鐘數的值。 您可以指定下列專案的值： 1 至 10080 （一週內的分鐘數）。 使用連續備份模式時，此值會被忽略。

    • A Boolean 指定是否處於連續備份模式的值。 值 True 指定處於連續備份模式。 當處於連續備份模式時，您為保留在備份模式的分鐘數指定的值會被忽略。 連續備份模式表示新的備份模式工作階段會在目前工作階段完成後啟動。

      值 False 表示不使用連續備份模式，而且在離開備份模式後，會繼續從GDS清除檔案。

  5. 擷取伺服器上備份模式工作階段的相關資訊

    從傳回的BackupModeEntryResult中叫用enterBackupMode方法後，擷取有關備份模式工作階段的資訊，以驗證其是否成功。 在進入備份模式後，您可以擷取的資訊對於與備份程式整合可能很有用。 例如，標籤、備份ID和開始時間可能很適合用來作為備份程式檔名的輸入。

  6. 執行GDS和資料庫的備份

    備份全域檔案儲存(GDS)和您的表單伺服器所連線的資料庫。 執行備份的動作並不是AEM Forms SDK的一部分，甚至可能包括組織中備份程式特有的手動步驟。

在表單伺服器上保留備份模式

您離開備份模式，讓表單伺服器繼續從表單伺服器上的GDS （全域檔案儲存）清除檔案。

在撰寫應用程式以進入離開模式之前，建議您先瞭解與AEM Forms搭配使用的備份程式。 如需執行AEM Forms備份時考量哪些事項的詳細資訊，請參閱 管理說明.

注意

如需有關備份和還原服務的詳細資訊，請參閱 AEM Forms的服務參考.

步驟摘要

若要離開備份模式，請執行下列步驟：

  1. 包含專案檔案。
  2. 建立BackupService使用者端物件。
  3. 離開備份模式。
  4. （選用）擷取表單伺服器上執行之備份模式工作階段的相關資訊。

包含專案檔案

在您的開發專案中包含所有必要的檔案。 這些檔案對於正確編譯程式碼及使用備份與還原服務API非常重要。

如需有關這些檔案位置的資訊，請參閱 包含AEM Forms Java程式庫檔案.

建立BackupService使用者端API物件

若要以程式設計方式離開備份模式，請建立BackupService使用者端物件，以使用備份和還原服務API。

離開備份模式

離開備份模式以繼續從全域檔案儲存體(GDS)正常清除檔案。 離開備份模式之前，您應該確認備份程式已完成。

擷取結束的備份模式工作階段的相關資訊

離開備份模式後，您可以擷取有關工作階段的資訊。 此資訊可用於與備份程式整合。

使用Java API離開備份模式

使用Backup and Restore Service API (Java)離開備份模式：

  1. 包含專案檔案

    在您的Java專案的類別路徑中包含必要的使用者端JAR檔案，例如adobe-backup-restore-client-sdk.jar。 若要建立Java使用者端應用程式，必須將下列JAR檔案新增至專案的類別路徑：

    • adobe-backup-restore-client-sdk.jar
    • adobe-livecycle-client.jar
    • adobe-usermanager-client.jar
    • adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
    • jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

  2. 建立BackupService使用者端API物件

    您使用 ServiceClientFactory 物件與BackupService使用者端API物件在一起。

    • 建立 ServiceClientFactory 包含連線屬性的物件。 (請參閱 設定連線屬性.)
    • 建立 BackupService 物件，使用它的建構函式並傳遞 ServiceClientFactory 物件做為引數。

  3. 進入備份模式

    叫用以離開備份模式 leaveBackupMode 方法。

  4. 擷取伺服器上備份模式工作階段的相關資訊

    使用擷取操作的相關資訊 BackupModeResult 傳回的物件。 在進入備份模式後，您可以擷取的資訊對於與備份程式整合可能很有用。 例如，標籤、備份ID和開始時間可能很適合用來作為備份程式檔名的輸入。

使用Web服務API離開備份模式

使用備份與還原服務API （Web服務）離開備份模式：

  1. 包含專案檔案

    若要使用Web服務，您必須確定包含Proxy檔案。 請依照下列步驟設定您的專案，以使用備份與還原服務API作為Web服務。

    • 建立使用備份和還原服務API WSDL的Microsoft .NET使用者端元件。
    • 參考Microsoft .NET使用者端元件。

  2. 建立BackupService使用者端API物件

    使用Microsoft .NET使用者端元件，建立 BackupServiceService 物件，透過叫用其預設建構函式。

  3. 進入備份模式

    叫用以離開備份模式 leaveBackupMode Web服務作業。

  4. 擷取伺服器上備份模式工作階段的相關資訊

    在作業後擷取備份模式識別碼，以驗證作業是否成功。 離開備份模式後可以擷取的資訊對於與備份程式整合可能很有用。

本頁內容