NetBackup8302 RelNotes
NetBackup8302 RelNotes
NetBackup8302 RelNotes
Release Notes
Release 8.3.0.2
Document Version 1
Veritas NetBackup™ Release Notes
Last updated: 2021-07-29
Legal Notice
Copyright © 2021 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 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.
Upgrade documentation
For instructions to upgrade to NetBackup 8.3.0.2, see the NetBackup 8.3 Upgrade
Guide.
Operational notes are often added or updated after a version of NetBackup has
been released. As a result, the online versions of the NetBackup Release Notes or
other NetBackup documents may have been updated post-release. You can access
the most up-to-date version of the documentation set for a given release of
NetBackup at the following location on the Veritas Support website:
NetBackup Release Notes, Administration, Installation, Troubleshooting, Getting
Started, and Solutions Guides
For more information, refer to the mklogdir command from the Veritas NetBackup
Commands Reference Guide.
Operational notes 13
NetBackup installation and upgrade operational notes
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
Do not install from the menu that appears when the installation DVD
is inserted
The operating system may open a user interface window (such as File Manager
on Solaris) when the installation DVD is inserted into the disc drive. Veritas
recommends that you do not use this window to install NetBackup products because
unpredictable results may occur. Make sure to follow the installation instructions
that are found in the NetBackup Installation Guide.
Operational notes 14
NetBackup administration and general operational notes
Child backup jobs may enter a queued state for workloads that use
BigData policy
In NetBackup Appliance environments with multiple backup hosts where the BigData
policy is used, one of the child backup jobs may go into a queued state if the media
server goes into an inactive state. This scenario applies to Hadoop, HBase, and
MongoDB workloads.
Workaround:
Operational notes 15
NetBackup administration and general operational notes
From the Media and Device Management > Devices > Media servers menu in
NetBackup Administration Console, right-click the inactive media server and change
the status from Deactivated to Activate.
<INTSALL_PATH>/var/global/vxss/tomcatcreds/nbwebsvc/.VRTSat/profile/certstore/keystore
On UNIX:
<INSTALL_PATH>/var/global/vxss/tomcatcreds/nbwebsvc/.VRTSat/profile/certstore/keystore
2 After you have verified that the nbatd service has successfully migrated the
NetBackup CA, run the following command to renew the NetBackup web server
certificate:
nbseccmd -nbcamigrate -syncMigrationDB
Workaround:
1. Run the nbstlutil cancel -backupid <backup identifier> command to
cancel the backup job and clean up the pending jobs.
2. Trigger a manual backup.
2. If any of the partitions belongs to LVM, then remove the volume group from
disk using the vgreduce command and then the pvremove command.
3. Execute the blockdev -flushbufs command to remove any outstanding
reference to that device.
4. Remove the device references from the device tree. For example,
whole/partition disks /dev/xvdf, /dev/disk/by-path, by-id, by-label, by-partuuid
and by-uuid
5. Use the following command to remove the device from sysfs:
6. echo 1 > /sys/block/device-name/device/delete
If you encounter this issue, apply the appropriate Solaris patches or upgrades that
Oracle provides for this issue.
BMR restore may take significant amount of time for formatting and
volume creation step
Due to operating system changes, a Bare Metal Restore (BMR) restore may take
significant time during the formatting step when there are logical volumes in the
system being restore. Red Hat Enterprise Linux 8 has introduced some changes
for LVM2 which causes scanning of the udev database. This scanning takes a
significant amount of time for LVM-related operations.
When you perform a BMR restore, you may see the following message in the bmrrst
logs:
WARNING: Device * not initialized in udev database even after waiting
10000000 microseconds.
The BMR restore still succeeds, despite the longer restore time.
During the upgrade, the on-host agent from an actual VM "auto-grt-97230" released
the earlier connection, and the agent on the restored VM was able to connect on
the same queue. After the upgrade, the source on-host agent did not get the lock
and then continued to fail with the resource_locked error, making the on-host
agent offline.
Workaround:
Follow these steps if you want to take the application-consistent snapshots
of the restored instance:
1 On the restored host:
Operational notes 21
NetBackup with Veritas CloudPoint operational notes
■ For a Linux on-host agent, follow the steps from the Veritas NetBackup
CloudPoint Install and Upgrade Guide section Registering the Linux-based
agent.
■ For a Windows on-host agent, follow the steps from the Veritas NetBackup
CloudPoint Install and Upgrade Guide section Registering the
Windows-based agent.
Note: Ensure that you have removed the previously installed on-host agent
before installation and re-registration.
■ Windows:
Restart Veritas NetBackup CloudPoint Agent service
Follow the steps below if you want to take the crash-consistent snapshots of
the restored instance:
1 On the restored host:
■ Follow the steps from the Veritas NetBackup CloudPoint Install and Upgrade
Guide section Removing the CloudPoint agents.
2 Follow the steps below on the host from which the snapshot was restored:
■ Log in to the host.
■ Restart the flexsnap-agent:
■ Linux:
sudo systemctl stop flexsnap-agent.service
sudo systemctl start flexsnap-agent.service
■ Windows:
Restart Veritas NetBackup CloudPoint Agent service
Operational notes 22
NetBackup with Veritas CloudPoint operational notes
Workaround:
Follow these steps if you want to take the application-consistent snapshots
of the restored instance:
1 On the restored host:
■ For a Linux on-host agent, follow the steps from the Veritas NetBackup
CloudPoint Install and Upgrade Guide section Registering the Linux-based
agent.
■ For a Windows on-host agent, follow the steps from the Veritas NetBackup
CloudPoint Install and Upgrade Guide section Registering the
Windows-based agent.
Note: Ensure that you have removed the previously installed on-host agent
before installation and re-registration.
■ Windows:
Restart Veritas NetBackup CloudPoint Agent service
Follow the steps below if you do not want to take the application-consistent
snapshots of the restored instance:
1 On the restored host:
■ Follow the steps from the Veritas NetBackup CloudPoint Install and Upgrade
Guide section Removing the CloudPoint agents.
2 Follow the steps below on the host from which the snapshot was restored:
■ Log in to the host.
■ Restart the flexsnap-agent:
■ Linux:
sudo systemctl stop flexsnap-agent.service
sudo systemctl start flexsnap-agent.service
■ Windows:
Restart Veritas NetBackup CloudPoint Agent service
Configuring AWS plug-in with IAM role showed that the Authentication
Method field is blank
If you attach an IAM role to a CloudPoint server that is already added to NetBackup,
the role is not assigned in NetBackup.
Workaround:
You must sync NetBackup with CloudPoint by using the following command:
/usr/openv/volmgr/bin/tpconfig -update -cloudpoint_server <ip/name
which CP is registered in NBU> -cloudpoint_server_user_id admin
-manage_workload CLOUD
<asset_id: eg:fs-lnxnative-ext4-74d0ad4b-d81e-4819-9a68-
Operational notes 25
NetBackup with Veritas CloudPoint operational notes
bda6b3750b8e-33280449d30c2bb766721379375a1130>
with exc <Exception details>.
Workaround:
You can use the following command to unfreeze the file system:
fsfreeze -u <mount_point>
In the case of an Oracle application, if CloudPoint fails to unfreeze the file system,
the next snapshot job fails.
Different source and target zones for Google Cloud Platform are not
supported
Although Google Cloud Platform allows the restore snapshot across all zones, the
CloudPoint server does not allow the source location and target location of the
restore to be in different zones across plug-in configurations. This issue occurs
Operational notes 26
NetBackup deduplication operational notes
because the zones are managed by configuration and so the restore to zones which
is not part of config is not supported.
Workaround:
Ensure that the source location and the target locations are in the same zones as
plug-in configurations.
Backup jobs fail with "Storage server is down ..." for WORM storage
servers in multi-domain environments
A problem occurs in a multi-domain environment, where two domains (both
NetBackup master servers) share an MSDP user name.
If Domain 1 and Domain 2 have the same MSDP user name, and Domain 1 has
created a NetBackup WORM Storage Server, and Domain 2 is configured to connect
to the WORM Storage Server, backup jobs fail with the error Storage Server is
down or unavailable.
Workaround:
1. Create a new user for Domain 2. On the NetBackup WORM Storage Server,
run the following command to create the MSDP user:
setting MSDP-user add-MSDP-user username=user_name
3. On the NetBackup WORM Storage Server, stop and then restart the NetBackup
Deduplication Manager (spad):
dedupe MSDP stop
HPE 3PAR array snapshot import fails with status code 4213
An HPE 3PAR array snapshot import fails with status code 4213. Currently,
CloudPoint does not support the snapshot type Clone for the VSO (virtual server
owner) snapshot method.
Workaround: Reconfigure the policy using the snapshot type COW (copy-on-write).
In the case of the Index from Snapshot operation, if the /usr/openv directory on
the snapshot mount host is linked to a different path, the contents of the snapshot
is not indexed accurately in the catalog.
Workaround: Reconfigure the storage lifecycle policy to have only the snapshot
operation and remove the index from snapshot operation.
■ 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.
noted, Veritas recommends that you install the latest OS updates on your servers
and clients before you install or upgrade NetBackup.
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. Table B-1 includes the OS updates and patches that are required for
NetBackup 8.3.0.2. However, this information may sometimes change in between
releases. The most up-to-date required OS patch information for NetBackup 8.3.0.2
and other NetBackup releases can be found on the Veritas Services and Operational
Readiness Tools (SORT) website and in the NetBackup compatibility lists.
See “About NetBackup compatibility lists and information” on page 40.
See “About Veritas Services and Operations Readiness Tools” on page 32.
Note: An OS vendor may have released a more recent update or patch that
supersedes or replaces a patch that is listed in Table B-1. The OS patches that are
listed here and in SORT should be considered at the minimum patch level that is
required to install and run NetBackup. Any OS updates, patches, or patch bundles
that supersede or replace those listed in Table B-1 are supported unless otherwise
specified. Veritas recommends that you visit the Support website of your particular
OS vendor for their latest patch information.
Note: Any required patch that is listed in Table B-1 for the NetBackup client should
also be installed on your master servers and media servers to ensure proper client
functionality.
Table B-1 Required operating system patches and updates for NetBackup
8.3.0.2
Table B-1 Required operating system patches and updates for NetBackup
8.3.0.2 (continued)
Oracle Linux 7 Media, client Kernel 3.10.0-229.7.1 or later More information is available:
Red Hat Enterprise Linux 7 Master, media, Kernel 3.10.0-229.7.2.el7 or More information is available:
client later
Red Hat tech note
RHSA-2015:1137 - Security
Advisory
SUSE Linux 11 Master, media, SUSE Linux Enterprise 11 More information is available:
client Service Pack 3 or later
Security update for Linux
kernel:SUSE-SU-2014:1695-1
NetBackup installation requirements 38
Required operating system patches and updates for NetBackup
Table B-1 Required operating system patches and updates for NetBackup
8.3.0.2 (continued)
SUSE Linux 12 Master, media, Kernel 3.12.31 or later More information is available:
client
Security update for the Linux
Kernel: SUSE-SU-2015:0068-1
Veritas recommends the following updates when you run NetBackup on Windows
operating systems:
■ Symantec AntiVirus. Update to latest version and latest update (required).
■ The Symevent driver updates (required). Update to latest driver version.
Appendix C
NetBackup compatibility
requirements
This appendix includes the following topics:
includes a media server, it must use the same NetBackup version as the primary
server to perform a catalog backup.
For complete information about compatibility between NetBackup versions, refer
to the Veritas SORT website.
Veritas recommends that you review the End of Support Life information available
online.
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.
maintaining support for existing versions of products, while also introducing new
support for the following:
■ General availability releases
■ Latest versions of new software and hardware
■ New NetBackup features and functionality
While Veritas continually adds support for new features and systems, it may be
necessary to improve, replace, or remove certain support in NetBackup. These
support actions may affect older and lesser-used features and functionality. The
affected features and functionality may include support for software, OS, databases,
applications, hardware, and 3rd-party product integration. Other affected items may
include the products that are no longer supported or nearing their end-of-support
life with their manufacturer.
Veritas provides advance notification to better help its customers to plan for
upcoming changes to the support status of the various features in NetBackup.
Veritas intends to list older product functionality, features, systems, and the 3rd-party
software products that are no longer supported in the next release of NetBackup.
Veritas makes these support listings available as soon as possible with a minimum
of 6 months where feasible before major releases.
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 32.
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.