NetBackup IT Analytics Installation and Upgrade Guide for Linux

Last Published:
Product(s): NetBackup IT Analytics (11.4)
  1. Installation overview
    1.  
      Introduction
    2.  
      NetBackup IT Analytics components
    3.  
      Standard or Shared Services licensing edition
    4.  
      Install options
    5.  
      Multi-language support and locale considerations (Linux)
    6.  
      Supported third-party and open source products
  2. Install NetBackup IT Analytics on a Linux server
    1.  
      Step-1: Get the NetBackup IT Analytics license key file
    2.  
      Step-2: Portal and database deployment strategies
    3.  
      Step-3: Portal and database prerequisites
    4. Step-4: Install Oracle database application binaries (Linux)
      1.  
        Create database and users in existing Oracle farm in a Split Architecture deployment
    5.  
      Step-5: Install the Portal application binaries (Linux)
    6.  
      Step-6: Start the Portal services (Linux)
    7.  
      Step-7: Log into the Portal
    8.  
      Step-8: Install a license
    9. Verify the current license configuration
      1.  
        Run the License Summary report
      2.  
        About NetBackup IT Analytics version and license
      3.  
        View License Details
    10. Next steps
      1.  
        Performing a cold backup of the database
      2.  
        Recommended database backup process
  3. Upgrade NetBackup IT Analytics Portal on Linux
    1.  
      Overview
    2.  
      Upgrade path
    3.  
      Before upgrading
    4. Upgrade NetBackup IT Analytics Portal
      1.  
        Upgrade a shared services environment
      2.  
        Run the upgrade utility installer (Linux)
      3.  
        Known issues
      4.  
        Run the upgrade utility
      5.  
        After the upgrade
      6.  
        Upgrade methods to incorporate enterprise objects
      7. Attribute merging during the Portal upgrade
        1.  
          Attribute Management During the Portal Upgrade
        2.  
          Example of a Merge of Attribute Values
        3.  
          Steps to Rename Duplicate Attributes
        4.  
          Best Practice for Attributes in Multi-Tenancy Environments
    5. Data Collector upgrades
      1.  
        Mandatory prerequisites
    6.  
      Troubleshoot - Manual Data Collector upgrades
    7.  
      Troubleshoot Data Collector upgrade manager upgrade failure and collector bundle download failure on Linux
    8.  
      Collector updates from the NetBackup IT Analytics Portal
  4. Upgrade and Migrate to a new server
    1. Upgrade and migrate to a new server
      1.  
        Install the latest release of NetBackup IT Analytics on the new server
      2.  
        Perform an export of the database on the existing server
      3.  
        Stop Portal and agent services on the new server
      4.  
        Drop and re-create the existing portal user on the new server
      5.  
        Import the database onto the new server
      6.  
        Start Portal and agent services on the new server
      7.  
        Download, install, and execute to upgrade the database schema
    2.  
      Testing
    3.  
      Update Data Collector binaries (if necessary)
  5. Appendix A. X Virtual Frame Buffer
    1.  
      Configure X Virtual Frame Buffer (Xvfb)
  6. Appendix B. Oracle patches for the database server
    1. Apply Oracle 19c October 2024 patch application
      1.  
        Pre-Install setup
      2.  
        OPatch installation steps
      3.  
        Installing the Oracle patches
      4.  
        Validate the database and OJVM patches
      5.  
        Validating JDK version update

Troubleshoot Data Collector upgrade manager upgrade failure and collector bundle download failure on Linux

NetBackup IT Analytics Data Collector software includes two components - Upgrade Manager and Data Collector.

When NetBackup IT Analytics Portal is upgraded successfully to a newer version, the subsequent Data Collector upgrade may fail with errors like "Collector bundle download failed for 11.4 Premature EOF" or "Upgrade Manager upgrade failed. Exception is : Premature EOF". These errors indicate that upgrade bundle could not be downloaded successfully on to the Data Collector server due to slow network/low bandwidth.

Prerequisites to troubleshoot

You must have access to:

  • Data Collector server and Portal server.

  • Permissions to copy files from and to Data Collector server and Portal server.

Notation used in the steps below

Table: Notations used in the code snippets

Notation

Description

<PORTAL_APTARE_HOME>

Path of Portal installation.

Default value for Linux Portal: /opt/aptare

<DC_APTARE_HOME>

Path of Data Collector installation.

Default value for Linux : /usr/openv/analyticscollector

<version>

Version of the NetBackup IT Analytics Portal.

You can troubleshoot upgrade manager upgrade failure and collector bundle download failure individually or together as discussed below.

Troubleshoot upgrade failure of the upgrade manager component

To resolve the issue with the upgrade manager component:

  1. Log on to the Portal server.
  2. Go to <PORTAL_APTARE_HOME>/updates location and copy <PORTAL_APTARE_HOME>/updates/aptare_dc_upgrader-linux.zip to a temporary location on any other server or Data Collector server directly.
  3. Log on to Data Collector server and copy aptare_dc_upgrader-linux.zip from temporary location to <DC_APTARE_HOME>/upgrade/bundles.
  4. Remove all *.properties files from the <DC_APTARE_HOME>/upgrade directory
  5. Remove restore.txt file from <DC_APTARE_HOME>/upgrade directory
  6. Upgrade either from the Portal (recommended) or from the Data Collector server as described in the procedures below.

