Pre-Installation Setup for EMC Avamar > Adding an EMC Avamar Data Collector Policy
  
Version 10.2.01P10
Adding an EMC Avamar Data Collector Policy
• Before adding the policy: A Data Collector must exist in the Portal, to which you will add Data Collector Policies. See Adding/Editing Data Collectors. For specific prerequisites and supported configurations for a specific vendor, see the APTARE Certified Configurations Guide.
• After adding the policy: For some policies, collections can be run on-demand using the Run button on the Collector Adminstration page action bar. The Run button is only displayed if the policy vendor is supported.
On-demand collection allows you to select which probes and devices to run collection against. This action collects data the same as a scheduled run, plus logging information for troubleshooting purposes. For probe descriptions, refer to the policy and see On-Demand Data Collection for details about Run.
To add the policy
1. Select Admin > Data Collection > Collector Administration. Currently configured Portal Data Collectors are displayed.
2. Search for a Collector if required. See Navigating with Search.
3. Select a Data Collector from the list.
4. Click Add Policy, and then select the vendor-specific entry in the menu.
5. Enter or select the parameters. Mandatory parameters are denoted by an asterisk (*):
Field
Description
Collector Domain
The domain of the collector to which the collector backup policy is being added. This is a read-only field. By default, the domain for a new policy will be the same as the domain for the collector. This field is set when you add a collector.
Policy Domain
The Collector Domain is the domain that was supplied during the Data Collector installation process. The Policy Domain is the domain of the policy being configured for the Data Collector. The Policy Domain must be set to the same value as the Collector Domain.
The domain identifies the top level of your host group hierarchy. All newly discovered hosts are added to the root host group associated with the Policy Domain.
Typically, only one Policy Domain will be available in the drop-down list. If you are a Managed Services Provider, each of your customers will have a unique domain with its own host group hierarchy.
To find your Domain name, click your login name and select My Profile from the menu. Your Domain name is displayed in your profile settings.
Avamar Servers*
You can add Avamar servers by clicking Add. You can also import multiple servers using a .CSV file. You can also do this using the Inventory. The Avamar Servers table is populated using any of these methods. The servers added to this table using EMC Avamar Data Collector Policy screen are also displayed under Inventory. You must indicate which servers are active.
Active
Click Active to indicate the Avamar server(s) to use in the data collection policy. For Avamar, this is the Utility Node. If additional fields must be configured, the Configure Server dialog is automatically displayed when you make your selection.
Add
Click Add to add an Avamar server type. The added servers are also displayed under Inventory.
Note: Data Collector policies can be in place for multiple servers, but a server cannot have multiple policies.
Configure
Click Configure to revise or add information to the Avamar server you selected. See also Adding/Configuring an Avamar Server within the Data Collector Policy Window.
Import
Click Import to browse for the CSV file in which you entered the Avamar server configuration details. See also Importing EMC Avamar Server Information.
Export
Click Export to create and download a comma-separated values (CSV) file containing all the server information listed in the Avamar Servers table. See also Exporting EMC Avamar Server Information.
Active Probes
Click the clock icon to set a schedule frequency. You can schedule the collection frequency by minute, hour, day, week and month. Advanced use of native CRON strings is also available. You can set a schedule to collect on:
• Activity Details
• Configuration Changes
• Operational Data
• Static Data
Note: Explicit schedules set for a Collector policy are relative to the time on the Collector server. Schedules with frequencies are relative to the time that the Data Collector was restarted.
Activity Details
Collects backup events/activities from the Avamar server.
Configuration Changes
Collects datasets, retention policies, schedules, Avamar clients, groups and group members from the Avamar server.
Operational Data
Collects node utilization, node space, events, DPN statistics, Garbage Collection (GC) status, current Global Storage Area Network (GSAN) status from the Avamar.
Static Data
Collects the Axion systems, event catalog and plugin catalog entries from the Avamar server.
Utility Node Details
Collects chassis information for the Avamar Utility Node.
6. Click OK to save the Policy.
7. Install/update the Data Collector software on the Data Collector server.
Testing the Collection
You can test the collection of data using the Run functionality available in Admin>Data Collection>Collector Administration. This test run performs a high-level check of the installation, including a check for the domain, host group and URL, plus Data Collector policy and database connectivity. See Working with On-Demand Data Collection for details.
 
