NetBackup™ Upgrade Guide

Last Published:
Product(s): NetBackup (10.3.0.1, 10.3)
  1. Introduction
    1.  
      About the NetBackup 10.3 Upgrade Guide
    2.  
      Available NetBackup upgrade methods
    3. About changes in NetBackup 10.3
      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.  
        Windows compiler and security requirements for NetBackup 9.1 and later installation and upgrade
      5.  
        Java GUI and JRE installation optional for some computers
      6.  
        Logging directory permissions require reset on rollback
      7.  
        Upgrades from NetBackup 7.6.0.4 and earlier are not supported
      8.  
        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.3 upgrade
      2.  
        How to plan for an upgrade to NetBackup 10.3
      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.  
        Creating the user account to support the NetBackup web server
      2.  
        About NetBackup 10.3 support for Fibre Transport Media Server with RHEL 7.5 and later
      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. Primary server upgrade
    1.  
      About primary server upgrades
    2.  
      Preinstall procedure for upgrading to NetBackup 10.3
    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.3
    6.  
      Silently upgrading NetBackup primary server software on Linux
    7.  
      Post-install procedure for upgrading to NetBackup 10.3
    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.3
    2.  
      Upgrading NetBackup media servers to NetBackup 10.3
    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.3
    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.  
      New 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.  
      Manually install or uninstall NetBackup IT Analytics Data Collector binaries
    9.  
      Configure the NetBackup IT Analytics Data Collector manually for NetBackup
    10.  
      Manually upgrading the NetBackup IT Analytics Data Collector
    11.  
      Persistent Java Virtual Machine options
    12.  
      About RBAC bootstrapping
    13.  
      About NetBackup software availability
    14.  
      Additional post-upgrade steps for NetApp clusters
    15.  
      Using NetApp disk arrays with Replication Director
    16.  
      About compatibility between NetBackup versions
    17.  
      Upgrade requirements for UNIX and Linux
    18.  
      Upgrade requirements for Windows and Windows clusters
    19.  
      Requirements for Windows cluster upgrades
    20.  
      Removing a clustered media server by migrating all data to a new media server
    21.  
      Post upgrade procedures for Amazon cloud storage servers
    22.  
      Upgrading clients after servers are upgraded
    23.  
      Upgrade failure rollback steps
    24.  
      Size guidance for the NetBackup primary server and domain

Silently upgrading NetBackup primary server software on Linux

You can upgrade NetBackup Linux primary 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.

Note:

