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

Oracle stream handler

The Oracle stream handler is not enabled by default for existing and new Oracle clients in NetBackup 8.3. Also, the Oracle stream handler only supports stream-based backups and you can enable and disable the Oracle stream handler per <client> <policy> combination using the cacontrol command line utility.

In NetBackup 10.0, the Oracle stream handler is enabled (by default) for all new clients that have no existing images. As with previous versions, the Oracle stream handler only supports stream-based backups and you can configure the Oracle stream handler using the cacontrol command line utility. You can enable and disable the stream handler per the following:

Policy and client
Policy level
Stream type level

Note:

When you use the Oracle stream handler, it is not recommended to use variable-length deduplication.

The cacontrol command utility with the --sth flag, is used to override the default behavior of NetBackup by creating a Marker Entry for a client, policy, or stream type in a configuration file. The cacontrol command utility is located in the following locations:

Windows: install_path\Veritas\pdde\cacontrol
UNIX: /usr/openv/pdde/pdcr/bin/cacontrol

In the following examples for cacontrol, STHTYPE must be set to Oracle to configure the Oracle stream handler.

In NetBackup 8.3, you can configure cacontrol using the following options:

You can query the settings for the stream handler per client and policy.
```
cacontrol --sth get <STHTYPE> <CLIENT> <POLICY> [SPAUSER]
```

You can enable the stream handler per client and policy.

cacontrol --sth update 
<STHTYPE> <CLIENT> <POLICY> [SPAUSER] <enabled>

You can delete the settings for client and policy (return to default behavior).
```
cacontrol --sth delete <STHTYPE> <CLIENT> <POLICY> [SPAUSER]
```

You can disable the stream handler on a client and policy.

cacontrol --sth update 
<STHTYPE> <CLIENT> <POLICY> [SPAUSER] <disabled>

Note:

When you use cacontrol to set <POLICY> or <STHTYPE> to enabled, NetBackup enables all the old clients which have existing images. The deduplication rate decreases significantly only at the first backup after enabled. Also, the storage usage increases only in the first backup after enabled. Basically, NetBackup behaves as if you have run a first full backup. Both the deduplication rate and storage usage improve after initial activation of the stream handler.

When using the cacontrol command utility to create a Marker Entry in NetBackup 10.0, priority is given to the more granular configuration. For example:

Marker Entry 1: <Client1> <Policy1> to enabled

Marker Entry 2: <Policy1> to disabled

The stream handler is enabled because the more granular configuration in Marker Entry 1 has higher priority.

In NetBackup 10.0, you can configure cacontrol using the following options:

You can query the settings for the stream handler per client and policy.
```
cacontrol --sth get <STHTYPE> <CLIENT> <POLICY> [SPAUSER]
```

You can enable the stream handler per client and policy.

cacontrol --sth update 
<STHTYPE> <CLIENT> <POLICY> [SPAUSER] <enabled>

You can delete the settings for a client and policy (return to default behavior).
```
cacontrol --sth delete <STHTYPE> <CLIENT> <POLICY> [SPAUSER]
```

You can disable the stream handler on a client and policy.

cacontrol --sth update 
<STHTYPE> <CLIENT> <POLICY> [SPAUSER] <disabled>

You can query the settings for the stream handler per policy.
```
cacontrol --sth getbypolicy <STHTYPE> <POLICY> [SPAUSER]
```

You can enable the stream handler per policy.

cacontrol --sth updatebypolicy 
<STHTYPE> <POLICY> [SPAUSER] <enabled>

You can delete the settings for the stream handler per policy (return to default behavior).
```
cacontrol --sth deletebypolicy <STHTYPE> <POLICY> [SPAUSER]
```

You can disable the stream handler per policy.

cacontrol --sth updatebypolicy 
<STHTYPE> <POLICY> [SPAUSER] <disabled>

You can query the settings for the stream handler per stream handler type.
```
cacontrol --sth getbytype <STHTYPE> [SPAUSER]
```

You can enable a stream handler per stream handler type.

cacontrol --sth updatebytype <STHTYPE> [SPAUSER] <enabled>

You can delete the settings for a stream handler (return to default behavior).
```
cacontrol --sth deletebytype <STHTYPE> [SPAUSER]
```

You can disable the stream handler per stream handler type.

cacontrol --sth updatebytype <STHTYPE> [SPAUSER] <disabled>