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

Silently upgrading NetBackup media server software on Linux

You can upgrade NetBackup Linux media servers with native installers. You can use either the NetBackup install script or your preferred installer method.

For Linux: rpm, yum, etc.

A successful installation or upgrade is recorded in the /usr/openv/pack/install.history file.

Caution:

You must remove the NetBackup Nutanix plug-in package before you upgrade NetBackup Red Hat and SUSE Linux with the native installers. Both the Nutanix plug-in and NetBackup install the same libraries to the same location, which results in a failure to upgrade. The upgrade fails with an install of package_name conflicts with file from package package_name error message.

Use the command that is shown to uninstall the plug-in before attempting the NetBackup upgrade.

rpm -e VRTSnbntnxahv*

To upgrade the Linux media server binaries using native installers:

  1. Please create the NetBackup installation answer file (NBInstallAnswer.conf) in the media server /tmp directory. More information about the answer file and its contents is available.

    See About the NetBackup answer file.

  2. (Conditional) If your environment uses a NetBackup Certificate Authority, and the media server is already configured for NetBackup Certificate Authority, proceed to 4. Otherwise, populate NBInstallAnswer.conf with the following required information:
    CA_CERTIFICATE_FINGERPRINT=fingerprint

    Example (the fingerprint value is wrapped for readability):

    CA_CERTIFICATE_FINGERPRINT=01:23:45:67:89:AB:CD:EF:01:23:45:67:
    89:AB:CD:EF:01:23:45:67

    Depending on the security configuration in your NetBackup environment, you may need to add the AUTHORIZATION_TOKEN option to the answer file. Additional information about the AUTHORIZATION_TOKEN option is available.

    See About the NetBackup answer file.

  3. (Conditional) If your environment uses an external certificate authority, and the media server is already configured for external certificate authority, proceed to 4. Otherwise, populate NBInstallAnswer.conf with the following required information:
    • ECA_CERT_PATH

      Use this field to specify the path and the file name of the external certificate file. This field is required to set up an external certificate from a file.

    • ECA_TRUST_STORE_PATH

      Use this field to specify the path and the file name of the file representing the trust store location. This field is required to set up an external certificate from a file.

    • ECA_PRIVATE_KEY_PATH

      Use this field to specify the path and the file name of the file representing the private key. This field is required to set up an external certificate from a file.

    • ECA_KEY_PASSPHRASEFILE

      Use this field to specify the path and the file name of the file that contains the passphrase to access the keystore. This field is optional and applies only when setting up an external certificate from a file.

    • ECA_CRL_CHECK_LEVEL

      Use this field to specify the CRL mode. This field is required. Supported values are:

      • USE_CDP: Use the CRL defined in the certificate.

      • USE_PATH: Use the CRL at the path that is specified in ECA_CRL_PATH.

      • DISABLED: Do not use a CRL.

    • ECA_CRL_PATH

      Use this field to specify the path to the CRL associated with the external CA certificate. This field is required only when ECA_CRL_CHECK_LEVEL is set to USE_PATH. If not applicable, leave this field empty.

  4. Additionally, you can add the optional parameters shown to the NBInstallAnswer.conf file.
    • Additional SERVER entries

    More information about each option is available.

    See About the NetBackup answer file.

  5. Download the server package that matches your server platform to a system with sufficient space. Then extract the required server package.

    Extract the contents of the server package file. Example:

    • For Linux Red Hat:

      tar -xzvf NetBackup_10.4_LinuxR_x86_64.tar.gz

    • For Linux SuSE:

      tar -xzvf NetBackup_10.4_LinuxS_x86_64.tar.gz

  6. Change to the directory for your desired operating system and copy server files to the media server.

    Operating system directory:

    • For Linux Red Hat:

      NetBackup_10.4_LinuxR_x86_64/linuxR_x86/anb

    • For Linux SuSE:

      NetBackup_10.4_LinuxS_x86_64/linuxS_x86/anb

    Copy server files to the computer to be installed

    • Linux: VRTSnetbp.rpm, VRTSnbslibs.rpm, and VRTSpddes.rpm

    • Linux Red Hat: VRTSpddei.rpm

  7. Extract the client binaries and copy them to the media server:

    Extract the client binaries:

    tar -xzvf client_dist.tar.gz

    Change directory to your desired operating system:

    • Red Hat: openv/netbackup/client/Linux/RedHat3.10.0

    • SuSE: openv/netbackup/client/Linux/SuSE3.0.76

    Copy the files that are shown to the media server.

    Note:

    The upgrade of the Java GUI and the JRE is optional. If you do not want them upgraded, omit the copy and the install of the VRTSnbjava and VRTSnbjre packages.

    Veritas recommends the removal of the old Java GUI and JRE packages if you decide not to upgrade them.

    See Add or Remove Java GUI and JRE after upgrade.

    • VRTSnbpck.rpm

    • VRTSpbx.rpm

    • VRTSnbclt.rpm

    • VRTSnbclibs.rpm

    • VRTSnbjre.rpm

    • VRTSnbjava.rpm

    • VRTSpddea.rpm

    • VRTSnbcfg.rpm

    • VRTSpddeu.rpm

  8. Install the Veritas precheck package.

    Linux: rpm - U VRTSnbpck.rpm

  9. (Conditional) If you are upgrading from pre-NetBackup 8.0, remove the old SYMC* packages. The example shown indicates the commands used to remove the SYMC RPM packages. This process preserves your NetBackup configuration.
    rpm -e SYMCnbjava
    rpm -e SYMCpddea
    rpm -e SYMCnbclt
    rpm -e SYMCnbjre
    rpm -e SYMCpddes
    rpm -e SYMCnetbp
  10. Install the files in the order that is shown with the commands shown:

    Note:

    The upgrade of the Java GUI and the JRE is optional. If you do not want them upgraded, omit the copy and the install of the VRTSnbjava and VRTSnbjre packages.

    Veritas recommends the removal of the old Java GUI and JRE packages if you decide not to upgrade them.

    See Add or Remove Java GUI and JRE after upgrade.

    RedHat Linux

    rpm -U VRTSpbx.rpm
    rpm -U VRTSnbclt.rpm
    rpm -U VRTSnbclibs.rpm
    rpm -U VRTSnbjre.rpm
    rpm -U VRTSnbjava.rpm
    rpm -U VRTSpddes.rpm
    rpm -U VRTSpddeu.rpm
    rpm -U VRTSpddea.rpm
    rpm -U VRTSnbcfg.rpm
    rpm -U VRTSnetbp.rpm
    rpm -U VRTSnbslibs.rpm

    SuSE Linux

    rpm -U VRTSpbx.rpm
    rpm -U VRTSnbclt.rpm
    rpm -U VRTSnbclibs.rpm
    rpm -U VRTSnbjre.rpm
    rpm -U VRTSnbjava.rpm
    rpm -U VRTSpddeu.rpm
    rpm -U VRTSpddea.rpm
    rpm -U VRTSpddes.rpm
    rpm -U VRTSnbcfg.rpm
    rpm -U VRTSnetbp.rpm
    rpm -U VRTSnbslibs.rpm
  11. You can remove the old versions of the Java GUI and the JRE if you no longer plan to use them.
    • Linux:

      rpm -e VRTSnbjava.rpm

      rpm -e VRTSnbjre.rpm