Search <book_title>...

NetBackup™ for Oracle Administrator's Guide

Last Published: 2023-10-23

Product(s): NetBackup (10.3.0.1, 10.3)

Introduction
1. About NetBackup for Oracle
2. NetBackup for Oracle features
NetBackup for Oracle QuickStart
1. Install NetBackup for Oracle
2. Register Oracle database instances
3. Add an Oracle database instance group
4. Create an Oracle policy
Installing NetBackup for Oracle
1. Verifying the operating system and platform compatibility
2. NetBackup server and client requirements for NetBackup for Oracle
3. Requirements for using NetBackup for Oracle in a NetBackup cluster
4. License for NetBackup for Oracle
5. About accurate licensing for Oracle
6. About linking Oracle RMAN with NetBackup for UNIX
  1. Verifying environment variables and shutting down Oracle
  2. Linking Oracle RMAN with NetBackup on UNIX platforms
Configuring RBAC for the Oracle administrator
1. RBAC roles for the Oracle administrator
Managing Oracle instances and databases
1. About Oracle discovery
  1. Configure discovery of Oracle clients
2. Managing Oracle instances
3. Manage Oracle databases and pluggable databases
  1. View Oracle database details
  2. View pluggable database details
4. About Oracle database instance groups
  1. Add an instance to an instance group
5. Clean up Oracle instance and databases
6. Authorizing a DBA to register instances or instance groups with the nboraadm command
Managing Oracle credentials
1. About Oracle credentials
2. Oracle credential types in the NetBackup Credential Management (CMS)
3. Add a credential to use for cloning an Oracle database
4. Edit or delete a named credential
5. Manage credentials for an instance or an Oracle RAC database
Configuring Oracle policies
1. Preparing for NetBackup for Oracle configuration
2. About Oracle Intelligent Policies (OIP)
3. About script-based Oracle policies
4. Configuring the logon account for the NetBackup Client Service for NetBackup for Oracle
5. Testing configuration settings for NetBackup for Oracle
Managing Oracle RAC
1. Oracle Real Application Clusters (RAC)
2. Add an Oracle Real Application Cluster (RAC)
3. Edit or delete an Oracle RAC database
Performing backups and restores of Oracle
1. Overview of using NetBackup for Oracle
2. Maintaining the RMAN repository
3. Querying the RMAN repository
4. About NetBackup for Oracle backups
  1. Running the NetBackup for Oracle shell script
  2. Running RMAN
5. Browsing backups using the bplist command
6. Managing expired backup images
  1. About preventing the direct expiration of backup images
7. About NetBackup for Oracle restores
8. Using NetBackup for Oracle in a Windows Server Failover Cluster (WSFC)
Oracle cloning
1. About cloning an Oracle database or a pluggable database
2. Create a custom RBAC role for Oracle cloning
3. Clone an Oracle database
4. Clone a pluggable database
5. Cloning a database from an Oracle Intelligent Policy (OIP) that is Data Guard aware
6. Additional functionality in NetBackup APIs
NetBackup Copilot for Oracle
1. About Oracle Copilot
2. Configuring an OIP using a share on the NetBackup appliance (Oracle Copilot)
3. Creating an instant recovery point from an Oracle Copilot image (NetBackup Appliance share)
4. Deleting an instant recovery point for Oracle Copilot instant recovery
5. Configuring an OIP using universal shares (Oracle Copilot)
  1. Recommendations when you configure an Oracle Copilot with universal shares
  2. Troubleshooting issues related to Oracle Copilot with universal shares
6. Managing an instant access mount from an Oracle Copilot universal share image
7. Cleaning up the Oracle Copilot share after point in time restore of database
8. Single-step restore to ASM storage from an Oracle Copilot recovery point or instant access mount
9. About restoring from a data file copy to ASM storage using RMAN
Oracle Copilot with instant access
1. Prerequisites when you configure an instant access Oracle database
  1. Hardware configuration requirement of instant access
2. Things to consider before you configure an instant access mount point
3. Backing up an Oracle database using Oracle Copilot policy with a universal share
4. Configure an instant access mount
5. View the livemount details of an instant access mount
6. Configuring Auto Image Replication for Oracle instant access backups
7. Delete an instant access mount
8. NetBackup for Oracle terms
9. Frequently asked questions
NetBackup for Oracle with Snapshot Client
1. About NetBackup for Oracle with Snapshot Client
2. How NetBackup for Oracle with Snapshot Client works
3. About configuring Snapshot Client with NetBackup for Oracle
4. Restoring NetBackup for Oracle from a snapshot backup
  1. About restoring individual files from a NetBackup for Oracle snapshot backup
  2. About NetBackup for Oracle restores of volumes and file systems using snapshot rollback
    1. Performing a snapshot rollback restore using a script or RMAN command
    2. Performing a NetBackup for Oracle point-in-time rollback restore from a SnapVault backup (UNIX)
5. About configuring NetBackup for Oracle block-level incremental backups on UNIX
6. About Snapshot Client effects
7. About Oracle support for Replication Director
  1. Configuring an Oracle Intelligent Policy using Replication Director
  2. Configuring a script-based Oracle policy
