HP StorageWorks XP10000 Disk Array - Manual (Page 112)

Using the Device Manager Properties File 112
5-3-3 Message Trace Output
You can use the –t or --messagetrace option to record the requests sent to the Device Manager server
and the responses received back from the Device Manager server. By default, the messages are recorded in
the MessageTrace.log file. You can also turn on message trace and specify the location of the log file in the
properties file.
For example, you could specify the log file location and turn on message trace in the property file as follows:
hdvmcli.tracefile=C:/DeviceManager/traffic.log
messagetrace=true
For more information on Device Manager properties, please refer to the HP StorageWorks Command View XP
Advanced Edition Device Manager Server Installation and Configuration Guide.
5-3-4 Specifying the Device Manager Server URL
Because the same Device Manager server may be used repeatedly, the URL can be specified in the properties
file. The hdvmcli.serverurl property can specify the following URL:
hdvmcli.serverurl=http://localhost:2001/service
When the URL is defined in the properties file, it can be omitted from the command line. For example:
C:\hdvm > hdvmcli GetStorageArray serialnum=30057 model=XP512
When the URL is also specified in the command line, that URL is used instead of the URL from the properties
file.
5-3-5 Inputting Requests from XML Documents
CAUTION: To use the XML-API CLI feature, you should have thorough knowledge of XML-API, and should
take great care in formulating commands.
Instead of specifying the command and parameters from the command line, you can make the request from a
file. The file must contain a valid XML document in the correct form for a Device Manager request. The
command line option -i or --input specifies the input file. The other application options are still valid.
However, any command or parameter specified from the command line or in the properties file is ignored,
because that information is already in the XML document.
The -i <filename> option allows you to specify an xml message file. You can use this feature to request multiple
operations in on the CLI command, which can save considerable time.
For example, usually the AddLun command specifies creation of a single LUN. The AddLun XML-API allows
you to create multiple LUNs with a single request.
Syntax:
hdvmcli [-t] AddLun
serialnum=<Serial Number> model=<Model Name of Array>
port=<Port #> domain=<HostStorageDomain#>
scsi=<Scsi Target #> lun=<SCSI LU #> devnum=<LDEV #>
Example 1:
To add a LUN to LDEV 0:01 on XP1024 (Serial:15045), where Port 1-A, HostStorageDomain 0, LU 100 is
assigned to that LUN, do the following:
hdvmcli -t addLUN
serialnum=15045 model=XP1024
port=0 domain=0 scsi=15 lun=100 devnum=1
Following XML-API request will be generated according to specified parameters to hdvmcli;
<?xml version="1.0" encoding="UTF-8"?>
<HiCommandServerMessage>
<APIInfo version="4.3" />
<Request>
<StorageManager>
<Add target="LUN">
<StorageArray objectID="ARRAY.HDS9980V.15045">
<Path portID="0" domainID="0" scsiID="15" lun="100" devNum="1" />
</StorageArray>