Recovering Oracle backups
Unitrends supports recovery of full and incremental backups. As with Oracle backups, the agent leverages RMAN to perform recovery operations. Oracle recoveries occur in two phases. First, the backup is extracted to the server’s storage and exposed as a CIFS share (/backups/rae/<asset_name>/ <instance>). In the second phase, the asset accesses the exposed CIFS share, and the RMAN is invoked to recover back to the Oracle database.
Consider the following before recovering Oracle data from the backup system:
• | Free space equivalent to twice the size of the backup is required on the Unitrends appliance for recovery processing. If adequate space is not available, the recovery fails. |
• | Recoveries are performed to the original database only. If you are recovering from a Unitrends appliance backup copy target and the original database is not available, you can recover from the target after performing a bare metal recovery of the Oracle asset. This procedure is only supported for Oracle on Windows platforms running Oracle 19c, 18, 12c, or 11g. See Windows Bare Metal Protection and Recovery for details. |
• | Only one recovery or backup operation per database can run at any given time. |
• | For a given database, any backups initiated while a recovery is in progress fails. Once the recovery completes, backups can be run for the given database. |
• | For a given database, any recoveries initiated while a backup is in progress will fail. Once the backup completes, recoveries can be run for the given database. |
• | For item-level recovery, the backup is unfolded to a Unitrends appliance. From here you can recover items using an Oracle or third-party tool. After recovery, you must tear down the recovery object. See Recovering Oracle backups for procedures and details. Subsequent backup or recovery operations for the given instance fail until the share has been manually torn down. |
• | For Oracle on Windows, recovery requires that the underlying file system has the same structure as when the database was initially backed up. For details, see Oracle Database: Failed to Create File. |
The following recovery options are available:
• | Recover – Select a backup to recover all data in the backup group up to the point in time when the backup ran. |
• | Recover Files – Search a selected backup and choose specific files to recover. |
You can recover from a backup by using the Backup Catalog or the Backup Browser. To recover from an imported backup copy, you must use the Backup Catalog. See these topics for details:
This procedure recovers a database to the original location. Note that the existing database is deleted from the Oracle instance as part of the recovery process.
Run this procedure from the backup appliance to recover a backup or imported backup copy. To recover from a hot backup copy, see Oracle recovery from a Unitrends appliance backup copy target.
1 | Log in to the backup appliance. |
2 | Select Recover and click the Backup Catalog tab. |
(Optional) Use Filter Backups to the right to customize the backups that display. For details, see Working with custom filters.
3 | Expand the Oracle asset and select the backup or imported backup copy. |
(To import a backup copy, see To import a cold backup copy or To import a hot backup copy.)
4 | Click Recover. |
5 | Select the desired recovery options. |
6 | Click Save. |
To monitor the recovery, select Jobs > Active Jobs.
Notes:
• | In a successful recovery, status changes from Queued to Active to Successful. |
• | If the status displays as Canceled with a message Share is unavailable, the recovery cannot run because a share already exists for this instance. To determine what process is using the share and how to proceed, see Recovering Oracle backups. |
This procedure recovers a database to the original location. Note that the existing database is deleted from the Oracle instance as part of the recovery process.
Note: This procedure is not supported for imported backups and backup copies. To recover an imported backup, use the Backup Catalog procedure above. To recover from a hot backup copy, see Oracle recovery from a Unitrends appliance backup copy target.
1 | Log in to the backup appliance. |
2 | Select Recover > Backup Catalog and click Backup Browser. |
3 | Select the Appliance and Date Range of backups to search. Backups that ran during the date range display. |
4 | (Optional) Refine the search: |
• | Enter text in any column field to filter the display. |
• | Click an arrow to sort by column. |
• | Click the accordion icon to add or remove columns from the display. (Not all columns display by default.) |
• | For a description of each column, see Backup Browser column descriptions. |
5 | Select the Oracle backup. |
6 | Click Recover. |
7 | Select the desired recovery options. |
8 | Click Save. |
To monitor the recovery, select Jobs > Active Jobs.
Notes:
• | In a successful recovery, status changes from Queued to Active to Successful. |
• | If the status displays as Canceled with a message Share is unavailable, the recovery cannot run because a share already exists for this instance. To determine what process is using the share and how to proceed, see Recovering Oracle backups. |
Use this procedure to unfold the backup to a share on the backup appliance. Once unfolded, use an Oracle or third-party tool to recover desired items.
Run this procedure from the backup appliance to recover items from a backup or imported backup copy. To recover from a hot backup copy, see Oracle recovery from a Unitrends appliance backup copy target.
1 | Log in to the backup appliance. |
2 | Select Recover and click the Backup Catalog tab. |
(Optional) Use Filter Backups to the right to customize the backups that display. For details, see Working with custom filters.
3 | Expand the Oracle asset and select the backup or imported backup copy. |
(To import a backup copy, see To import a cold backup copy or To import a hot backup copy.)
4 | Click Recover Files. |
5 | Click Confirm to create the recovery object and start the recovery. |
6 | Click OK to clear the Notice dialog. |
A row for this recovery displays on the File Level Recovery tab.
7 | Select the Oracle recovery row and click Show Details to display the full path of the share: \\<ApplianceIP>\<InstanceID>. |
Note: Record the Network Path to access files to recover later.
8 | On the workstation to be used to recover files, map a network drive to \\<ApplianceIP>\<InstanceID>. |
9 | Recover the desired items using an Oracle or third-party tool. |
10 | Disconnect the network share once files are recovered. To disconnect the share, select the share and click Remove. |
11 | On the backup appliance, tear down the recovery object. |
Important! Tear down the objects soon as possible. Subsequent backups and recoveries cannot run for this instance until the object has been manually torn down.
Use this procedure to unfold the backup to a share on the backup appliance. Once unfolded, use an Oracle or third-party tool to recover desired items.
Note: This procedure is not supported for imported backups and backup copies. To recover items from an imported backup, use the Backup Catalog procedure above. To recover from a hot backup copy, see Oracle recovery from a Unitrends appliance backup copy target.
1 | Log in to the backup appliance. |
2 | Select Recover > Backup Catalog and click Backup Browser. |
3 | Select the Appliance and Date Range of backups to search. Backups that ran during the date range display. |
4 | (Optional) Refine the search: |
• | Enter text in any column field to filter the display. |
• | Click an arrow to sort by column. |
• | Click the accordion icon to add or remove columns from the display. (Not all columns display by default.) |
• | For a description of each column, see Backup Browser column descriptions. |
5 | Select the Oracle backup. |
6 | Click Recover Files. |
7 | Click Confirm to create the recovery object and start the recovery. |
8 | Click OK to clear the Notice dialog. A row for this recovery displays on the File Level Recovery tab. |
9 | Select the Oracle recovery row and click Show Details to display the full path of the share: \\<ApplianceIP>\<InstanceID>. |
Note: Record the Network Path to access files to recover later.
10 | On the workstation to be used to recover files, map a network drive to \\<ApplianceIP>\<InstanceID>. |
11 | Recover the desired items using an Oracle or third-party tool. |
12 | Disconnect the network share once files are recovered. To disconnect the share, select the share and click Remove. |
13 | On the backup appliance, tear down the recovery object. |
Important! Tear down the objects soon as possible. Subsequent backups and recoveries cannot run for this instance until the object has been manually torn down.
Only one recovery or backup job per instance can run at any given time. If an Oracle backup or recovery operation fails with a share is unavailable message, a share already exists for this database. Review the following for additional information:
• | If a share exists for this database, it is in use by another backup or recovery process, or it has not been torn down after a previous recovery. |
• | If no active job is using the share, tear down the share. Disconnect any network drive mappings to the share before tearing it down. To tear down the share, select Recover, click the File Level Recovery tab, select the share, and click Remove. |
• | To view details on active jobs, select Jobs and click the Active Jobs tab. |
After files are recovered, the object remains until you tear it down. Because appliance resources are used to maintain the object, it is important to tear it down to ensure optimal performance.
To view Oracle recovery image
Select Recover and click the File Level Recovery tab.
To tear down the Oracle recovery object
1 | Disconnect any network drive mappings to the share before tearing it down. |
2 | Select Recover and click the File Level Recovery tab. |
3 | Select the recovery image to tear down. |
4 | Click Remove. |
Use this procedure if you are unable to recover from the backup appliance. This procedure is only supported on Oracle on Windows platforms running Oracle 19c, 18, 12c, or 11g.
Because Oracle recovery to an alternate server is not supported, this procedure requires that you perform a disaster recovery (DR) of the Windows asset to a new asset that is directly attached to the backup copy target. See Windows Bare Metal Protection and Recovery for details.
Once the asset has been recovered, you perform an Oracle granular recovery.
Consider the following before recovering from a Unitrends appliance backup copy target:
• | Free space equivalent to twice the size of the backup is required on the local share for recovery processing. If adequate space is not available, the recovery fails. |
• | A backup copy of the source asset taken after the database was deployed is required. To perform DR using Windows integrated recovery, the backup copy must have been run using version 7.3 or higher for BIOS-based assets, or version 7.4 or higher for UEFI-based assets. To perform DR using Windows image-based bare metal, the backup must be a bare metal backup. |
• | A backup copy of the database to recover is required. |
• | Only one recovery or backup operation per database can run at any given time. Any backup or recovery initiated while another is in progress fails. |
• | The Oracle backup is unfolded to a remote share. When you are finished recovering, you must tear down the share. Subsequent backup or recovery operations for the given instance will fail until the share has been torn down. |
1 | Perform a disaster recovery of the Oracle asset from the Unitrends appliance backup copy target. See Windows Bare Metal Protection and Recovery for details. |
2 | Select Recover and click the File Level Recovery tab to determine if a share exists for this database. Review the following before proceeding: |
• | If no share exists for this database, proceed to the next step in this procedure. |
• | If a share exists for this database, it is in use by another backup or recovery process, or it has not been torn down after a previous recovery. You cannot perform the item recovery until the share is available. |
• | If no active job is using the share, tear down the share. Disconnect any network drive mappings to the share before tearing it down. To tear down the share, select it and click Remove. |
• | To view details on active jobs, select Jobs and click the Active Jobs tab. |
3 | Select Recover, and click the Backup Catalog tab. |
4 | In the Filter Backups window on the right, select Backup Copy. |
5 | (Optional) Select other filter options. For details, see Working with custom filters. |
6 | Click Filter. |
7 | Expand the list of backups under the Oracle instance and select a backup to recover. |
8 | Click Recover Files. |
9 | Click the File Level Recovery tab. |
10 | Select the share and click Show Details. |
Record or copy the CIFS path as it displays in the File Level Recovery Details window.
11 | Log in to the target you created in step 1. |
12 | Open Windows Explorer. |
13 | In Windows Explorer, navigate to the CIFs path recorded in step 10. |
14 | Open the file unitrends-<database>.env. Note the following values: |
• | Oracle SID |
• | Oracle Home |
• | Backup # |
15 | Open a command-line prompt. |
16 | Execute the following commands: |
# set ORACLE_SID=<SIDfromLastStep>
# set ORACLE_HOME=<HomefromLastStep>
# %ORACLE_HOME%\bin\rman target /
# shutdown immediate;
# startup nomount;
# restore controlfile from '<pathFromStep8>\unitrends-<database>.ctf';
# alter database mount;
# crosscheck backup;
# catalog start with '<pathFromStep8>\unitrends';
# list backup tag 'unitrends-<backup#FromLastStep>';
17 | Run the following commands: |
# restore database;
# recover database;
# alter database open resetlogs;
# quit;
The Oracle recovery is complete.
18 | On the Unitrends appliance backup copy target, disconnect any network mapping to the share and tear down the restore share. To tear down the share, select it and click Remove. |
Important! Tear down the share as soon as possible. Subsequent backups and restores cannot run for this instance until the share has been manually torn down.