NetBackup IT Analytics Installation and Upgrade Guide for Linux

Last Published:
Product(s): NetBackup IT Analytics (11.1)
  1. Install the NetBackup IT Analytics Portal on a Linux server
    1.  
      Introduction
    2.  
      Multi-language support and locale considerations (Linux)
    3.  
      OVA-based deployment on VMware ESXi
    4. Installer-based deployment
      1.  
        Task 1: Portal and database deployment strategies (Linux)
      2.  
        Task 2: Pre-installation configuration (Linux)
      3.  
        Task 3: Install Oracle database application binaries (Linux)
      4.  
        Task 4: Install the Portal application binaries (Linux)
      5.  
        Task 5: Installing the database schema (Linux)
      6.  
        Task 6: Start the Portal services (Linux)
      7.  
        Task 7: Request the license key file (Linux)
      8.  
        Task 8: Log into the Portal
      9.  
        Task 9: Install the license key file (Linux)
      10.  
        Task 10: Performing a cold backup of the database (Linux)
      11.  
        Recommended database backup process
    5.  
      Supported third-party and open source products
    6.  
      Uninstall the NetBackup IT Analytics Portal
  2. 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.  
      Collector updates from the NetBackup IT Analytics Portal
  3. Oracle patches for the database server
    1.  
      Apply Oracle-recommended patches
    2. Apply Oracle 19c April 2023 patch application on Linux
      1.  
        Pre-Install setup
      2.  
        OPatch installation steps
      3.  
        Installing the patches
      4.  
        Validate the database and OJVM patch
      5.  
        Validate the JDK version update
  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)

Run the upgrade utility

The following instructions assume that the Portal and Database components reside on the same server.

  1. Verify your current NetBackup IT Analytics version. You must be currently running NetBackup IT Analytics version 10.4.00 or greater.

  2. Verify that the libXtst.so.6 libraries are installed.

  3. Ensure that all NetBackup IT Analytics application services are up and running. Next, as user root run the following command and respond to the prompts accordingly.

    sh /opt/aptare/upgrade/upgrade.sh

    • While upgrading to 10.6 or later for the first time, the upgrade utility prompts for a new license file with .slf extension. You must have equal or more entitlement than the currently consumed license capacity.

      For information on license generation and installation, see NetBackup IT Analytics Licensing Guide.

    • If there are errors during the upgrade, the following banner is displayed:

      ##############################################################

      # WARNING WARNING WARNING WARNING WARNING #

      # Possible problems were encountered during the upgrade. #

      # Please check the log file /opt/aptare/upgrade/logs/upgrade.log #

      # for errors and contact Customer Support if necessary. #

      ##############################################################

  4. If the upgrade process encountered any errors, save a copy of the log file for any correspondence with the Veritas Support. You can find the upgrade log file in the following location:

    /opt/aptare/upgrade/logs/upgrade.log

Note that:

  • If you have installed any patches on your present NetBackup IT Analytics version, please check the Release Notes to verify that they are included in this release. If you are uncertain, please check with the Veritas Support. In most cases, previously installed patches are included in the current release.

  • If your upgrade fails because of an Apache version conflict, contact Veritas Support for instructions and a link to download a new version.