To upgrade from NetBackup IT Analytics Portal:

  1. Login to the Portal.
  2. Go to Admin > Data Collection > Collector Administration and verify whether the Data Collector appears online.
  3. Go to Admin > Data Collection > Collector Updates and select the Data Collector for which the Upgrade Manager component needs to be upgraded.
  4. Click Update Upgrade Manager.

    The upgrade takes up to 15 minutes to complete.

To upgrade from the Data Collector server:

  1. Log on to the Data Collector server.

    The upgrade takes up to 15 minutes to complete.

  2. As a root user, run:
    <DC_APTARE_HOME>/mbs/bin/downloadlib.sh

    The upgrade takes up to 15 minutes to complete.

Troubleshoot upgrade failure of the Data Collector component

To resolve the failure of Data Collector component upgrade:

  1. Log on to the Portal server and go to <PORTAL_APTARE_HOME>/dc_upgraders/linux.
  2. Copy aptare.jar to a temporary location on any other server or Data Collector server directly.
  3. Log on to the Data Collector server.
  4. Copy aptare.jar from the temporary location to <DC_APTARE_HOME>/upgrade/bundles.
  5. Rename aptare.jar to dc_upgrader.<version>.zip.

    For example, if <version> is 11.3.1.02, then file name will be dc_upgrader.11.3.1.02.zip

  6. Remove all *.properties files from the <DC_APTARE_HOME>/upgrade directory
  7. Remove restore.txt file from <DC_APTARE_HOME>/upgrade directory
  8. Upgrade the Data Collector component either from the Portal (recommended) or from the Data Collector server as described in the procedures below.

To upgrade from NetBackup IT Analytics Portal:

  1. Login to the Portal.
  2. Go to Admin > Data Collection > Collector Administration and verify whether the Data Collector appears online.
  3. Go to Admin > Data Collection > Collector Updates and select the Data Collector for which the component needs to be upgraded.
  4. Select Upgrade aptare.jar.

    The upgrade takes up to 15 minutes to complete.

To upgrade from the Data Collector server:

  1. Log on to the Data Collector server.
  2. As a root user, run:
    <DC_APTARE_HOME>/mbs/bin/downloadlib.sh

    The upgrade takes up to 15 minutes to complete.

Upgrade the Upgrade Manager and Data Collector components together

To upgrade both Upgrade Manager and Data Collector components together:

  1. Log on to the Portal server.
  2. Go to <PORTAL_APTARE_HOME>/updates location and copy <PORTAL_APTARE_HOME>/updates/aptare_dc_upgrader-linux.zip to a temporary location on any other server or Data Collector server directly.
  3. Copy <PORTAL_APTARE_HOME>/dc_upgraders/<version>/linux/aptare.jar to a temporary location on any other server or Data Collector server directly.
  4. Log on to Data Collector server and copy aptare_dc_upgrader-linux.zip and aptare.jar from the temporary location to <DC_APTARE_HOME>/upgrade/bundles.
  5. Rename aptare.jar to dc_upgrader.<version>.zip.

    For example, if <version> is 11.3.1.02, then file name will be dc_upgrader.11.3.1.02.zip

  6. Remove all *.properties files from the <DC_APTARE_HOME>/upgrade directory
  7. Remove restore.txt file from <DC_APTARE_HOME>/upgrade directory
  8. Upgrade the Data Collector component either from the Portal (recommended) or from the Data Collector server as described in the procedures below.

To upgrade from NetBackup IT Analytics Portal:

  1. Login to the Portal.
  2. Go to Admin > Data Collection > Collector Administration and verify whether the Data Collector appears online.
  3. Go to Admin > Data Collection > Collector Updates and select the Data Collector for which the component needs to be upgraded.
  4. Select Upgrade Both.

    The upgrade takes up to 15 minutes to complete.

To upgrade from the Data Collector server:

  1. Log on to the Data Collector server.
  2. The upgrade takes up to 15 minutes to complete.
  3. As a root user, run:
    <DC_APTARE_HOME>/mbs/bin/downloadlib.sh

    The upgrade takes up to 15 minutes to complete.

Upgrade logs and upgrade related database views

Logs:

  • Upgrade Manager upgrade logs:

    <DC_APTARE_HOME>/mbs/logs/watchdog.log

  • Data Collector upgrade logs:

    "Download of DC upgrade bundle and verification related"

    <DC_APTARE_HOME>/mbs/logs/watchdog.log
<DC_APTARE_HOME>/upgrade/logs

Database views

  • apt_v_system_upgrade: High level upgrade status

    • "Component_Name" column indicates the Data Collector server

    • "Message From" column indicates if it is a "Data Collector" component or "Upgrade Manager" component upgrade

      • If "Message From" is "Super_Upgrader" - The status is related to "Upgrade Manager" component upgrade

      • If "Message From" is "Upgrade_Manager" - The status is related to "Data Collector" component upgrade

  • apt_v_system_upgrade_detail: Detailed upgrade messages for a particular upgrade session.