Manage Database Backup and Recovery on Oracle Exadata Database Service on Dedicated Infrastructure
Learn how to work with the backup and recovery facilities provided by Oracle Exadata Database Service on Dedicated Infrastructure.
- Oracle Recommended Options to Perform Backup and Recovery Operations
Oracle offers the following options for Oracle Database Backup and Recovery operations. These options are mutually exclusive. - Managing Exadata Database Backups
Automatic Exadata database backups are managed by Oracle Cloud Infrastructure. You configure this by using the Console or the API. - Managed Backup Types and Usage Information
There are two types of automatic Exadata database backups: Autonomous Recovery Service, and Oracle Object Storage. - Default Backup Channel Allocation
The default settings for database backup channels when using "Oracle Managed Backup" or "User Configured Backup" - Prerequisites for Backups on Exadata Cloud Infrastructure
- Using the Console to Manage Backups
- To designate Autonomous Recovery Service as a Backup Destination for an Existing Database
To designate Autonomous Recovery Service as a Backup Destination for an existing database, use this procedure. - Recovering an Exadata Database from Backup Destination
This topic explains how to recover an Exadata database from a backup stored in either Object Storage or Autonomous Recovery Service by using the Console or the API. - Managing Exadata Database Backups by Using bkup_api
- Using the API to Manage Backup and Recovery
- Alternative Backup Methods
Learn about alternative backup methods that are available in addition to the OCI Console. - Recovering a Database Using Oracle Recovery Manager (RMAN)
Parent topic: How-to Guides
Oracle Recommended Options to Perform Backup and Recovery Operations
Oracle offers the following options for Oracle Database Backup and Recovery operations. These options are mutually exclusive.
A hybrid configuration, that is, mixing the options is not supported. Mixing the options will break automation.
Option 1: Oracle Managed Backups
Oracle managed backups are entirely managed by Exadata Cloud Infrastructure (ExaDB-D) or Exadata Cloud@Customer (ExaDB-C@C) based on a one-time configuration. Besides being fully integrated into ExaDB-D or ExaDB-C@C cloud services Control Plane, these backups can also be accessed through OCI APIs. Oracle recommends this approach.
- The
dbaascli database backup
anddbaascli database recover
commands can be used in conjunction with the automated backups for certain operations. For more information, seedbaascli database backup
anddbaascli database recover
. - Customers are allowed to query RMAN views or issue RMAN restore and recovery commands, for example, table, datafile, or tablespace recovery commands.
Note
Do not use RMAN configuration to change any of the pre-tuned cloud RMAN settings.
Option 2: User Configured Backups
Customers can also configure backups from the host using the
dbaascli database backup
and dbaascli database
recover
commands. These backups, however, are not synchronized with the
Control Plane nor are they integrated with the OCI APIs. Also, neither management
nor lifecycle operations on these backups are supported from the service Control
Plane console. Hence, this is not a recommended approach.
This approach is useful when direct access to Backup destinations is required to perform certain tasks. Accessing the OSS bucket, for example, to replicate backups across regions or monitor Backup Destinations.
If customers configure backups to Object Storage using RMAN without using the OCI Control Plane or OCI APIs, customers are responsible for manually configuring TDE Wallet backups. By default, Oracle cloud automation cleans up archive log files every 24 hours. When you use RMAN to perform manual backups, there is a risk of the archive logs being deleted. Refer to dbaascli database backup for information on how to configure the archive log cleanup. The recommendation is to use Oracle managed backups.
For more information, see User Configured Backup.
Option 3: Backups using RMAN
Backups can be directly taken using RMAN with customer-owned customized scripts. Oracle, however, does not recommend this approach.
It is not recommended to use RMAN backups in conjunction with Oracle Managed Backups or User Configured Backups.
- Customers who want to maintain their existing RMAN backup/restore scripts.
- Customers who want to configure backups from Standby database in Data Guard environments to offload the backup workload to Standby.
ExaDB-D:
If you plan to backup using RMAN, then you must unregister the database from backup automation. For more information, see Disabling Automatic Backups to Facilitate Manual Backup and Recovery Management.
Managing Exadata Database Backups
Automatic Exadata database backups are managed by Oracle Cloud Infrastructure. You configure this by using the Console or the API.
For unmanaged backups, see Managing Exadata Database Backups by Using bkup_api.
There are two destinations possible for automatic Exadata database backups: Autonomous Recovery Service, or Oracle Object Storage.
If you previously used bkup_api
to configure backups
and then you switch to using the Console or the API for backups:
- A new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to protect your database.
bkup_api
uses cron jobs to schedule backups. These jobs are not automatically removed when you switch to using managed backups.
Managed Backup Types and Usage Information
There are two types of automatic Exadata database backups: Autonomous Recovery Service, and Oracle Object Storage.
The database and infrastructure (the VM cluster or DB system) must be in an “Available” state for a backup operation to run successfully. Oracle recommends that you avoid performing actions that could interfere with availability (such as patching operations) while a backup operation is in progress. If an automatic backup operation fails, the Database service retries the operation during the next day’s backup window. If an on-demand full backup fails, you can try the operation again when the Exadata Cloud Infrastructure instance and database availability are restored.
When you enable the Automatic Backup feature, either service creates daily incremental backups of the database to the selected Backup Destination.
If you choose to enable automatic backups, you can control the retention period. The system automatically deletes backups when the assigned retention period is expired.
Object Storage Backup retention period: 7, 15, 30, 45, 60. Default: 30 days.
The automatic backup process starts at any time during your daily backup window. You can optionally specify a 2-hour scheduling window for your database during which the automatic backup process will begin. There are 12 scheduling windows to choose from, each starting on an even-numbered hour (for example, one window runs from 4:00-6:00 AM, and the next from 6:00-8:00 AM). Backups jobs do not necessarily complete within the scheduling window.
The default backup window of 00:00 to 06:00 in the time zone of the Exadata Cloud Infrastructure instance's region is assigned to your database if you do not specify a window. Note that the default backup scheduling window is six hours long, while the windows you specify are two hours long.
- Bronze :14 days
- Silver: 35 days
- Gold: 65 days
- Platinum: 95 days
- Custom defined by you
- Default: Silver - 35 days
The automatic backup process starts at any time or within the assigned window.
- Data Guard: You can enable the Automatic Backup feature on a database with the standby role in a Data Guard association.
- Backup Retention Changes: If you shorten your database's backup retention period or your protection policy in the future, existing backups falling outside the updated retention period are deleted by the system.
- Backup Storage Costs: Automatic backups incur storage usage costs for either Autonomous Recovery Service or Object Storage depending on the backup destination selected.
You can create a full backup of your database at any time using either service.
When you terminate an Exadata Cloud Service instance database, all of its resources are deleted. Managed backups using the Object Storage destination will be deleted, and Managed backups using the Autonomous Recovery Service will be deleted according to the deletion option selected. Standalone backups created in Object Storage will remain after the database is terminated and must be manually deleted. You can use a standalone backup to create a new database.
To align with the Oracle recommended practice of using SYSBACKUP administrative privilege for Backup and Recovery operations, cloud automation creates a common administrative user C##DBLCMUSER with SYSBACKUP role at the CDB$ROOT container level. Backup and Recovery operations are therefore performed with the user having the least required privileges. Credentials for this user are randomly generated and securely managed by cloud automation. If the user is not found or is LOCKED and EXPIRED, then cloud automation will recreate or unlock this user during the backup or recovery operation. This change in the cloud automation is made starting with dbaastools version 21.4.1.1.0.
Default Backup Channel Allocation
The default settings for database backup channels when using "Oracle Managed Backup" or "User Configured Backup"
When a database is configured for backup using "Oracle Managed Backup" or "User Configured Backup", the tooling uses "default" for the backup channels. When default is used, dbaas will determine the number of channels to allocate at the time the backup or restore command is executed. The number of channels allocated is determined by the OCPU count of the node. The following table provides the values used and the OCPU range, both the OCPU and the channel values are per node. Restore operations are prioritized. The cluster-wide total channel count is the per node value multiplied by the number of nodes. The automation uses the SCAN to distribute RMAN channels across all nodes in the cluster.
OCPUs Per Node | Formula | Backup Channels Allocation Per Node | Restore Channels Allocation Per Node |
---|---|---|---|
Less than or equal to 12 | OCPU <= 12 | 2 | 4 |
Greater than 12 and less than or equal to 24 | OCPU > 12 and OCPU <= 24 | 4 | 8 |
Greater than 24 | OCPU > 24 | 8 | 16 |
If needed, a static per node value can be set by using the DBAASCLI getConfig/configure
to generate a bckup cfg and setting the parameter bkup_channels_node
to
the number of channels per node desired.
Valid values are 1 - 32: The total channel count will be the value times the number of
nodes. This value cannot exceed the limit of 255 channels. A value of
default
for bkup_channels_node
sets OCPU channel
based allocation.
Prerequisites for Backups on Exadata Cloud Infrastructure
Recovery Service
Ensure that your tenancy is configured to use Recovery Service.
Table 5-5 Review the prerequisite tasks before you use Recovery Service as the automatic backup destination
Task | More Information | Required or Optional |
---|---|---|
Create IAM policies |
Policies to Enable Access to Recovery Service and Related Resources |
Required |
Configure network resources and register a Recovery Service subnet |
Required |
|
Create protection policies |
Optional |
For more information about Recovery Service, see Overview of Oracle Database Autonomous Recovery Service.
Object Storage
- The Exadata Cloud Service instance requires access to the Oracle
Cloud Infrastructure Object Storage. Oracle recommends using a service gateway
with the VCN to enable this access. For more information, see Network Setup for Exadata Cloud Infrastructure Instances. In that topic, pay particular attention to:
- Service Gateway for the VCN
- Node Access to Object Storage: Static Route
- Backup egress rule: Allows access to Object Storage
- Subnet Size Requirements and Security Rules for Recovery Service Subnet
- An existing Object Storage bucket to use as the backup destination. You can use the Console or the Object Storage API to create the bucket. For more information, see Managing Buckets.
- An auth token generated by Oracle Cloud Infrastructure. You can use the Console or the IAM API to generate the password. For more information, see Working with Auth Tokens.
- The user name specified in the backup configuration file must have
tenancy-level access to Object Storage. An easy way to do this is to add the
user name to the Administrators group. However, that allows access to all of the
cloud services. Instead, an administrator should create a policy like the
following that limits access to only the required resources in Object Storage
for backing up and restoring the
database:
Allow group <group_name> to manage objects in compartment <compartment_name> where target.bucket.name = '<bucket_name>' Allow group <group_name> to read buckets in compartment <compartment_name>
For more information about adding a user to a group, see Managing Groups. For more information about policies, see Getting Started with Policies.
Related Topics
Using the Console to Manage Backups
You can use the Console to enable automatic incremental backups, create full backups on demand, and view the list of managed backups for a database. You can also use the Console to delete manual (on-demand) backups.
- The list of backups you see in the Console does not include any
unmanaged backups (backups created directly by using
bkup_api
). - All backups are encrypted with the same master key used for Transparent Data Encryption (TDE) wallet encryption.
- Backups for a particular database are listed on the details page for that database. The Encryption Key column displays either Oracle-Managed Key or a key name if you are using your own encryption keys to protect the database. See Backing Up Vaults and Keys for more information.
Do not delete any necessary encryption keys from the vault because this causes databases and backups protected by the key to become unavailable.
To configure automatic backups for a database
When you create an Exadata Cloud Infrastructure instance, you can optionally enable automatic backups for the initial database. Use this procedure to enable or disable automatic backups after the database is created.
Databases in a security zone compartment must have automatic backups enabled. See the Security Zone Policies topic for a full list of policies that affect Database service resources.
- Open the navigation menu. Click Oracle Database, then click Exadata on Oracle Public Cloud.
- Choose your Compartment.
- Navigate to the cloud VM cluster or DB system containing the database you want to
configure:
Cloud VM clusters (The New Exadata Cloud Infrastructure Resource Model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
DB systems: Under Oracle Base Database, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.
- In the list of databases, find the database for which you want to enable or disable automatic backups, and click its name to display database details. The details indicate whether automatic backups are enabled.
- Click Configure Automatic Backups.
- In the Configure Automatic Backups dialog, enter
the following details:
- Backup Destination: Your choices are Autonomous Recovery
Service (default) or Object Storage.
-
Scenario 1: The customer enables automatic backups AND has available limits AND there is available capacity in the region for Autonomous Recovery Service.
Backup Destination: Your choices are Autonomous Recovery Service (default) or Object Storage. You can switch the backup destination from Autonomous Recovery Service to Object Storage.
-
Scenario 2: Customer enables automatic backups AND has exhausted the default limits for the Recovery Service AND there is available capacity in the region for Autonomous Recovery Service.
Backup Destination: You can only use Object Storage. However, you can make an additional limits request and then use Autonomous Recovery Service.
The system displays the following message with a link to request an increase to the limits.
Tenancy has reached the limit for Autonomous Recovery Service. View your service limits and request an update.
-
Scenario 3: Customer enables automatic backups AND there is no available capacity in the region for Autonomous Recovery Service.
Backup Destination: You can only use Object Storage. You can transition to Autonomous Recovery Service when there is sufficient capacity.
The system displays the following message
Autonomous Recovery Service has no available capacity in this region. Select Object Storage as your backup destination. You can transition from Object Storage to Autonomous Recovery Service when there is sufficient capacity.
Proactively check if Autonomous Recovery Service capacity is available. If the required capacity becomes available and if you had chosen Object Storage, then you can transition to Autonomous Recovery Service.
-
- Backup Scheduling:
- Object Storage (L0):
- Full backup scheduling day: Choose a day of the week for the initial and future L0 backups to start.
- Full backup scheduling time (UTC): Specify the time window when the full backups start when the automatic backup capability is selected.
-
Take the first backup immediately: A full backup is an operating system backup of all datafiles and the control file that constitute an Oracle Database. A full backup should also include the parameter file(s) associated with the database. You can take a full database backup when the database is shut down or while the database is open. You should not normally take a full backup after an instance failure or other unusual circumstances.
If you choose to defer the first full backup your database may not be recoverable in the event of a database failure.
-
Object Storage (L1):
- Incremental backup scheduling time (UTC): Specify the time window when the incremental backups start when the automatic backup capability is selected.
- Autonomous Recovery Service (L0):
- Scheduled day for initial backup: Choose a day of the week for the initial backup.
- Scheduled time for initial backup (UTC): Select the time window for the initial backup.
- Take the first backup immediately: A full backup is an operating system
backup of all datafiles and the control file that constitute an Oracle Database.
A full backup should also include the parameter file(s) associated with the
database. You can take a full database backup when the database is shut down or
while the database is open. You should not normally take a full backup after an
instance failure or other unusual circumstances.
If you choose to defer the first full backup your database may not be recoverable in the event of a database failure.
- Autonomous Recovery Service (L1):
- Scheduled time for daily backup (UTC): Specify the time window when the incremental backups start when the automatic backup capability is selected.
- Deletion options after database termination: Options that you can use to
retain protected database backups after the database is terminated. These options
can also help restore the database from backups in case of accidental or malicious
damage to the database.
- Retain backups for the period specified in your protection policy or backup retention period: Select this option if you want to retain database backups for the entire period defined in the Object Storage Backup retention period or Autonomous Recovery Service protection policy after the database is terminated.
- Retain backups for 72 hours, then delete: Select this option to retain backups for a period of 72 hours after you terminate the database.
- Object Storage (L0):
- Enable Real-Time Data Protection: Real-time protection is the continuous transfer of redo changes from a protected database to Autonomous Recovery Service. This reduces data loss and provides a recovery point objective (RPO) near 0. This is an extra cost option.
- Backup Destination: Your choices are Autonomous Recovery
Service (default) or Object Storage.
- Click Save Changes.
The Database Details page displays the configuration details, Health, Real-Time Data Protection, and Policy information in the Backup section.
To create an on-demand backup of a database
Object Storage creates a full backup of the database while Recovery Service creates an incremental backup.
- Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure
- Choose your Compartment.
-
Navigate to the cloud VM cluster or DB system containing the database you want to back up:
Cloud VM clusters ( new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.
- In the list of databases, find the database for which you want to create an on-demand full backup and click its name to display database details.
-
Under Resources, click Backups.
A list of backups is displayed.
- Click Create Backup.
Related Topics
Parent topic: Using the Console to Manage Backups
To view backup status
- Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure.
- Choose your Compartment.
- Navigate to the cloud VM cluster containing the database backup you want to view.
- Click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
- In the list of databases, find the database you are interested in and click its name to display database details.
- Under Resources, click Backups.
A list of backups is displayed. The state column displays the status of the backup: Active, Creating, Canceled, Canceling, or Failed.
Parent topic: Using the Console to Manage Backups
To cancel a backup
- Open the navigation menu. Click Oracle Database, then click Exadata on Oracle Public Cloud.
- Choose your Compartment.
- Navigate to the cloud VM cluster containing the database backup you want to view:
- Click Exadata VM Clusters.
In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
- In the list of databases, find the database you are interested in and click its name to display database details.
- Under Resources, click Backups.
A list of backups is displayed. The state column displays the status of the backup: Active, Creating, Canceled, Canceling, or Failed.
- A backup in the Creating state may be canceled by clicking the Actions icon (three
dots) on the right of the backup row and clicking Cancel
Backup.
A Cancel Backup confirmation dialog will appear.
- Enter the name of the backup, and click Cancel Backup.
The state changes to Canceling.
The Cancel backup Work request can be viewed, by clicking Work requests under Resources.
If the Cancel backup fails:
- In the Work requests pane under Resources, you will see a line item called "Cancel Database Backup" with a state of "Failed". There will also be a work request for the backup "Create Database Backup" that will reflect the state of the Backup operation.
Parent topic: Using the Console to Manage Backups
To delete full backups from Object Storage
You cannot explicitly delete automatic backups. Unless you terminate the database, automatic backups remain in Recovery Service and Object Storage for the number of days specified by the user, after which time they are automatically deleted.
- Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure.
- Choose your Compartment.
-
Navigate to the cloud VM cluster or DB system containing the database backup you want to delete:
Cloud VM clusters ( new resource model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
DB systems: Under Bare Metal, VM, and Exadata, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.
- In the list of databases, find the database you are interested in and click its name to display database details.
-
Under Resources, click Backups.
A list of backups is displayed.
- Click the Actions icon (three dots) for the backup you are interested in, and then click Delete.
- Confirm when prompted.
Related Topics
Parent topic: Using the Console to Manage Backups
To delete standalone backups from Object Storage
- Open the navigation menu. Click Oracle Database, then click Standalone Backups under Resources.
- In the list of standalone backups, find the backup you want to use to delete.
- Click the Actions menu for the backup you are interested in, and then click Delete.
- In the Delete dialog, click Delete to confirm the backup deletion.
Parent topic: Using the Console to Manage Backups
To designate Autonomous Recovery Service as a Backup Destination for an Existing Database
To designate Autonomous Recovery Service as a Backup Destination for an existing database, use this procedure.
- Open the navigation menu. Click Oracle Database, then click Exadata on Oracle Public Cloud.
- Choose your Compartment.
- Navigate to the database:
Cloud VM clusters (The New Exadata Cloud Infrastructure Resource Model): Under Exadata on Oracle Public Cloud, click Exadata VM Clusters.
In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
DB systems: Under Oracle Base Database, click DB Systems.
In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.
On the cloud VM cluster or DB system details page, in the Databases table, click the name of the database to display the Database Details page. - Click Configure automatic backups.
- In the resulting window, provide the following details:
- Enable automatic backup: Check the check box to enable automatic incremental backups for this database. If you are creating a database in a security zone compartment, you must enable automatic backups.
- Backup Destination: Select Autonomous Recovery Service.
- Backup Scheduling: If you enable automatic backups, you can choose a two-hour scheduling window to control when backup operations begin. If you do not specify a window, then a six-hour default window of 00:00 to 06:00 (in the time zone of the DB system's region) is used for your database.
-
Protection Policy: If you choose to enable automatic backups, you can choose a policy with one of the following preset retention periods, or a Custom policy.
Object Storage Backup retention period: 7, 15, 30, 45, 60. Default: 30. The system automatically deletes your incremental backups at the end of your chosen retention period.
Autonomous Recovery Service protection policy:- Bronze: 14 days
- Silver: 35 days
- Gold: 65 days
- Platinum: 95 days
- Custom defined by you
- Default: Silver - 35 days
- Enable Real-Time Data Protection: Real-time protection is the continuous transfer of redo changes from a protected database to Autonomous Recovery Service. This reduces data loss and provides a recovery point objective (RPO) near 0. This is an extra cost option.
- Click Save Changes.
Recovering an Exadata Database from Backup Destination
This topic explains how to recover an Exadata database from a backup stored in either Object Storage or Autonomous Recovery Service by using the Console or the API.
- Object Storage service is a secure, scalable, on-demand storage solution in Exadata Cloud Infrastructure.
- OracleDatabase Autonomous Recovery Service is a centralized, fully managed, and standalone backup solution for Oracle Cloud Infrastructure (OCI) databases.
For more information about backing up your databases to Object Storage, see Managing Exadata Database Backups.
- Using the Console to restore a database
You can use the Console to restore the database from a backup in a backup destination that was created by using the Console.
Related Topics
Using the Console to restore a database
You can use the Console to restore the database from a backup in a backup destination that was created by using the Console.
- Restore to latest
- Restore to a timestamp
- Restore to SCN
The list of backups you see in the Console does not include any unmanaged backups (backups created directly by using
bkup_api
).
To restore a database
- Open the navigation menu. Click Oracle Database, then click Oracle Exadata Database Service on Dedicated Infrastructure
- Choose your Compartment.
- Navigate to the cloud VM cluster or DB system containing the database you want to
restore:
Cloud VM clusters (The New Exadata Cloud Infrastructure Resource Model): Under Oracle Exadata Database Service on Dedicated Infrastructure, click Exadata VM Clusters. In the list of VM clusters, find the VM cluster you want to access and click its highlighted name to view the details page for the cluster.
DB systems: Under Oracle Base Database, click DB Systems. In the list of DB systems, find the Exadata DB system you want to access, and then click its name to display details about it.
- In the list of databases, find the database you want to restore, and click its name to display details about it.
- Click Restore.
- Select one of the following options, and click Restore
Database:
- Restore to the latest: Restores the database to the last known good state with the least possible data loss.
- Restore to the timestamp: Restores the database to the timestamp specified.
-
Restore to System Change Number (SCN): Restores the database using the SCN specified. This SCN must be valid.
Note
You can determine the SCN number to use either by accessing and querying your database host, or by accessing any online or archived logs.
- Confirm when prompted.
If the restore operation fails, the database will be in a "Restore Failed" state. You can try restoring again using a different restore option. However, Oracle recommends that you review the
RMAN
logs on the host and fix any issues before reattempting to restore the database. These log files can be found in subdirectories of the/var/opt/oracle/log
directory.
Related Topics
Parent topic: Using the Console to restore a database
Managing Exadata Database Backups by Using bkup_api
bkup_api
, to back up
databases on an Exadata Cloud Infrastructure instance to
an existing bucket in the Oracle Object Storage service and to the local disk Fast
Recovery Area.
bkup_api
is deprecated equivalent
dbaascli
commands are listed for each bkup_api
command
For backups managed by Oracle Cloud Infrastructure, see Managing Exadata Database Backups.
This topic explains how to:
- Create a backup configuration file that indicates the backup destination, when the backup should run, and how long backups are retained. If the backup destination is Object Storage, the file also contains the credentials to access the service.
- Associate the backup configuration file with a database. The database will be backed up as scheduled, or you can create an on-demand backup.
You must update the cloud-specific tooling on all the compute nodes in your Exadata Cloud Infrastructure instance before performing the following procedures. For more information, see Updating an Exadata Cloud Service Instance.
- Default Backup Configuration
Description of the default backup configuration that follows Oracle best practice guidelines. - To create a backup configuration file
- To create an on-demand backup
- To remove the backup configuration
- To delete a local backup
- To delete a backup in Object Storage
Default Backup Configuration
Description of the default backup configuration that follows Oracle best practice guidelines.
The backup configuration follows a set of Oracle best-practice guidelines:
- Full (level 0) backup of the database followed by rolling incremental (level 1) backups on a seven-day cycle (a 30-day cycle for the Object Storage destination).
- Full backup of selected system files.
- Automatic backups daily at a specific time set during the database deployment creation process.
Retention period:
- Both Object Storage and local storage: 30 days, with the 7 most recent days' backups available on local storage.
- Object Storage only: 30 days.
- Local storage only: Seven days.
Encryption:
- Both Object Storage and local storage: All backups to cloud storage are encrypted.
- Object Storage only: All backups to cloud storage are encrypted.
Parent topic: Managing Exadata Database Backups by Using bkup_api
To create a backup configuration file
bkup_api
is deprecated, use dbaascli database backup
and its options instead
The following procedure must be performed on the first compute node in
the Exadata Cloud Infrastructure VM cluster or DB system
resource. To determine the first compute node, connect to any compute node as the
grid
user and execute the following
command:
$ $ORACLE_HOME/bin/olsnodes -n
The first node has the number 1 listed beside the node name.
-
SSH to the first compute node in the VM cluster or DB system resource.
ssh -i <private_key_path> opc@<node_1_ip_address>
-
Log in as opc and then sudo to the root user.
login as: opc [opc@dbsys ~]$ sudo su -
- Use the
bkup_api get config
command to generate a file containing the current backup settings for the database deployment:# /var/opt/oracle/bkup_api/bkup_api get config [--file=<file_name>] --dbname=<db_name>
-
Use the following command to install the backup configuration, configure the credentials, schedule the backup, and associate the configuration with a database name.
[root@dbsys bkup]# /var/opt/oracle/ocde/assistants/bkup/bkup -cfg bkup.cfg --dbname=<database_name>
The backup is scheduled via cron and can be viewed at
/etc/crontab
.
When the scheduled backup runs, you can check its progress with the following command.
[root@dbsys bkup]# /var/opt/oracle/bkup_api/bkup_api bkup_statusThe backup configuration file parameters are described in the following table:
Parameter | Description |
---|---|
bkup_disk=[yes|no] | Whether to back up locally to disk (Fast Recovery Area). |
bkup_oss=[yes|no] | Whether to back up to Object Storage. If yes, you must also provide the parameters bkup_oss_url, bkup_oss_user, bkup_oss_passwd, and bkup_oss_recovery_window. |
bkup_oss_url=<swift_url> |
Required if bkup_oss=yes. The Object Storage URL including the tenant and bucket you want to use. The URL is:
where <tenant> is the lowercase tenant name (even if it contains uppercase characters) that you specify when signing in to the Console and <bucket> is the name of the existing bucket you want to use for backups. |
bkup_oss_user=<oci_user_name> |
Required if bkup_oss=yes. The user name for the Oracle Cloud Infrastructure user account. This is the user name you use to sign in to the Oracle Cloud Infrastructure Console. For example, To determine which type of user you have, see the following topics:
Note that the user must be a member of the Administrators group, as described in Prerequisites. |
bkup_oss_passwd=<auth_token> |
Required if bkup_oss=yes. The auth token generated by using the Console or IAM API, as described in Prerequisites. This is not the password for the Oracle Cloud Infrastructure user. |
bkup_oss_recovery_window=n |
Required if bkup_oss=yes. The number of days for which backups and archived redo logs are maintained in the Object Storage bucket. Specify 7 to 90 days. |
bkup_daily_time=hh:mm | The time at which the daily backup is scheduled, specified in hours and minutes (hh:mm), in 24-hour format. |
bkup_archlog_cron_entry=[yes|no] | When no backups are configured using dbaastools, setting
bkup_archlog_cron_entry=no will remove the archive
log cleanup job from crontab. The default value is “yes”.
|
Related Topics
Parent topic: Managing Exadata Database Backups by Using bkup_api
To create an on-demand backup
bkup_api
is deprecated. Use dbaascli database backup
and its options instead.
You can use the bkup_api
utility to create an on-demand backup of a database.
-
SSH to the first compute node in the Exadata VM cluster or DB system resource.
ssh -i <private_key_path> opc@<node_1_ip_address>
To determine the first compute node, connect to any compute node as the
grid
user and execute the following command:$ $ORACLE_HOME/bin/olsnodes -n
The first node has the number 1 listed beside the node name.
-
Log in as opc and then sudo to the root user.
login as: opc [opc@dbsys ~]$ sudo su -
-
You can let the backup follow the current retention policy, or you can create a long-term backup that persists until you delete it:
-
To create a backup that follows the current retention policy, enter the following command:
# /var/opt/oracle/bkup_api/bkup_api bkup_start --dbname=<database_name>
-
To create a long-term backup, enter the following command:
# /var/opt/oracle/bkup_api/bkup_api bkup_start --keep --dbname=<database_name>
-
-
Exit the root-user command shell and disconnect from the compute node:
# exit $ exit
By default, the backup is given a timestamp-based tag. To specify a custom backup tag, add the --tag
option to the bkup_api
command; for example, to create a long-term backup with the tag "monthly", enter the following command:
# /var/opt/oracle/bkup_api/bkup_api bkup_start --keep --tag=monthly
After you enter a bkup_api bkup_start
command, the bkup_api
utility starts the backup process, which runs in the background. To check the progress of the backup process, enter the following command:
# /var/opt/oracle/bkup_api/bkup_api bkup_status --dbname=<database_name>
Related Topics
Parent topic: Managing Exadata Database Backups by Using bkup_api
To remove the backup configuration
bkup_api
is deprecated. Use dbaascli database backup
with its option instead.
A backup configuration can contain the credentials to access the Object Storage bucket. For this reason, you might want to remove the file after successfully configuring the backup.
[root@dbsys bkup]# rm bkup.cfg
Related Topics
Parent topic: Managing Exadata Database Backups by Using bkup_api
To delete a local backup
bkup_api
is deprecated. Use dbaascli database backup
and its option instead.
To delete a backup of a database deployment on the Exadata Cloud Infrastructure instance, use the bkup_api
utility.
-
Connect to the first compute node in your Exadata VM cluster or DB system resource as the
opc
user.To determine the first compute node, connect to any compute node as the
grid
user and execute the following command:$ $ORACLE_HOME/bin/olsnodes -n
The first node has the number 1 listed beside the node name.
-
Start a root-user command shell:
$ sudo -s#
-
List the available backups:
# >/var/opt/oracle/bkup_api/bkup_api recover_list --dbname=<database_name>
where
dbname
is the database name for the database that you want to act on.A list of available backups is displayed.
-
Delete the backup you want:
# /var/opt/oracle/bkup_api/bkup_api bkup_delete --bkup=<backup-tag> --dbname=<database_name>
where
backup-tag
is the tag of the backup you want to delete. -
Exit the root-user command shell:
# exit $
Related Topics
Parent topic: Managing Exadata Database Backups by Using bkup_api
To delete a backup in Object Storage
Use the RMAN delete backup
command to delete a backup from the Object Store.
Parent topic: Managing Exadata Database Backups by Using bkup_api
Using the API to Manage Backup and Recovery
Using the API to manage backups
For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.
Use these API operations to manage database backups:
- ListBackups
- GetBackup
- CreateBackup
- DeleteBackup
- UpdateDatabase - To enable and disable automatic backups.
- RestoreDatabase
For the complete list of APIs for the Database service, see Database Service API.
Parent topic: Using the API to Manage Backup and Recovery
Alternative Backup Methods
Learn about alternative backup methods that are available in addition to the OCI Console.
Backup for databases on Exadata Cloud Infrastructure
can be accomplished through several methods in addition to the automatic backups
configured in the console. Generally, the console (or the OCI API / CLI that correspond
to it) is the preferred method as it provides the simplest and most automated method. In
general, it is preferable to leverage the OCI Console, OCI API, or OCI Command-Line over
alternative management methods. However, if required actions cannot be completed through
the preferred methods, two other options are available to manually configure backups:
bkup_api
and Oracle Recovery Manager (RMAN).
bkup_api
will be deprecated in a future release. Use the
dbaascli database backup
, dbaascli pdb backup
,
dbaascli database recover
, and dbaascli pdb
recover
commands to backup and recover container databases and pluggable
databases. For more information, see User Configured Backup.
RMAN is the backup tool included with the Oracle Database. For information about using RMAN, see the Oracle Database Backup and Recovery User's Guide for Release 19. Using RMAN to back up databases on Exadata Cloud Infrastructure provides the most flexibility in terms of backup options, but also the most complexity.
While using RMAN for restoring databases backed up through any method described herein is considered safe, RMAN should NEVER be used to set up backups in conjunction with either console (and OCI API / CLI), nor in conjunction with
bkup_api
.
If you choose to orchestrate backups manually leveraging RMAN, you should not use either
console automated backups, nor should you use bkup_api
. You must first
completely disable console based automated backups. For more information, see Disabling Automatic Backups to Facilitate Manual Backup and Recovery
Management.
The bkup_api
method offers a middle ground between RMAN and
console automated backups in terms of flexibility and simplicity. Use
bkup_api
if needed functionality is not supported with console
automated backups, but when you wish to avoid complexity of using RMAN directly. In
certain cases, bkup_api
can be used to modify the console automated
backup configuration, but this is not generally the case. Generally,
bkup_api
must be used instead of enabling backups in the
console.
Related Topics
Disabling Automatic Backups to Facilitate Manual Backup and Recovery Management
Backups, configured in the Exadata Cloud Infrastructure console, API or bkup_api
work for a variety of backup and recovery use cases. If you require
use cases not supported by the cloud-managed backups, then you can
manage database backup and recovery manually, using the Oracle
Recovery Manager (RMAN) utility. For information about using RMAN,
see the Oracle Database Backup and Recovery
User's Guide for Release 19.
Managing backup and recovery, using RMAN, on Exadata Cloud Infrastructure requires taking full ownership of both database and archive log backups, and the cloud-managed backups should no longer be used. Before manual backups are started, the cloud-managed backup functionality should be disabled. This is needed so the cloud backup jobs do not purge archive logs before they are manually backed up and do not conflict with the manual backups.
You can use the bkup_api
utility to disable
cloud-managed backups, including disabling the automatic archive log
purge job, by following this procedure:
If you execute these steps, then the automation will no longer purge/backup the archive logs in the FRA for the database.
Recovering a Database Using Oracle Recovery Manager (RMAN)
If you backed up your database using
bkup_api
, then you can manually restore
that database backup by using the Oracle Recovery Manager (RMAN)
utility. For information about using RMAN, see the Oracle Database Backup and Recovery User's
Guide for Release 19.
While recovering using RMAN is safe, you must not use RMAN to initiate backups or edit backup setting in conjunction with either
backup_api
usage or in conjunction with
automated console backups. Doing so could result in conflicting
conditions or over-writes of settings, and backups may not execute
successfully.