NetBackup1011 WebUIGuide OracleAdmin
NetBackup1011 WebUIGuide OracleAdmin
Oracle Administrator's
Guide
Release 10.1.1
Last updated: 2022-12-12
Legal Notice
Copyright © 2022 Veritas Technologies LLC. All rights reserved.
Veritas, the Veritas Logo, and NetBackup are trademarks or registered trademarks of Veritas
Technologies LLC or its affiliates in the U.S. and other countries. Other names may be
trademarks of their respective owners.
This product may contain third-party software for which Veritas is required to provide attribution
to the third party (“Third-party Programs”). Some of the Third-party Programs are available
under open source or free software licenses. The License Agreement accompanying the
Software does not alter any rights or obligations you may have under those open source or
free software licenses. Refer to the Third-party Legal Notices document accompanying this
Veritas product or available at:
https://www.veritas.com/about/legal/license-agreements
The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Veritas Technologies
LLC and its licensors, if any.
The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, et seq.
"Commercial Computer Software and Commercial Computer Software Documentation," as
applicable, and any successor regulations, whether delivered by Veritas as on premises or
hosted services. Any use, modification, reproduction release, performance, display or disclosure
of the Licensed Software and Documentation by the U.S. Government shall be solely in
accordance with the terms of this Agreement.
http://www.veritas.com
Technical Support
Technical Support maintains support centers globally. All support services will be delivered
in accordance with your support agreement and the then-current enterprise technical support
policies. For information about our support offerings and how to contact Technical Support,
visit our website:
https://www.veritas.com/support
You can manage your Veritas account information at the following URL:
https://my.veritas.com
If you have questions regarding an existing support agreement, please email the support
agreement administration team for your region as follows:
Japan [email protected]
Documentation
Make sure that you have the current version of the documentation. Each document displays
the date of the last update on page 2. The latest documentation is available on the Veritas
website:
https://sort.veritas.com/documents
Documentation feedback
Your feedback is important to us. Suggest improvements or report errors or omissions to the
documentation. Include the document title, document version, chapter title, and section title
of the text on which you are reporting. Send feedback to:
You can also see documentation information or ask a question on the Veritas community site:
http://www.veritas.com/community/
https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf
Contents
■ Oracle RAC databases are discovered when NetBackup queries the Oracle
Cluster Ready Services (CRS) using the Oracle Clusterware high availability
API.
Oracle RAC in the web UI does not support upgrades from legacy script-based
policies. Also, there is no web UI support for the configurations that are created
using Appendix A or Appendix B in the NetBackup for Oracle Administrator’s Guide.
To allow the NetBackup web UI to discover a RAC instance or cluster:
■ Remove the Oracle RAC from any configuration that is setup using Appendix
A or Appendix B in the NetBackup for Oracle Administrator’s Guide.
■ Remove any Oracle RAC from existing OIP policies in the current NetBackup
Administrator’s Console.
Note: When an Oracle RAC database is discovered, that database does not have
a Database ID. A Database ID is required to manually add additional RAC instances
to the database. You must register the RAC database and provide a Database ID
before adding additional instances.
See “Manage credentials for an instance or an Oracle RAC database” on page 14.
See “Add an Oracle Real Application Cluster (RAC)” on page 12.
By default, this service is enabled to report instances. However, you can use the
REPORT_CLIENT_DISCOVERIES client configuration entry to shut down or restart the
service on a particular client. By default, REPORT_CLIENT_DISCOVERIES is not present
in the Windows registry or the UNIX bp.conf file.
To change the default setting, use bpsetconfig to add or change the entry:
■ In the Windows registry.
■ In the /usr/openv/netbackup/bp.conf file on UNIX.
Use the following format: REPORT_CLIENT_DISCOVERIES = TRUE | FALSE
Set REPORT_CLIENT_DISCOVERIES to FALSE to shut down the discovery service.
The service shuts down within 10 minutes and remains down on the client. To turn
on the discovery service on that client, set REPORT_CLIENT_DISCOVERIES to TRUE
or remove the entire entry. Then run bp.start_all on the client to restart the
service.
To set this value on a client remotely, run the following command from the primary
server:
Note: For more information about instance management, see Instance management
for an Oracle Intelligent Policy in the NetBackup for Oracle Administrator’s Guide.
Note: Instance group names cannot be localized. NetBackup does not support
non-US ASCII characters in the instance group name.
Note: Any nodes of the Oracle RAC cluster that is used in backups, must be running
a NetBackup client. The version should be the same version across the cluster.
For Oracle RAC OIP support the NetBackup 8.3 client is required.
Managing Oracle RAC 12
Add an Oracle Real Application Cluster (RAC)
Enter the appropriate credential information for the Oracle RAC and then click
Add credentials.
See “Load balance Oracle RAC instances” on page 27.
Managing Oracle RAC 13
Edit or delete an Oracle RAC database
4 Click Finish.
To add credentials for a RAC database
1 On the left, click Workloads > Oracle and then click RAC databases.
2 In the RAC databases tab, click the Actions menu for the instance and select
Manage credentials.
3 In the Manage credentials for RAC database screen, select one of the
appropriate credential authentication methods:
■ Select Use Oracle Wallet to use the credentials that are located in the
Oracle Wallet. For non-RAC installations, the instance net service name
must be stored in the Oracle Wallet as defined in Oracle’s wallet
documentation.
■ Select RAC database credentials and enter the correct Username and
Password for the database.
■ (Optional) Enter credentials for the Oracle RMAN recovery catalog
credentials section.
■ Backing up an Oracle database using Oracle copilot policy with universal share
Prerequisites:
■ For Build Your Own (BYO) server, the operating system version must be same
as the latest appliance operating system version that is RHEL 7.6 and later.
■ For BYO server, NGINX is installed on the storage server.
■ The NGINX version must be same as the one in the corresponding official
RHEL version release. You need to install it from the corresponding RHEL
yum source (EPEL).
■ Ensure that the policycoreutils and policycoreutils-python packages
are installed from the same RHEL yum source (RHEL server). Then run the
following commands:
■ semanage port -a -t http_port_t -p tcp 10087
■ setsebool -P httpd_can_network_connect 1
■ For BYO server, the /mnt folder on the storage server cannot be mounted by
any mount points directly. User mount points must be mounted to its subfolders.
■ For BYO server, enable the logrotate permission in SELinux using the following
command:
semanage permissive -a logrotate_t
■ Instant access is only supported for Oracle backup images when the following
conditions are met:
■ The backup is an Oracle Copilot incremental merge (Whole
Database-Datafile Copy Share and Database Backup Shares).
For more information, see Backup Selections tab in the NetBackup for Oracle
Administrator’s Guide.
■ The backup is a full database backup.
■ The primary server, media server, storage server, and client version must
be NetBackup 10.0 or later. The NetBackup appliance must be running
software version 4.0 or later.
For instant access using backup copies from cloud LSU (logical storage
unit), the primary server and media server must be at NetBackup 10.0.1 or
later.
■ The storage server must be NetBackup Appliance, Flex Appliance, Flex
WORM, Flex Scale, Media Server Deduplication Pool (MSDP) AKS (Azure
Kubernetes Services)/EKS (Amazon Elastic Kubernetes Service) deployment,
and BYO on-premises or cloud-based that meets the earlier specified
prerequisites.
For more information about limitations of instant access for cloud LSU (logical
storage unit), refer to the NetBackup Deduplication Guide.
Oracle Copilot with instant access and universal share 18
Things to consider before you configure an instant access mount point
Note: Oracle Copilot with instant access is not supported on a universal share that
has WORM enabled storage.
■ /usr/openv/netbackup/bin/nbwmc stop
■ /usr/openv/netbackup/bin/nbwmc start
3 Click the Recovery points tab, then click the date on which the backup
occurred.
The available images appear in rows with the backup timestamp for each
image.
4 Right-click on the backup image and click Actions > Configure instant access
mount.
Note: This option is only displayed if the recovery point supports instant access.
5 Enter the host names where you want to configure the instant access mount
for the database.
6 Click Configure.
7 After the instant access job starts, click on the Restore activity tab to view
the progress.
See “View the livemount details of an instant access mount” on page 20.
If you back up multiple universal shares and then create an instant access database,
multiple instant access mounts are configured.
3 On the Instant access databases tab, click on the database name to see its
details.
Export path Exported instant access livemount path from the storage
server.
Recovery point time Date when the recovery point was created.
Retention Time period for which you want the instant access mount
to be retained.
4 To save the full export path to your Clipboard, click on the copy-to-clipboard
icon next to the export path in the details listing.
Term Definition
Full backup A full backup backs up all the blocks into the backup set, skipping only
data file blocks that have never been used. Note that a full backup is
not the same as a whole database backup; "full" is an indicator that
the backup is not incremental.
Incremental backup An incremental backup is a backup of only those blocks that have
changed since a previous backup. Oracle lets you create and restore
incremental backups of data files, tablespaces, and a database. You
can include a control file in an incremental backup set, but the control
file is always included in its entirety. No blocks are skipped.
Oracle Copilot with instant access and universal share 24
Frequently asked questions
Term Definition
Multilevel RMAN lets you create multilevel backups. RMAN can create multilevel
incremental backup incremental backup. A value of 0 or 1 denotes each incremental level.
Differential In a differential level 1 backup, RMAN backs up all blocks that have
incremental backup changed since the most recent incremental backup at level 1
(cumulative or differential) or level 0. For example, in a differential level
1 backup, RMAN determines which level 1 backup is the most recent
backup. RMAN backs up all blocks that have been modified after that
backup. If no level 1 is available, then RMAN copies all blocks that
have changed since the base level 0 backup.
How can I enable the Oracle instant access Perform the steps in the following order:
feature on BYO after storage is configured or
1 Install the required NGINX service version.
upgraded without the NGINX service
installed? 2 Run the command:
/usr/openv/pdde/vpfs/bin/vpfs_config.sh
--configure_byo
How can I resolve the following issue in the Perform the steps in the following order:
vpfs-config.log file that is raised from?
1 Install the policycoreutils and policycoreutils-python
Verifying that the MSDP REST API
packages through the yum tool.
is available via https on port
10087 2 As required by SELinux for NGINX, add the following rules to bind
on the 10087 port.
■ semanage port -a -t http_port_t -p tcp 10087
■ setsebool -P httpd_can_network_connect 1
Instant Access for BYO uses a self-signed To configure the external certificate, perform the following steps:
certificate by default and only supports *.pem
1 If the new certificate is already generated (the certificate must
external certificate.
contain long and short host names for the media server), go to
How do I replace it with a certificate signed step 5.
by external CA (*.pem certificate), if required?
2 Create the RSA public or private key pair.
3 Create a certificate signing request (CSR).
The certificate must contain long and short host names for the
media server.
/usr/openv/pdde/vpfs/bin/vpfs_config.sh
--configure_byo
Oracle Copilot with instant access and universal share 26
Frequently asked questions
How can I disable media automount for the Follow the guideline to disable the gnome automount:
instant access livemount share in gnome?
https://access.redhat.com/solutions/20107
If the automount is enabled, the source folder
is mounted from the livemount share in
gnome and smaller disks appear. In this
scenario, the instant access feature does not
work properly.
How can I resolve the following issue in the Perform the steps in the following order:
/var/log/vpfs/vpfs-config.log file?
1 Ensure that your NetBackup primary server is up and there is no
**** Asking the NetBackup firewall blocking the connection between the primary server and
Webservice to trust the MSDP storage server.
webserver (spws) ****
2 Run the following command on storage server to verify the
/usr/openv/netbackup/bin/nblibcurlcmd connection status:
failed (1):
/usr/openv/netbackup/bin/bpclntcmd -pn
/usr/openv/pdde/vpfs/bin/vpfs_config.sh
--configure_byo
Chapter 5
Other Oracle configuration
This chapter includes the following topics:
6 (Optional) If you select Do not use in the action menu on the right, that instance
moves to the RAC instances excluded from backup table.
NetBackup does not use this instance when backup operations are performed.
7 Click Save.
See “Add an Oracle Real Application Cluster (RAC)” on page 12.
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>)))
2 Add the connect descriptors with the Oracle MKSTORE utility. The descriptors
are case-sensitive and must match exactly to what is in NetBackup.
3 Register the RAC with the wallet path using the web UI.
See “Add an Oracle Real Application Cluster (RAC)” on page 12.
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.
4 (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.