Veritas NetBackup™ Upgrade Guide

Last Published:
Product(s): NetBackup (8.2)
  1. Introduction
    1.  
      About the NetBackup 8.2 Upgrade Guide
    2.  
      Available NetBackup upgrade methods
    3. About changes in NetBackup 8.2
      1.  
        Upgrades from NetBackup 7.6.0.4 and earlier are not supported
      2.  
        External certificate authority certificates supported by NetBackup 8.2
    4.  
      About Veritas Smart Meter
    5.  
      Best practices for Veritas Smart Meter
  2. Planning for an upgrade
    1. General upgrade planning information
      1.  
        About planning a NetBackup 8.2 upgrade
      2.  
        How to plan for an upgrade to NetBackup 8.2
      3.  
        Known catalog backup limitation
      4.  
        About security certificates for NetBackup hosts
      5.  
        About automatic file changes from an upgrade
    2. About upgrade tools
      1.  
        About Veritas Services and Operations Readiness Tools
      2.  
        Recommended SORT procedures for upgrades
      3.  
        Recommended SORT procedures for new installations
      4.  
        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 8.2 support for Fibre Transport Media Server with RHEL 7.5
      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 master server upgrades
    2.  
      Preinstall procedure for upgrading to NetBackup 8.2
    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 8.2
    6.  
      Post-install procedure for upgrading to NetBackup 8.2
    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 8.2
    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 master 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.  
      About the NetBackup web user interface
    5.  
      About the NetBackup answer file
    6.  
      About RBAC bootstrapping
    7.  
      Update cloud configuration file on the master server immediately after install or upgrade to NetBackup 8.2
    8.  
      About NetBackup software availability
    9.  
      Additional post-upgrade steps for NetApp clusters
    10.  
      Using NetApp disk arrays with Replication Director
    11.  
      About compatibility between NetBackup versions
    12.  
      Installation and upgrade requirements for UNIX and Linux
    13.  
      Installation and upgrade requirements for Windows and Windows clusters
    14.  
      Requirements for Windows cluster installations and upgrades
    15.  
      Removing a clustered media server by migrating all data to a new media server
    16.  
      Disabling the connection between your NetBackup OpsCenter server and your NetBackup Master Server
    17.  
      Post upgrade procedures for Amazon cloud storage servers
    18.  
      Upgrading clients after servers are upgraded

Preinstall procedure for upgrading to NetBackup 8.2

Use the following procedure to upgrade your environment to NetBackup 8.2.

Veritas has developed tools to help you perform the extra step that is required for the guided method. For more details, contact your Business Critical Services (BCS) representative.

Additional steps are required if the NetBackup upgrade includes an upgrade to RHEL 7.5 and you use Fibre Transport Media Server (FTMS). More information is available.

See About NetBackup 8.2 support for Fibre Transport Media Server with RHEL 7.5.

Note:

Remember to update NetBackup OpsCenter to version 8.2 before you update your NetBackup master servers to version 8.2. You must also disable OpsCenter data collection. See the NetBackup OpsCenter Administrator's Guide for complete information.

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

Be aware there is a known issue for OpsCenter upgrades on 64-bit Windows platforms. If language packs or Maintenance Packs are installed, the upgrade can fail. More information about this issue is available.

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

You can disable the OpsCenter data collection for a specific master server. If you disable data collection, you can upgrade your master server before your OpsCenter server. Disabling data collection results in known issues. More information about disabling data collection and the risks is available.

See Disabling the connection between your NetBackup OpsCenter server and your NetBackup Master Server.

Note:

For NetBackup installations that include globally clustered master servers using the Global Cluster Option (GCO), follow the upgrade planning guidelines in this guide. Then, refer to the following document for the specific steps to upgrade these servers: https://www.veritas.com/support/en_US/article.100041191

Preinstall steps to upgrade to NetBackup 8.2 and complete the image metadata migration

  1. Perform environment checks with the SORT tool.

    See Recommended SORT procedures for upgrades.

  2. Download the Customer Registration Key for Veritas Smart Meter. More information about Veritas Smart Meter is available.

    See About Veritas Smart Meter.

    During install and upgrade to NetBackup 8.1.2, please allow the installer to copy the veritas_customer_registration_key.json file to its final destination. NetBackup can set the file permission and ownership correctly through this process. If you place the file onto your systems outside of the install or the upgrade process, the process may not work correctly.

  3. Perform any pre-upgrade tasks that you would normally do in regard to your NetBackup environment. For example:

    • Stop all customized or third-party scripts.

    • Perform any cluster-specific tasks.

    • Run a hot catalog backup.

    • Disable OpsCenter data collection for this master server.

    • Disable all storage lifecycle policies (SLPs).

    • Deactivate all NetBackup policies.

    • Deactivate all disk staging storage units for all pre-NetBackup 7.5.x environments.

    • For clustered systems only, take the following NetBackup resources offline:

      • Windows Server Failover Clusters (WSFC): Take all of the NetBackup group resources offline except for the disk, the virtual name, and the virtual IP address. Refer to the Microsoft Cluster Administration documentation to determine how to take the NetBackup group resources offline through the cluster administrator interface.

      • Cluster Server (VCS) clusters: Take the NetBackup resource offline.

        Freeze the NetBackup group with the -persist option using the command shown:

        hagrp -freeze NetBackup_service_group -persistent

      Refer to the Veritas NetBackup Clustered Master Server Administrator's Guide for the commands to take these resources offline.

  4. (Conditional) If you plan to change your NetApp cluster to Vserver mode from node scope mode, create a detailed image report for each filer. You can generate this report with the bpimagelist command. The example that is shown is one possible option. Use whatever options are necessary for your environment.

    bpimagelist - client ndmp_host_name

  5. Beginning with NetBackup 8.0, the NetBackup master 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 master server (or each node of a clustered master server). More information is available:

    See NetBackup master server web server user and group creation.

    Note:

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

    Note:

    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

  6. Stop any applications on the system that interact with NetBackup. This step includes any databases or system components being backed up. Failure to stop these applications may result in unexpected behavior. Observed behavior includes aborted upgrades and application failures.

    For Oracle users, you must take down your database and your listener processes before you upgrade.

    If you cannot stop your Oracle database, a procedure is available that may let you install NetBackup with the Oracle database active. More information on this topic is available.

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

  7. Stop all NetBackup services.

    • On UNIX systems: /usr/openv/netbackup/bin/bp.kill_all

    • On Windows systems: install_path\NetBackup\bin\bpdown -f

The preinstall procedure is completed. Proceed to upgrade the NetBackup binaries, based on your platform. More information is available about this topic.