com.adobe.idp.backup.dsc.service
Interface BackupService

All Known Implementing Classes:

BackupServiceClient

public interface BackupService

BackupService has api to backup the Adobe Experience Manager forms system. There are two main apis

enterBackupMode - should be called to enter into backup mode.

leaveBackupMode - should be called to leave the backup mode.

Field Summary

static java.lang.String

SERVICE_NAME

Method Summary

BackupModeEntryResult	enterBackupMode(java.lang.String aLabel, int aBackupModeTimeout, boolean aContinuousCoverageMode) Enters into new backup mode.
BackupModeResult	leaveBackupMode() Leave an existing snapshot backup mode, or leave an existing continuous backup mode session and start a new one.
BackupModeResult	leaveContinuousBackupMode() Leave an existing backup mode, even continuous backup mode.

Field Detail

SERVICE_NAME

static final java.lang.String SERVICE_NAME

See Also:

Constant Field Values

Method Detail

enterBackupMode

BackupModeEntryResult enterBackupMode(java.lang.String aLabel,
                                      int aBackupModeTimeout,
                                      boolean aContinuousCoverageMode)
                                      throws BackupException

Enters into new backup mode.

Parameters:

aLabel - A human readable label for the backup. Spaces in the label may get lost as this string becomes part of the xml file. Avoid spaces or characters which cannot be encoded as xml content.

aBackupModeTimeout - The number of minutes after which the backup mode will be considered invalid. This will not be enforced precisely, but allows the system to resume file deletions if a backup does not complete in a reasonable time period. A value of 0 may be used to indicate no time out is allowed. It ranges between 0 and 10080( ~1 week). The aBackupModeTimeout does not apply to when in aContinuousCoverageMode. In continuousCoverageMode, it is assumed that continuous recovery coverage is desired and any resumption of unmanaged deletions would defeat the purpose of the backup mode.

aContinuousCoverageMode - If true, then system will re-enter into new backup mode with the same parameters after leaving the current backup session, otherwise, the system will revert to normal file deletion behavior. aContinuousCoveragee may be used for implementation of point in time recovery procedures.

Returns:

BackupModeEntryResult representing the backup mode. null is returned if not in backup mode.

Throws:

BackupException - BackupException is thrown if

input is not valid or

if backend document management system cannot enter into the backup mode.

leaveBackupMode

BackupModeResult leaveBackupMode()
                                 throws BackupException

Leave an existing snapshot backup mode, or leave an existing continuous backup mode session and start a new one.

Returns:

BackupModeResult with methods to get the backup information. null is returned if not in backup mode.

Throws:

BackupException - BackupException is thrown if backend document management system cannot leave the backup mode.

leaveContinuousBackupMode

BackupModeResult leaveContinuousBackupMode()
                                           throws BackupException

Leave an existing backup mode, even continuous backup mode. Use with caution, if continuous backup mode is dropped continuity of backup coverage cannot be re-established for the time the backup mode was off.

Returns:

BackupModeResult with methods to get the backup information. null is returned if not in backup mode.

Throws:

BackupException - BackupException is thrown if backend document management system cannot leave the backup mode.