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

Configure the NetBackup IT Analytics Data Collector manually for NetBackup

The primary server installation deploys the NetBackup IT Analytics Data Collector binaries automatically as part of a successful NetBackup installation. The binaries are installed to install_path\Veritas\ (Windows) or /usr/openv/analyticscollector (Linux). This section details the steps that are required to manually configure the Data Collector.

Keep the following details handy when you configure the Data Collector:

  • Name of the Data Collector (as configured on the Veritas Alta or NetBackup IT Analytics Portal).

  • Passcode of the Data Collector (as configured on the Veritas Alta or NetBackup IT Analytics Portal).

  • Data receiver URL (generated when you create the Data Collector on the Veritas Alta or NetBackup IT Analytics Portal). Ensure the NetBackup primary server can resolve the host name of the Data Receiver URL.

  • Key file path (generated when you create the Data Collector on the Veritas Alta or NetBackup IT Analytics Portal and copied to the NetBackup primary server).

See the Add/Edit Data Collectors section in the NetBackup IT Analytics User Guide for more information.

To configure the Data Collector manually on Windows:

  1. Create a response file as a batch script responsefile.cmd with the contents shown. These are the responses to the user input required to configure the Data Collector.
    SET DATACOLLECTOR_NAME=name_of_the_data_collector
SET DATACOLLECTOR_PASSCODE=passcode_for_the_data_collector
SET DATARECEIVER_URL=data_receiver_URL
SET DATACOLLECTOR_KEY_FILE_PATH=path_to_the_key_file
SET HTTP_PROXY_CONF=N
SET PROXY_HTTP_URL=
SET PROXY_HTTP_PORT=
SET PROXY_HTTPS_URL=
SET PROXY_HTTPS_PORT=
SET PROXY_USERID=
SET PROXY_PASSWORD=
SET PROXY_NOT_FOR=
  2. Update the value for each field with appropriate data. A sample response file is also available in the installer media in x64\ITA_DC\responsefile.cmd.
  3. Run the command shown:
    "C:\ProgramData\Veritas\NetBackup IT Analytics\DC\configure.cmd"
\RESPFILE:response_file_path \INSTALL_TYPE:CONFIG
  4. Validate the Data Collector integration with NetBackup IT Analytics by going to C:\Program Files\Veritas\analyticscollector\mbs\bin\ and running this command:
    checkinstall.bat

    If the Data Collector is configured with the Portal, the response is displayed as SUCCESSFUL.

    Note:

    If there is a version mismatch of aptare.jar between the Data Collector and the portal, execution of the checkinstall.bat command starts an auto-update of the Data Collector.

To configure the Data Collector manually on Linux:

  1. Create a response file with the contents shown. These are the responses to the user input required to configure the Data Collector:
    COLLECTOR_NAME=name_of_the_data_collector
COLLECTOR_PASSCODE=passcode_for_the_data_collector
DR_URL=data_receiver_URL
COLLECTOR_KEY_PATH=path_to_the_key_file
HTTP_PROXY_CONF=N
HTTP_PROXY_ADDRESS=
HTTP_PROXY_PORT=
HTTPS_PROXY_ADDRESS=
HTTPS_PROXY_PORT=
PROXY_USERNAME=
PROXY_PASSWORD=
PROXY_EXCLUDE=
  2. Update the value for each field with appropriate data.

    A sample response file is available on the install media and from /usr/openv/analyticscollector/installer/responsefile.sample on the primary server.

  3. Run the command: 
    /usr/openv/analyticscollector/installer/dc_installer.sh -c responsefile_path
  4. Validate the Data Collector integration with NetBackup IT Analytics by navigating to /usr/openv/analyticscollector/mbs/bin/ and running ./checkinstall.sh

    If the Data Collector is able to communicate with the NetBackup IT Analytics Portal, the response is displayed as SUCCESSFUL.

    Note:

    If there is a version mismatch of aptare.jar between the Data Collector and the portal, execution of the checkinstall.sh command starts an auto-update of the Data Collector.

Start, stop, and get the status of the Data Collector

On Linux:

  • To start the Data Collector processes, run:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent start

  • To stop the Data Collector processes, run:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent stop

  • To get the status of the Data Collector processes, run:

    /usr/openv/analyticscollector/mbs/bin/aptare_agent status

On Windows: Review the status of Aptare Agent, Aptare Kafka, and Aptare Zookeeper services on the Windows service panel.

Note:

If the Data Collector is configured with an on-premises NetBackup IT Analytics Portal, then to edit any of the Data Collector properties on the Portal, refer to Edit NetBackup IT Analytics Data Collector credentials section in the NetBackup IT Analytics User Guide.