Search <book_title>...

APTARE IT Analytics Data Collector Installation Guide for Backup Manager

Last Published: 2021-12-01

Product(s): APTARE IT Analytics (10.5)

Introduction
1. Overview
2. Backup Manager Collection of Backup and Restore Data
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
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
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
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
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
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
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
Pre-Installation setup for HP Data Protector
1. Introduction
2. Architecture overview (HP Data Protector)
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
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
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
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
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)
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
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. Adding a Veritas NetBackup Data Collector policy
15. Add/Edit NetBackup Master Servers within the Data Collector policy
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
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
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
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
Discovery policies for Veritas NetBackup
1. Task overview: Configure and monitor discovery policies
2. Discovery policies overview
3. About Discovery types
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
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
8. Regenerate authentication certificate nearing expiry (or already expired)
9. Recover inadvertently deleted keystore file
10. Authenticate new database with existing SSL certificates
11. SSL certificate authentication for a new data collector
Validate data collection
1. Validation methods
2. Data Collectors: Vendor-Specific validation methods
3. Working with on-demand Data Collection
4. Using the CLI check install utility
5. List Data Collector configurations
Manually start the Data Collector
1. Introduction
Uninstall the Data Collector
1. Uninstall the Data Collector on Linux
2. Uninstall the Data Collector on Windows
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
Appendix B. Firewall configuration: Default ports
1. Firewall configuration: Default ports

Recover inadvertently deleted keystore file

The keystore (aptare.ks) file contains the data collector private key and portal public key. This is the key that is generated when you click Generate Key while creating a data collector on the portal. The file also contains local AES keys that are used to encrypt and decrypt the keys stored in aptare_message_relay_keystore.properties file. Hence when aptare.ks gets deleted, there are no ways to encrypt/decrypt the keys stored in aptare_message_relay_keystore.properties. This procedure provides the steps to recover an inadvertently deleted keystore (aptare.ks) file.

To recover a keystore file:

Login to the data collector system and navigate to its installation path: /Aptare/mbs/conf.
Identify these files inside /Aptare/mbs/conf:
- aptare_message_relay_certificate.pem
- aptare_message_relay_keystore.ks
- aptare_message_relay_keystore.properties x
Stop the Aptare Agent service on the data collector system.
On a Windows system, you can stop the service from the Services Console, whereas you can use ./aptareagent stop command on Unix.
Delete these files from /Aptare/mbs/conf.
- aptare_message_relay_certificate.pem
- aptare_message_relay_keystore.ks
- aptare_message_relay_keystore.properties x
Login to the APTARE IT Analytics Portal to generate a new keystore file.
Since the certificate was changed, the portal will display a notification which states:
```
Data Collector SSL certificate has not been downloaded 
for collector(s): <data_collector_name>.
```
Go to Admin > Data Collection > Collector Administration and click the collector name to view its policies.
Double-click the collector to invoke the Edit Collector window.
Copy the Passcode value and save it for later use.
Click Generate Key and download the key file.
Copy the key file to /Aptare/mbs/conf folder on the data collector system. Ensure the file name is same as that of the data collector on the portal.
On the data collector system, open the collector.properties file from /Aptare/mbs/conf and replace the COLLECTOR_PASSWORD value with the Passcode value copied from the Edit Collector window.
Save the collector.properties file and start the Aptare Agent service.
After the service starts:
- A new aptare.ks is generated inside /Aptare/mbs/conf which consumes the new key file.
- . The aptare_message_relay_certificate.pem, aptare_message_relay_keystore.ks, and aptare_message_relay_keystore.properties files are generated later shortly.
- Since the certificate was changed, the portal will display a notification which states:
```
Data Collector SSL certificate has not been downloaded 
for collector(s): <data_collector_name>.
```
On the APTARE IT Analytics Portal, go to Admin > Data Collection > Collector Administration and click the collector name to view its policies.
Double-click the policy name for which SSL certificate needs to be downloaded. The policy configuration window is displayed.
Click Download SSL Certificate. The certificate is downloaded to your system.
Copy the certificate to the data sender trust store.