You're viewing help content for version:
- 6.5
- 6.4
- 6.3
- Older Versions
The Backup and Restore service lets you put AEM Forms into backup mode, which enables hot backups to be performed. The Backup and Restore service does not actually perform a backup of AEM Forms or restore your system. Instead, it puts your server in a state for consistent and reliable backups while allowing your server to continue to run. You are responsible for the actions to back up the Global Document Storage (GDS) and the database connected to the forms server. The GDS is a directory used to store files used within a long-lived process.
Backup mode is a state that the server enters so that files in the GDS are not being purged while a backup procedure is taking place. Instead, subdirectories are created under the GDS directory to maintain a record of files to be purged after save backup mode ends. A file is intended to survive system restarts and can span days, or even years. These files are a critical part of the overall state of the forms server and may include PDF files, policies, or form templates. If any of these files are lost or become corrupted, the processes on the forms server may become unstable and data could be lost.
You can choose to perform snapshot backups, where you would usually enter backup mode for a period and then leave backup mode after you complete your backup activities. Leaving backup mode is required so that files can be purged from the GDS to ensure that it does not grow unnecessarily large. You can either leave backup mode explicitly or wait for the time to expire on a backup mode session.
You can also leave your server in perpetual backup mode, which is typical for backup strategies for rolling backups or continuous system coverage. Rolling backup mode indicates that the system is always in backup mode, with a new backup mode session initiated as soon as the previous session is released. When in continuous backup mode, a file is purged after two backup mode session and is no longer referenced.
You can use the Backup and Restore service to add to existing applications or new applications that you create to perform backups of the GDS or database connected to the forms server.
Note:
As with any other aspect of your AEM Forms implementation, your backup and recovery strategy should be developed and tested in a development or staging environment before being used in production to ensure that the entire solution is working as expected with no data loss.
Note:
For more information about what to consider when performing backups for AEM Forms, see administration help.
Note:
For more information about the Backup and Restore service, see Services Reference for AEM Forms.
You enter backup mode to allow for hot backups of a forms server. When you enter backup mode, you specify the following information based on your organization’s backup procedures:
A unique label to identify the backup mode session that may be useful for your backup processes.
The time for the backup procedure to complete.
A flag to indicate whether to be in continuous backup mode, which is useful only if you are performing rolling backups.
Before you write applications to enter into backup mode, it is recommended that you understand the backup procedures that will be used after you put the forms server in backup mode. For more information about what to consider when performing backups for AEM Forms, see administration help.
Note:
For more information about the Backup and Restore service, see Services Reference for AEM Forms.
Include necessary files in your development project. These files are important to include in your project for compiling your code properly and using the Backup and Restore Service API.
For information about the location of these files, see Including AEM Forms Java library files.
To programmatically leave backup mode, you create a BackupService client object to use the Backup and Restore Service API.
Decide upon a unique label, determine the amount of time to perform the backup, and decide whether to be in continuous backup mode
Before you enter backup mode, you should decide upon a unique label, determine the amount of time that you want to allocate to perform the backup, and decide whether you want the forms server to stay in backup mode. These considerations are important to integrate with the backup procedures established by your organization. (See administration help.)
Enter backup mode with the parameters that are consistent with the backup procedures at your organization.
After you enter backup mode, you can retrieve information about the session. This information can be used to integrate with your backup procedures
After you successfully enter backup mode, you can perform a backup of the Global Document Storage (GDS) and the database that the forms server is connected to. This step is specific to your organization, since you can perform this step manually or you can run other tools to perform the backup procedure.
-
Create a BackupService Client API object
You use a ServiceClientFactory object and the BackupService client API object together.
Create a ServiceClientFactory object that contains connection properties. (See Setting connection properties.)
Create an BackupService object by using its constructor and passing the ServiceClientFactory object.
-
Decide upon a unique label, determine the amount of time to perform the backup, and decide whether to be in continuous backup mode
Decide upon a unique label, determine the amount of time that you want to allocate to perform the backup, and decide whether you want the forms server to stay in continuous backup mode.
-
Enter backup mode
Enter backup mode by invoking the enterBackupMode method with the following parameters:
A String value that specifies a unique human-readable label that identifies the backup mode session. It is recommended that you do not use spaces or characters that cannot be encoded into XML format.
An int value that specifies the number of minutes to stay in backup mode. You can specify a value from 1 to 10080 (the number of minutes in one week). This value is ignored when using continuous backup mode.
A Boolean value that specifies whether to be in continuous backup mode. A value of True specifies to be in continuous backup mode. When in continuous backup mode, the value you specify for the number of minutes to stay in backup mode is ignored.
Continuous backup mode means that a new backup mode session is started after the current one is completed. A value of False means that continuous backup mode is not used and, after leaving backup mode, the purging of files from the GDS resumes.
-
Retrieve information about the backup mode session on the server
Retrieve information using the BackupModeEntryResult object that is returned after invoking the enterBackupMode method. The information that you can retrieve after you enter backup mode may be useful for integrating with your backup procedures. For example, the label, backup ID, and start time may be useful as input for filenames for your backup procedure.
-
Decide upon a unique label, determine the amount of time to perform the backup, and decide whether to be in continuous backup mode
Decide upon a unique label, determine the amount of time that you want to allocate to perform the backup, and decide whether you want the forms server to stay in continuous backup mode.
-
Enter backup mode
To enter backup mode, invoke the enterBackupMode method and pass the following values:
A String value that specifies a unique human-readable label that identifies the backup mode session. It is recommended that you do not use spaces or characters that cannot be encoded into XML format.
A Uint32 value that specifies the number of minutes to stay in backup mode. You can specify a value from 1 to 10080 (number of minutes in one week). This value is ignored when using continuous backup mode.
A Boolean value that specifies whether to be in continuous backup mode. A value of True specifies to be in continuous backup mode. When in continuous backup mode, the value you specify for the number of minutes to stay in backup mode is ignored. Continuous backup mode means that a new backup mode session is started after the current one is completed.
A value of False means that continuous backup mode is not used and, after leaving backup mode, the purging of files from the GDS resumes.
-
Retrieve information about the backup mode session on the server
Retrieve information about the backup mode session after invoking the enterBackupMode method from the BackupModeEntryResult that is returned to verify that it was successful. The information that you can retrieve after you enter backup mode may be useful for integrating with your backup procedures. For example, the label, backup ID, and start time may be useful as input for filenames for your backup procedure.
You leave backup mode so that the forms server resumes purging of files from the GDS (Global Document Storage) on the forms server.
Before you write applications to enter into leave mode, it is recommended that you understand the backup procedures that are used with AEM Forms. For more information about what to consider when performing backups for AEM Forms, see administration help.
Note:
For more information about the Backup and Restore service, see Services Reference for AEM Forms.
Include all necessary files in your development project. These files are important for compiling your code properly and using the Backup and Restore Service API.
For information about the location of these files, see Including AEM Forms Java library files.
To programmatically leave backup mode, you create a BackupService client object to use the Backup and Restore Service API.
Leave backup mode to resume normal purging of files from the Global Document Storage (GDS). Before you leave backup mode, you should verify that your backup procedures have been completed.
After you leave backup mode, you can retrieve information about the session. This information can be used to integrate with your backup procedures.
-
Create a BackupService Client API object
You use a ServiceClientFactory object and the BackupService client API object together.
Create a ServiceClientFactory object that contains connection properties. (See Setting connection properties.)
Create a BackupService object by using its constructor and passing the ServiceClientFactory object as parameter.
-
Retrieve information about the backup mode session on the server
Retrieve information about the operation using the BackupModeResult object that is returned. The information that you can retrieve after you enter backup mode may be useful for integrating with your backup procedures. For example, the label, backup ID, and start time may be useful as input for filenames for your backup procedure.