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

Performing silent upgrades on Windows systems

A silent upgrade avoids the need for interactive input in the same manner as performing a remote upgrade. Silent NetBackup installations are not supported if you want to run the NetBackup services as a specific user rather than the local system.

To perform a silent upgrade, you must first modify the appropriate NetBackup script. After script modification, you can run the script to initiate the silent upgrade.

The script shuts down all NetBackup services so that the upgrade can be initiated. If the script detects that other system processes still maintain a handle on any NetBackup files, the upgrade fails. To identify which NetBackup processes are still running, check the NetBackup Install log file at the following location:

%ALLUSERSPROFILE%\Veritas\NetBackup\InstallLogs

After you have manually stopped each of the identified processes, you can run the upgrade script again.

Note:

For Windows 2008/2012/2012 R2/2016 Server Core systems, you can only upgrade NetBackup with this procedure.

To upgrade NetBackup server software silently

  1. Log on as administrator to the system where you want to upgrade NetBackup.
  2. Navigate to the location where the ESD images (downloaded files) reside.
  3. Open Windows Explorer and copy the contents of the X64 directory to a temporary directory on your hard drive. Choose the directory that is associated with the platform type that you want to install.
  4. Since the source files are read-only, you must change the permissions for the copied files to allow the installation or the update.
  5. In the temporary directory where the copied files reside, select the appropriate script to modify:

    • To upgrade a master server, edit silentmaster.cmd

    • To upgrade a media server, edit silentmedia.cmd

    • To upgrade a NetBackup Remote Administration Console, edit silentadmin.cmd

  6. Edit the following lines as needed for your installation:

    • SET ADDITIONALSERVERS=media1,media2,media3

      Enter the names of any additional NetBackup master servers and media servers that you want to communicate with this host. Include the names of servers where you plan to install NetBackup later.

      If no other servers are to communicate with this host, remove this line from the script.

    • SET ABORT_REBOOT_INSTALL=0

      This line lets you determine how you want the upgrade to continue if a restart is required. Select from the following settings:

      0 (default)

      By default, a silent upgrade does not abort if it is determined that a restart is required. If you leave this setting at 0, select one of the following tasks:

      • After the upgrade is complete, check the installation log to see if a restart is required.

        If the string in use appears anywhere in the log, you must restart the system manually.

      • Force an automatic restart after the upgrade is complete.

        To force an automatic restart, before you run the script, remove the following option from the silent installation command script (silent*.cmd):

        REBOOT="ReallySuppress"

      Warning:

      A forced restart occurs with no warning to the user. It does not cancel the upgrade or roll back the system to its original state.

      1

      Select this setting to abort the upgrade if it is determined that a restart is required.

      If a restart is needed, this setting cancels the upgrade and the system is rolled back to its original state.

    • SET SMART_METER_FILE_PATH=path

      For master servers only, you must specify the path to the Veritas Smart Meter customer registration key. More information is available. See About Veritas Smart Meter.

    • ECA_CERT_STORE

      This field is for media servers only. Use this field to specify the external certificate location in a Windows certificate store. This field is specified in the form store_name\issuer_DN\subject. This field is required to use an external certificate from the Windows certificate store.

    • ECA_CERT_PATH

      This field is for media servers only. 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

      This field is for media servers only. 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_CRL_CHECK_LEVEL

      This field is for media servers only. 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

      This field is for media servers only. Use this field to specify the path and the file name of 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.

    • ECA_KEY_PASSPHRASEFILE

      This field is for media servers only. 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.

  7. Save the script and run it.
  8. Examine the installation log at the following location:

    %ALLUSERSPROFILE%\Veritas\NetBackup\InstallLogs\

    Search the installation log for the following error indications:

    • Strings that include Return Value 3.

    • Important log messages are color coded as follows:

      Yellow = warning.

      Red = error.

  9. The binaries are successfully installed. Proceed to the post-installation procedure. More information is available.

    See Post-install procedure for upgrading to NetBackup 8.2.