Enabling the Hitachi HiCommand Device Manager Agent

When you need to use this agent

If the Hitachi data storage system is being managed by Hitachi Device Manager Server (HDM) and you want to monitor the gFiler through HDM, you must enable the NetApp HiCommand gateway agent on the gFiler. If the agent is not enabled, HDM cannot show storage utilization by the gFiler.

Prerequisites

Adding a user for the Device Manager

You must define a user in the Hitachi HiCommand Device Manager for your HiCommand agent. See the Hitachi HiCommand Device Manager Server Installation and Configuration Guide for instructions about adding a user with Peer user group privileges. This user gives your HiCommand agent the appropriate privileges to update the host information in the Device Manager.

Required information

You need the following information to configure your HiCommand agent options:

The IP address of the Device Manager Server
The port number of the Device Manager Server
The user name of the user created in the Device Manager Server for your gateway
The password for the user name that you specified using the Device Manager Server
The number of minutes desired between successive reports on your gateway
The version of the Device Manager to determine the uri that publishes the http POST

Configuring the HiCommand agent options

To configure the HiCommand agent options, complete the following steps at the command-line prompt of your gateway.


options gfagent.hdm.host { ip_address | host_name }
options gfagent.hdm.port port_number
options gfagent.hdm.user user_name
options gfagent.hdm.password password
Configure the HiCommand agent option for the time interval, in 
minutes, between two successive scans or reports for updating the 
Device Manager Server by entering the following command:

Step	Action
1	Configure the HiCommand agent option for the IP address or the host name of the Device Manager Server by entering the following command: *options gfagent.hdm.host { ip_address* \| host_name } Note** DNS service is required if you want to use the host name.
2	Configure the HiCommand agent option for the port number of the Device Manager Server by entering the following command: options gfagent.hdm.port port_number
3	Configure the HiCommand agent option for the user name of the Device Manager Server by entering the following command: options gfagent.hdm.user user_name
4	Configure the HiCommand agent option for the password of the Device Manager Server by entering the following command: options gfagent.hdm.password password Note The combination of user name and password authenticates the agent to update Device Manager Server information. This is a write-only option.
5	Configure the HiCommand agent option for the time interval, in minutes, between two successive scans or reports for updating the Device Manager Server by entering the following command: options gfagent.interval.minutes minutes Note The range for the time interval is between thirty minutes to twenty-four hours. It is recommended that you set the time interval to 24 hours (1440 minutes) for daily updates. Example To configure daily updates, enter the following command: options gfagent.interval.minutes 1440

Determining whether you need to configure the uri

The uri is where the Device Manager Server publishes the HTTP POST. The uri is determined by the version of Device Manager.

If your version of Device Manager is 2.2 or later, you do not need to configure this option. The option is preconfigured as /service/StorageManager.

If your version of Device Manager is earlier than 2.2, you must configure the uri with the options gfagent.hdm.uri uri command, where uri may be /service/HiScan. Consult your authorized reseller to verify the correct uri.

Configuring the uri

If you receive instructions from your authorized reseller to reconfigure the uri to another location, complete the following step.

Step	Action
1	Enter the following command: options gfagent.hdm.uri uri

Enabling your HiCommand agent

To enable your HiCommand agent, complete the following step.

Step	Action
1	Enter the following command: options gfagent.enable on Note The default is off.

Disabling your HiCommand agent

If you need to disable your HiCommand agent, complete the following step.

Step	Action
1	Enter the following command: options gfagent.enable off