Adding/Configuring an Avamar Server within the Data Collector Policy Window
Add Avamar servers by clicking Add, by importing using a .CSV file, or by using the Inventory. The Avamar Servers table is populated using any of these methods. Servers added to this table are also displayed under Inventory. The Avamar Servers table only displays available servers. These servers are not assigned to other policies within the domain.
Note: Data Collector policies can be in place for multiple servers, but a server cannot be assigned multiple policies within the same domain. If you try add a server that is already assigned to another Data Collector policy, you will be prompted to remove it from its current policy and reassign it.
1. Click Add on the EMC Avamar Data Collector Policy screen. The Add EMC Avamar Server screen displays.
2. Enter the values:
Field
Description
Avamar Server Name
The Avamar Utility Node server name. This is displayed on the Inventory page under the Host Name column. This is displayed on the Host Administration dialog under Internal Name. This is a required field.
Utility Node IP Address
IP address of the Avamar Utility Node. This is management server with which the Data Collector will communicate. This is displayed on the Host Management page under the Primary IP column. This is a required field.
Software Location
Directory under which all Avamar binaries and configuration files are kept. This field is pre-populated with a default location: /usr/local/avamar. You can edit the field, but it must contain a value.
Utility Node User ID
The login credentials must have admin or dpn access to the Avamar utility node so that the Data Collector can invoke command-line programs in the /usr/local/avamar/bin directory.
Password
Password for the utility node username that has root-level access to the Avamar utility node. This is a required field.
Database Address
Hostname or IP address used to connect to the Avamar Management Console database. This field is pre-populated with a default address: the Utility Node IP address. You can edit the field, but it must contain a value.
Database User ID
User name to log into the EMC Avamar Management Console database for reporting access. This field is pre-populated with a default Avamar user ID: viewuser. You can edit the field, but it must contain a value.
Password
Password for credentials required to log into the EMC Avamar management console database for reporting access. This field is pre-populated with a default Avamar user password: viewuser1. You can edit the field, but it must contain a value.
Importing EMC Avamar Server Information
You can quickly add a list of EMC Avamar servers using the Import function. The information is displayed in the Avamar Servers table on the EMC Avamar Data Collector Policy screen. Because the import is done within a policy, the host group/domain selected for the policy is used for server location.
CSV Format Specifications
Before importing, create a comma-separated values (CSV) file of Avamar server data. The CSV file must use the following order to populate the fields correctly when importing:
1. Avamar Server Name - maximum 128 characters. Null is not accepted
2. Utility Node IP Address - maximum 40 characters. Null is not accepted
3. Utility Node User ID - maximum 64 characters. Null is not accepted
4. Utility Node Password - maximum 256 characters. Null is not accepted
5. Software Location - maximum 256 characters. If this field is blank, the following default is used: /usr/local/avamar.
6. Database Address - maximum 128 characters. If the Avamar database is resident on the Utility Node, this should contain the Utility Node’s IP Address.
7. Database User ID - maximum 64 characters. If this field is blank, the following default is used: viewuser.
8. Database Password - maximum 64 characters. If this field is blank, the following default is used: viewuser1.
Import Notes
If the same Avamar Server already exists in the specified host group, the details are updated when an import occurs.
To Import EMC Avamar Servers
1. Prepare the CSV according to CSV Format Specifications.
2. Select Admin > Data Collection > Collector Administration.
3. Click Add Policy.
4. Select EMC Avamar. The EMC Avamar Data Collector Policy screen is displayed.
5. Click Import. The Import EMC Avamar Servers window is displayed. You can browse for the CSV file you created.
Exporting EMC Avamar Server Information
Use Export to create a comma-separated values (CSV) file containing all the server information listed in the Avamar Servers table.
Click Export to download the CSV file to your local system.