Cisco High-Performance Subnet Manager for InfiniBand Server Switches, Release 1.3
Administrative Commands
Downloads: This chapterpdf (PDF - 153.0KB) The complete bookPDF (PDF - 3.13MB) | Feedback

Administrative Commands

Table Of Contents

Administrative Commands

echo

exit

help

history

repeat

run

shutdown

?


Administrative Commands


This chapter includes the following commands:

echo

exit

help

history

repeat

run

shutdown

echo

To echo the command arguments back to the screen, use the echo command.

echo

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Usage Guidelines

This command echoes the command arguments back to the screen.

Examples

ib_sm> echo text
text
ib sm>

Related Commands

None.

exit

To disconnect the CLI session, use the exit command.

exit

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Usage Guidelines

The Subnet Manager permits 3 simultaneous CLI sessions only.


Note This command only ends a CLI session. It does not shut down the Subnet Manager.


Examples

ib_sm> exit 
SM disconnected.  Exiting.
[root@ibmg-r2-1850-1 log]# 

Related Commands

shutdown

help

To display the usage for a command, use the help command.

help [cmd]

Syntax Description

cmd

(Optional) Displays the usage of the specified command.


Defaults

This command has no default settings.

Usage Guidelines

This command displays the usage for all commands or for a specific command if you use the [cmd] option.

Examples

ib_sm> help
   ? [cmd] -- Show usage for all commands or a specific command.
   echo [args ...] -- Print arguments on output.
   exit -- Disconnect from the SM.
   shutdown -- Terminate the SM.
   help [cmd] -- Show usage for all commands or a specific command.
   pm -- Control the performance management feature. Type "pm help" for help.
   repeat <count> <command...> -- Repeatedly execute a command.
   show -- Show subnet data. Type "show help" for help.
   config -- Set operating parameters. Type "config help" for help.
   run -- Run cli command file. Type "run help" for help.

ib_sm> help echo
echo [args ...] -- Print arguments on output.

ib_sm>

Related Commands

?

history

To view a list of previously-used commands, use the history command.

history

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Usage Guidelines

The history command lists up to 100 previously issued commands. One can traverse through the command history by repeated up/down arrow strokes or Ctrl-p/Ctrl-n keystrokes.

Examples

ib_sm> history
    1  show service
    2  show subscription
    3  show lft
    4  show mft
    5  show other-sm
    6  show pm port counter access
    7  show pm monitored ports
    8  config pm monitored port add 00:05:ad:00:00:04:e5:64 1
    9  show pm monitored ports
   10  history

Related Commands

Any command in the "Administrative Commands" chapter, the "Configure Commands" chapter, the "Performance Management Commands" chapter, or the "Show Commands" chapter may appear in this command output.

repeat

To repeatedly execute a user-provided command, use the repeat command.

repeat count command...

Syntax Description

count

Specifies the number of times to repeat a command.

command...

Identifies the specific the command to be repeated.


Defaults

This command has no default settings.

Usage Guidelines

This command repeatedly executes the user-provided command.

Examples

ib_sm> repeat 3 pm reset counters
.
Counter reset succeeded.
.
Counter reset succeeded.
.
Counter reset succeeded.
ib_sm> 

Related Commands

None.

run

To run all commands in a file that contains a line-delineated list of CLI commands, use the run command.

run cmd-file file

Syntax Description

cmd-file

Runs the commands in the specified file.

file

Specifies the name of the file that contains the commands you want to run.


Note The path to the file must be absolute.



Defaults

This command has no default settings.

Usage Guidelines

This command allows you to specify a file that contains a list of CLI commands. The commands in the file are executed one at a time, just as if you had typed the commands sequentially into the CLI. This command can be used to perform batch operations and to debug a command file before adding it to the default Subnet Manager invocation command.

Examples

[root@ibmg-r2-1850-1 log]# ib_sm_cli
ib_sm> show config

================================================================================
                          Subnet Manager Configuration
================================================================================
                 subnet-prefix : fe:80:00:00:00:00:00:00
                          guid : 00:05:ad:00:00:04:e5:25
                      priority : 0
                        sm-key : 00:00:00:00:00:00:00:00
                   oper-status : master
                     act-count : 1658
           sweep-interval(sec) : 10
        response-timeout(msec) : 200
                   mad-retries : 5
                  node-timeout : 10
     master-poll-interval(sec) : 3
           master-poll-retries : 2
                max-active-sms : 0
              LID-mask-control : 0
              switch-life-time : 1820
               sw-link-hoqlife : 1820
               ca-link-hoqlife : 1820
                      max-hops : 64
          wait-report-response : false
            sa-mad-queue-depth : 256
            local-node-retries : 10
               qos-admin-state : disabled
            max-operational-vl : auto-link
           min-vl-cap-detected : vl0-vl7
          max-multicast-groups : 20480
           max-multicast-ports : 12288
            max-multicast-lids : 1024
     multicast-lid-overloading : enabled
        ipv6-ND-group-bundling : enabled
ib_sm> show partition
================================================================================
                                 All Partitions
================================================================================
                 subnet-prefix : fe:80:00:00:00:00:00:00
                         p-key : ff:ff
                         ipoib : enabled

             partition-members : 
                     node-guid : 00:05:ad:00:00:00:12:34
                      port-num : 0
                   member-type : full

                     node-guid : 00:05:ad:00:00:01:60:04
                      port-num : 0
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e4:4c
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:1c
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:24
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:64
                      port-num : 1
                   member-type : full

ib_sm> run cmd-file /tmp/sm_commands
ib_sm> config priority 11