NetBackup Dedupe Direct for Oracle
1. About NetBackup Dedupe Direct for Oracle plug-in
2. Verifying the operating system and platform compatibility
3. Before you install NetBackup Dedupe Direct for Oracle plug-in
4. Installing NetBackup Dedupe Direct for Oracle plug-in on the Oracle database server
5. Using NetBackup Dedupe Direct for Oracle plug-in
6. Uninstalling the NetBackup Dedupe Direct for Oracle plug-in
Other Oracle configuration
1. Load balance Oracle RAC instances
2. Configure an Oracle Wallet with RAC within NetBackup
Troubleshooting
1. About troubleshooting NetBackup for Oracle
2. About NetBackup for Oracle troubleshooting steps
3. NetBackup debug logs and reports
4. Enabling the debug logs manually (Windows)
5. Enabling the debug logs manually (UNIX)
6. About the NetBackup for Oracle log files
7. Setting the debug level on a Windows client
8. Setting the debug level on a UNIX client
9. About RMAN utility logs
10. Troubleshooting RMAN backup or restore errors
  1. Verifying the RMAN script on UNIX
  2. Troubleshooting each stage of the backup or restore
11. Troubleshooting NetBackup for Oracle with Snapshot Client
12. Error: Unable to re-create online log
13. Minimizing timeout failures on large database restores
14. Minimizing the loading and unloading of tapes for database backups
15. Enabling the debug logs manually for NetBackup Dedupe Direct for Oracle plug-in
Appendix A. Deduplication best practices
1. Optimizing and deduplicating stream-based and proxy copy Oracle backups
2. Oracle stream handler
3. Configuring a stream-based Oracle backup
4. Example RMAN script for a stream-based backup
5. Editing the RMAN script and configuring NetBackup for Oracle for a proxy copy backup
6. Example RMAN script for a proxy copy backup
Appendix B. Snapshot Client support of SFRAC
1. About Snapshot Client support of SFRAC
2. NetBackup configuration for an SFRAC environment
3. Configuring the SFRAC environment for a backup operation
4. Performing a rollback restore in an SFRAC environment
5. Troubleshooting NetBackup in an SFRAC environment
Appendix C. Script-based Block-Level Incremental (BLI) Backups without RMAN on UNIX and Linux systems
1. About script-based Block-Level Incremental (BLI) Backups without RMAN
2. About BLI backup and restore operations
3. Verifying installation requirements for BLI backups without RMAN
  1. File system and Storage Checkpoint space management
4. Creating NetBackup policies for script-based BLI backup
5. Performing backups and restores
6. About troubleshooting backup or restore errors
Appendix D. XML Archiver
1. NetBackup for Oracle XML export and XML import
2. About the environment variables set by a user in the XML export parameter file
3. About XML export shell scripts
  1. Creating XML export scripts manually
4. Performing an XML export archive
5. Browsing XML export archives using bporaimp parameters
6. Browsing XML export archives using bplist
7. Restoring an XML export archive
8. Troubleshooting XML export or XML import errors
  1. Checking the logs to determine the source of an error
  2. Troubleshooting each stage of the XML export or XML import
9. Additional XML export and import logs
Appendix E. Register authorized locations
1. Registering authorized locations used by a NetBackup database script-based policy

Troubleshooting NetBackup in an SFRAC environment

The following describes some common errors and how to troubleshoot them:

Problem: The backup failed with error code 6 displayed in the GUI. The rman_script.out file shows the following error:
```
RMAN-06403: could not obtain a fully authorized session
	ORA-01034: ORACLE not available
	ORA-27101: shared memory realm does not exist
	SVR4 Error: 2: No such file or directory
```
Resolution: Check the ORACLE_HOME and ORACLE_SID values. ORACLE_HOME should not have an extra '/' at the end.
Problem: The backup failed with error code 239. The dbclient logs show the following log statement:
```
serverResponse: ERR - server exited with status 239: the specified 
client does not exist in the specified policy
01:02:23.844 [4000] <16> CreateNewImage: ERR - serverResponse() fail
```
Resolution: The client name mentioned in the policy and in the bp.conf file at the client are different.

Problem: The backup failed with error 156. The bpfis logs show the following error.

CVxFSPlugin::vxFreezeAll : ioctl VX_FREEZE_ALL failed with errno : 16
CVxFSPlugin::quiesce - Could not quiesce as VX_FREEZE_ALL failed and 
VX_FREEZE is not allowed

Resolution: Add the following lines to the /usr/openv/lib/vxfi/configfiles/vxfsfi.conffile:

file:[QUIESCENCE_INFO]
"QUIESCENCE_SERIAL_QUIESCENCE"=dword:00000001

Problem: The rollback failed with the following error displayed in the GUI:

Failed to process backup file <bk_113_1_728619266>

The dbclient logs show the following error:

xbsa_ProcessError: INF - leaving
xbsa_QueryObject: ERR - VxBSAQueryObject: Failed with error: Server 
Status: client is not validated to use the server
xbsa_QueryObject: INF - leaving (3)
int_FindBackupImage: INF - leaving
int_AddToFileList: ERR - Failed to process backup file 
<bk_113_1_728619266>

Resolution : Add the following line in the bp.conf file on the primary node of the cluster PREFERRED_NETWORK = <virtual_name>

More Information

About Snapshot Client support of SFRAC