准备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 FormsJava库文件。

创建BackupService Client API对象

要以编程方式退出备份模式，请创建一个BackupService客户端对象以使用Backup and Restore Service 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 Client API对象

    将ServiceClientFactory对象和BackupService客户端API对象结合使用。

    • 创建包含连接属性的ServiceClientFactory对象。 （请参阅设置连接属性。）
    • 使用BackupService对象的构造函数创建ServiceClientFactory对象。

  3. 确定唯一标签，确定执行备份的时间，并决定是否处于连续备份模式

    确定唯一标签，确定要分配多长时间来执行备份，并决定是否希望表单服务器保持连续备份模式。

  4. 进入备份模式

    使用以下参数调用enterBackupMode方法进入备份模式：

    • 一个String值，它指定标识备份模式会话的唯一人可读标签。 建议不要使用无法编码为XML格式的空格或字符。

    • 一个int值，指定在备份模式下停留的分钟数。 可以指定从1到10080的值（一周内的分钟数）。 使用连续备份模式时忽略此值。

    • 一个Boolean值，它指定是否处于连续备份模式。 值True指定为处于连续备份模式。 在连续备份模式下，将忽略您为在备份模式下停留的分钟数指定的值。

      连续备份模式意味着在当前备份模式会话完成后启动新的备份模式会话。 值False表示不使用连续备份模式，在离开备份模式后，恢复从GDS清除文件。

  5. 检索有关服务器上备份模式会话的信息

    使用调用enterBackupMode方法后返回的BackupModeEntryResult对象检索信息。 进入备份模式后可以检索到的信息对于与备份过程集成可能非常有用。 例如，标签、备份ID和开始时间可能用作备份过程文件名的输入。

  6. 执行GDS和数据库的备份

    备份全局文档存储(GDS)和表单服务器所连接的数据库。 用于执行备份的操作不属于AEM FormsSDK的一部分，甚至可能包括您组织中特定于备份过程的手动步骤。

使用Web服务API进入备份模式

使用Backup and Restore Service API提供的Web服务进入备份模式：

  1. 包括项目文件

    • 创建一个Microsoft .NET客户端程序集，它使用Backup and Restore Service API WSDL。
    • 引用Microsoft .NET客户端程序集。

  2. 创建BackupService Client API对象

    使用Microsoft .NET客户端程序集，通过调用其默认构造函数创建一个BackupServiceService对象，并使用Credentials方法指定凭据。

  3. 确定唯一标签，确定执行备份的时间，并决定是否处于连续备份模式

    确定唯一标签，确定要分配多长时间来执行备份，并决定是否希望表单服务器保持连续备份模式。

  4. 进入备份模式

    要进入备份模式，请调用enterBackupMode方法并传递以下值：

    • 一个String值，它指定标识备份模式会话的唯一人可读标签。 建议不要使用无法编码为XML格式的空格或字符。

    • 一个Uint32值，它指定在备份模式下停留的分钟数。 可以指定从1到10080的值（一周内的分钟数）。 使用连续备份模式时忽略此值。

    • 一个Boolean值，它指定是否处于连续备份模式。 值True指定为处于连续备份模式。 在连续备份模式下，将忽略您为在备份模式下停留的分钟数指定的值。 连续备份模式意味着在当前备份模式会话完成后启动新的备份模式会话。

      值False表示不使用连续备份模式，在离开备份模式后，恢复从GDS清除文件。

  5. 检索有关服务器上备份模式会话的信息

    从BackupModeEntryResult调用enterBackupMode方法后检索有关备份模式会话的信息，该方法将返回以验证其是否成功。 进入备份模式后可以检索到的信息对于与备份过程集成可能非常有用。 例如，标签、备份ID和开始时间可能用作备份过程文件名的输入。

  6. 执行GDS和数据库的备份

    备份全局文档存储(GDS)和表单服务器所连接的数据库。 用于执行备份的操作不属于AEM FormsSDK的一部分，甚至可能包括您组织中特定于备份过程的手动步骤。

在表单服务器上退出备份模式

您退出备份模式，以便表单服务器恢复从表单服务器上的GDS(全局文档存储)清除文件。

在编写应用程序以进入退出模式之前，建议您了解与AEM Forms一起使用的备份过程。 有关为AEM Forms执行备份时要考虑的事项的详细信息，请参见管理帮助。

注意

有关备份和还原服务的详细信息，请参阅AEM Forms的服务参考。

步骤的摘要

要退出备份模式，请执行以下步骤：

  1. 包括项目文件。
  2. 创建BackupService客户端对象。
  3. 退出备份模式。
  4. （可选）检索有关在表单服务器上运行的备份模式会话的信息。

包括项目文件

在开发项目中包含所有必需的文件。 这些文件对于正确编译代码和使用备份和还原服务API非常重要。

有关这些文件的位置的信息，请参见包括AEM FormsJava库文件。

创建BackupService Client API对象

要以编程方式退出备份模式，请创建一个BackupService客户端对象以使用Backup and Restore Service API。

退出备份模式

保留备份模式，以恢复从全局文档存储(GDS)正常清除文件。 在离开备份模式之前，应验证备份过程是否已完成。

检索有关已结束的备份模式会话的信息

离开备份模式后，可以检索有关会话的信息。 此信息可用于与备份过程集成。

使用Java API退出备份模式

使用备份和还原服务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 Client API对象

    将ServiceClientFactory对象和BackupService客户端API对象结合使用。

    • 创建包含连接属性的ServiceClientFactory对象。 （请参阅设置连接属性。）
    • 使用BackupService对象的构造函数创建ServiceClientFactory对象，并将<a1/>对象作为参数进行传递。

  3. 进入备份模式

    通过调用leaveBackupMode方法退出备份模式。

  4. 检索有关服务器上备份模式会话的信息

    使用返回的BackupModeResult对象检索有关操作的信息。 进入备份模式后可以检索到的信息对于与备份过程集成可能非常有用。 例如，标签、备份ID和开始时间可能用作备份过程文件名的输入。

使用Web服务API退出备份模式

使用备份和还原服务API（Web服务）退出备份模式：

  1. 包括项目文件

    要使用Web服务，必须确保包含代理文件。 请按照以下步骤将项目配置为将备份和还原服务API用作Web服务。

    • 创建一个Microsoft .NET客户端程序集，它使用Backup and Restore Service API WSDL。
    • 引用Microsoft .NET客户端程序集。

  2. 创建BackupService Client API对象

    使用Microsoft .NET客户端程序集，通过调用其默认构造函数创建一个BackupServiceService对象。

  3. 进入备份模式

    通过调用leaveBackupMode Web服务操作，使备份模式保持不变。

  4. 检索有关服务器上备份模式会话的信息

    在操作后检索备份模式标识符，以验证其是否成功。 在离开备份模式后可以检索到的信息对于与备份过程集成可能非常有用。

在此页面上