Veritas NetBackup™ Upgrade Guide

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

Post-install procedure for upgrading to NetBackup 9.1

Post-installation steps to upgrade to NetBackup 9.1 describes the post-installation steps to upgrade NetBackup and complete the image metadata migration.

Post-installation steps to upgrade to NetBackup 9.1

  1. Check for an available NetBackup 9.1 maintenance release. Maintenance releases include very important fixes that are released after NetBackup 9.1. Veritas encourages you to install the latest available maintenance release during upgrade activities.

    To access the latest NetBackup 9.1 maintenance release:

    • Go to the NetBackup SORT website.

    • In the Installation and Upgrade Checklist section:

      • Under Product, select the correct product (NetBackup Enterprise Server or NetBackup Server)

      • Under Product version you are installing or upgrading to specify the latest version of NetBackup

      • Under Platform select the platform of the server you want to upgrade.

      • Under Processor specify the processor of your server.

      • Under Product version you are upgrading from (Optional) select the current version of NetBackup on the server you want to upgrade.

      • Click Generate Checklist.

    • Under Upgrade Information, there is a version_number Download Links hyperlink. Click that hyperlink for the latest maintenance release.

    • If no maintenance release is available, restart bprd if you terminated it. Proceed once bprd is restarted.

      UNIX/Linux: /usr/openv/netbackup/bin/bprd

      Windows: install_path\NetBackup\bin\bprd

    • If you find a maintenance release is available, download it now.

    • Prepare for the install by stopping all NetBackup processes and services. Use the command shown:

      UNIX/Linux: /usr/openv/netbackup/bin/bp.kill_all

      Windows: install_path\NetBackup\bin\bpdown -f

    • Install the maintenance release.

    • Restart NetBackup with the commands shown:

      UNIX/Linux systems: /usr/openv/netbackup/bin/bp.start_all

      Windows systems: install_path\NetBackup\bin\bpup -f

  2. Set a passphrase for the disaster recovery package. If you do not set a passphrase, the catalog backups fail. More information is available. Please see the information about passphrases in the NetBackup Troubleshooting Guide.
  3. 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.

  4. Start any applications on the system that interact with NetBackup. This step includes any databases or system components being backed up.
  5. If you have a clustered primary server, generate a certificate on the inactive nodes for secure communications. More information is available.

    See Generate a certificate on the inactive nodes of a clustered master server.

  6. (Conditional) This step applies only to cluster installations. If this computer is not a clustered primary server upgrade, proceed to the next step.

    Update the other nodes in the cluster. You can update the other primary servers nodes in the cluster to NetBackup 9.1 by following standard cluster upgrade process. For complete details, see the Veritas NetBackup Clustered Primary Server Administrator's Guide.

    If the NetBackup resource is not online, bring that resource online.

  7. (Conditional) For a primary server that uses external certificate authority (ECA) or for a media server that skipped ECA configuration, configure the ECA now. More information is available:

    For more information, see the NetBackup Security and Encryption Guide and refer to the chapter on external CA and external certificates.

  8. If you have any media servers that you intend to upgrade to NetBackup 9.1, you may upgrade them now. If you start any media server upgrades, do not continue with this procedure until the media server upgrades are complete.


    NetBackup requires that media servers have a security certificate to function correctly in certain use cases. More information about this topic is available.

    See About security certificates for NetBackup hosts.

    More information about this topic is available.

    See Upgrading NetBackup media servers to NetBackup 9.1.

  9. Reactivate the following in the order as shown:

    • All disk staging storage units.

    • All NetBackup policies.

    • All storage lifecycle policies (SLPs).

    • OpsCenter data collection for this primary server.

  10. (Conditional) If your environment uses cloud storage, you need to update the read and write buffer sizes. More information is available.

    See Post upgrade procedures for Amazon cloud storage servers.

  11. (Conditional) If you have a NetApp cluster, additional steps may be required. More information is available.

    See Additional post-upgrade steps for NetApp clusters .

  12. (Conditional) For the cloud and the storage servers with SSL enabled, the CRL validation is enabled by default. Verify if the storage servers are running and the CRL functionality works correctly. More information is available.

    See the NetBackup Cloud Administrator's Guide.

  13. (Conditional) For Amazon configurations, after you upgrade NetBackup and CloudPoint to the latest version, you must update the credentials. Run the tpconfig -update command. After the upgrade, the credentials are updated to only support the AWS IAM role. More information is available.

    See the NetBackup Cloud Web UI Administrator's Guide.

  14. Monitor your backup environment to verify that normal NetBackup operation has resumed.
  15. Upgrade any media servers and clients not already upgraded as time and backup windows permit. Be sure to upgrade the media servers before you upgrade the clients. You cannot back up or restore a NetBackup 8.1 client to a pre-8.1 media server.

    See Upgrading NetBackup media servers to NetBackup 9.1.

    A client upgrade is the same as a client installation. See the NetBackup Installation Guide - UNIX and Windows manual for help with the installation.


    All scripts must be stored and run locally. One recommendation is that scripts should not be world-writable. Scripts are not allowed to be run from network or remote locations. Any script that is created and saved in the NetBackup db_ext (UNIX) or dbext (Windows) location needs to be protected during a NetBackup uninstall.

    For more information about registering authorized locations and scripts, review the knowledge base article:

    For more information about your specific database agent, review the documentation for that agent:

  16. (Conditional) For upgrades of NetBackup 8.2 UNIX clusters with NAT enabled to the latest version, the upgrade disables NAT. To turn on NAT and allow the cluster to monitor the nbmqbroker service that is added to a NetBackup cluster group, run the command shown:
    • To configure with default ports:

      configureMQ -enableCluster -defaultPorts

    • To configure with specific ports:

      configureMQ -enableCluster -externalPort port1 -internalPorts port2 port3 port4

  17. Perform any additional upgrade steps. More information about this topic is available.

    See Completing your system update after an upgrade.