Pre-Installation Setup for Hitachi Block > Adding a Hitachi Block Storage Data Collector Policy
  
Version 10.3.00P13
Adding a Hitachi Block Storage 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 IT Analytics Certified Configurations Guide.
After adding the policy: For some policies, collections can be run on-demand using the Run button on the Collector Administration 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.
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.
For HP Command View Advanced Edition, HP XP arrays are treated as Hitachi Block Storage. To add a policy to collect from HP StorageWorks XP arrays (HP Command View Advanced Edition), use this Hitachi Block Storage Data Collector Policy.
5. Specify Data Collector Properties.
6. Add 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, click your login name and select My Profile from the menu. Your Domain name is displayed in your profile settings.
yourdomain
Hitachi Device Manager Server*
The address of the Hitachi Device Manager Server—either the IP address or server name. For HP Command View Advanced Edition, use the IP address or server name of the Command View Server.
If this policy is being created to collect block storage shared with Hitachi NAS (HNAS), you must specify the IP address of the Hitachi Device Manager that manages the array that shares capacity with HNAS. See Configuring a Collector for Hitachi NAS Block Storage.
hds_server1
User ID*
Use the User ID and passcode as defined in Hitachi Device Manager (HDvM). This typically would be an administrator privilege, but must be a minimum privilege of a view-only user. Create a new user with view-only privileges and add the user to ViewGroup, a built-in HDvM group. See Configuring a Hitachi Device Manager User.
For Hitachi Device Manager 7.1.1 and 7.2, the user ID configured to access HDvM must have view permissions to HRpM and HTSM.
Administrator
Password*
Note: The password is encrypted prior to saving in the database and is never visible in any part of the application.
Password1
Exclude Arrays
Enter one or more array names to be excluded.
Comma-separated names are supported. Example: USPV1_172.16.1.13, USPV1_172.16.1.14,
AMS - Corporate(5100)@172.16.1.43
 
Array Details
Click the check box to activate array details collection. Click the clock icon to set the schedule.
For example:
 
*/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.
 
Array Performance
Click the check box to activate performance collection and enable entries and selections for the HTnM Install Location and the Performance Schedule.
Note that at least one collection from this array must be performed BEFORE array performance data can be collected.
Requirement: To collect performance data from Hitachi Tuning Manager, the Data Collector must be installed on the same server as Tuning Manager. And, a single Data Collector policy must be used to collect both the capacity data from the Device Manager server and the performance data from the Tuning Manager server.
 
HTnM Install Location
Specify the Tuning Manager server installation directory. By default, the Tuning Manager server will be installed in the following locations:
Windows Server 2003 (x86) and Windows Server 2008 (x86):
%SystemDrive%\Program Files\HiCommand\TuningManager
Windows Server 2003 (x64) and Windows Server 2008 (x64):
%SystemDrive%\Program Files (x86)\HiCommand\TuningManager
Solaris: /opt/HiCommand/TuningManager
 
HDT Collection
Activate HDT Collection. An HDT Schedule is not required if your HDvM is not managing VSP arrays running HDT.
Click the clock icon to create 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.
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.
 
Notes
Enter or edit notes for your data collector policy. The maximum number of characters is 1024. Policy notes are retained along with the policy information for the specific vendor and displayed on the Collector Administration page as a column making them searchable as well.
 
7. Click OK to save the Policy and return to the Collection Administration window where the Policy will be listed under the Data Collector.
8. On the Data Collector server, install/update the Data Collector software.
Configuring a Hitachi Device Manager User
The Data Collector requires read-only permission to gather data from Hitachi Device Manager (HDvM). This requires an HDvM read-only user. To configure a read-only user, take the following steps.
1. Login to Hitachi Device Manager.
2. From the Administration tab, click Users and Permissions.
3. Under Users and Permissions, select Users and click Add User.
4. For the User ID, enter aptare and fill in the required user fields and click OK.
5. Under Users and Permissions, select Users again to verify the account that you just created.
6. Click the Change Permission tab for the aptare user only.
7. Check the boxes under the View column to configure read-only permission for each licensed component. Options are: HTnM, HRpM, HTSM, and HCSM.
Note: You may not have all (or any) components licensed in your environment, therefore you may not see all the components.
8. Click OK to save the permissions for the aptare user.
9. From the Administration tab, click User Groups.
10. Select ViewGroup, which is a built-in user group.
11. In the ViewGroup window, click Add Users.
12. Select the aptare user and click OK.
Validate the User ID Access
1. To list the aptare user configured on Hitachi Device Manager, use the Hitachi Device Manager XML API, connecting via:
http://<DeviceManagerIP>:2001/service/ServerAdmin
where:
DeviceManagerIP
Hitachi Device Manager IP address
2001
Default port number allocated to this server
2. Copy and paste the following XML request into the Server Administration Service API window and click Submit.
 
<?xml version="1.0"?>
<HiCommandServerMessage>
<APIInfo version="7.2"/>
<Request>
<SecurityAdmin>
<Get target="User">
<User>
</User>
</Get>
</SecurityAdmin>
</Request>
</HiCommandServerMessage>
Sample output from this request:
This XML response lists the aptare user as a Guest role. The Guest role has read-only permission, sufficient for collecting data from Hitachi storage arrays.
Configuring a Collector for Hitachi NAS Block Storage
If you are configuring a Hitachi Data Systems policy to collect block storage shared with Hitachi NAS (HNAS), you will need the IP address of the Hitachi Device Manager server.
1. In the HNAS UI, go to: Home > Storage Management > Hitachi Device Managers.
2. Use the Device Manager’s default user name and password.