Veritas NetBackup™ Upgrade Guide

Last Published:
Product(s): NetBackup (9.1)
  1. Introduction
    1.  
      About the NetBackup 9.1 Upgrade Guide
    2.  
      Available NetBackup upgrade methods
    3. About changes in NetBackup 9.1
      1.  
        Windows compiler and security requirements for NetBackup 9.1 and later installation and upgrade
      2.  
        Java GUI and JRE installation optional for some computers
      3.  
        Logging directory permissions require reset on rollback
      4.  
        Upgrades from NetBackup 7.6.0.4 and earlier are not supported
      5.  
        External certificate authority certificates supported in NetBackup 8.2 and later
    4.  
      About Veritas Usage Insights
    5.  
      Best practices for Veritas Usage Insights
  2. Planning for an upgrade
    1. General upgrade planning information
      1.  
        About planning a NetBackup 9.1 upgrade
      2.  
        How to plan for an upgrade to NetBackup 9.1
      3.  
        Known catalog backup limitation
      4.  
        About security certificates for NetBackup hosts
      5.  
        About automatic file changes from an upgrade
      6.  
        Reduce the job database size before upgrade
      7.  
        Known SUSE Linux primary server upgrade issue
    2. About upgrade tools
      1.  
        About Veritas Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for upgrades
      3.  
        About the NetBackup preinstall checker
    3. Upgrade operational notes and limitations
      1.  
        Creating the user account to support the NetBackup web server
      2.  
        About NetBackup 9.1 support for Fibre Transport Media Server with RHEL 7.5 and later
      3.  
        MSDP changes in NetBackup 8.1
      4.  
        Potential required changes for NetApp clusters
      5.  
        Errors when Bare Metal Restore information is replicated using Auto Image Replication
      6.  
        Upgrade issue with pre-8.1 clients and 8.1 or later media servers
  3. Master server upgrade
    1.  
      About primary server upgrades
    2.  
      Preinstall procedure for upgrading to NetBackup 9.1
    3.  
      Performing local, remote, or clustered server upgrades on Windows systems
    4.  
      Performing silent upgrades on Windows systems
    5.  
      Upgrading UNIX and Linux server software to NetBackup 9.1
    6.  
      Post-install procedure for upgrading to NetBackup 9.1
    7.  
      About NetBackup startup and shutdown scripts
    8.  
      Completing your system update after an upgrade
  4. Media server upgrade
    1.  
      Upgrading NetBackup media servers to NetBackup 9.1
    2.  
      Silently upgrading NetBackup media server software on UNIX and Linux
  5. MSDP upgrade for NetBackup
    1.  
      MSDP upgrade considerations for NetBackup 8.1
    2.  
      About MSDP rolling data conversion
    3.  
      About MSDP fingerprinting algorithm changes
  6. Client upgrade
    1.  
      About client upgrades
    2.  
      Upgrading UNIX and Linux clients with the NetBackup upgrade script
    3.  
      Upgrade of the UNIX and Linux client binaries with native installers
  7. NetBackup Deployment Management with VxUpdate
    1.  
      About VxUpdate
    2.  
      Commands used in VxUpdate
    3.  
      Repository management
    4.  
      Deployment policy management
    5.  
      Manually initiating upgrades from the primary server using VxUpdate
    6.  
      Manually initiating upgrades from the media server or client using VxUpdate
    7.  
      Deployment job status
  8. Appendix A. Reference
    1.  
      NetBackup master server web server user and group creation
    2.  
      Generate a certificate on the inactive nodes of a clustered master server
    3.  
      About the NetBackup Java Runtime Environment
    4.  
      Add or Remove Java GUI and JRE after upgrade
    5.  
      About the NetBackup web user interface
    6.  
      About the NetBackup answer file
    7.  
      Persistent Java Virtual Machine options
    8.  
      About RBAC bootstrapping
    9.  
      About NetBackup software availability
    10.  
      Additional post-upgrade steps for NetApp clusters
    11.  
      Using NetApp disk arrays with Replication Director
    12.  
      About compatibility between NetBackup versions
    13.  
      Upgrade requirements for UNIX and Linux
    14.  
      Installation and upgrade requirements for Windows and Windows clusters
    15.  
      Requirements for Windows cluster installations and upgrades
    16.  
      Removing a clustered media server by migrating all data to a new media server
    17.  
      Disabling the connection between your OpsCenter server and your NetBackup Primary Server
    18.  
      Post upgrade procedures for Amazon cloud storage servers
    19.  
      Upgrading clients after servers are upgraded
  9.  
    Index

How to plan for an upgrade to NetBackup 9.1

Several factors must be considered when you prepare for an upgrade to NetBackup 9.1.

Starting NetBackup daemons and services as non-administrative user

