Backup Lifecycle & Housekeeping
This section will help you understand the components and functionality of backup lifecycle with Backint.
Topics
Overview
The configuration can be found in the emory.cfg configuration file in the following format:
_15LifeCycle:_15  active: true_15  Log:_15    Retention: 15_15  Daily:_15    Retention: 15_15  Weekly:_15    CronExpression: 0 0 * * 0_15    Retention: 90_15  Monthly:_15    CronExpression: 0 0 1 * *_15    Retention: 120_15  Yearly:_15    CronExpression: 0 0 1 1 *_15    Retention: 720
Configure Backup Lifecycle
Follow these steps to configure the Backint lifecycle before you start performing your backups.
- Start emory settings tool by executing /opt/emory/emoryas <sid>adm
- Select Lifecycle from the main menu.
_10  ? Backint:  [Use arrows to move, type to filter]_10  Storage Providers profiles_10  Data storage providers for backups & restores_10  Specific Database configuration for Oracle database_10  License Software_10  Logging settings_10  Syntax Backups Dashboard_10> Backups Lifecycle_10  Exit
- Enable lifecycle options and configure them:
_10? Select action to perfom:  Backups Lifecycle_10? Enable backups lifecycle? Yes_10? Select :   [Use arrows to move, type to filter]_10> Configure Log Retention_10  Configure Daily Retention_10  Configure Weekly Retention_10  Configure Monthly Retention_10  Configure Yearly Retention_10  Deactivate Lifecycle_10  Return
- 
Specify the proper information for each specific retention period: - For log retention, specify the retention days after which the logs will be purged:
_10? Select : Configure Log Retention_10? Set the number of retention days: (0) 15
- For daily retention, specify the retention days after which the backups will be purged:
_10? Select : Configure Daily Retention_10? Set the number of retention days: (0) 15
- For weekly retention, specify the retention days and the day of the week (DOW) for the backup to be performed:
_11? Select : Configure Weekly Retention_11? Select action to perfom: Edit existing profile_11? Set the number of retention days: 90_11? Choose the day of the week [Use arrows to move, enter to select, type to filter]_11> Sunday_11Monday_11Tuesday_11Wednesday_11Thursday_11Friday_11Saturday
- For Monthly retention, specify the retention days and the day of the month (DoM) for the backup to be performed:
_10? Select : Configure Monthly Retention_10? Set the number of retention days: 120_10? Choose monthly retention [Use arrows to move, enter to select, type to filter]_10Specific Weekday of every Month_10Day of every Month_10> First Day of every Month_10Last Day of every Month_10Back
- For Yearly retention, specify the retention days and the day of the year (DoY) for the backup to be performed:
_10? Select : Configure Yearly Retention_10? Set the number of retention days: 720_10? Yearly Menu [Use arrows to move, enter to select, type to filter]_10> First day of the Year_10Last day of the Month_10Day of specific month_10Specific day of Year_10Back
 
- For log retention, specify the retention days after which the logs will be purged:
Use cron expressions
For the weekly, monthly and yearly retention periods you can use cron expressions to identify when the retentions should be applied. Use one of this examples if needed, to modify the configuration file manually:
| cron expresion | description | 
|---|---|
| 0 0 * * <n> | Weekly. Set one day of week where <n> [0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday] | 
| 0 0 1 * * | First Day Of Month | 
| 0 0 L * * | Last Day Of Month | 
| 0 0 <n> * * | Specific Day Of Month (n = day of month) | 
| 0 0 * * <wd>#1 | First Week Of Month, where <wd> [0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday] | 
| 0 0 * * <wd>#2 | Second Week Of Month, where <wd> [0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday] | 
| 0 0 * * <wd>#3 | Third Week Of Month, where <wd> [0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday] | 
| 0 0 * * <wd>#4 | Fourth Week Of Month, where <wd> [0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday] | 
| 0 0 * * <wd>#L | Last Week Of Month, where <wd> [0: Sunday, 1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday] | 
| * * 1 1 * | First day of the Year | 
| * * L 12 * | Last day of the Month | 
| * * <d> <m> * | Specific day of Year, where <d>: day, and <m>: month | 
Auto Delete Expired Backups
You can make Backint to delete the expired backups each time a backup is executed. This operation will delete the file from both the catalog and the cloud storage destination.
To activate this option, follow these steps:
- Start emory settings tool by executing /opt/emory/emoryas <sid>adm
- Select Backups Lifecycle settings from the main menu.
_17? Backint:  [Use arrows to move, enter to select, type to filter]_17  --------------------------------------------------------------------------------_17  Storage Providers profiles_17  Set storage providers for backup/restore, disaster recovery and system copy_17  Configuration for DB2_17> Backups Lifecycle settings_17  Monitoring_17  --------------------------------------------------------------------------------_17  License_17  --------------------------------------------------------------------------------_17  Logging file settings_17  Debug traces_17  Show relevant information of this Backint_17  --------------------------------------------------------------------------------_17  Catalog & Backups management_17  --------------------------------------------------------------------------------_17  Exit
- Select Delete expired backups automatically:
_10? Backint: Backups Lifecycle settings_10? Select :   [Use arrows to move, enter to select, type to filter]_10  Configure Log Retention_10  Configure Daily Retention_10  Configure Weekly Retention_10  Configure Monthly Retention_10  Configure Yearly Retention_10  Deactivate Lifecycle_10> Delete expired backups automatically_10  Back
- Answer Yes [Y]when prompted:
_10? Backint: Backups Lifecycle settings_10? Select :  Delete expired backups automatically_10? Delete automatically expired backups? (Y/n) Y
- You can go now back and save the new configuration.
You can see the parameter in you configuration file with the following syntax:
_10LifeCycle:_10  Enabled: true_10  AutoDeleteExpired: true
Lifecycle and storage provider versioning and replication
If you have versioning and/or data replication activated there are some actions to be performed to have Backint lifecycle working properly.
AWS S3 bucket replication
AWS bucket replication requires versioning to be enabled.
Replication is supported by Backint. However versioning generates a noncurrent version of every deleted object, and by default those objects are never removed.
If Backint lifecycle has been activated to free up storage space from AWS S3, some configurations have to be done:
- Create an S3 lifecycle rule to remove all noncurrent versions of an object older than 1 day in both buckets, original and replica
Note: you can also check Delete expired object delete markers or incomplete multipart uploads (optional)
- Configure a replication rule to replicate S3 Delete Markers from original bucket to its replica to avoid objects being recovered from replication bucket when Backint removes them from the original one
- Disable S3 Replication Time Control. S3 RTC is enabled by default and it must be disabled to have Backint Lifecycle operations working properly. Reference: https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-time-control.html