Using the command-line utility
The IBM® Storage Management Pack includes a standalone command-line interface (CLI) utility, scomu.cmd, which you can use from a desktop shortcut or from the Run command box on the Windows Start menu.
Using a set of CLI commands, you can configure the IBM storage systems that are monitored by Microsoft SCOM, as explained
in the following subsections.
Note: scomu.cmd can also
be used to diagnose issues and collect logs for troubleshooting. For
more information, see Diagnostics and troubleshooting.
|
To display the full list of commands and options available for the CLI utility, enter scomu.cmd --help in the command prompt window.
C:\Program Files\IBM\Storage\Host\IBMStorageSCOM\bin>scomu.cmd --help
IBM Storage SCOM-control Utility - Version 2.3.0
Usage: Usage:
scomu.cmd --add [--no-test | --timeout TIMEOUT] [device options]
scomu.cmd --modify [--no-test | --timeout TIMEOUT] [device options]
scomu.cmd --del [device options]
scomu.cmd --list [-t DEVICE_TYPE] [--format FORMAT]
scomu.cmd --test [--timeout TIMEOUT] [device options]
scomu.cmd --setseverity -t DEVICE_TYPE --event_id [EVENT ID] --severity [SEVERITY]
scomu.cmd --restoreseverity -t DEVICE_TYPE --event_id [EVENT ID]
scomu.cmd --listseverity
scomu.cmd --loglevel -t DEVICE_TYPE [LOG_LEVEL]
scomu.cmd --diag [--no-test]
scomu.cmd --precheck
scomu.cmd --migrate
scomu.cmd --sc-get
scomu.cmd --sc-set [--servername SERVERNAME | --domain DOMAIN | --username USERNAME |
--password PASSWORD]
scomu.cmd --sc-del
scomu.cmd --sc-check
scomu.cmd --helpOptions:
Main operation mode:
--add Add a connection
--modify Modify a connection
--del Delete a connection
--list List all connections
--test Test whether a connection can be established
--loglevel View the log level, or set log level to ['NOTSET',
'TRACE', 'DEBUG', 'INFO', 'WARNING', 'ERROR',
'CRITICAL']
--diag Collect diagnostic data
--precheck Pre-check the environment
--setseverity Set event severity
--restoreseverity Restore event severity
--listseverity List event severity mappings
--sc-get Get configurations for System Center
--sc-set Set configurations for System Center
--sc-del Delete configurations for System Center
--sc-check Check configurations for System Center
--migrate Migrate configurations and synchronize them with
System Center
Operation modifiers:
-F FILE, --file=FILE
Obtain configuration from a file or read the
environment IBM_SCOM_HOME (used only by the service
team)
--debug Display debug information (used by service team)
--no-test Skip the connection test
--timeout=TIMEOUT The device connection timeout duration in seconds,
which can be any value between 1s and 3600s. Default
value: 60s
--format=FORMAT The output format: html (default) or csv Device options:
-t DEVICE_TYPE, --dev_type=DEVICE_TYPE
Set the device type to ['ds8k', 'storwize.v3700',
'flex', 'storwize', 'svc', 'storwize.v7000u',
'storwize.v7000', 'storwize.v3500', 'xiv',
'storwize.v5000']. 'ds8k' for IBM System Storage
DS8000,'storwize.v3700' for IBM Storwize V3700,'flex'
for IBM Flex System V7000,'storwize' for IBM
Storwize,'svc' for IBM System Storage SAN Volume
Controller,'storwize.v7000u' for IBM Storwize V7000
Unified,'storwize.v7000' for IBM Storwize
V7000,'storwize.v3500' for IBM Storwize V3500,'xiv'
for IBM XIV Storage System,'storwize.v5000' for IBM
Storwize V5000
--subtype=DEV_TYPE_SUB
Sub-type of IBM Storwize: v3500, v3700, v5000, v7000,
v7000u
--ip=IP, --host=IP IP address or hostname
-U USERNAME, --username=USERNAME
username
-P PASSWORD, --password=PASSWORD
password
-p PASSPHRASE, --passphrase=PASSPHRASE
passphrase
--url=URL URL, for example <http | https>://<hostname or IP>:<port>
--namespace=NAMESPACE
namespace
--authmode=AUTHMODE
Set authentication mode to AUTHMODE. "publickey" for a
certificate file, "password" for password (can be used
for SAN Volume Controller or Storwize V7000 of
microcode version 6.3 or later.)
--certpath=CERTPATH
certificate file path
--event_id=EVENT_ID
event ID
--severity=SEVERITY
Set event severity to SEVERITY
Device options for IBM System Storage DS8000:
-t ds8k --url URL [--username USERNAME] [--password PASSWORD]
[--namespace NAMESPACE]
Device options for IBM System Storage SAN Volume Controller:
-t svc --ip IP [--authmode AUTHMODE] [--username USERNAME]
[--password] PASSWORD [--certpath CERTPATH] [--passphrase] PASSPHRASE
Device options for IBM Storwize System family:
-t storwize --subtype DEV_TYPE_SUB --ip IP [--authmode AUTHMODE]
[--username USERNAME] [--password] PASSWORD [--certpath CERTPATH]
[--passphrase] PASSPHRASE
Device options for IBM Flex System V7000:
-t flex --ip IP [--authmode AUTHMODE] [--username USERNAME]
[--password] PASSWORD [--certpath CERTPATH] [--passphrase] PASSPHRASE
Device options for IBM XIV Storage System:
-t xiv --ip IP [--username USERNAME] [--password PASSWORD]
Device options to set System Center configurations:
--sc-set [--servername SERVERNAME | --domain DOMAIN | --username
USERNAME | --password PASSWORD]
--servername=SERVERNAME
The server name of System Center Operations Manager
Management Server
--domain=DOMAIN The Windows domain name Other options:
-h, --help Display help information
--version Display the IBM Storage Management Pack version number
Examples:
scomu.cmd --add -t xiv --ip 192.0.2.10 -U u1 -P 123 # adds a connection
scomu.cmd --add -t storwize --ip 192.0.2.10 --authmode password --username usr1
--password pass1 # adds a connection
scomu.cmd --add -t storwize --subtype v3700 --no-test --ip 192.0.2.10
--authmode password --username usr1 --password pass1 # adds a connection
scomu.cmd --modify -t xiv --ip 192.0.2.10 -P x # modifies a connection
scomu.cmd --del -t svc --ip 192.0.2.10 # deletes a connection
scomu.cmd --list # lists all connections
scomu.cmd --test -t xiv --ip 192.0.2.10 -U u1 -P 123 # tests a connection
scomu.cmd --loglevel -t ds8k ERROR # sets log level
scomu.cmd --setseverity -t svc --event_id 980001 --severity information
# set severity in SCOM MP of event 980001 to information
scomu.cmd --restoreseverity -t svc --event_id 980001
# restore severity SCOM MP of event 980001 to default
scomu.cmd --listseverity # list all customized event severity mappings
scomu.cmd --sc-get # get configurations for System Center
scomu.cmd --sc-set --servername scomsrv01 --domain domain01 --username usr
--password pass # set configurations for System Center in agent
scomu.cmd --sc-set --servername localhost
# set configurations for System Center in management server
scomu.cmd --sc-del # delete configurations for System Center
scomu.cmd --sc-check # check configurations for System Center
scomu.cmd --migrate # migrate configurations and synchronize them with System Center