NetBackup™ Upgrade Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.4)
  1. Introduction
    1.  
      About the NetBackup 10.4 Upgrade Guide
    2.  
      Available NetBackup upgrade methods
    3. About changes in NetBackup 10.4
      1.  
        License file required for upgrade
      2.  
        Windows primary server upgrades are slowed if a large number of files are in the installation directory
      3.  
        About NetBackup database changes
      4.  
        Java GUI and JRE installation optional for some computers
      5.  
        Logging directory permissions require reset on rollback
      6.  
        Upgrades from NetBackup 7.6.0.4 and earlier are not supported
      7.  
        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 10.4 upgrade
      2.  
        How to plan for an upgrade to NetBackup 10.4
      3.  
        Legacy logging directory security update
      4.  
        Unified logging security update
      5.  
        Notifications, Messages, and Resiliency configuration information are not upgraded
      6.  
        Known catalog backup limitation
      7.  
        About security certificates for NetBackup hosts
      8.  
        About automatic file changes from an upgrade
      9.  
        Reduce the job database size before upgrade
      10.  
        Known SUSE Linux primary server upgrade issue
    2.  
      Performance and tuning considerations
    3. About upgrade tools
      1.  
        About Veritas Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for upgrades
      3.  
        About the NetBackup preinstall checker
      4.  
        About the NetBackup database analyzer tool
    4. Upgrade operational notes and limitations
      1.  
        Windows compiler and security requirements for NetBackup 10.4 and later upgrade
      2.  
        Creating the user account to support the NetBackup web server
      3.  
        About NetBackup 10.4 support for Fibre Transport Media Server with RHEL 7.5 and later
      4.  
        MSDP changes in NetBackup 8.1
      5.  
        Potential required changes for NetApp clusters
      6.  
        Errors when Bare Metal Restore information is replicated using Auto Image Replication
      7.  
        Upgrade issue with pre-8.1 clients and 8.1 or later media servers
  3. Primary server upgrade
    1.  
      About primary server upgrades
    2.  
      Preinstall procedure for upgrading to NetBackup 10.4
    3.  
      Performing local, remote, or clustered server upgrades on Windows systems
    4.  
      Performing silent upgrades on Windows systems
    5.  
      Upgrading Linux server software to NetBackup 10.4
    6.  
      Silently upgrading NetBackup primary server software on Linux
    7.  
      Post-install procedure for upgrading to NetBackup 10.4
    8.  
      About NetBackup startup and shutdown scripts
    9.  
      Completing your system update after an upgrade
  4. Media server upgrade
    1.  
      Preinstall procedure for upgrading media servers to NetBackup 10.4
    2.  
      Upgrading NetBackup media servers to NetBackup 10.4
    3.  
      Silently upgrading NetBackup media server software on 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.  
      Preinstall procedure for upgrading clients to NetBackup 10.4
    3.  
      Upgrading UNIX and Linux clients with the NetBackup upgrade script
    4.  
      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.  
      EEB management view
  8. Appendix A. Reference
    1.  
      NetBackup primary server web server user and group creation
    2.  
      NetBackup database user
    3.  
      Generate a certificate on the inactive nodes of a clustered primary server
    4.  
      About the NetBackup Java Runtime Environment
    5.  
      Add or Remove Java GUI and JRE after upgrade
    6.  
      About the NetBackup web user interface
    7.  
      About the NetBackup answer file
    8.  
      About the NetBackup IT Analytics Data Collector
    9.  
      Manually install or uninstall NetBackup IT Analytics Data Collector binaries
    10.  
      Manually configure the NetBackup IT Analytics Data Collector
    11.  
      Manually upgrading the NetBackup IT Analytics Data Collector
    12.  
      Persistent Java Virtual Machine options
    13.  
      About RBAC bootstrapping
    14.  
      About NetBackup software availability
    15.  
      Additional post-upgrade steps for NetApp clusters
    16.  
      Using NetApp disk arrays with Replication Director
    17.  
      About compatibility between NetBackup versions
    18.  
      Upgrade requirements for UNIX and Linux
    19.  
      Upgrade requirements for Windows and Windows clusters
    20.  
      Requirements for Windows cluster upgrades
    21.  
      Removing a clustered media server by migrating all data to a new media server
    22.  
      Post upgrade procedures for Amazon cloud storage servers
    23.  
      Upgrading clients after servers are upgraded
    24.  
      Upgrade failure rollback steps
    25.  
      Size guidance for the NetBackup primary server and domain

Repository management

