NetBackup1011 RelNotes
NetBackup1011 RelNotes
Notes
Release 10.1.1
Document Version 1
NetBackup™ Release Notes
Last updated: 2022-12-18
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
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
■ Resilient backup jobs feature is now available
■ Support for agentless recovery to switch to instant access
■ Activity monitor improvements in the NetBackup web UI
■ Additional NetBackup Flex Scale features in the Flex Scale web UI
■ Limited types of job filters can be imported into NetBackup web UI
■ RESTful APIs included in NetBackup 10.1.1
Note: As Veritas continues to update its terminology, the deprecated terms and
the new terms may be used interchangeably.
Master Primary
NetBackup supports resilient backup jobs with Standard and Windows-NT policy
types. The policy's associated storage unit must be configured on a NetBackup
10.1.1 or greater media server. Additionally, multistreaming, multiple copies, and
multiplexing are not supported. Backup jobs with hierarchies are not supported.
See the NetBackup Administrator's Guide, Volume I for the new bp.conf resilient
backup settings.
For full instructions on managing NetBackup Flex Scale, see the following resources.
NetBackup Flex Scale Installation and Configuration Guide
NetBackup Flex Scale Administrator's Guide
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.1.1
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.1.1 includes these new and enhanced APIs:
■ Server Groups:
Asynchronously delete bulk server groups.
■ Bare Metal Restore:
Retrieve list of thin pools from BMR configuration.
New features, enhancements, and changes 16
NetBackup 10.1.1 new features, changes, and enhancements
■ Log Records:
■ Retrieve in-progress record count.
■ Create new log record.
■ Upload logs for a record ID.
■ Gather logs for a record ID.
■ Retrieve details of a record ID.
■ Delete collected logs for a record ID.
Versioned APIs
These APIs that have been versioned in NetBackup 10.1.1 due to breaking changes.
The previous version of these APIs is still supported by specifying the correct
version. See the Versioning section in the API Reference on SORT for examples
and more details.
■ Get Jobs:
GET /admin/jobs has changed the properties of the object getJobsResponse
to return the activeElapsedTime and elapsedTime attributes in ISO 8601
duration format.
■ Get Root Hierarchy Jobs:
GET /admin/root-hierarchy-jobs has changed the properties of the object
getJobsResponse to return the activeElapsedTime and elapsedTime attributes
in ISO 8601 duration format.
■ Get Job:
GET /admin/jobs/{jobId} has changed the properties of the object
getJobByIdResponse to return the activeElapsedTime and elapsedTime
attributes in ISO 8601 duration format.
■ Examples:
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.
The following products and services are supported starting with NetBackup 10.1.1:
■ VMware - VDDK 8.0 - Sanity
■ VMWare - Red Hat 9.0 as a Backup Host
■ Hyper-V for Windows Server 2022
■ Red Hat OpenStack 16.2 Proliferation
■ Microsoft SQL 2016 SP3 - Windows Server 2016
■ Microsoft SQL 2016 SP3 - Windows Server 2019
■ Ubuntu 22.04 as NBSM Host OS
■ Red Hat Enterprise Linux (RHEL) 9.0 as NBSM Host OS and Asset OS
■ COSP - NetApp StorageGRID
■ COSP – Red Hat CEPH
■ NetApp StorageGRID – S3 Object Lock
■ Quantum Activescale – S3 Object Lock
Note: Backup and restore of a namespace with mixed volumes is not supported
in the NetBackup 10.1.1 release.
For more information, see the NetBackup Web UI Kubernetes 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.
VMware backups support for file system optimizations with XFS file
systems
VMware backups on XFS file systems now support file system optimizations (exclude
deleted and unused blocks).
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.
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
Policy name link does not work for some failed jobs in the web UI
Activity Monitor
For some failed jobs that are displayed in the Activity Monitor in the NetBackup
web UI, the Policy name link is not functional. For these jobs, you cannot click the
policy name to view further details.
Workaround:
To view details about these jobs, navigate to the Policies page and find the policy.
BMR tries to mount the disks on the Virtual Instance Converter (VIC) VDDK mount
call.
The following example shows how the error appears in the bmrb2vrst logs:
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},
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.1.1 Virtual Instance Converter (VIC),
you can use NetBackup 10.1 Virtual Instance Converter (VIC) to do BMR direct VM
conversion of NetBackup 10.1.1 backups.
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.
The default haproxy configuration works fine with most of the environments. When
the time-out issue with the NBOSDMAPI is observed, customize the haproxy
configuration. For more information, see the following tech note:
https://www.veritas.com/support/en_US/article.100052551
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.
Operational notes 31
NetBackup for OpenStack operational notes
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.
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.
■ DB2:
Datafile path, Tablespace name
■ SAP:
English SAP runs on localized OS. ( No specific SAP fields are localized.)
■ Exchange:
Mailboxes, Mails, Attachment names and contents, Public folders, Contacts,
Calendar, Folders and Database paths
■ SharePoint:
Site Collection Names, Libraries and lists within the site collection
■ Lotus Notes:
Emails data /.nsf files
■ Enterprise Vault (EV) agent:
Vault store, Partitions, Data
■ VMWare:
Username, Password, VM display name, DataCenter, Folder, Datastore,
Resource pool, VApp, Network name, VM disk path
■ 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:
free space is required in those locations equal to or greater than the size of the
files in those locations. Refer to the NetBackup Administrator's Guide, Volume
I for more information about storing NBDB database files in alternate locations.
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.1.1 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 43.
See “About Veritas Services and Operations Readiness Tools” on page 36.
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 821 MB No longer Media server or client compatibility only.
Server supported
SUSE Linux Enterprise Server z/Architecture 836 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 36.
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.