APTARE IT Analytics Data Collector Installation Guide for Backup Manager

Last Published:
Product(s): APTARE IT Analytics (10.6)
  1. Introduction
    1.  
      Overview
    2.  
      Backup Manager Collection of Backup and Restore Data
  2. Pre-Installation setup for Commvault Simpana
    1.  
      Introduction
    2.  
      Architecture overview (Commvault Simpana)
    3.  
      Prerequisites for adding Data Collectors (Commvault Simpana)
    4.  
      Upgrade troubleshooting: Microsoft SQL Server and Java 11
    5.  
      Installation overview (Commvault Simpana)
    6. Open TCP/IP access to the Commvault database
      1.  
        Additional Static Port Configuration Steps
    7. Set up a read-only user in the CommServe server
      1.  
        Option 1: Execute SQL commands in the CommServe database
      2.  
        Option 2: Use MSSQL Management Studio
    8.  
      Load historical data prior to initial data collection
    9.  
      Add Commvault Simpana servers
    10.  
      Add a Commvault Simpana Data Collector policy
  3. Pre-Installation setup for Cohesity DataProtect
    1.  
      Introduction
    2.  
      Prerequisites for adding Data Collectors (Cohesity DataProtect)
    3.  
      Installation overview (Cohesity DataProtect)
    4.  
      Add a Cohesity DataProtect Data Collector policy
  4. Pre-Installation setup for EMC Avamar
    1.  
      Introduction
    2.  
      Architecture overview (EMC Avamar)
    3.  
      Prerequisites for adding Data Collectors (EMC Avamar)
    4.  
      Installation overview (EMC Avamar)
    5.  
      Add EMC Avamar servers
    6.  
      Adding an EMC Avamar Data Collector policy
    7.  
      Testing the collection
    8.  
      Add/Configure an Avamar Server within the Data Collector policy window
    9. Import EMC Avamar server information
      1.  
        CSV Format Specifications
      2.  
        Import Notes
    10.  
      Export EMC Avamar server information
  5. Pre-Installation setup for EMC Data Domain backup
    1.  
      Architecture overview (EMC Data Domain Backup)
    2.  
      Prerequisites for adding Data Collectors (EMC Data Domain Backup)
    3.  
      Installation overview (EMC data domain Backup)
    4.  
      Add EMC data domain servers
    5.  
      Add an EMC data domain backup Data Collector policy
    6.  
      Adding/Configuring an EMC data domain server within the Data Collector policy window
    7.  
      Configure a data domain server for file-level compression collection
  6. Pre-Installation setup for EMC NetWorker
    1.  
      Introduction
    2. Architecture overview (EMC NetWorker)
      1.  
        EMC NetWorker Terminology
    3.  
      Prerequisites for adding Data Collectors (EMC NetWorker)
    4.  
      Installation overview (EMC NetWorker)
    5.  
      Add EMC NetWorker servers
    6.  
      Adding an EMC NetWorker Data Collector policy
    7.  
      Adding/Editing a EMC NetWorker server within the Data Collector policy
    8.  
      Configure a notification action in EMC NetWorker
  7. Pre-Installation setup for Dell EMC NetWorker backup & Recovery
    1.  
      Introduction
    2.  
      Prerequisites for adding data collectors (Dell EMC NetWorker Backup & Recovery)
    3.  
      Installation overview (Dell EMC Networker Backup & Recovery)
    4.  
      Adding a Dell EMC Networker Backup & Recovery Data Collector policy
  8. Pre-Installation setup for generic backup
    1.  
      Introduction
    2.  
      Generic backup data collection
    3.  
      Prerequisites for adding Data Collectors (Generic Backup)
    4.  
      Installation overview (generic backup)
    5.  
      Add generic backup servers
    6.  
      Add a generic backup Data Collector policy
    7.  
      Adding/Editing a generic backup server within the Data Collector policy
    8.  
      Manually load the CSV file (generic backup)
    9. CSV format specification
      1.  
        EXAMPLE: genericBackupJobs.csv
  9. Pre-Installation setup for HP Data Protector
    1.  
      Introduction
    2. Architecture overview (HP Data Protector)
      1.  
        Cell Manager
      2.  
        Disk agent (backup agent)
      3.  
        Media agent
      4.  
        Client systems
      5.  
        User interface (UI)
    3.  
      Prerequisites for adding Data Collectors (HP Data Protector)
    4.  
      Installation overview (HP Data Protector)
    5.  
      Identify HP Data Protector collection requirements
    6.  
      Cell Manager commands for data collection
    7.  
      Preparing for centralized data collection on a remote Cell Manager
    8. Configure the Data Collector server in Cell Manager (HP Data Protector)
      1.  
        Requirements for the Data Collector (Windows)
      2.  
        Steps to Configure the Data Collector Server in Cell Manager
    9.  
      Configure an HP Data Protector admin user
    10.  
      Validate HP Data Protector setup
    11.  
      Add HP Cell Manager servers to APTARE IT Analytics
    12.  
      Add an HP Data Protector Data Collector policy
    13.  
      Add/Edit a HP Data Protector server within the Data Collector policy
    14.  
      Tune the configuration
  10. Pre-Installation setup for IBM Spectrum Protect (TSM)
    1.  
      Introduction
    2. Architecture overview (IBM Spectrum Protect -TSM)
      1.  
        IBM Spectrum Protect (TSM) - servers and instances defined
    3.  
      Prerequisites for adding data collectors (IBM Spectrum Protect - TSM)
    4.  
      Installation overview (IBM Spectrum Protect - TSM)
    5.  
      Add IBM Spectrum Protect (TSM) servers
    6.  
      Adding an IBM Spectrum Protect (TSM) Data Collector policy
    7.  
      Add/Configure an IBM Spectrum Protect (TSM) server within the Data Collector policy
    8. Import IBM Spectrum Protect (TSM) information
      1.  
        CSV format specifications
    9.  
      Export IBM Spectrum Protect (TSM) server information
  11. Pre-Installation setup for NAKIVO Backup & Replication
    1.  
      Introduction
    2.  
      Prerequisites for adding data collectors (NAKIVO Backup & Replication)
    3.  
      Installation overview (NAKIVO Backup & Replication)
    4.  
      Add a NAKIVO Backup & Replication Data Collector policy
  12. Pre-Installation setup for Veritas Backup Exec
    1.  
      Introduction
    2.  
      Architecture overview (Veritas Backup Exec)
    3.  
      Backup Exec terminology
    4.  
      Prerequisites for adding data collectors (Veritas Backup Exec)
    5.  
      Upgrade troubleshooting: Microsoft SQL Server and Java 10
    6.  
      Installation overview (Veritas Backup Exec)
    7.  
      Enable TCP/IP for the SQL server
    8.  
      Configure a Windows user
    9.  
      Add Veritas Backup Exec servers
    10.  
      Importing Backup Exec Server information
    11.  
      Add a Veritas Backup Exec Data Collector policy
  13. Pre-Installation setup for Veritas NetBackup
    1.  
      Introduction
    2.  
      General prerequisites for adding data collectors (Veritas NetBackup)
    3.  
      Centralized or distributed deployment (Veritas NetBackup)
    4.  
      Centralized NetBackup data collection (Recommended)
    5. Prerequisites to use SSH and WMI (Veritas NetBackup)
      1.  
        Configure NetBackup Access Control (NBAC) for NetBackup Data Collection
      2.  
        Configure NetBackup sudo access for NetBackup data collection
      3.  
        Configure NetBackup Appliances for Data Collection
      4.  
        Configure NetBackup Flex Appliances for Data Collection
      5.  
        Veritas NetBackup SSH: Changing the Linux Temporary Directory for Collection
    6. Prerequisites for NetBackup collection over SSH (Kerberos option)
      1.  
        Enable Kerberos authentication for NetBackup SSH collection
    7.  
      Prerequisites for centralized NetBackup data collection (using NetBackup software)
    8. Veritas NetBackup 8.1 (or later) requirements for centralized collection
      1.  
        Required software
      2.  
        Overview of centralized Data Collector steps
      3.  
        Verify remote commands for centralized NetBackup data collection
    9.  
      Distributed NetBackup data collection
    10.  
      Enable access to the Veritas NetBackup Master Server
    11.  
      Before you install the Data Collector (Veritas NetBackup)
    12.  
      Collecting from NetBackup clusters
    13.  
      Clustered NetBackup upgrade procedure
    14.  
      Add a Veritas NetBackup Data Collector policy
    15.  
      Add/Edit NetBackup Master Servers within the Data Collector policy
    16. Configuring file analytics in NetBackup Data Collector policy
      1.  
        Prerequisites to configure File Analytics for NetBackup
      2.  
        Data Collector and Portal sizing guidelines for File Analytics
      3.  
        Configure File Analytics
      4.  
        Export File Analytics data
  14. Pre-Installation setup for Veritas SaaS backup
    1.  
      Introduction
    2.  
      Prerequisites for adding data collectors (Veritas SaaS Backup)
    3.  
      Installation overview (Veritas SaaS Backup)
    4.  
      Add a generic backup Data Collector policy
  15. Pre-Installation setup for Oracle Recovery Manager (RMAN)
    1.  
      Introduction
    2.  
      Prerequisites for adding data collectors (Oracle Recovery Manager - RMAN)
    3.  
      Installation overview (Oracle Recovery Manager - RMAN)
    4.  
      Add an Oracle Recovery Manager (RMAN) Data Collector policy
  16. Pre-Installation setup for Rubrik Cloud Data Management
    1.  
      Introduction
    2.  
      Prerequisites for adding Data Collectors (Rubrik Cloud Data Management)
    3.  
      Installation overview (Rubrik Cloud Data Management)
    4.  
      Add a Rubrik Cloud Data Management Data Collector policy
  17. Pre-Installation setup for Veeam Backup & Replication
    1.  
      Introduction
    2.  
      Prerequisites for adding data collectors (Veeam Backup & Replication)
    3.  
      Verifying Data Collector servers can connect to Veeam servers
    4.  
      Known issues and limitations (Veeam Backup & Replication)
    5.  
      Installation overview (Veeam Backup & Replication)
    6.  
      Add a Veeam Backup & Replication Data Collector policy
  18. Discovery policies for Veritas NetBackup
    1.  
      Task overview: Configure and monitor discovery policies
    2.  
      Discovery policies overview
    3. About Discovery types
      1.  
        Client drive discovery
      2.  
        Media server disk discovery
      3.  
        Backup policy coverage
    4.  
      Activate a Discovery license
    5.  
      Create and edit Discovery policies
    6.  
      Exclude devices from Discovery policies
    7.  
      Activate Discovery probes in the NetBackup Data Collector policy
    8.  
      Monitor Discovery processes
    9.  
      View client protection status
    10.  
      Reset Discovery data
    11.  
      Why enable SNMP?
    12. About SNMP probes
      1.  
        First probe (sysObjectOID)
      2.  
        Second probe (sysDescr OID)
    13.  
      Example--Installing Net-SNMP
    14.  
      Troubleshoot Net-SNMP installations
  19. Installing the Data Collector software
    1.  
      Introduction
    2.  
      Installing the WMI Proxy service (Windows host resources only)
    3.  
      Testing WMI connectivity
    4.  
      Installing Data Collector software: From the internet
    5.  
      Installing Data Collector software: No internet available from the Data Collector server
    6.  
      Installing Data Collector software on Windows portal platform
    7.  
      Installing Data Collector software on Linux portal platform
  20. Validate data collection
    1.  
      Validation methods
    2.  
      Data Collectors: Vendor-Specific validation methods
    3.  
      Working with on-demand Data Collection
    4.  
      Collect historic data on-demand
    5.  
      Using the CLI check install utility
    6.  
      List Data Collector configurations
  21. Manually start the Data Collector
    1.  
      Introduction
  22. Uninstall the Data Collector
    1.  
      Uninstall the Data Collector on Linux
    2.  
      Uninstall the Data Collector on Windows
  23. Appendix A. Load historic events
    1.  
      Load historic events
    2.  
      Load Commvault Simpana events
    3.  
      Load EMC Avamar events
    4.  
      Load EMC NetWorker events
    5.  
      Load HP Data Protector events
    6.  
      Load IBM Spectrum Protect (TSM) events
    7.  
      Load Oracle Recovery Manager (RMAN) events
    8.  
      Load Veeam Backup & Replication events
    9. Load Veritas NetBackup events
      1.  
        Load events for individual NetBackup clients
      2.  
        Load events for a group of NetBackup clients
    10.  
      Load Veritas Backup Exec events
    11.  
      Corrections in duplication of clients
  24. Appendix B. Firewall configuration: Default ports
    1.  
      Firewall configuration: Default ports

