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

Silently upgrading NetBackup media server software on UNIX and Linux

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

  • For Linux: rpm, yum, etc.

  • For Solaris: pkginfo, pkgadd

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

Note:

Because of package name changes, native installer methods require additional steps to upgrade media servers from NetBackup 7.7.3 and earlier to NetBackup 8.2 and later. You have two options to correctly upgrade your media servers and convert to the Veritas packages. You can use the NetBackup installer to upgrade the media server to the new Veritas packages. Or you can follow the native installers procedure and perform the conditional steps. More information is available.

See “To upgrade the UNIX or Linux client binaries using native installers:”.

Both of these upgrade options result in the same outcome. Once you have successfully upgraded to the Veritas packages, you can perform future upgrades with the installer of your choice.

To upgrade the UNIX or 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.

      • SKIP: Used to skip setting up the certificate authority. To skip the ECA configuration, you must set all required ECA_ values to SKIP. Be aware that if you continue with the installation without a certificate authority, the backups and restores fail.

    • 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 LICENSE entries

    • 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 RedHat:

      tar -xzvf NetBackup_8.2_LinuxR_x86_64.tar.gz

    • For Linux SuSE:

      tar -xzvf NetBackup_8.2_LinuxS_x86_64.tar.gz

    • For Linux-s390x RedHat:

      tar -xzvf NetBackup_8.2_zLinuxR.tar.gz

    • For Linux-s390x SuSE:

      tar -xzvf NetBackup_8.2_zLinuxS.tar.gz

    • For Solaris SPARC:

      tar -xzvf NetBackup_8.2_Solaris_Sparc64.tar.gz

    • For Solaris x86:

      tar -xzvf NetBackup_8.2_Solaris_x86.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 RedHat:

      NetBackup_8.2_LinuxR_x86_64/linuxR_x86/anb

    • For Linux SuSE:

      NetBackup_8.2_LinuxS_x86_64/linuxS_x86/anb

    • For Linux-s390x RedHat:

      NetBackup_8.2_zLinuxR/zlinuxR/anb

    • For Linux-s390x SuSE:

      NetBackup_8.2_zLinuxS/zlinuxS/anb

    • For Solaris SPARC:

      NetBackup_8.2_Solaris_Sparc64/solaris/anb

    • For Solaris x86

      NetBackup_8.2_Solaris_x86/solaris_x86/anb

    Copy server files to the computer to be installed

    • Linux: VRTSnetbp.rpm and VRTSpddes.rpm

      Note that VRTSpddes.rpm does not exist on Linux-s390x.

    • Solaris: VRTSnetbp.pkg and VRTSpddes.pkg

  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:

    • RedHat: openv/netbackup/client/Linux/RedHat2.6.32

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

    • Linux-s390x RedHat: openv/netbackup/client/Linux-s390x/IBMzSeriesRedHat2.6.32

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

    • SPARC: openv/netbackup/client/Solaris/Solaris10

    • Solaris_x86: openv/netbackup/client/Solaris/Solaris_x86

    Copy the files that are shown to the media server.

    Linux

    VRTSnbpck.rpm
    VRTSpbx.rpm
    VRTSnbclt.rpm
    VRTSnbjre.rpm
    VRTSnbjava.rpm
    VRTSpddea.rpm
    VRTSnbcfg.rpm

    Note that VRTSpddea.rpm does not exist for Linux-s390x.

    Solaris

    .pkg_defaults
    VRTSnbpck.pkg.gz
    VRTSpbx.pkg.gz
    VRTSnbclt.pkg.gz
    VRTSnbjre.pkg.gz
    VRTSnbjava.pkg.gz
    VRTSpddea.pkg.gz
    VRTSnbcfg.pkg.gz

    Note:

    The Solaris client binaries include a hidden administration file called .pkg_defaults. This administration file contains default installation actions.

  8. (Conditional) For Solaris, extract the compressed package files with the command shown:

    gunzip VRTS*.*

    This action extracts all the package files as shown:

    VRTSnbpck.pkg
    VRTSpbx.pkg
    VRTSnbclt.pkg
    VRTSnbjre.pkg
    VRTSnbjava.pkg
    VRTSpddea.pkg
    VRTSnbcfg.pkg
  9. Install the Veritas precheck package.
    • Linux: rpm - U VRTSnbpck.rpm

    • Solaris: pkgadd -a .pkg_defaults -d VRTSnbpck.pkg VRTSnbpck

  10. (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
  11. Install the files in the order that is shown with the commands shown:

    Linux

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

    Solaris

    Use the pkgadd -a admin -d device [pkgid] command as shown to install the files:

    pkgadd -a .pkg_defaults -d VRTSpbx.pkg VRTSpbx
    pkgadd -a .pkg_defaults -d VRTSnbclt.pkg VRTSnbclt
    pkgadd -a .pkg_defaults -d VRTSnbjre.pkg VRTSnbjre
    pkgadd -a .pkg_defaults -d VRTSnbjava.pkg VRTSnbjava
    pkgadd -a .pkg_defaults -d VRTSpddea.pkg VRTSpddea
    pkgadd -a .pkg_defaults -d VRTSpddes.pkg VRTSpddes
    pkgadd -a .pkg_defaults -d VRTSnbcfg.pkg VRTSnbcfg
    pkgadd -a .pkg_defaults -d VVRTSnetbp.pkg VRTSnetbp
    • The -a option defines a specific admin (.pkg_defaults) to use in place of the default administration file. The admin file contains default installation actions.

    • The -d device option specifies the source of the software packages. A device can be the path to a device, a directory, or a spool directory.

    • Use the pkgid parameter to specify a name for the package being installed. This parameter is optional.