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

Configure an Oracle Wallet with RAC within NetBackup

The configuration and setup of the Oracle Wallet in NetBackup is a two-step process. You add descriptors first, then you register the wallet. In the cases of Oracle RAC, your descriptors must enumerate the list of RAC instances that comprise your RAC cluster.

NetBackup Oracle Wallet prerequisites:

The Oracle wallet location must be accessible from all nodes of the RAC cluster.
Using a shared location is encouraged for maintainability.
An example storage location can be: An Oracle ACFS file system that is mounted on each node or an NFS share accessible to each node. The mount point of the shared location must be the same on each node.
If the wallet is not in a shared location, it must be in an identically duplicate location on each node of the RAC cluster. The full contents of the wallet must also be duplicated on each node of the RAC cluster.

To configure Oracle Wallet with RAC in NetBackup:

Retrieve the RAC connect descriptors for all instances in the RAC database. Place the list of connect descriptors in a text file for easy access at step 2. Use one of the following methods:
Get RAC connect descriptors from the NetBackup web UI:
- On the left, click Workloads > Oracle and then click RAC databases.
- Click RAC connect descriptors from the action menu on the right in the RAC database row.
- Copy each full RAC connect descriptor by highlighting the text save the connector for later use.
Get RAC connect descriptors from the NetBackup CLI:
- Use the nboraadm command to retrieve the connect descriptors:
```
nboraadm -list_rac_instances 
-rac_db_unique_name RAC_DB_NAME -show_connect_descriptor
```
- Copy the connect descriptors from the screen or use the '>' command to create a file with the connect descriptors.
Manually create the RAC connect descriptors:
- If you don't have this information, use the web UI Oracle RAC functionality or nboraadm to retrieve the information needed. You need to retrieve the scan name, service name, and port number for the given RAC database. If the RAC instances for the RAC database are not known, use either interface to collect the list of instance names.
- For each instance of a RAC, you must insert this information to create a connect descriptor. Insert the scan name, service name, and port number (from RAC database), as well as the instance name (from RAC instance) into the following example:
```
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)
(HOST=<INSERT SCAN NAME>)(PORT=<INSERT PORT NUMBER>))
(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=<INSERT SERVICE NAME>)
(INSTANCE_NAME=<INSERT INSTANCE NAME>)))
```

Add the connect descriptors with the Oracle MKSTORE utility. The descriptors are case-sensitive and must match exactly to what is in NetBackup.

mkstore -wrl /db/orac183/wallet/ -CreateCredential 
'(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=exampleScanName.veritas.com)
(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)
(SERVICE_NAME=orac183.veritas.com)(INSTANCE_NAME=orac1831)))' 
testUser testPassword

mkstore -wrl /db/orac183/wallet/ -CreateCredential 
'(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=exampleScanName.veritas.com)
(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)
(SERVICE_NAME=orac183.veritas.com)(INSTANCE_NAME=orac1832)))' 
testUser testPassword

Register the RAC with the wallet path using the web UI.
To register the RAC with the wallet path from the CLI, run nboraadm -register_rac_db.
If the RAC is registered for the first time from discovery, you need to include the dbid. From the CLI, run nboraadm -register_rac_db -rac_db_unique_name.
(Optional) If you get an error when you attempt to register the RAC, review the error message. Compare the descriptors in the error message with what you generated in step 1 and what you inserted into your Oracle wallet.

More Information

Add an Oracle Real Application Cluster (RAC)