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)

Task 5: Installing the database schema (Linux)

System: Database Server

This section covers the creation of the NetBackup IT Analytics database. Follow these steps on the same server you installed the Oracle application binaries.

Note:

This step is required only if you have not opted to run create_itanalytics_database.sh as a part of the Itanalyticsinstaller.sh script.

  1. Log in as aptare to your NetBackup IT Analytics Database server.

    You must be logged in as a database user. If you already are logged in as root: su - aptare

  2. Run the NetBackup IT Analytics database installation script to install the NetBackup IT Analytics database objects and schema:

    mnt/portal/create_itanalytics_database.sh

    Note:

    The following dialog will only appear if you are re-installing the NetBackup IT Analytics database (e.g., after a failed attempt)

    The installer launches and prompts you to enter the domain name:

    Enter your IT Analytics Portal Domain Name: yourcompany.com
You entered the following of your IT analytics 
domain name: yourcompany.com
Your IT Analytics Super User Login Account will be 
admin@yourdomain
Is this the correct domain name (y/n)? y

  3. Database files will be extracted and the database schema will be created. This step will take between 5 - 10 minutes to complete.

  4. Next, the installer will load the database with Oracle packages. This step will take between 30 - 60 minutes to complete, depending on your system performance.

  5. The Portal user and the database schema are now created. During this step Oracle may produce messages similar to the following:

    mv: cannot stat `/opt/aptare/oracle/lib/EVENT_PACKAGE__PORTAL__2.so': No such file or directory

    Note:

    These messages can be ignored. Any other exceptions or errors however indicate a potential issue with the installation.

    Creating NetBackup IT Analytics Portal user ...
Completed creation of the NetBackup IT Analytics Portal database user
Creating NetBackup IT Analytics database schema tables ...
...
... (EACH STEP LOGS TO THE CONSOLE...)
...
Completed creation of the NetBackup IT Analytics base schema tables
Creating NetBackup IT Analytics <backup product> schema tables ...

  6. The Packages are now validated:

    If you do not see the message "Successfully validated ALL Packages" at the end of this step, there is a possible problem with the install and you should save a copy of the installer log and contact the Veritas Support.

    Validating NetBackup IT Analytics Packages...
Validating PACKAGE ADAPTOR_PACKAGE
Validating PACKAGE ADMINREP_PACKAGE
Validating PACKAGE ALL_ERROR_PKG
...
... (EACH PACKAGE IS LOGGED TO THE CONSOLE...)
...
Validating PACKAGE XML_REPORT_PKG
Package specifications have successfully been validated
...
Successfully validated ALL Packages.

  7. The database creation is now complete. 

    Creation of NetBackup IT Analytics Database completed at 
Nov 11 18:31:46 PDT 2021
A complete log of this session can be found in the file: 
/opt/aptare/logs/install/create_itanalytics_database_xxxxx.log

    Note:

    If the installer reports errors during the install and you are unable to resolve the problem, you should save a copy of the installer log and contact the Veritas Support.

    If you do not have a NetBackup IT Analytics license, you can install a trial license which is valid for 60 days with the this command as a root user:

    /opt/aptare/utils/installlicenseUI.sh /mnt/portal/license.slf

  8. Installation of the Database components is now complete.

    The NetBackup IT Analytics database is a container database with the pluggable database SCDB attached to it. The data files for the tablespaces are stored in the /data01-06/oradata/scdbpdb directory.

    Continue to the next section for the final step--License Key file installation.

If you have configured a custom OS user or a group for Oracle or portal, instead of the default users or groups:

  • Update the OS user and group details in the environment file /opt/aptare/bin/aptare_env.sh.

  • Ensure environment variables for Oracle, such as ORACLE_HOME, ORACLE_SID, PATH, LD_LIBRARY_PATH are set appropriately in /opt/aptare/bin/aptare_env.sh and are exported correctly.