VxUpdate uses a repository that resides on the primary server. The repository contains all packages that you can deploy to media servers and clients. Your repository can contain upgrade packages, engineering binaries, and hotfixes. With VxUpdate, the nbrepo command controls the package repository management. Do not attempt to manually modify or update the repository without the use of the nbrepo command. Depending on the packages added, the repository can grow large. Confirm that you have sufficient space on your primary server for all packages that are required for your environment. Monitor the repository directory on the primary server and remove unnecessary packages from the repository. For Linux, the repository is in /usr/openv/var/global/repo. For Windows, the repository is in install_path\NetBackup\var\global\repo.

The nbrepo command verifies and populates the repository with NetBackup packages. Veritas signs the VxUpdate packages. Attempts to populate the repository with unofficial or unsigned NetBackup packages fails. These packages are referenced in the deployment policies that install NetBackup on target hosts. When you use the nbrepo command to populate the repository, be mindful of the required disk space. The primary server must have enough disk space to store packages for the NetBackup versions and platforms that are specified in deployment policies.

The package types you can load into the repository include:

  • VxUpdate media server and client packages

    You can upgrade NetBackup media servers and clients to a newer version of NetBackup with VxUpdate. These packages are slightly different from standard NetBackup media server and client packages. The packages include additional components to support the various VxUpdate operations.

  • Emergency binaries (EEBs) and hotfixes

    You can use VxUpdate to deploy emergency binaries and hotfixes to NetBackup 8.1.2 and later media servers and clients. You can obtain VxUpdate formatted EEBs from support in the same way you obtain traditional EEBs. These EEBs are only for NetBackup version 8.1.2 and later. Any media server or client hotfixes that Veritas creates for NetBackup 8.1.2 and later releases include VxUpdate formatted fixes.

Downloading Veritas NetBackup approved media server and client packages

VxUpdate formatted packages are available from the myveritas.com licensing portal. Emergency binaries and hotfixes are obtained from the standard locations. You should download the VxUpdate versions of these packages and place them in a location accessible to the primary server. Once they are accessible to your primary server, you can add them to the NetBackup package repository.

  1. Go to the myveritas.com licensing portal.
  2. Enter your user name and password.
  3. Select Licensing.
  4. Enter or select your account number.
  5. Select Apply Filters
  6. Select your account number from the resulting table.

    This action presents a listing of your entitlements. From here, you have the ability to download the associated software.

  7. Select Downloads
  8. Use the filter options to limit the results to the NetBackup product line and the appropriate product version.

    Add your filters and select Apply Filters.

  9. Under Actions, select the download icon
  10. In the resulting table, select the VxUpdate packages and then select Download.

    Packages that contain both media server and client binaries follow the naming convention shown: vxupdate_nb_version_operatingsystem_platform.sja

  11. Download and extract the files to a temporary location on your computer.

When you finish downloading and extracting all the relevant packages to your computer, add the packages to the NetBackup package repository. More information about this topic is available.

See “Adding packages to the NetBackup package repository”.

Adding packages to the NetBackup package repository

VxUpdate can only use the Veritas signed packages that you added to the NetBackup package repository. Use the nbrepo command to add packages to the repository. This command adds metadata to the EMM database and places the packages in the repository directory structure on the file system. You can use the nbrepo command to list the contents of the package repository as well as the details about individual packages.

  1. Navigate to the admincmd directory from a command prompt.

    Linux: /usr/openv/netbackup/bin/admincmd

    Windows: install_path\NetBackup\bin\admincmd\

  2. Use the nbrepo command with the -a option:

    nbrepo -a package_path

    Example: nbrepo -a C:\temp\nbclient_8.1.2_windows_x64.sja

  3. After successfully verifying and adding the package to the repository, the command returns a success message.
  4. More information about the nbrepo command is available.

    NetBackup Commands Reference Guide

  5. When there are packages in the repository that are no longer used, remove the packages. More information is available.

    See “Removing packages from the NetBackup package repository”.

Removing packages from the NetBackup package repository

You can remove packages from the repository either when they are no longer needed or to conserve disk space. For example, remove the NetBackup 8.1.2 packages once all of the clients are upgraded to that version. Use the nbrepo command to remove packages. Use of the -pkgDetails option shows the package details, including the file system path and other package attributes. To verify that a package is removed, use the nbrepo command to list all packages. You can confirm that the package is no longer in the repository. You can also verify that the package is no longer located at the file system path.

  1. Navigate to the admincmd directory from a command prompt.

    Linux: /usr/openv/netbackup/bin/admincmd

    Windows: install_path\NetBackup\bin\admincmd\

  2. Use the nbrepo command with the -l option to list all the packages and their identifiers.

    nbrepo -l

  3. Use the nbrepo command with the -d option to delete any unused packages.

    nbrepo -d package_identifier

    Example: nbrepo -d 6

  4. More information about the nbrepo command is available.

    NetBackup Commands Reference Guide