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. Apply Oracle 19c October 2024 patch application
      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

Step-1: Get the NetBackup IT Analytics license key file

A valid license file is required to run the Portal application. If you already have a license file, proceed to the Installation section.

To generate a license key:

  1. Open the Veritas support portal. (https://www.veritas.com/content/support/en_US/)
  2. Click Licensing and login to the Veritas Entitlement Management System using your Administrator credentials.
  3. Open the Entitlements tab and use the filters at the top to filter and locate the entitlements granted to your account.
  4. Click the key icon located against the entitlement ID for which you wish to generate a license key. The Generate License Key page is displayed. Verify your account details for which you plan to generate the license key.
  5. Select the product version for which you want to generate the key. By default, the latest product version is selected.
  6. Specify the license quantity that you wish to deploy using the key. By default, the entire available quantity is displayed in the field. You can utilize a partial subset of your entitled licenses with this key and generate a separate key for the remainder.

    Note:

    If you create a key for less than the entitled quantity and if you wish to increase the quantity of the systems later using the entitlement associated with the key, you must create a new key for the additional systems. On the contrary, to reduce the number of systems associated with a key, you need to assign a new key to the reduced systems and edit the older key.

  7. Provide the host lock string of the system where APTARE IT Analytics will be installed using this key. To get the correct host lock string, run one of these commands on the portal server:
    /opt/aptare/utils/VxLicGetHostLock.sh

    On Linux, VxLicGetHostLock.sh uses hostname --fqdn commands to get the hostname of the system and uses it to create the host string. Hence, ensure hostname --fqdn returns a fully qualified host name, instead of a short name. For example, the command output must have at least one dot (.) character.

    If you have not installed the APTARE IT Analytics Portal, you can download the VxLicGetHostLock.sh from the Veritas download center and run the appropriate script depending on the OS of the Portal server.

  8. After running the VxLicGetHostLock.sh file, you get the following output:
    Veritas Get Host Lock utility v1.0.0.0
    Copyright (c) 2022 Veritas Technologies LLC. All rights reserved.
    
    FQDN: xyz.abc.com
    Host Lock String: [sha512]4aba838e350d3c9471aa5334db5de8ad4a0ff
    45e34a6cfaea064f4ca77812acd4c8abc7be6b2d756574b7d6e06ceb9581357
    b824f4f70f84b39d938e85ee62b5

    While generating the license key on VEMS, use the same host lock string including [sha512].

    For example:

    [sha512]4aba838e350d3c9471aa5334db5de8ad4a0ff
    45e34a6cfaea064f4ca77812acd4c8abc7be6b2d756574b7d6e06ceb9581357
    b824f4f70f84b39d938e85ee62b5
  9. Add comments about to the license key if required for the future reference.
  10. Click Generate. The Generated Key page is displayed with the new key in the License Key column. You can click the key link and save it locally.