NetBackup102 RelNotes
NetBackup102 RelNotes
NetBackup102 RelNotes
Notes
Release 10.2
Document Version 1
NetBackup™ Release Notes
Last updated: 2023-03-30
Legal Notice
Copyright © 2023 Veritas Technologies LLC. All rights reserved.
Veritas, the Veritas Logo, Veritas Alta, 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 CustomerCare_Japan@veritas.com
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:
NB.docs@veritas.com
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
latest version of NetBackup is used as a basis on which the appliance code is built.
For example, NetBackup Appliance 3.1 is based on NetBackup 8.1 This development
model ensures that all applicable features, enhancements, and fixes that were
released within NetBackup are included in the latest release of the appliance.
The NetBackup appliance software is released at the same time as the NetBackup
release upon which it is based, or soon thereafter. If you are a NetBackup appliance
customer, make sure to review the NetBackup Release Notes that correspond to
the NetBackup appliance version that you plan to run.
Appliance-specific documentation is available at the following location:
http://www.veritas.com/docs/000002217
Note: The NetBackup Release Notes only lists the new platform support that begins
at a particular NetBackup version level at the time of its release. However, Veritas
routinely backdates platform support to previous versions of NetBackup. Refer to
the NetBackup compatibility lists for the most up-to-date platform support listings.
New features
■ Changes in Veritas terminology
■ Improvements to the NetBackup web UI
■ New EEB management view
■ Configuring Veritas Alta Recovery Vault Azure and Azure Government
■ RESTful APIs included in NetBackup 10.2
■ Linux environments require a new non-root database user when the root user
starts NetBackup daemons
■ New connection pooler on port 13787
Other announcements
■ Using Azure recovery points with Snapshot Manager
■ Single file restore from a backup of snapshot
■ Elastic media server provides autoscaling of replicas
■ Documentation changes
Note: As Veritas continues to update its terminology, the deprecated terms and
the new terms may be used interchangeably.
Master Primary
■ Configuring NetBackup Alta Recovery Vault Azure and Azure Government using
the CLI
API documentation
You can find documentation for the NetBackup APIs in on SORT and on your
primary server. Make sure to review the Versioning topic and the What's New topic
in the Getting Started section.
■ On SORT:
NetBackup API documentation is available on SORT:
HOME > KNOWLEDGE BASE > Documents > Product Version > 10.2
Look under API Reference. A Getting Started document provides background
information about using NetBackup APIs. The API YAML files are also available
for reference, however, they are not functional. You cannot test the APIs from
the documents on SORT.
■ On your primary server:
APIs are stored in YAML files on the primary server:
https://<primary_server>/api-docs/index.html
The APIs are documented in Swagger format. This format lets you review the
code and test the functionality by making actual calls with the APIs. You must
have the appropriate security permissions to access the primary server and
APIs to use the Swagger APIs.
New APIs
NetBackup 10.2 includes these new and enhanced APIs:
■ Drives:
Retrieve list of drives.
■ Images:
Retrieve the contents for raw partition eligible images.
New features, enhancements, and changes 15
NetBackup 10.2 new features, changes, and enhancements
■ Jobs: Retrieve job ID for new job after restarting specified original job.
■ NAS Workloads:
Recover individual files and folders from a NAS system.
■ FlashBackup Windows Workloads:
■ Recover individual files and folders from a FlashBackup backup.
■ Recover individual files and folders from a FlashBackup Windows backup.
■ Log Records:
■ Retrieve the logging level values of hosts and its components for specified
record ID.
■ Update the logging level settings to the host and its components for specified
record ID.
Versioned APIs
There are no versioned APIs in NetBackup 10.2.
Note: This information is subject to change. See the NetBackup Compatibility List
for all Versions for the most recent product and services support additions and
changes.
New features, enhancements, and changes 16
NetBackup 10.2 new features, changes, and enhancements
The following products and services are supported starting with NetBackup 10.2:
■ Red Hat Enterprise Linux Server 9.0 as a primary and a media server
■ Oracle Linux 9.0 as a primary and a media server
■ Azure Stack Hub 2206
■ MariaDB 10 on Red Hat Enterprise Linux 9.0
■
Note: Support for PaaS database protection for AWS RDS SQL began with
NetBackup 10.1.1. For more information, see the NetBackup Web UI Cloud
Administrator's Guide.
■ bpdown
■ bpclusterkill
Please plan accordingly. The new command will be announced in future release
notes and in the NetBackup Commands Reference Guide.
■ Veritas recommends that you run the database precheck tool to identify any
potential data issues before you upgrade NetBackup. See
New features, enhancements, and changes 18
NetBackup 10.2 new features, changes, and enhancements
For the latest cloud configuration package, see the following article:
https://www.veritas.com/content/support/en_US/downloads/update.UPD971796
For additional information on adding cloud storage configuration files, refer to the
following tech note:
http://www.veritas.com/docs/100039095
Documentation changes
With this release, the NetBackup Deployment Guide for Azure Kubernetes Services
(AKS) Cluster and the NetBackup Deployment Guide for Amazon Elastic Kubernetes
Services (EKS) Cluster will no longer be published. These guides are now combined
into one guide:NetBackup Deployment Guide for Kubernetes Clusters. NetBackup
Chapter 3
Operational notes
This chapter includes the following topics:
For more information, refer to the mklogdir command from the Veritas NetBackup
Commands Reference Guide.
NetBackup servers must use a host name that is compliant with RFC
1123 and RFC 952
Starting with NetBackup 8.0, all NetBackup server names must use a host name
that is complaint with RFC 1123 ("Requirements for Internet Hosts - Application
and Support") and RFC 952 ("DOD Internet Host Table Specification") standards.
These standards include the supported and unsupported characters that can be
used in a host name. For example, the underscore character ( _ ) is not a supported
character for host names.
More information is available about these standards and about this issue:
RFC 952
RFC 1123
http://www.veritas.com/docs/000125019
These standards should be applied to all computing hosts, including all NetBackup
hosts. To accommodate legacy environments and functionality, features of
NetBackup that were implemented before 2010 continue to allow some
non-compliant characters. But newer features, as well as more recently integrated
3rd-party components, are not tested with nor expected to be compatible with host
names that do not adhere to the industry standards.
In some situations, it may be possible to configure name services with a network
hostname alias that is standards-compliant, and then use the alias when you
configure NetBackup. But using host names that are standards-compliant is the
only way to ensure compatibility with all features.
Operational notes 25
NetBackup administration and general operational notes
Note: Before you take the NetBackup database server offline with the -stop option,
stop all services that are running except the NetBackup Scale-Out Relational
Database.
Operational notes 26
NetBackup administration and general operational notes
After PIT restore, "The host ID does not exist" error appears
After a point in time (PIT) restore operation (which may include either a Full File
System restore or a BMR restore), the error message The host ID does not exist
appears.
In this scenario, a full backup is taken when a SERVICE_USER as root/administrator
account is configured. This account takes the backup of the NetBackup installed
binaries with root/administrator ownership. Before a restore, SERVICE_USER is
configured with an account other than root/administrator, and then an incremental
backup is taken where the service user is backed up as part of bp.conf. In a PIT
restore operation with the incremental backup, the SERVICE_USER entry gets
restored. However, the binaries are restored in the root account ownership.
Workaround:
After changing the service user, you must take a full backup, whether it is a
MS-Windows\Standard Policy for File System or BMR policy configuration.
After DR, jobs using Veritas Alta Recovery Vault volumes may fail
After a disaster recovery is performed for NetBackup 10.2, the refresh token of a
Veritas Alta Recovery Vault credential may become invalid. This situation can lead
to failure for jobs that use Veritas Alta Recovery Vault volumes. For more information,
see the following technical article:
https://veritas.com/en_US/article.100055366
handling the client connection from the various programs that want to perform
database activities.
For some workload environments, reduce the size of the job database
before upgrade
Following an upgrade to NetBackup 9.1, existing jobs for certain workloads are
assigned an asset namespace to enable access control at an asset level. This
process may take some time. You should reduce the size of the jobs database
before upgrade. This action minimizes the amount of processing required to perform
the association and minimizes the effect on web services performance. Very large
job databases may see an alert regarding high heap space usage.
The affected workloads include: Cloud, Nutanix AHV, RHV, and VMware
For further details see the following article:
http://www.veritas.com/docs/100049808
After PIT restore, "The host ID does not exist" error appears
After a point in time (PIT) restore operation (which may include either a Full File
System restore or a BMR restore), the error message The host ID does not exist
appears.
In this scenario, a full backup is taken when a SERVICE_USER as root/administrator
account is configured. This account takes the backup of the NetBackup installed
binaries with root/administrator ownership. Before a restore, SERVICE_USER is
configured with an account other than root/administrator, and then an incremental
Operational notes 30
NetBackup Bare Metal Restore operational notes
backup is taken where the service user is backed up as part of bp.conf. In a PIT
restore operation with the incremental backup, the SERVICE_USER entry gets
restored. However, the binaries are restored in the root account ownership.
Workaround:
After changing the service user, you must take a full backup, whether it is a
MS-Windows\Standard Policy for File System or BMR policy configuration.
0,51216,434,434,1225074,1669017201225,3136,3144,0:,211:MountManagerApi::AddMountPoint() -
Error: Failed to create mountpoint:
\\?\Volume{7427BE07-4C03-4849-8B50-4BB2186EAFE0} for device:
\Device\vstor2-mntapi20-shared-90B9CB47000010000000000001000000.
Error code:
87,42:CVmwareOffHostVmRestoreWorker.cpp:ubslog(),5
0,51216,434,434,1225075,1669017201225,3136,3144,0:,188:SetupVirtVolumeAccess
The device \Device\vstor2-mntapi20-shared-90B9CB47000010000000000001000000 has no
drive letter. Using the volume guid \\?\Volume{9d318822-6695-11ed-80b4-806e6f6e6963},
Operational notes 31
NetBackup Snapshot Manager (formerly NetBackup CloudPoint)
42:CVmwareOffHostVmRestoreWorker.cpp:ubslog(),5
0,51216,434,434,1225076,1669017201242,3136,3144,0:,91:FormatEx was unable to complete
successfully 126-The specified module could not be
found.!!,
42:CVmwareOffHostVmRestoreWorker.cpp:ubslog(),5
Workaround:
Because this issue is specific to NetBackup 10.2 Virtual Instance Converter (VIC),
you can use NetBackup 10.1 Virtual Instance Converter (VIC) to do BMR direct VM
conversion of NetBackup 10.2 backups.
Backups from snapshot jobs for NAS data protection policy fail with
error 927
Backups from snapshot jobs for NAS data protection policy fail with error 927. This
issue occurs if the backup host pool does not contain a host that is of the same or
lower version of NetBackup than the media server.
Workaround:
Ensure that all media servers associated with the storage unit, specified in the
Storage Lifecycle Policy (SLP), have a higher version NetBackup than the lowest
version of backup host in the backup host pool.
To exclude a media server, go to the storage unit properties for the STU specified
in the SLP. Select the Only use the following media servers option. Then select
the media servers with a NetBackup version higher or equal to the lowest NetBackup
version of the hosts in the backup host pool.
Success message appears along with the error message when you
delete the policy that has snapshots
When you delete the policy that has snapshots, the following success and error
messages appear. However, the policy is not deleted and only error message should
appear.
■ Error: Invalid state: This policy contains snapshots. Please delete
all snapshots and try again.
Workaround:
Add IP host name mapping in /etc/hosts to resolve this issue.
For more information, see the following Support article:
https://www.veritas.com/support/en_US/article.100045941
Database does not sync after NetBackup cluster gets new nodes
After NetBackup re-configuration post addition of two more nodes to existing
NetBackup VM cluster ("import policies" was not selected), the databases do not
sync against already existing NetBackup VM.
It is expected that while adding the two new nodes, the databases on node1 should
get synced up with the two new nodes, and the existing policies must be available
post the reconfig on the new 3-node NetBackup VM cluster.
Workaround:
Run the policy import from CLI.
Workaround:
Upload the certificates again.
Snapshots fails with "object is not subscriptable" for many policy jobs
at the exact same time
Running more than 25 policies at the same time leads to an error. The nbosdmapi
service does not respond.
Snapshots fail with Object is not subscriptable. error.
Workaround:
Contact Veritas Support to implement a known workaround.
■ Host name (primary server, media server, Enterprise Media Manager (EMM)
server, volume database host, media host, client, instance group)
■ Policy name
■ Policy KEYWORD (Windows only)
■ Backup, Archive, and Restore KEYWORD (Windows only)
■ Storage unit name
■ Storage unit disk pathname (Windows only)
■ Robot name
■ Device name
■ Schedule name
■ Media ID
■ Volume group name
■ Volume pool name
■ Media description
■ Vault policy names
■ Vault report names
■ BMR Shared Resource Tree (SRT) name
■ Token name
■ Storage lifecycle policy (SLP) names
Appendix A
About SORT for
NetBackup Users
This appendix includes the following topics:
■ Custom Reports
Use this tool to get recommendations for your system and Veritas enterprise
products.
■ NetBackup Future Platform and Feature Plans
Use this tool to get information about what items Veritas intends to replace with
newer and improved functionality. The tool also provides insight about what
items Veritas intends to discontinue without replacement. Some of these items
include certain NetBackup features, functionality, 3rd-party product integration,
Veritas product integration, applications, databases, and the OS platforms.
Help for the SORT tools is available. Click Help in the upper right corner of the
SORT home page. You have the option to:
■ Page through the contents of the help similar to a book
■ Look for topics in the index
■ Search the help with the search option
Appendix B
NetBackup installation
requirements
This appendix includes the following topics:
Note: This free disk space requirement assumes that you have already
performed the best practice of completing a successful catalog backup before
you begin the upgrade.
■ Primary and media servers must have a minimum soft limit of 8000 file
descriptors per process for NetBackup to run correctly.
For more information about the effects of an insufficient number of file descriptors,
refer to the following articles on the Veritas Support website:
http://www.veritas.com/docs/000013512
■ NetBackup primary and media servers exchange server version information at
startup, and every 24 hours. This exchange occurs automatically. During startup
after an upgrade, the upgraded media server uses the vmd service to push its
version information to all of the servers that are listed in its server list.
■ Veritas recommends that you have the primary server services up and available
during a media server upgrade.
■ All compressed files are compressed using gzip. The installation of these files
requires gunzip and gzip, so make sure that they are installed on the computer
before you attempt to install NetBackup. For all UNIX platforms except HP-UX,
the binaries are expected to be in /bin or /usr/bin and that directory is a part
of the root user’s PATH variable. On HP-UX systems, the gzip and gunzip
commands are expected to be in /usr/contrib/bin. Installation scripts add
that directory to the PATH variable. These commands must be present to have
successful UNIX installations.
such compatibility issues are noted, Veritas recommends that you install the latest
OS updates on your servers and clients before you install or upgrade NetBackup.
The most up-to-date required OS patch information for NetBackup 10.2 and other
NetBackup releases can be found on the Veritas Services and Operational
Readiness Tools (SORT) website and in the NetBackup Compatibility Lists for All
Versions. The compatibility lists include information about the minimum OS level
that is required to support a minimum NetBackup version in the latest major release
line. In some cases, new releases of NetBackup may require specific vendor OS
updates or patches.
See “About NetBackup compatibility lists and information” on page 46.
See “About Veritas Services and Operations Readiness Tools” on page 38.
Note: As of NetBackup 8.3, the Java GUI and JRE packages are optional with most
clients and media servers. The package sizes were calculated with the Java GUI
and JRE included.
Note: Table B-1 lists only the supported operating systems. For up-to-date
information about the specific operating system versions that NetBackup currently
supports, check the Installation and Upgrade Checklist on the Services and
Operations Readiness Tools (SORT) website, or the NetBackup Compatibility List
for all Versions.
Red Hat Enterprise Linux z/Architecture 889 MB No longer Media server or client compatibility only.
Server supported
SUSE Linux Enterprise Server z/Architecture 904 MB No longer Media server or client compatibility only.
supported
Note: For information about which versions of NetBackup are compatible with each
other, select a Software Compatibility List (SCL), and then select Compatibility
Between NetBackup Versions from within the SCL.
Using SORT
Advance notification of future platform and feature support including end-of-life
(EOL) information is available through a widget on the Veritas Services and
Operations Readiness Tools (SORT) for NetBackup home page. The NetBackup
Future Platform and Feature Plans widget on the SORT for NetBackup home page
can be found directly at the following location:
https://sort.veritas.com/nbufutureplans
NetBackup end-of-support-life (EOSL) information is also available at the following
location:
https://sort.veritas.com/eosl/show_matrix
See “About Veritas Services and Operations Readiness Tools” on page 38.
Note: Veritas assumes no responsibility for the correct installation or use of PDF
reader software.
All references to UNIX also apply to Linux platforms unless otherwise specified.