Storage Array Pre-Installation Setup > Adding an EMC VNX (Celerra) Data Collector Policy
   
Version 9.1.01
Adding an EMC VNX (Celerra) Data Collector Policy
Before adding the policy:
Configure a Read-Only User with an Operator Role
Start the XML API Server
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, see the APTARE StorageConsole Certified Configurations Guide.
Configure a Read-Only User with an Operator Role
A read-only user with an operator role is required to access the EMC VNX server for data collection.
1. On the VNX server, launch EMC Unisphere and login as root.
2. Select the Celerra server from the drop-down list at the top of the EMC Unisphere toolbar.
3. Click the Settings icon in the EMC Unisphere toolbar and then click Security.
4. Select Local Users.
5. From the Groups tab, click Create to create a new group.
6. In the new group window:
Enter a Group Name.
For Role, select Operator.
Keep the other default values.
Click OK.
Once you click OK, the group will appear in the Groups list as a Local User, a Group Type of Local, and a Role of Operator.
7. Click the Users tab at the top of the EMC Unisphere window.
8. Click Create, configure the values for the following fields, and click OK:
User Name
Password
Primary Group (select the group you just created)
Group (Role) Membership (check the group with the Operator role that you just created)
CLI access allowed (check the box to enable access)
Once you click OK, the new user will appear in the list as a State of Enabled, Account Type of Local, and a Role of Operator.
Start the XML API Server
Before collecting data from the EMC VNX (Celerra) server, the XML API server must be enabled (By default, the XML API server is disabled.). The XML API provides a communication protocol that supports authentication and XML requests.
To start the XML API server, take the following steps on the VNX server.
1. Login as root.
2. In the /nas/sys/nas_mcd.cfg file, uncomment the following lines:
daemon "XML API Server"
executable "/nas/sbin/start_xml_api_server"
optional yes
canexit yes
autorestart yes
ioaccess no
3. Restart the NAS services:
service nas start
At this point, the XML API is started and is controlled by the master control daemon.
Configuring an EMC VNX (Celerra) 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, see Capacity Manager: Collection of Array Capacity and Host Data and the APTARE StorageConsole Certified Configurations Guide.
 
1. Select Admin > Data Collection > Collectors.
The list of currently configured Portal Data Collectors is displayed.
2. Select a Data Collector from the list.
3. Click Add, and then select EMC VNX (Celerra).
4. Enter or select the parameters. Mandatory parameters are denoted by an asterisk (*):
Field
Description
Sample Value
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 that is 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 select Admin > Hosts and Domains > Domains.
 
Array Addresses*
Enter one or more VNX (Celerra) storage array address(es) separated by commas. List only one Control Station IP address per array.
Make sure that XML API server is running. Click Help to view the steps to start the XML API server on VNX (Celerra) arrays. See Adding an EMC VNX (Celerra) Data Collector and Start the XML API Server.
 
User ID*
Enter a User ID for the VNX array. This ID must have an Operator role, which enables read-only privileges.
 
Password*
Password associated with the User ID
 
Repeat Password*
Password associated with the User ID
 
Array Details
Check the box to activate the collection of array details.
Click the clock icon to create a schedule. Every Minute, Hourly, Daily, Weekly, and Monthly schedules may be created. Relative schedules are relative to when the Data Collector is restarted. Advanced use of native CRON strings is also available.
Examples of CRON expressions:
*/30 * * * * means every 30 minutes
*/20 9-18 * * * means every 20 minutes between the hours of 9am and 6pm
*/10 * * * 1-5 means every 10 minutes Mon - Fri.
 
Active Directory Configuration
Check this box if you want the Data Collector to gather the verbose User Name from Active Directory and associate it with the appropriate VNX User ID for quota reporting purposes.
Note: Once a single EMC VNX (Celerra) Data Collector policy has been configured to use Active Directory, there is no need to configure Active Directory in other VNX (Celerra) Data Collector policies, if they are all using the same directory server.
Click the clock icon to create a schedule.
 
Domain Name
Enter a fully qualified Domain Name for the root of the LDAP directory tree. Use a period-separated format (example: ldap.emc.com). This example will be translated by the system to X.509 format: dc=ldap, dc=emc, dc=com. Only a single LDAP domain is supported. This is a mandatory field, if you have checked Active Directory Configuration.
 
Host Address
Enter the IP address or host name of the primary directory host that is used for authentication. This value is based on the format of the subject in the host’s certificate. This is a mandatory field if you have checked Active Directory Configuration.
 
User ID
Enter the Active Directory login name of the user account that binds to the directory server. This should be a restricted user account, such as a Domain Guest account, with directory read and search privileges. This is a mandatory field if you have checked Active Directory Configuration.
 
Password/Repeat Password
Enter the Password for the Active Directory account. This credential is used to authenticate the account. This is a mandatory field if you have checked Active Directory Configuration.
 
Port Number
Enter the network port used by Active Directory. This is a mandatory field if you have checked Active Directory Configuration.
 
SSL Enabled
Check this box if your LDAP protocol uses SSL for encryption and authentication.
 
SSL Primary Certificate File
Enter the explicit path and file name for the SSL primary certificate file. Example: C:\SSL\primaryCert.cer. This certificate is used for authentication when connecting to Active Directory.
 
5. Click OK to save the policy.
6. On the Data Collector server, install/update the Data Collector software.