Because of package name changes, native installer methods require additional steps to upgrade primary servers from NetBackup 7.7.3 and earlier to NetBackup 8.0 and later. You have two options to correctly upgrade your primary servers and convert to the Veritas packages. You can use the NetBackup installer to upgrade the primary 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 Linux primary server 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 Linux primary server binaries using native installers:

  1. Log on as the root user on the server.
  2. If the NetBackup Administration Console is open, you must close it now.
  3. (Conditional) For clustered environments, perform the following tasks:
    • If necessary, edit the bp.conf and the vm.conf files as follows:

      If a REQUIRED_INTERFACE entry exists, replace it with a CLUSTER_NAME entry. Otherwise, add a new CLUSTER_NAME entry. This entry should be defined as the virtual server name.

      For a primary server, make sure that the first SERVER entry matches the CLUSTER_NAME entry for the bp.conf file.

    • Take the NetBackup Group offline. Use the command shown:

      /opt/VRTSvcs/bin/hares -offline

    • Freeze the NetBackup Group so that migrations do not occur while the inactive nodes are upgraded. Use the command shown:

      /opt/VRTSvcs/bin/hagrp -freeze group -persistent

    • If you have a VCS cluster configured, you can freeze the NetBackup Group by using the Cluster Manager interface or the command line.

    • Before you proceed with a cluster upgrade, refer to the NetBackup Clustered Primary Server Administrator's Guide for other cluster upgrade requirements.

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

  4. NetBackup scripts that are not covered in Chapter 1 that you modified are removed when you run the upgrade script. More information about this topic is available.

    See About automatic file changes from an upgrade.

    Save any files that you have modified and want to keep.

  5. Please create the NetBackup installation answer file (NBInstallAnswer.conf) in the primary server's temporary directory. That directory is usually the /tmp directory. More information about the answer file and its contents is available.

    See About the NetBackup answer file.

  6. You can add optional parameters to the NBInstallAnswer.conf file. The parameters that are shown are examples of some of the parameters you can add. Veritas recommends that you review the NetBackup answer file section that is included in this documentation:
    • LICENSE entries

      LICENSE entries are only required on primary servers.

      For upgrades from pre-NetBackup 10.3 to NetBackup 10.3 or later, the LICENSE entry is required. LICENSE=TEMP_PRODUCTION | license_file_path. If you have not downloaded your license from Veritas Entitlement management portal, you can use TEMP_PRODUCTION. More information is available: https://www.veritas.com/support/en_US/article.100058779

      For upgrades from NetBackup 10.3 or later releases, you don't need to provide a LICENSE entry if you already have valid and unexpired license installed.

    • SERVER entries

    • DATABASE_USER

    • VXDBMS_POSTGRESQL_POOLER_ODBC_PORT

    See About the NetBackup answer file.

  7. (Conditional) If you want to assign RBAC security and backup administration roles to a user or a user group, populate NBInstallAnswer.conf with the following required information:
    • RBAC_DOMAIN_TYPE

      Use this field to specify the domain type to which the user or the user group belongs. The following RBAC_DOMAIN_TYPE values are supported: NT, VX, UNIXPWD, LDAP.

    • RBAC_DOMAIN_NAME

      Use this field to specify the name of the domain to which the user or the user group belongs.

    • RBAC_PRINCIPAL_TYPE

      Use this field to specify USER or USERGROUP.

    • RBAC_PRINCIPAL_NAME

      Use this field to specify the user name or the user group.

    More information about the RBAC_* options is available.

    See About RBAC bootstrapping.

    See About the NetBackup answer file.

  8. Download the server package that matches your server platform to a system with sufficient space. Then extract the contents of the server package file.

    Extract the contents of the server package file. Example:

    • For Linux RedHat:

      tar -xzvf NetBackup_10.3_LinuxR_x86_64.tar.gz

    • For Linux SuSE:

      tar -xzvf NetBackup_10.3_LinuxS_x86_64.tar.gz

  9. Change to the directory for your desired operating system and copy server files to computer to be installed.

    Operating system directory:

    • For Linux RedHat:

      NetBackup_10.3_LinuxR_x86_64/linuxR_x86/anb

    • For Linux SuSE:

      NetBackup_10.3_LinuxS_x86_64/linuxS_x86/anb

    Copy server files to machine to be installed:

    Linux

    • VRTSnbmqbrkr.rpm

    • VRTSnbprimary.rpm

    • VRTSnbslibs.rpm

    • VRTSnbweb.rpm

    • VRTSnetbp.rpm

    • VRTSpddei.rpm

    • VRTSpddes.rpm

    • VRTSpostgresql.rpm

  10. Extract the client binaries and copy them to the primary server.

    Extract the client binaries:

    tar -xzvf client_dist.tar.gz

    Change directory to your desired operating system:

    • RedHat: openv/netbackup/client/Linux/RedHat3.10.0

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

    Copy the files that are shown to the primary server.

    RedHat Linux and SuSE Linux

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

    RedHat Linux only

    VRTSpddeu.rpm
  11. (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 SYMCnetbp
    rpm -e SYMCpddes
    • Copy the ita_dc.tar.gz tarball from the media's /catalog/anb/ directory to the /usr/openv/tmp directory.

    • The copying of the tarball is only needed if you have to upgrade an existing unconfigured ITA DC installation on the host. Or if you upgrading from pre 10.1.1 release and want ITA DC.

    • If user doesn't want ITA DC installed they need to make sure the ITA DC value is in the answer file. set no.

  12. (Conditional): If the upgrade is from NetBackup 10.1.1 or earlier and you want to install NetBackup IT Analytics Data Collector; or if you have an unconfigured NetBackup IT Analytics Data Collector you want to upgrade:

  13. Install the files in the order that is shown with the commands that are shown:

    RedHat Linux

    rpm -U VRTSnbpck.rpm
    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 VRTSpostgresql.rpm
    rpm -U VRTSnetbp.rpm
    rpm -U VRTSnbprimary.rpm
    rpm -U VRTSnbmqbrkr.rpm
    rpm -U VRTSnbweb.rpm
    rpm -U VRTSnbslibs.rpm

    SuSE Linux

    rpm -U VRTSnbpck.rpm
    rpm -U VRTSpbx.rpm
    rpm -U VRTSnbclt.rpm
    rpm -U VRTSnbclibs.rpm
    rpm -U VRTSnbjre.rpm
    rpm -U VRTSnbjava.rpm  
    rpm -U VRTSpddea.rpm
    rpm -U VRTSpddes.rpm
    rpm -U VRTSnbcfg.rpm
    rpm -U VRTSpostgresql.rpm
    rpm -U VRTSnetbp.rpm
    rpm -U VRTSnbprimary.rpm
    rpm -U VRTSnbmqbrkr.rpm
    rpm -U VRTSnbweb.rpm
    rpm -U VRTSnbslibs.rpm
  14. If you decide to install the Java GUI or the JRE after the installation completes, additional information is available.

    See Add or Remove Java GUI and JRE after upgrade.