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
      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.  
        Perform 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 Linux July 2025 patch
  7. Appendix C. Upgrade Oracle rpms
    1.  
      Upgrade Oracle rpms in a Split Architecture Deployment

Upgrade Oracle rpms in a Split Architecture Deployment

The following procedure describes the steps to upgrade Oracle rpms if you have deployed Oracle and NetBackup IT Analytics Portal on separate servers. This deployment is also referred to as split architecture.

To upgrade the Oracle rpms in your split architecture deployment:

  1. Backup the existing Oracle directory.
    #cd /usr/lib
    #cp -Rp oracle oracle.BAK
  2. Verify the rpms installed.
    #rpm -qa | grep oracle
    
    oracle-instantclient-basic-xx.xx.x.x.x-x.exx.x86_64
    oracle-instantclient-sqlplus-xx.xx.x.x.x-x.exx.x86_64
  3. Remove the existing rpms.
    #rpm -e oracle-instantclient-basic-xx.xx.x.x.x-x.exx.x86_64
    # rpm -e oracle-instantclient-sqlplus-xx.xx.x.x.x-x.exx.x86_64
    
  4. Verify that the rpms are removed.
    #rpm -qa | grep oracle
  5. Install the new rpms.
    #rpm -ivh oracle-instantclient-basic-xx.xx.x.x.x-x.exx.x86_64.rpm
    warning: oracle-instantclient-basic-xx.xx.x.x.x-x.exx.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID ad986da3: NOKEY
    Verifying...                          ################################# [100%]
    Preparing...                          ################################# [100%]
    Updating / installing...
       1:oracle-instantclient-basic-21.18.################################# [100%]
    
    
    #rpm -ivh oracle-instantclient-sqlplus-xx.xx.x.x.x-x.exx.x86_64.rpm
    warning: oracle-instantclient-sqlplus-xx.xx.x.x.x-x.exx.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID ad986da3: NOKEY
    Verifying...                          ################################# [100%]
    Preparing...                          ################################# [100%]
    Updating / installing...
       1:oracle-instantclient-sqlplus-21.1################################# [100%]
  6. Verify that SQL Plus is installed.
    #which sqlplus
    /usr/bin/sqlplus
  7. Verify the symbolic link.
    #ls -al /usr/bin/sqlplus
    lrwxrwxrwx 1 root root 39 <TimeStamp> /usr/bin/sqlplus -> /usr/lib/oracle/21/client64/bin/sqlplus
  8. Verify the SQL Plus version and test.
    #su - aptare
    #sqlplus -version
    
    SQL*Plus: Release xx.x.x.x.x - Production
    Version xx.xx.x.x
    #sqlplus portal@<portal_user_password>@<service_name>
    
    SQL*Plus: Release xx.x.x.x.x - Production on <TimeStamp> 
    Version xx.xx.x.x
    
    Copyright (c) <year>, <year>, Oracle.  All rights reserved.
    
    Last Successful login time: <TimeStamp>
    
    Connected to:
    Oracle Database 19c Enterprise Edition Release 19.x.x.x.x - Production
    Version 19.x.x.x.x
    
    

    Example:

    #su - aptare
    #sqlplus -version
    
    SQL*Plus: Release 21.0.0.0.0 - Production
    Version 21.18.0.0.0
    
     
    
    #sqlplus portal/portal@scdb
    
    SQL*Plus: Release 21.0.0.0.0 - Production on Wed Jul 9 12:48:13 2025
    Version 21.18.0.0.0
    
    Copyright (c) 1982, 2022, Oracle.  All rights reserved.
    
    Last Successful login time: Sat May 17 2025 23:58:30 -05:00
    
    Connected to:
    Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
    Version 19.3.0.0.0
  9. Verify TNSNAMES.ORA if required.
    #cd /usr/lib/oracle/21/client64/lib/network/admin/
    
    #cat tnsnames.ora
    scdb =
        (DESCRIPTION =
            (ADDRESS=
                (PROTOCOL=TCP)
                (HOST=xxx.xxx.xxx.xxx)
                (PORT=1521)
            )
            (CONNECT_DATA=(SERVICE_NAME=scdb)(SID=scdb))
        )
    
    EXTPROC_CONNECTION_DATA =
        (DESCRIPTION =
            (ADDRESS=
                (PROTOCOL=IPC)
                (HOST=xxx.xxx.xxx.xxx)
                (KEY=extproc)
    
            (CONNECT_DATA=(SERVICE_NAME=extproc_sid)(SID=extproc_sid))
        )
    
    SCDBCNTR =
        (DESCRIPTION =
            (ADDRESS=
                (PROTOCOL=TCP)
                (HOST=xxx.xxx.xxx.xxx)
                (PORT=1521)
            )
            (CONNECT_DATA=(SERVICE_NAME=scdbcntr)(SID=scdbcntr))
        )