host‑name-or-IP-address
|
Specify either the host name or the Internet Protocol (IP)
address of an in-band managed storage array (IPv4 or IPv6) or an out-of-band
managed storage array (IPv4 or IPv6).
- If you manage a storage array by using a host connected directly
to the storage array (in‑band storage management), you must use the
-n parameter if more than one storage array is connected
to the host.
- If you manage a storage array through an Ethernet connection (out-of-band
storage management), you must specify the host‑name‑or‑IP‑address
of the redundant array of independent disks (RAID) controller modules.
- If you have previously configured a storage array in the graphical
user interface (GUI) of the MD Storage Manager, you can specify the
storage array by its user‑supplied name by using the
-n parameter.
|
-A
|
Use to add a storage array to the configuration files. If you
do not follow the
-A parameter with a host‑name‑or‑IP‑address,
automatic discovery scans the local subnet for storage arrays.
|
-a
|
Use to add an SNMP trap destination or an e-mail address alert
destination.
- When adding an SNMP trap destination, the SNMP community is automatically
defined as the community name for the trap and the
host is the IP address or Domain Name Server (DNS) host name of the system
to which the trap should be sent.
- When adding an e-mail address for an alert destination, the
email-address is the e-mail address to which to send
the alert message.
|
-c
|
Use to indicate that you are entering one or more script commands
to run on the specified storage array. Terminate each command by using
a semicolon (;).
You cannot place more than one
-c parameter on the same command line. You can include more than one
script command after the
-c parameter.
|
-d
|
Use to display the contents of the script configuration file. |
-e
|
Use to disable syntax checking when executing the current CLI
command.
|
-F (uppercase)
|
Use to specify the e-mail address from which all alerts will
be sent.
|
-f (lowercase)
|
Use to specify a file name containing script commands intended
to run on the specified storage array.
This parameter is similar
to the
-c parameter in that both are intended for running
script commands. The
-c parameter allows you to execute
individual script commands. The
-f (lowercase) parameter
allows you to execute script commands contained in a file.
-
NOTE: By default, any errors
encountered when running the script commands in a file are ignored,
and the file continues to run. To override this behavior, use the
set session errorAction=stop command in the script file.
|
-g
|
Use to specify an ASCII file that contains e-mail sender contact
information to include in all e-mail alert notifications. The CLI
assumes the ASCII file is text only, without delimiters or any expected
format. A typical file contains the following information:
- Name
- Title
- Company
- Phone
- Pager
-
NOTE: You can
use any file name that your operating system supports. You must not
use
userdata.txt. Some operating systems reserve
userdata.txt for system information.
|
-h
|
Use with the
-a and
-x parameters
to specify the host name that is running the SNMP agent to which the
storage array is connected.
|
-I
|
Use to specify the type of information to be included in the
e-mail alert notifications. The following are valid information arguments:
-
eventOnly— Only event information is included
in the e-mail.
-
profile— Event and array profile information is
included in the e-mail.
-
supportBundle— Event and support bundle information
is included in the e-mail.
-
NOTE: You can
enter only one information argument each time you execute the command.
If you want all of the information, you must run the command three
times.
|
-i
|
Use with the
-d parameter to display the IP
address of the known storage arrays.
|
-m
|
Use to specify the host name or IP address of the e-mail server
from which to send e-mail alert notifications.
|
-n
|
Use to specify the name of the storage array on which to run
the script commands. This name is optional when you use
host‑name-or-IP-address; however, if you are using the in-band method for managing the storage
array, you must use the
-n parameter if more than one
storage array is connected to the host at the specified address.
The storage array name is required when
host‑name-or-IP-address is not used; however, the name of the storage array configured for
use in the MD Storage Manager GUI (that is, listed in the configuration
file) must not be a duplicate name of any other configured storage
array.
|
-o
|
Use with the
-c or
-f parameter
to specify a file name for all output text that is a result of running
the script commands.
|
-p
|
Use to specify the password for the storage array on which
to run commands. A password is not necessary under the following conditions:
- A password has not been set on the storage array.
- The password is specified in a script file that is running.
- The storage array password is specified by using the
-c parameter and the
set session password=
password command.
|
-q
|
Use to specify how frequently to include additional profile
or support bundle information in the e-mail alert notifications. An
e-mail alert notification that contains at least the basic event information
is always generated for every critical event. If you set the
-I parameter to
eventOnly, the only valid
argument for
-q is
everyEvent. If you
set the
-I parameter to either
profile or
supportBundle, this information is included with
the e-mails with the frequency specified by the
-q parameter.
Valid frequency arguments are:
-
everyEvent— Information is returned with every
e-mail alert notification.
-
2— Information is returned no more than once every
two hours.
-
4— Information is returned no more than once every
four hours.
-
8— Information is returned no more than once every
eight hours.
-
12— Information is returned no more than once
every 12 hours.
-
24— Information is returned no more than once
every 24 hours.
|
-r
|
Use with the
-a or
-x parameter
to specify the name of a management station. The name of a management
station can be either
direct_sa (out-of-band
storage array) or
host_sa (in-band storage
arrays [host-agent]). The
-r parameter enables you
to set or change the alert notifications for all storage arrays under
each management station.
|
-S (uppercase)
|
Use to suppress the informational messages describing command
progress that appear when running script commands. (Suppressing informational
messages is also called
silent mode.) This parameter suppresses
the following messages:
- Performance syntax check
- Syntax check complete
- Executing script
- Script execution complete
- SMcli completed successfully
|
-s (lowercase)
|
Use with the
-d parameter to display the alert
settings in the configuration file.
|
-v
|
Use with the
-d parameter to display the current
global status of the known devices in the storage array configuration
file. (The configuration file lists all of the devices in a storage
array configuration and the relationship between the devices. Use
the configuration file to reconstruct a storage array).
|
-X (uppercase)
|
Use to delete a storage array from the configuration file.
(The configuration file lists all of the devices in a storage array
configuration and the relationship between the devices. Use the configuration
file to reconstruct a storage array).
|
-x (lowercase)
|
Use to remove an SNMP trap destination or an e-mail address
alert destination. The
community is the SNMP
community name for the trap, and the
host is
the IP address or DNS host name of the system to which you want the
trap sent.
|
-?
|
Use this parameter to display usage information about the CLI
commands.
|