Command abbreviation, Os error code integration, Composite commands – HP StoreVirtual 4000 Storage User Manual
Page 9: Size specification, Password prompt, Dns names, Storage system cli
Command abbreviation
There is no command or parameter abbreviation in the CLI when scripted. All commands and
parameter names must be fully specified. This is to prevent ambiguity in legacy scripts if new
commands or parameters are added.
OS error code integration
The CLI maps error codes to reasonable OS status codes (status in Linux, ERRORLEVEL in DOS).
Since these are limited to 0..255, some of the OS errors may have less granularity than the API
error codes.
Composite commands
Some commands take multiple elements for the parameter value. In this case, the parameter is
interpreted as an delimiter-separated ordered list. For example:
volumeName=volume1;volume2
login=10.0.1.2;10.1.2.3;10.2.3.4
If a parameter contains fewer elements in the list than needed for the composite command, the last
one in the list will be repeated. There must be at least one element in the list, if it's required.
Size specification
When volume sizes or thresholds are specified, the format is <size><units>, where units are:
•
KB—kilobytes (2^10)
•
MB—megabytes (2^20)
•
GB—gigabytes (2^30)
•
TB—terabytes (2^40)
•
PB—petabytes (2^50)
There is no default for size units; the units must be specified. These are defined as International
System of Units (SI) for file storage (popular use).
For example, size:
•
10 MB—1,048,576 bytes
•
10 GB—10,737,418,240 bytes
Password prompt
When credentials are required in the CLI, you may not want to display the password by typing
the "password=" parameter. If the username parameter is specified without the password parameter,
you will be prompted interactively for the password. This password will not be displayed.
cliq getGroupInfo login=10.0.1.2 username=admin
password: *******
DNS names
You can specify a manager using a host name, provided it can be resolved by DNS:
cliq getGroupInfo login=Exchange-1 username=admin password=secret
Storage System CLI
When commands are executed on the storage systems (via SSH), no authentication parameters
are required:
getGroupInfo
Syntax
9