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

Persistent Java Virtual Machine options

Before NetBackup 9.0, any web service Java Virtual Machine (JVM) tuning values (such as memory allocation) are overwritten during NetBackup upgrades. In NetBackup 9.0, Veritas has defined a set of web server JVM tuning options that persist across upgrades. These options are defined as environment variables in an executable shell script that is stored on the local host. The script's contents override the out of the box JVM tuning options. The script only runs when the NetBackup 9.0 or later web service starts. You can configure the options for which you want to override the default values. You can define this script at any time. Once the values are defined, you do not need to redefine them in any future upgrades.

To define the persistent JVM tuning options:

  1. Create the wmcConfig script in the appropriate NetBackup configuration directory:

    Windows: install_path\Veritas\NetBackup\var\global\wsl\config\wmcConfig.bat

    UNIX and Linux: /usr/openv/var/global/wsl/config/wmcConfig.sh

  2. Edit the script to include the desired variables from the supported variables list. Each value must be on its own line. Supported variables are:
    WMC_HEAP
WMC_METASPACE
WMC_NEW_RATIO
WMC_SURVIVOR_RATIO
WMC_GC_CONFIG
WMC_HEAP_DUMP_CONFIG

    Refer to the JVM documentation from Oracle for more information on the variables and their appropriate ranges.

  3. Restart the web service to apply the configuration changes.