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