Scheduling Backups
The CipherTrust Manager can periodically run database backup jobs in the background. This can be achieved by creating scheduler configurations for database backups. Scheduler configurations are supported for both system and domain scoped backups. Refer to Backups for details on backups and their types.
This section provides examples of backup scheduler configurations using the ksctl utility. Refer to the ksctl or API documentation for details.
Note
Scheduler itself is a generic service, so it provides granularity of a minute. A job configuration should take the nature of operation information into consideration. For example, backing up a database every minute is a highly unlikely use case.
Scheduling System Scoped Backup Jobs
To schedule a system scoped backup job, run the command:
ksctl scheduler configs create backup --name <config-name> --run-at "<cron-expression-format>" --description "<config-description>" --backup-key-id "<backupkeyID>"`
Here,
<config-name>: Name for the job configuration.<cron-expression-format>: Time when the job runs. The format must have five fields. If the number of fields is not equal to five, the format becomes invalid. Refer to Time Specification for details.<config-description>: Description of the job configuration.<backupkeyID>: ID of the backup key. If a key ID is not specified, the default backup key will be used.Note
Refer to the ksctl or API documentation for complete list of parameters needed for backup operations.
Example:
The following command schedules a system scoped database backup job using the specified backup key everyday at 9 AM.
$ ksctl scheduler configs create backup --name daily\_backup --run-at "0 9 * * *" --description "Daily system backup" --backup-key-id "e817b3ba-1787-496a-b5ac-27756e9efb1b"`
Scheduling Domain Scoped Backup Jobs
To schedule a domain scoped backup job, run the command:
ksctl scheduler configs create backup --scope "domain" --name <config-name> --run-at "<cron-expression-format>" --description "<config-description>"`
Here,
--scope domain: Scope of the backup is domain. The scope flag must be used for scheduling domain scoped backup jobs.<config-name>: Name for the job configuration.<cron-expression-format>: Time when the job runs. The format must have five fields. If the number of fields is not equal to five, the format becomes invalid. Refer to Time Specification for details.<config-description>: Description of the job configuration.
Example:
The following command schedules a domain scoped database backup job every Monday at 9 AM.
$ ksctl scheduler configs create backup --scope "domain" --name daily_backup --run-at "0 9 * * 1" --description "Weekly domain backup"`