ib_sm> config max-hops 5

ib_sm> config trace 2 0x1000

ib_sm> config partition key create 80:80

ib_sm> config db-sync enable

ib_sm> config pm threshold xmit-rate 5

ib_sm> config pm threshold rcv-rate 5

ib_sm> config pm threshold symbol-errors 3

ib_sm> config pm monitor state enabled-cisco-switches
ib_sm> show config

================================================================================
                          Subnet Manager Configuration
================================================================================
                 subnet-prefix : fe:80:00:00:00:00:00:00
                          guid : 00:05:ad:00:00:04:e5:25
                      priority : 11
                        sm-key : 00:00:00:00:00:00:00:00
                   oper-status : master
                     act-count : 2722
           sweep-interval(sec) : 10
        response-timeout(msec) : 200
                   mad-retries : 5
                  node-timeout : 10
     master-poll-interval(sec) : 3
           master-poll-retries : 2
                max-active-sms : 0
              LID-mask-control : 0
              switch-life-time : 1820
               sw-link-hoqlife : 1820
               ca-link-hoqlife : 1820
                      max-hops : 5
          wait-report-response : false
            sa-mad-queue-depth : 256
            local-node-retries : 10
               qos-admin-state : disabled
            max-operational-vl : auto-link
           min-vl-cap-detected : vl0-vl7
          max-multicast-groups : 20480
           max-multicast-ports : 12288
            max-multicast-lids : 1024
     multicast-lid-overloading : enabled
        ipv6-ND-group-bundling : enabled

ib_sm> show partition
================================================================================
                                 All Partitions
================================================================================
                 subnet-prefix : fe:80:00:00:00:00:00:00
                         p-key : 80:80
                         ipoib : enabled

             partition-members : 
                          none

             partition-members : 
                     node-guid : 00:05:ad:00:00:00:12:34
                      port-num : 0
                   member-type : full

                     node-guid : 00:05:ad:00:00:01:60:04
                      port-num : 0
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e4:4c
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:1c
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:24
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:64
                      port-num : 1
                   member-type : full

                 subnet-prefix : fe:80:00:00:00:00:00:00
                         p-key : ff:ff
                         ipoib : enabled

             partition-members : 
                     node-guid : 00:05:ad:00:00:00:12:34
                      port-num : 0
                   member-type : full

                     node-guid : 00:05:ad:00:00:01:60:04
                      port-num : 0
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e4:4c
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:1c
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:24
                      port-num : 1
                   member-type : full

                     node-guid : 00:05:ad:00:00:04:e5:64
                      port-num : 1
                   member-type : full

ib_sm> show pm threshold

================================================================================
                                 PM thresholds
================================================================================
                 symbol-errors : 3
          link-recovery-errors : none
                    link-downs : none
                    rcv-errors : none
         rcv-remote-phy-errors : none
       rcv-switch-relay-errors : none
                 xmit-discards : none
        xmit-constraint-errors : none
         rcv-constraint-errors : none
   local-link-integrity-errors : none
  excessive-buf-overrun-errors : none
                 vl15-droppeds : none
                     xmit-rate : 5 %
                      rcv-rate : 5 %

Note Notice that the commands shown after the run cmd-file command have a blank line between them, indicating that they are being executed from the command file.


Related Commands

Any command in the "Administrative Commands" chapter, the "Configure Commands" chapter, the "Performance Management Commands" chapter, or the "Show Commands" chapter can be added to the file and run with the run command.

shutdown

To shut down the Subnet Manager, use the shutdown command.

shutdown

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default settings.

Usage Guidelines

This command shuts down the Subnet Manager itself. When invoked, the command requests that the Subnet Manager clean up and exit completely. All CLI sessions will be terminated, and the Subnet Manager process will shut down.


Note This command shuts down the Subnet Manager. It does not merely exit the user interface.


Examples

ib_sm> shutdown

SM disconnected.  Exiting.
[root@ibmg-r2-1850-1 log]# tail /var/log/messages
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: Initiating SM main shutdown 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: SM event loop terminated 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [ib_pm.c:3300]: Terminating PM event loop 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [ib_sa_admin.c:538]: Terminating SA event loop 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: PM event loop terminated 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [ib_sm.c:1010]: Terminating heartbeat event 
loop 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: SA event loop terminated 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [ib_sm_db_sync_session.c:1811]: Terminating 
DBSync event loop 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [ib_sm_transport.c:904]: Terminating TX event 
loop 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: DBSync event loop terminated 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: Heartbeat event loop terminated 
May  8 21:14:25 ibmg-r2-1850-1 ib_sm[1137]: [INFO]: TX event loop terminated

Related Commands

exit

?

To display the usage for a specific command or for all commands, use the ? command.

? [cmd]

Syntax Description

cmd

(Optional) Specifies a command.


Defaults

This command has no default settings.

Usage Guidelines

This command displays the usage for all commands or for a specific command if you use the [cmd] option.

Examples

ib_sm> ?
   ? [cmd] -- Show usage for all commands or a specific command.
   echo [args ...] -- Print arguments on output.
   exit -- Disconnect from the SM.
   shutdown -- Terminate the SM.
   help [cmd] -- Show usage for all commands or a specific command.
   pm -- Control the performance management feature. Type "pm help" for help.
   repeat <count> <command...> -- Repeatedly execute a command.
   show -- Show subnet data. Type "show help" for help.
   config -- Set operating parameters. Type "config help" for help.
   run -- Run cli command file. Type "run help" for help.

ib_sm> ? echo
   echo [args ...] -- Print arguments on output.

ib_sm>

Related Commands

help