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. Install Oracle 19c October 2025 patch
      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

Configure X Virtual Frame Buffer (Xvfb)

Xvfb is a graphic manager that ensures proper rendering of the reports or emails exported as PDF files. You can perform this configuration as a part of your pre-installation steps for NetBackup IT Analytics Portal.

To configure Xvfb:

  1. Ensure that system is configured to boot in graphical target, also known as runlevel 5.
    • Check existing default target.

      # systemctl get-default
    • Set default target to graphical.target.

      # systemctl set-default graphical.target
  2. Use yum to install Xvfb.
    # yum install Xvfb
  3. If the OS is RHEL 8, install rpm libXtst if not already installed.
    # yum install libXtst
  4. Create a config file for Xvfb.
    • Run # cd /etc/init.d

    • Create a file Xvfb_background with this content:

      #!/bin/sh
      # chkconfig:345 20 80
      # /etc/init.d/Xvfb_background
      #
      # Some things that run always
      #touch /var/lock/Xvfb_background
      # Carry out specific functions when asked to by the system 
      case "$1" in 
      start)
      echo "Starting script Xvfb_background"
      /usr/bin/Xvfb :99 &
      ;;
      stop)
      echo "Stopping script Xvfb_background"
      x=`pgrep Xvfb`; sudo kill -9 $x
      ;;
      *)
      echo "Usage: /etc/init.d/Xvfb_background {start|stop}"
      exit 1
      ;;
      esac
      exit 0
      
    • Run the commands:

      # chmod 755 Xvfb_background
      # chkconfig --add Xvfb_background
      # ./Xvfb_background start
      # /usr/lib/systemd/system-generators/systemd-sysv-generator
      # systemctl enable Xvfb_background
      
    • Confirm the Xvfb process is running on port :99 with:

      #  ps -ef | grep Xvfb
      # netstat -anp | grep Xvfb
      
  5. Update the Tomcat bash profile.
    su - tomcat
    

    Modify the profile file to look like the one below:

    # vi .bash_profile          
    JAVA_HOME=/usr/java
    JRE_HOME=
    TOMCAT_HOME=/opt/tomcat
    export JAVA_HOME JRE_HOME TOMCAT_HOME
    STORAGE_HOME=$PORTAL_BASE
    export STORAGE_HOME
    APTARE_HOME=/opt/aptare
    export APTARE_HOME
    PORTAL_HOME=$APTARE_HOME/portal
    export PORTAL_HOME
    export DISPLAY=:99
    
    JAVA_OPTS="-server -DPORTAL_HOME=/opt/aptare/portal -DAPTARE_HOME=/opt/aptare"
    export JAVA_OPTS
    umask 0022
    
  6. Restart NetBackup IT Analytics services.
  7. Test a wide report to ensure the exported PDF appears without truncation.