New to NetBackup 9.1, you can start most of the NetBackup daemons and services as a non-root user. Veritas recommends that you start the NetBackup services as a non-root user. If you decide to use a less privileged user, you must plan accordingly. Ensure that the user account has access to the paths of disaster recovery files, external certificate authority (ECA) files, and temporary files.

On UNIX and Linux, you see a new prompt during the upgrade. The new prompt asks you to provide a service user, preferably a non-root user. You must create this user in advance and the user must have nbwebgrp as the secondary group.

On Windows, you can use the Local Service built-in account as the service account. This option is available in the Custom upgrade path.

Media Server Deduplication Pool rolling conversion

The NetBackup 8.1 upgrade includes a rolling conversion of the Media Server Deduplication Pool (MSDP).

By default, the rolling conversion is performed when the system is not busy. In other words, the conversion runs when backups, restores, CRQP, CRC checks, compaction, etc. are not active. This conversion is not expected to affect normal system operations. After the rolling conversion is finished, there is no difference between the converted system and a new installation. More information about the rolling conversion is available.

See MSDP upgrade considerations for NetBackup 8.1.

See About MSDP rolling data conversion.

Specify security administrator for RBAC

If you plan to use role-based access control (RBAC), you must designate a security administrator. More information is available:

See About the NetBackup web user interface.

See NetBackup Web UI Administrator's Guide.

Addition of web service account for NetBackup installation and upgrade

Beginning with NetBackup 8.0, the NetBackup primary server includes a configured Tomcat web server to support critical backup operations. This web server operates under user account elements with limited privileges. These user account elements must be available on each primary server (or each node of a clustered primary server). More information is available:

See NetBackup master server web server user and group creation.

Note:

It is recommended that you save the details of the user account that you use for the NetBackup Web Services. A primary server recovery requires the same NetBackup Web Services user account and credentials that were used when the NetBackup catalog was backed up.

Caution:

If the NetBackup PBX is running in secure mode, please add the web service user as authorized user in PBX. More information about determining PBX mode and how to correctly add users is available.

http://www.veritas.com/docs/000115774

Upgrades of UNIX clustered NetBackup 8.2 with NAT enabled

Upgrades of NetBackup 8.2 UNIX clusters with NAT enabled incorrectly identify the NAT state. As a result, NAT is disabled after the upgrade to 9.1. After you complete the NetBackup 9.1 upgrade, you must turn NAT on again. More information is included in the post-upgrade procedure.

See Post-install procedure for upgrading to NetBackup 9.1.

Move the NetBackup database from any btrfs file systems

It is not supported the installation or upgrade of the NetBackup database on a btrfs file system. If the NetBackup database resides on a btrfs file system, move the database to a supported file system (such as ext4 or xfs) before you start the upgrade. The database files reside on the primary server in the directories under /usr/openv/db. More information about moving the database before an upgrade is available. See Preinstall procedure for upgrading to NetBackup 9.1.

Java GUI and JRE changes

Starting with NetBackup 8.3, the Java GUI and the JRE packages are optional for UNIX, Linux, and Windows media servers and UNIX and Linux clients.

As with previous releases, the Java GUI and JRE packages are installed automatically on all primary servers because they are required. The Java GUI and the JRE are not part of the default installation on Windows clients. Install the Java Remote Administration Console if you require this functionality on your Windows clients.

The various NetBackup upgrade methods allow the user the choice to upgrade or uninstall the Java GUI and JRE packages. More information about installing or removing the Java GUI and the JRE after upgrade is available.

See Add or Remove Java GUI and JRE after upgrade.

Environment variable for certificate key size

NetBackup uses security certificates to authenticate NetBackup hosts for secure communication. The security certificates conform to the X.509 Public Key Infrastructure (PKI) standard. A NetBackup primary server acts as the certificate authority (CA) and issues digital certificates to hosts. NetBackup now supports the following certificate key sizes: 2048 bits, 4096 bits, 8192 bits, and 16384 bits.

With a NetBackup 9.1 upgrade, new root CA with 2048 bit key strength is deployed. To use a certificate key size larger than 2048 bits, set the NB_KEYSIZE environment variable on the primary server before you start the installation.

For example:

NB_KEYSIZE = 4096

The NB_KEYSIZE can only have the following values: 2048, 4096, 8192, and 16384.

For more information about CA migration and certificate key sizes, see the NetBackup Security and Encryption Guide.

Table: Overview of the upgrade process shows the overview of the upgrade procedure.

Table: Overview of the upgrade process

Step

Details

More information

1

Review operating system requirements and confirm the computer meets all requirements.

See Upgrade requirements for UNIX and Linux.

See Installation and upgrade requirements for Windows and Windows clusters.

See Requirements for Windows cluster installations and upgrades.

2

Confirm that the web server user account and group account are created and enabled.

More information is available:

See NetBackup master server web server user and group creation.

3

Begin the upgrade process

See About primary server upgrades.