Upgrade troubleshooting: Microsoft SQL Server and Java 10

With release version 10.3 introducing support for Java 10, older versions of MS SQL Server may encounter compatibility issues. The following section covers potential workarounds. Collection occurs from the Microsoft SQL Server database used by the system the data collector is collecting from. The version of Java used by APTARE IT Analytics version 10.3 disables some insecure TLS algorithms by default. If collection fails with the following error in the collector logs, the version of MS SQL Server may be incompatible and not allow collection using the TLS algorithms enabled by default with Java 10.

Failed to establish JDBC connection to: jdbc:jtds:sqlserver://...
java.sql.SQLException: Network error IOException: null
at net.sourceforge.jtds.jdbc.JtdsConnection.<init>(JtdsConnection.java:437)

Upgrade MS SQL Server to the latest version to enable secure collection. Your MS SQL Server version may not be supported for APTARE IT Analytics version 10.3. If upgrade is not possible, a workaround can be attempted to restore compatibility. If the following steps do not resolve the issue, your version of MS SQL Server is not supported.

Use the following steps to modify the enabled algorithms to allow communication with the data collector:

  1. Edit <collector install dir>/jre/conf/security/java.security.

  2. Search for jdk.tls.disabledAlgorithms.

  3. Copy the existing lines and comment (to have a backup for easy restore).

    #jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    #    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
    jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
  4. Remove 3DES_EDE_CBC.

    #jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    #    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
    jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    EC keySize < 224, DES40_CBC, RC4_40
  5. Save the file.

  6. Run checkinstall and verify collection succeeds.

    If checkinstall does not succeed, each of the following algorithms can be individually re-enabled in an attempt to restore compatibility.

  7. If checkinstall does not succeed, restore, remove RC4_40, save, re-run checkinstall.

    #jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    #    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
    jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    EC keySize < 224, DES40_CBC, 3DES_EDE_CBC
  8. If checkinstall does not succeed, restore, remove DES40_CBC, save, re-run checkinstall.

    #jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    #    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
    jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    EC keySize < 224, RC4_40, 3DES_EDE_CBC
    					
  9. If checkinstall does not succeed, restore, change the DH keySize as follows, save, re-run checkinstall.

    #jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 1024, \
    #    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
    jdk.tls.disabledAlgorithms=TLSv3, RC4, MD5withRSA, DH keySize < 768, \
    EC keySize < 224, DES40_CBC, RC4_40, 3DES_EDE_CBC
  10. After a working configuration is found, restart the collector service.