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.6.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 --help

Options:
  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 time-out 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', 'a9000r', 'svc',
                        'xiv'], 'ds8k' for IBM System Storage DS8000,'a9000r'
                        for IBM FlashSystem A9000/R,'svc' for IBM Spectrum
                        Virtualize Family,'xiv' for IBM XIV Storage System
    --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 Spectrum Virtualize Family:
    -t svc --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 for IBM FlashSystem A9000 or FlashSystem A9000R:
    -t a9000r --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 a9000r --ip 192.0.2.10 -U u1 -P 123 # adds a connection
  scomu.cmd --add -t svc --ip 192.0.2.10 --authmode password --username usr1 
                         --password pass1 # adds a connection
  scomu.cmd --add -t svc --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 --modify -t a9000r --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 --test -t a9000r --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