NetBackup IT Analytics Installation and Upgrade Guide for Linux

Last Published:
Product(s): NetBackup IT Analytics (11.6)
  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 - Downgrade of Data Collector is not supported
    7.  
      Troubleshoot - Manual Data Collector upgrades
    8.  
      Troubleshoot Data Collector upgrade manager upgrade failure and collector bundle download failure on Linux
    9.  
      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 January 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
      6.  
        Removing Oracle SQL Developer with log4j
      7.  
        Installing SQL Developer for Oracle 19c on Linux Virtual Machine

Installing SQL Developer for Oracle 19c on Linux Virtual Machine

Installing SQL Developer on Linux involves few steps. As part of this process, ensure proper version of java is installed. Verify the following versions:

  • SQL developer version 21.4.2.x and above

  • log4j version 2.17 and above

  • Java version 11 and above

Following are the steps to install SQL Developer for Oracle 19c on Linux virtual machine.

Removing old SQL Developer

If you have SQL Developer under /opt/aptare/oracle/sqldeveloper folder with log4j version below 2.17, refer to See Removing Oracle SQL Developer with log4j. section to remove old SQL Developer.

Pre-requisites for the installation
  1. Log into the virtual machine or server as a root user.
  2. Download the following 2 files from Oracle Website for Linux platform RPM and save to /tmp folder.

    https://www.oracle.com/database/sqldeveloper/technologies/download/

    • sqldeveloper-21.4.2-018.1706.noarch.rpm

    • jdk-8u411-linux-x64.rpm

    Note:

    Cohesity does NOT recommended to run sqldeveloper on the portal system.

  3. Run cd/tmp command.
  4. Log into the server as a root user.
  5. Stop all the services using . /opt/aptare/bin/aptare stop command.
Installing Java version 11

As a root user create a copy of the jdk file from /tmp to /opt/ folder using the following commands.

 mv jdk-8u411-linux-x64.rpm  /opt
sudo su -
rpm -ivh jdk-8u411-linux-x64.rpm
Installing SQL Developer
  1. As a root user, create a copy of the SQL Developer rpm from /tmp to /opt folder using the following command.

    mv sqldeveloper-21.4.2-018.1706.noarch.rpm /opt

  2. Install the SQL Developer using the following command

    sudo rpm -Uhv sqldeveloper-21.4.2-018.1706.noarch.rpm

    Note:

    The above command will create a sqldeveloper folder in /opt.

  3. Access the file with the following command and configure the Java path as follows:
    vi /root/.sqldeveloper/21.4.2/product.conf 
SetJavaHome /opt/aptare/oracle/jdk
  4. Verify the Java Home configuration using the following command.

    echo $JAVA_HOME

Installing X11 forwarding tool

Install a X11 forwarding tool on a separate machine.

This requires to start the SQL Developer.

Starting SQL Developer
  1. Log into virtual machine or the server where SQL Developer and X11 forwarding tool is installed.
  2. The SQL Developer binary is located in /opt/sqldeveloper folder, hence execute the binary from the following.
    cd /opt/sqldeveloper
./sqldeveloper.sh

    This will start up SQL Developer