Qlogic QLogic 12000 Series Reference Manual

InfiniBand Switches and Directors CLI Reference Guide Version 6.0

Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document. Document Revision History Revision E, August 15, 2010 Changes Sections Affected Added the following commands to the group Network: dnsParamsShow dnsParamsSet “Network” on page 1-39

Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Knowledge Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii 1 Switch Command Line Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Commands and Functional Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Accessing the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Groups and Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32 Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-39 Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-52 Subnet Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59 Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91 Key Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-98 IbSwitchInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-100 TimeManagement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-122 SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-126 CaptureInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-132

QLogic 12300 and 12800 family of switches. This manual is organized as follows: This section describes the intended audience and technical support. Section 1 describes the 12000 switch CLI commands. Intended Audience This manual is intended to provide network administrators and other qualified personnel a reference for the command line interface of the QLogic 12000 series switches. Documentation Conventions This guide uses the following documentation conventions: „ NOTE: provides additional information. „ CAUTION! indicates the presence of a hazard that has the potential of causing damage to data or equipment. „ WARNING!! indicates the presence of a hazard that has the potential of causing personal injury. „ Text in blue font indicates a hyperlink (jump) to a figure, table, or section in this guide, and links to Web sites are shown in underlined blue. For example: ‰ Table 9-2 lists problems related to the user interface and remote agent. ‰ See “Installation Checklist” on page 3-6. ‰ For more information, visit www.qlogic.com. „ Text in bold font indicates user interface elements such as a menu items, buttons, check boxes, or column headings. For example: ‰ Click the Start button, point to Programs, point to Accessories, and then click Command Prompt. ‰ Under Notification Options, select the Warning Alarms check box.

text. For example: ‰ To return to the root directory from anywhere in the file structure: Type cd /root and press ENTER. ‰ Enter the following command: sh ./install.bin „ Key names and key strokes are indicated with UPPERCASE: ‰ Press CTRL+P. ‰ Press the UP ARROW key. „ Text in italics indicates terms, emphasis, variables, or document titles. For example: ‰ For a complete listing of license agreements, refer to the QLogic Software End User License Agreement. ‰ What are shortcut keys? ‰ To enter the date type mm/dd/yyyy (where mm is the month, dd is the day, and yyyy is the year). „ Topic titles between quotation marks identify related topics either within this manual or in the online help, which is also referred to as the help system throughout this document. License Agreements Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product. Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates. Availability QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays.

Fibre Channel products. From the main QLogic web page at www.qlogic.com, click the Education and Resources tab at the top, then click the Education & Training tab on the left. The QLogic Global Training Portal offers online courses, certification exams, and scheduling of in-person training. Technical Certification courses include installation, maintenance and troubleshooting QLogic products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by e-mail at [email protected]. Contact Information Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Knowledge Database The QLogic knowledge database is an extensive collection of QLogic product information that you can search for specific solutions. We are constantly adding to the collection of information in our database to provide answers to your most urgent questions. Access the database from the QLogic Support Center: http://support.qlogic.com. Web http://support.qlogic.com Email [email protected]

Interface Overview This section details the usage of the Command Line Interface (CLI) feature for the QLogic 12000 family of switches: „ The QLogic 12300 „ The QLogic 12800 Series: ‰ 12800-040 ‰ 12800-120 ‰ 12800-180 ‰ 12800-360 The CLI allows the user to perform remote configuration and management tasks, which in many respects mirrors the functionality of the Chassis Viewer GUI. The CLI is accessed via a terminal attached to the RS232 port(s) or via the OOB management port using Telnet and secure shell (SSH) of: „ The 12300 chassis „ The SEEB module(s) of the 12800 series Accessing the CLI through the serial port does not require a login and password (unless configured to do so) and defaults to administrator privileges. Providing access through the serial port means that users will always have access to the switch, even if Telnet and SSH are not functioning. For a standalone switch, the user would Telnet to the IP address(es) of the unit. Once connected, the CLI works as any telnet session does. To access the CLI using Telnet and SSH, a login and password is required. There are two user modes, operator and administrator with the following access privileges: Operator: „ Read only access.

Commands and Functional Groups 1-2 D000103-000 E Administrator: „ Read and write Access. „ Reboot access. „ Can change operator and administrator passwords. „ Can disable user login and passwords. This would allow all users admin-level access without the need for a user name or password. „ Can view all current user sessions „ Can access all of the commands executed from any open operator session. „ Can log out any open user sessions „ Can send messages to the open user sessions The CLI allows multiple users to be logged in simultaneously. However, some commands will be locked to a user(s) if another user is executing the same command. Commands and Functional Groups The list of available commands can be accessed by typing list. To keep the list short, the commands are grouped into functional groups, which are: General: General commands for user management and CLI configuration. Deprecated: Commands that have been deprecated. The Deprecated group contains CLI commands that have been replaced or are to be removed. Please use the new command where appropriate. Chassis: Chassis management commands. (FRU info, fan/power supply state, etc). Network: Ethernet interface management commands. Firmware: Provides commands for updating the firmware via a File Transfer Protocol (FTP) server or Secure Copy Protocol (SCP) (if using SSH to access the Bridge Module). The switch has the ability to store the location of the firmware files for future upgrades. Additionally, the Firmware functional group includes commands for viewing the current firmware revisions and for changing the boot image.

Commands and Functional Groups D000103-000 E 1-3 SubnetManagement: InfiniBand subnet manager configuration and management. Log: Provides commands for viewing log files as well as configuring logging parameters. KeyManagement: License key management. IbSwitchInfo: Provides commands for displaying InfiniBand (IB) statistics for all IB ports on the switch, as well as for configuring port statistic thresholds. TimeManagement: Provides commands for retrieving and setting the current system time, as well as commands for setting the time zone and daylight saving time parameters. Snmp: Provides commands for configuring SNMP trap destinations and security parameters required to access the switch from an SNMP manager. CaptureInfo: Provides commands for capturing switch-specific information for the purposes of analysis and debugging. To list commands within a functional group, simply type in the functional group name. For example, to list all of the firmware commands, type list Firmware. The system displays information similar to the following: -> list Firmware fwUpdateSlot Update units firmware fwUpdateChassis Update units firmware fwListFiles List the contents of the firmware ramdisk fwShowUpdateParams Display firmware default update parameters fwSetUpdateParams Configure firmware default update parameters showCapability Display the capabilities/features showLastScpRetCode Display the return code from the last SCP Firmware Push fwVersion Display Firmware revisions bootQuery Query boot image information bootSelect Change boot selection

Online Help 1-4 D000103-000 E Online Help The online help for the CLI provides, for each command, all necessary information to successfully execute the command. For example, typing help list (can also type list help) displays the following information for the list command: NAME list SYNOPSIS list [group] [-noprompt] [-verbose] DESCRIPTION List available commands. OPTIONS group - List the commands in that particular group -noprompt - Just list the command groups. -verbose - Print full help for each command, instead of summary. NOTES Specify the group name or use 'all' to list all available commands. Keyboard Shortcuts „ The CLI keeps a history of recently executed commands. This history is available via the Up and Down arrow keys. „ Users may edit the current command with the Left and Right arrow keys. „ Tab completion: pressing the Tab key after typing at least one character either completes a command or lists all the available commands that begin with the characters already typed. Accessing the CLI NOTE: The CLI can be accessed via Telnet, SSH, or through the switch RS232 serial port. The following instructions use Telnet. 1. Telnet to the IP address of the switch (the default IP address is 192.168.100.9) with the following command: telnet 2. The system prompts for a username. The CLI has the following default user names: Operator access: operator Administrator access: admin Type the appropriate username and press Enter.

Keyboard Shortcuts D000103-000 E 1-5 3. The system prompts for a password. The CLI has the following default passwords: Operator access: operpass Administrator access: adminpass Type the appropriate password and press Enter. The system responds with: Welcome to the CLI. Type 'list' for the list of commands.

Groups and Commands 1-6 D000103-000 E Groups and Commands The following section lists all CLI functional groups along with the commands for each group. Commands for all 12000 switches are listed. Any commands specific to a switch(es) is noted. For more specific information for each functional group, the user would execute the help command. For more specific command information, the user would execute the help command. General help Displays help information for a specific command. Syntax: Options: Sample Output: NOTES: General Help Type list or ? for the list of commands. To get help on a particular command type: commandname help. For convienence purposes you can also type: help commandname help [command] [command] The command to display help for. -> help list NAME list SYNOPSIS list [group] [-noprompt] DESCRIPTION List available commands. OPTIONS group - List the commands in that particular group -noprompt - Just list the command groups.

Groups and Commands D000103-000 E 1-7 Use the Up and Down arrow keys to browse command history, Left and Right arrow keys to edit the current command and the Tab key for tab completion of a command. Two alternate key bindings exist for the backspace and delete keys. If these keys are not responding as expected use the swapBsDel command to swap the bindings. Commands are grouped into subcategories. To list the commands in a subcategory type in the category heading. Category headings are identified by starting with a capital letter. For example, to list all the commands that handle log configuration type Log. In each help description, items in brackets(e.g. [] in this help description) represent optional parameters. User selectable input is indicated by items within the '<' and '>' symbols(e.g. ). Text outside the '<' and '>' characters is the actual text that needs to be entered. When there is more than one choice, the options are specified within '{' and '}' characters, where the options are separated by '|' characters. list Displays a list of all valid commands. Syntax: Options: Sample Output: list [all] [group] [-noprompt] [-verbose] all List the commands for all groups. group Displays a list of commands for a particular group -noprompt Displays a list of the command groups only. -verbose Print full help for each command, instead of summary. list List of Valid Commands: General General commands for user management and CLI configuration. Deprecated These commands have been deprecated Network Snmp configuration commands. Firmware Update firmware and display current revision levels. Log Log file display and configuration IbSwitchInfo InfiniBand port configuration and statistics TimeManagement Display and configure the system time Snmp Snmp configuration commands. Type the name of the group you want to list or return to exit:

Groups and Commands 1-8 D000103-000 E NOTES: Use 'list all' to display brief help for all available commands. Use 'list all -verbose' to display verbose help for all commands. Use 'list -noprompt' to display the list of command groups. history Displays the command history for this session. Syntax: Options: Sample Output: reboot (12300) Reboots the device. Syntax: history None. -> history command history [30 max lines]: list Deprecated Network Firmware Log IbSwitchInfo TimeManagement Snmp Ethernet help list history reboot [now][-m][slot n][-s][-n][all]

Groups and Commands D000103-000 E 1-9 Options: Sample Output: NOTES: You may reboot the local (Master) Managment Module or the remote (Slave) Managment Module with one or multiple arguments. Non-disruptive arguments will not interfere with switch traffic. Providing the argument all performs disruptive reboot of all present Managment Modules and cards. If rebooting the local device from telnet, ssh, etc., you will have to reconnect after rebooting. Default (no arguments) reboots local device disruptively after prompt. See also: 'resetCard', 'showInventory'. reboot (12800 Series) Reboots the device. Syntax: now Does not prompt the user before rebooting. -m Reboot Master (local) QLogic 12300 (non-disruptive). slot n reset specific device where n = slotNumber (disruptive). -s Reboot Slave (remote) QLogic 12300 -n Reboot Slave (remote) management card only (non-disruptive) all Reboot All local devices (excludes -n/-m/-s). -> reboot Disruptive reboot selected Proceed with reboot? [N] reboot [now][-m][slot n][-s][-n][all]

Groups and Commands 1-10 D000103-000 E Options: Sample Output: NOTES: You may reboot the local (Master) Managment Module or the remote (Slave) Managment Module with one or multiple arguments. Non-disruptive arguments will not interfere with switch traffic. Providing the argument all performs disruptive reboot of all present Managment Modules and cards. If rebooting the local device from telnet, ssh, etc., you will have to reconnect after rebooting. Default (no arguments) reboots local device disruptively after prompt. See also: 'resetCard', 'showInventory'. killCliSession Terminates an existing CLI session Syntax: Options: now Does not prompt the user before rebooting. -m Reboot Master (local) Management Module 228 (non-disruptive). slot n reset specific device where n = slotNumber (disruptive). -s Reboot Slave (remote) Management Module 227. -n Reboot Slave (remote) management card only (non-disruptive) all Reboot All local devices (excludes -n/-m/-s). -> reboot Disruptive reboot selected Proceed with reboot? [N] killCliSession sessionNumber sessionNumber The sessionNumber that is returned from the who command.

Groups and Commands D000103-000 E 1-11 Sample Output: NOTES: This command logs out remote sessions. Use 'who' to obtain the list of active sessions. who Displays currently active CLI sessions. Syntax: Options: Sample Output: NOTES: Displays a list of currently active CLI sessions. Note that a session can be 'active', but no user information available (in most cases, this indicates the session is waiting for the user to enter login information). For each session the following information is displayed: „ user: username of the logged in user „ role: security role of the user „ index: internal session index „ logged in: timestamp of when the user logged in „ last cmd: timestamp of the users last command „ type: method used to connect to the system „ ip address: ip address of the user (if applicable) broadcast Write a message to all active CLI sessions Syntax: -> killCliSession must supply session number who None. user role index logged in last cmd type ip address --------------------------------------------------------------------------------------------------- admin admin 0 13:19:03 07/11/2008 09:41:20 07/11/2008 serial 0.0.0.0 broadcast msg

Groups and Commands 1-12 D000103-000 E Options: Sample Output: NOTES: Writes the supplied message to all other active CLI sessions. The message to be written must be encapsulated in quotes, and non-empty. swapBsDel Swaps the backspace and delete character key bindings. Syntax: Options: Sample Output: NOTES: Terminals may bind the backspace and delete key bindings differently. This command swaps two commonly used bindings, which allow the user to use the backspace and delete keys properly without having to adjust their terminal settings. Backspace and delete swapping is persistently maintained per user (i.e. each login account can have a separate binding). setTermWidth Change the terminal width for text formatting purposes. Syntax: Options: msg Message (Note: the message text must be encapsulated in quotes "". -> broadcast "The system will be rebooted in 5 minutes." swapBsDel None. -> swapBsDel setTermWidth width width Width of the user’s terminal window. Minimum width is 20 characters.

Groups and Commands D000103-000 E 1-13 Sample Output: NOTES: Allows modification of the terminal width used for text formatting purposes. Note that not all commands adhere to this setting. The minimum width is 20 characters. getTermWidth Displays the terminal width for text formatting purposes. Syntax: Options: Sample Output: NOTES: Displays the terminal width used for text formatting purposes. Note that not all commands adhere to this setting. prompt Set the CLI prompt (global for all active CLI sessions). Syntax: Options: Sample Output: NOTES: This changes the prompt for all CLI sessions. The prompt may not exceed 11 characters and is not saved across reboots. If the prompt contains a space, asterick, comma, parenthesis or semicolon it must be enclosed with double quotes -> setTermWidth 100 getTermWidth None. -> getTermWidth Current terminal width: 80 characters. prompt str str The new prompt. prompt -> "12300->" 12300->

Groups and Commands 1-14 D000103-000 E ". For example: "*a prompt*". Also, if a prompt is not accepted try to enclose it with double quotes. In order for some FastFabric Tools to function correctly, the prompt must end in "-> " (note trailing space). case Display or change the case sensitivity for the command interpreter for the CLI session. Syntax: Options: Sample Output: NOTES: This displays or changes the case sensitivity for the command interpreter for the CLI session. If an option is not specified the current case sensitivity is displayed, otherwise the case sensitivity is turned on or off depending on the specified option. When case sensitivity is on, the CLI input must match the exact character case (lower and upper case) as specified in the help text. When case sensitivity is turned off, the input may be any combination of upper and lower case. showLastRetCode Display the return code from the last executed command. Syntax: Options: Sample Output: NOTES: This allows for automated systems to determine if a command was successful or not. case [off | on] off | on Turn case sensitivity off or on. -> case off Case sensitivity is now off showLastRetCode [-brief] -brief Displays just the numeric value of the return code. -> showLastRetCode Last Exit Code: 0: Success

Groups and Commands D000103-000 E 1-15 echo Echoes text back to the output.. Syntax: Options: Sample Output: NOTES: This echoes the text for each argument back to the output. If there are multiple arguments they are separated by spaces. rlogin Creates I/O terminal to local cards. Syntax: Options: Sample Output: NOTES: This command allows users to open a terminal to local I/O devices within the chassis. The command rcmd is an alias of rlogin. See also hostShow. echo [ ...] [ ...] Text to be echoed.. -> echo test test rlogin [hostName] hostName The name of the device to connect. -> rlogin Slave

Groups and Commands 1-16 D000103-000 E rcmd Creates I/O terminal to local cards. Syntax: Options: Sample Output: NOTES: This command allows users to open a terminal to local I/O devices within the chassis. The command rcmd is an alias of rlogin. See also hostShow. resetCard Reboot a specific slot in the chassis. Syntax: Options: Sample Output: NOTES: If you reset the switch you are connected to you will have to reconnect. You can find out the valid slots for this device with the 'showInventory' command. rcmd [hostName] hostName The name of the device to connect. -> rcmd Slave resetCard n [now] n Chassis slot number. now No prompt before resetting the card. -> resetCard 101 now

Groups and Commands D000103-000 E 1-17 logout Logout of the current CLI session. Syntax: Options: Sample Output: user Change user accounts. Syntax: Options: Sample Output: NOTES: Use this command to change to the 'operator' account, or to the 'admin' account. The minimum password length is 8 characters. The maximum length is 40 characters. logout None. logout user [user] [user] Name of user account to change to. -> user operator User changed to: operator

Groups and Commands 1-18 D000103-000 E passwd Change users password(s). Syntax: Options: Sample Output: NOTES: Allows the modification of the user's password. userAdd Add a user account. Syntax: Options: Sample Output: passwd [username] [username] Name of the user whose password needs to be changed. -> passwd operator1 User password changed successfully userAdd [role] [username] [password] [role] Can be either admin or operator. [username] The name of the user to be added. [password] Optional password. If not supplied the default password for that role is used. -> userAdd admin Bob User added: Bob Password is set to the default password for this role: admin

Groups and Commands D000103-000 E 1-19 userRem Remove a user account. Syntax: Options: Sample Output: userListShow List all user accounts for this device. Syntax: Options: Sample Output: userRem [username] username Name of the user to be removed. -> userRem Bob User deleted: Bob userListShow None. -> userListShow username role operator1 operator USERID admin Bob admin

Groups and Commands 1-20 D000103-000 E sshKey Adds, displays, and removes SSH public keys for individual users.. Syntax: Options: Sample Output: NOTES: Adds, displays, and removes SSH public keys for individual users. Users with administrative privileges may use the -u option to manage keys for other users. sshKey [-u ] [] show Displays the SSH public keys in the users authorized_keys file. add “” Add key to the users authorized_keys file. Must be enclosed within double-quotes (""). rem Remove key at for the user. rem -all Remove all keys for the usern. -u Perform the operation on the user (for admins only). -> sshKey show Index Key ----------------------------------- 1 "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEArNiSexu30rZjs1HAXbDBwTgJgcxLF..."

Groups and Commands D000103-000 E 1-21 loginMode Allows the user to change the user interface authentication requirements. Syntax: Options: Sample Output: NOTES: This command displays or changes how users are authenticated when connecting to the GUI or CLI. With no parameters, the current login mode is displayed. The login mode can be changed by specifying a single integer parameter indicating which of the following modes should become active: 0 - Username and password required 1 - Password is not required 2 - Username / password are not required 3 - LDAP Authentication When usernames are disabled, all users will be logged on as the administrative user. There is no way to change this behavior. setldapSvrIpAddr Modify the LDAP Server IP Address. Syntax: Options: Sample Output: loginMode [mode] [mode] Determines how users are able to login. -> loginMode 1 Mode successfully changed to: 1 = Password is not required setldapSvrIpAddr [ipaddress] [ipaddress] The IP address of the ldap server you wish to set to authenticate in the format "192.168.0.1" -> setldapSvrIpAddr 192.168.0.29

Groups and Commands 1-22 D000103-000 E NOTES: This sets the LDAP server ip address. The LDAP server will be contacted for remote authentication. setldapSvrPort Modify the LDAP Server Port. Syntax: Options: Sample Output: NOTES: Sets the LDAP server port. The LDAP server will be contacted for remote authentication. idleTimeoutGet Retrieves the UI idle timeout value. Syntax: Options: Sample Output: NOTES: Displays the system idle timeouts for the GUI and CLI interfaces. If set to zero, the timeout is disabled. setldapSvrPort [port] [port] The port of the LDAP server to be authenticated. -> setldapSvrPort 389 idleTimeoutGet [--all] [--cli] [--gui] --all Display all timeouts. This is the default if no options are specified. --cli Display the timeout for CLI sessions. --gui Display the timeout for GUI sessions. -> idleTimeoutGet Timeout is 600 seconds.

Groups and Commands D000103-000 E 1-23 idleTimeoutSet Set the UI idle timeout value. Syntax: Options: Sample Output: NOTES: Modifies the idle timeout for the CLI or GUI interfaces. Timeouts are in number of seconds, with zero meaning the timeout is disabled. sessionTimeoutDisable Disable the idle timeout for the current CLI session. Syntax: Options: Sample Output: NOTES: Disables the idle timeout for the current CLI session. This value does not persist across instances of the session (i.e., each time you log on, it will default back to the system default value). idleTimeoutSet [--all | --cli | --gui] seconds] [seconds] Idle timeout value (in seconds). --all Set the idle timeout for both the CLI and the GUI to the same value. --cli Set the idle timeout for the CLI. This is the default if no identifier is specified. --gui Set the idle timeout for the GUI. -> idleTimeoutSet --all 700 Timeout is set to 700 seconds. sessionTimeoutDisable None. -> sessionTimeoutDisable Disabled session idle timeout.

Groups and Commands 1-24 D000103-000 E sessionTimeoutEnable Enable the idle timeout for the CLI session. Syntax: Options: Sample Output: NOTES: Enables the idle timeout for the current CLI session. This value does not persist across instances of the session (i.e., with each log on, it defaults back to the system default value). loginMsgGet Displays the CLI login message for this device. Syntax: Options: Sample Output: NOTES: Displays the current login welcome message for the CLI. This message can be customized with the loginMsgSet command. loginMsgSet Set the CLI login message for this device. Syntax: sessionTimeoutEnable None. -> sessionTimeoutEnable Enabled session idle timeout. loginMsgGet None. -> loginMsgGet Welcome message: Be certain to logout when you are finished using the CLI. loginMsgSet [message] [-clear]

Groups and Commands D000103-000 E 1-25 Options: Sample Output: NOTES: This command can be used to modify the welcome message displayed when logging onto the CLI. The current message can be viewed with the loginMsgGet command. loginNameGet Display the name of the device displayed when logged into via telnet. Syntax: Options: Sample Output: NOTE: The login name is an arbitrary string displayed prior to a user attempting a login to a new CLI session. This command displays the current value of this string. loginNameSet Modify the string displayed to users prior to attempting a login for a new CLI session. Syntax: [message] The login message (should be encapsulated in quotes “ “). [-clear] Clear welcome message. -> loginMsgSet "Be certain to logout when you are finished using the CLI." Welcome message set successfully loginNameGet None. -> loginNameGet login-name: Switch1 loginNameSet [option]

Groups and Commands 1-26 D000103-000 E Options: Sample Output: NOTES: The login name is an arbitrary string displayed prior to a user attempting a login to a new CLI session. This command modifies this string. The current name can be viewed with the loginNameGet command. serialAuthGet Displays the current serial authentication status. Syntax: Options: Sample Output: NOTES: Displays whether user login and authentication is required on the serial console of the system. serialAuthSet Enable or disable authentication on the systems serial console. Syntax: Options: [name] Set the login name. [-clear] Clear the login name. -> loginNameSet Switch1 login-name set successfully serialAuthGet None. -> serialAuthGet Serial authentication is currently disabled. serialAuthSet [enable] [enable] Boolean value to enable or disable serial authentication.

Groups and Commands D000103-000 E 1-27 Sample Output: NOTES: This command is used to enable or disable user authentication on the serial console. Use 1 as the only parameter to enable authentication, or 0 to disable authentication. Exit and re-login for the setting to take effect. The login mode must be set to 0 or 1 for authentication to take place on the serial port. uiConfig View or configure the user interfaces to this device. Syntax: Options: Sample Output: NOTES: There are several access methods for this device. With no arguments, this command displays which access methods are available, and whether each method is enabled or disabled. -> serialAuthSet 1 Serial authentication set to enabled. uiConfig [-telnet 0|1] [-https 0|1] [-http 0|1] [-ftp 0|1] [-snmp 0|1] [telnet] Enable/disable access to the device via telnet.. [https] Enable or disable https access. [http] Enable or disable http access. [ftp] Enable or disable ftp access. [snmp] Enable or disable SNMP access. -> uiconfig -telnet 0 Successfully modified configuration. Option Value ----------------------- telnet 0 http 1 https 0 ftp 1 snmp 1

Groups and Commands 1-28 D000103-000 E This command can also be used to enable or disable various access methods. Use '- 0' to disable a protocol, and '- 1' to enable. Multiple operations may be specified in a single command. A reboot is not required for this command. Depending on the specific method, it may take 5-10 seconds for the changes. Note that existing connections (for example a telnet session) will not be affected by disabling the underlying access method. Any access method supported by the device (but not listed here) cannot be configured and is always enabled. genPost Displays General POST results and runs tests Syntax: Options: Sample Output: NOTES: Displays General POST results and runs tests. genPost None. MasterMM202-> genpost ID Gen POST Name Result ENA DEM PWR Result-Ext --------------------------------------------------------------------------- * POST TEST CPU NO-RUN Y N Y * POST TEST MEM DRAM NO-RUN Y N Y * POST TEST BOOTROM IMG CHKSUM NO-RUN Y N Y * POST TEST RUN-TIME IMG CHKSUM NO-RUN Y N Y * POST TEST JMP RAM NO-RUN Y N Y 6 POST TEST I2C PROBE NO-RUN Y Y N 7 POST TEST FAN TRAYS NO-RUN Y Y N 8 POST TEST PWR SUPPLIES NO-RUN Y Y N 9 POST TEST REAL-TIME CLOCK NO-RUN Y Y N 10 POST TEST PROTO NO-RUN Y Y N

Groups and Commands D000103-000 E 1-29 IpoIbConfigShow Displays the IPoIB Enable/Disable setting. Syntax: Options: Sample Output: IpoIbConfigEnable Enable IPoIB feature. Syntax: Options: Sample Output: IpoIbConfigDisable Disables the IPoIB feature. Syntax: Options: Sample Output: IpoIbConfigShow None. -> IpoIbConfigShow IpoIbConfigEnable <- IpoIb enable> None. -> IpoIbConfigEnable IpoIbConfigDisable None. -> IpoIbConfigDisable

Groups and Commands 1-30 D000103-000 E IpoIbAddressShow Displays the IpoIb IP address and associated netmask. Syntax: Options: Sample Output: NOTES: IPoIB must be enabled to display these fields. IpoIbAddressSet Change the IpoIb IP address and associated network mask. Syntax: Options: Sample Output: NOTES: IPoIB must be enabled to display these fields. IpoIbAddressSetIPv6 Changes the IPoIB IPv6 address and netmask. Syntax: IpoIbAddressShow None. -> IpoIbAddressShow IpoIbAddressSet -h ipaddress -m netMask [-h ipaddress] the new IP address in dotted notation format 'xxx.xxx.xxx.xxx'. [-m netMask] network mask. (in hexidecimal format). -> IpoIbAddressSet -h 123.45.6.789 IpoIbAddressSetIPv6

Groups and Commands D000103-000 E 1-31 Options: Sample Output: NOTES: The is made up of two major components, separated by a '/'. The ipv6Address is in notation format 'a:b:c:d:e:f:g:h', where embedded 0s can be shortened (for example, 'a:b::g:h'). The netMaskLen is a value between 0 and 128 inclusive. IpoIbAddressShowIPv6 Displays the IPoIB IPv6 Address and associated netmask settings. Syntax: Options: Sample Output: exit Exit the CLI. Syntax: Options: Sample Output: See NOTES. -> IpoIbAddressSetIPv6 IpoIbAddressShowIPv6 None. -> IpoIbAddressShowIPv6 exit None. exit

Groups and Commands 1-32 D000103-000 E Chassis hwCheck Runs a system check at the chassis level and returns current hardware status. Syntax: Options: Sample Output: NOTES: Returns OK or provides detailed status/warning/error information. If an error/warning is detected, this command automatically provides verbose information. hwMonitor Displays current port states, fan speeds, temperatures, and voltages. Syntax: Options: hwCheck [n - 0=default, 1=verbose] -> hwCheck Chassis hardware status: GOOD hwMonitor [slot] [onepass] [slot] Slot number to display. 0 for current slot of the management board. [onepass] Display the current values and exits. Do not continuosly monitor.

Groups and Commands D000103-000 E 1-33 Sample Output: NOTES: To exit monitoring, press the enter key. The slot number may require a prefix. The prefix for a Leaf is 'L', the prefix for a Spine is 'S', the prefix for a Mangement Module is 'M', the prefix for a Power Supply is 'P', the prefix for a Fan is 'F', and the prefix for the Chassis is 'C'. The Leaf, Spine and Management Module slots do not require a prefix. The Power Supply, Fan and Chassis slots require a prefix since their slot numbers overlap with the Leaf, Spine and Management Module slot numbers. showIBNodeDesc Displays the IB Node subnet management agent (SMA) Description.. Syntax: (Sample 1) -> hwMonitor 0 System monitor, Uptime: 0 days 4 hours 55 minutes 37 seconds MODULES MODULES(cont) MODULES(cont) Power & Fans SLOT|P|TMP|VLT SLOT|P|TMP|VLT SLOT|P|TMP|VLT SLOT|P|SPEED SLOT|P|SPEED | |E|W|E|W | |E|W|E|W | |E|W|E|W | | | | M201 |*| | | | L101 |*| | | | | | | | | P201| | F201|*| 6840 M202 |*| | | | L102 |*| | | | | | | | | P202|*| F202|*| 6480 S105A|*| | | | L103 |*| | | | | | | | | P203| | F203|*| 6480 S105B|*| | | | L104 |*| | | | | | | | | P204|*| F204|*| 6840 Max Temp=60C (Management Module 202) Legend: P=pres/abs TMP=Temperature VLT=Voltage E=Err W=Warn (X=Err/Warn found) (Sample 2) -> hwMonitor 0 System monitor, Uptime: 0 days 4 hours 57 minutes 2 seconds DETAIL FOR DEVICE: Leaf 101 Temperatures: Base Board: [fusion]=31C [asic]=40C Voltages: Base Board [FPGA_1.5V_AUX]=1.555 [PCIE_1.5V_BULK]=1.480 [3.3V_AUX]=3.312 [VDD_1.0V_BULK]=0.980 [AVTR_1.2V_BULK]=1.161 [AVDD_1.5V_BULK]=1.474 [3.3V_BULK]=3.290 [AVTT_1.5_BULK]=1.485 [PLL_2.5_BULK]=2.391 InfiniBand Port Status L101P01[ Down ] L101P02[ Down ] L101P03[ Down ] L101P04[ Down ] L101P05[ Down ] L101P06[ Down ] L101P07[ Down ] L101P08[ Down ] L101P09[ Down ] L101P10[ Down ] L101P11[ Down ] L101P12[ Down ] L101P13[ Down ] L101P14[ Down ] L101P15[ Down ] L101P16[ Down ] L101P17[ Down ] L101P18[Active] L101P19S105BP18[Active] L101P20S105BP17[Active] L101P21S105AP21[Active] L101P22S105BP15[Active] L101P23S105AP23[Active] L101P24S105AP24[Active] L101P25S105AP25[Active] L101P26S105AP26[Active] L101P27S105AP27[Active] L101P28S105AP28[Active] L101P29S105AP29[Active] L101P30S105AP30[Active] L101P31S105BP06[Active] L101P32S105BP05[Active] L101P33S105BP04[Active] L101P34S105BP03[Active] L101P35S105BP02[Active] L101P36S105BP01[Active] showIBNodeDesc [-d]

Groups and Commands 1-34 D000103-000 E Options: Sample Output: NOTES: Entering this command with no parameters displays the current Node Description. The -d option will display the unit's default value. setIBNodeDesc Changes the IB Node (SMA) Description. Syntax: Options: Sample Output: NOTES: New node name must be enclosed in quotes. Node name must be less than 64 characters. setIBNodeDescFormat Changes the IB Node (SMA) description format modifier. Syntax: Options: [-d] Show the default Node Name for this unit. -> showIBNodeDesc IB Node (SMA) Description is = QLogic 12300 GUID=0x00066a00030001xa setIBNodeDesc "New Node String" None. -> setIBNodeDesc "QLogic 12300 GUID=0x00066a00da000" IB Node (SMA) Description successfully changed to = QLogic 12300 setIBNodeDescFormat [format] [format] Use 0 or 1 to set the format

Groups and Commands D000103-000 E 1-35 Sample Output: NOTES: If the format is not specified, then the current format selection value is displayed. When the format is 0, the SMA node description is in a verbose format. When the format is one the format is brief. The brief format is more consistent with the CLI/GUI Port Stat port naming. fruInfo Displays the EEProm contents. Syntax: Options: Sample Output: NOTES: The '-all' parameter performs this command against all available slots for the device. -> setIBNodeDescFormat Format = 0 fruInfo [slot|'-all'] [slot] Slot that you wish to display EEProm contents. Defaults to 0 (chassis EEProm) -> fruInfo xInfo_ChassisInfo: RecType: 1 LastRec: 0 LenMult: 0 ReadOnly: 1 RecordFormat: 2 RecLen: 14 LogicalLen: 020 HdrChkSum: c6 ChassisGuid: 00066a000300012a SlotCount: 1 (IB Mods in Chassis) SlotNumbers: 81 (pairs:ext0|Slt1) CmeAccess: 80 (bits:ext0|Slt1|Cme) SlotNumber: 0 <-Record accessed via this slot CmeAccessBits: 2 (Access slot relative) ProxyAccess: 0 (Access slot relative) LockDrivesCTR: 0 (Clear to Remove interlock) MechLock: 1 NodeCount: 0 ...

Groups and Commands 1-36 D000103-000 E chassisQuery Displays information about modules inserted in the chassis that support firmware updates. This includes information regarding cardType, Board Support Package (BSP) and SlotNumber. Syntax: Options: Sample Output: NOTES: Entering this command with no parameters will display all currently occupied card slots. showInventory Displays a detailed list of all hardware within the chassis. Syntax: Options: chassisQuery [-master] [-slave] [slot] [-showType] [-type card_type] [-ignoreInvalidType] [-master] Display the master slot number [-slave] Display slave slot number [n] slot number (numeric) [-showType] display the card type [-type card_type] display slots that have given card type [-ignoreInvalidType] do not return an error if an invalid card type is supplied MasterMM202-> chassisQuery slots: 201 202 showInventory None.

Groups and Commands D000103-000 E 1-37 Sample Output: setBeacon Allows the user to view/set the chassis beacon. Syntax: Options: Sample Output: NOTES: Calling this function with no argument displays its current value. setSystemContact Allows the user to set/show the chassis system contact. Syntax: Options: MasterMM202-> showInventory ___________________________________ Leaf 101 ----------------------------------- GUID - 00066A00EC002712 Manufacturer Id - 00066A Manufacturer Name - SST Mfg Date/Time - 2009/04/09 10:00 Model - 12800-LF18 Part Number - 220052-004-B Product Name - 12800 QDR 18P Leaf Module Serial Number - USF1150920031 Version - 004-B ... setBeacon [beacon] [beacon] 1=on, 0=off. -> setBeacon 0 setSystemContact [contact] [contact] System contact string.

Groups and Commands 1-38 D000103-000 E Sample Output: NOTES: If the system contact is not specified, the current system contact is displayed. setSystemName Allows the user to set/show the chassis system name. Syntax: Options: Sample Output: NOTES: If the system name is not specified, the current system name is displayed. setSystemLocation Allows the user to set/show the chassis system location. Syntax: Options: Sample Output: NOTES: If the system location is not specified, the current system location is displayed. -> setSystemContact [contact string] setSystemName [name] [name] System name string -> setSystemName [name string] setSystemLocation [location] [location] System location string -> setSystemLocation [location string]

Groups and Commands D000103-000 E 1-39 Network ifShow Displays information for all the network interfaces for the switch, including the management port and the internal Ethernet network. Syntax: Options: Sample Output: NOTES: This routine displays the attached network interfaces for debugging and diagnostic purposes. If ifName is given, only the interfaces belonging to that group are displayed. If ifName is omitted, all attached interfaces are displayed. routeShow Displays the OOB LAN IP routes. Syntax: ifShow [ifName] [ifName] The network interface name. -> ifShow sbe0 (unit number 0): Flags: (0x8063) UP BROADCAST MULTICAST ARP RUNNING Type: ETHERNET_CSMACD Internet address: 192.168.100.9 Broadcast address: 192.168.111.255 Internet address: 172.26.3.19 Broadcast address: 172.26.15.255 Netmask 0xfffff000 Subnetmask 0xfffff000 Net 0xc0a86000 Subnet 0xc0a86000 Ethernet address is 00:06:6a:01:99:c8 Metric is 0 Maximum Transfer Unit size is 1500 2524301 octets received 6604130 octets sent 28728 packets received 14310 packets sent 19665 broadcast packets received 31 broadcast packets sent 0 multicast packets received 0 multicast packets sent routeShow

Groups and Commands 1-40 D000103-000 E Options: Sample Output: ping Send ping packets to a specified host. Syntax: Options: None. -> routeShow ROUTE NET TABLE destination gateway flags Refcnt Use Interface ---------------------------------------------------------------------------- 0.0.0.0 172.26.0.1 3 2 18966 sbe0 0.0.0.0 172.26.3.35 3 0 0 sbe0 127.1.0.0 127.1.1.2 101 0 0 sbe1 127.2.0.0 127.2.0.1 101 0 0 sbe1 172.26.0.0 172.26.3.35 101 0 0 sbe0 172.26.0.0 172.26.3.19 101 -1 0 sbe0 ---------------------------------------------------------------------------- ROUTE HOST TABLE destination gateway flags Refcnt Use Interface ---------------------------------------------------------------------------- 127.0.0.1 127.0.0.1 5 3 14209 lo0 ---------------------------------------------------------------------------- ping [ipAddress] [packetCount] [IpAddress] The IP address of the network host to ping. [packetCount] The number of packets with which to ping the host (default is 5).

Groups and Commands D000103-000 E 1-41 Sample Output: NOTES: This routine spawns a process to send ping packets to the specified IP address. If packetCount is given, the process exits after that number of packets are sent. If packetCount is ommitted, a default the number of packets defaults to 5. ping6 Sends ping packets to a specified IPv6 address. Syntax: Options: Sample Output: -> ping 172.26.0.254 PING 172.26.0.254: 56 data bytes 64 bytes from 172.26.0.254: icmp_seq=0. time=0. ms 64 bytes from 172.26.0.254: icmp_seq=1. time=0. ms 64 bytes from 172.26.0.254: icmp_seq=2. time=0. ms 64 bytes from 172.26.0.254: icmp_seq=3. time=0. ms 64 bytes from 172.26.0.254: icmp_seq=4. time=0. ms ----172.26.0.254 PING Statistics---- 5 packets transmitted, 5 packets received, 0% packet loss round-trip (ms) min/avg/max = 0/0/0 ping6 [-n] [-q] [-v] [-c ] [-I ] [-n] Numeric output only. [-q] Only display summary lines. [-v] Verbose output. [-c ] The number of packets to ping the host with (default is 5). [-I ] The local interface name to use (useful for link local ping). [ipv6Address] The network host to ping, scoped address accepted. -> ping6 ipv6Address

Groups and Commands 1-42 D000103-000 E NOTES: This routine spawns a process to send ping packets to the specified IPv6 address. If packetCount is given, the process exits after that number of packets are sent. If packetCount is omitted, a default the number of packets defaults to 5. showChassisIpAddr Displays the chassis IP address. Syntax: Options: Sample Output: setChassisIpAddr Change the OOB LAN IP address and network mask. Syntax: Options: Sample Output: NOTES: Changing the chassis IP address will drop the connection to the CLI if not using the console port and may cause the device to become unreachable. setChassisIpv6Addr Changes the chassis IPv6 address. Syntax: showChassisIpAddr None. -> showChassisIpAddr Chassis IP Address: 172.26.0.221 Net mask: 255.255.240.0 setChassisIpAddr -h ipaddress -m netMask -h ipaddress The new IP address in dotted notation format 'xxx.xxx.xxx.xxx'. -m netMask The network mask. (may be in dotted notation or hexidecimal format) -> setChassisIpAddr -h 172.26.0.221 -m 255.255.240.0 setChassisIpv6Addr [ /]

Groups and Commands D000103-000 E 1-43 Options: Sample Output: NOTES: Changing the chassis IPv6 address may drop the connection to the CLI if not using the console port, and may cause the device to become unreachable. delChassisIpv6Addr Deletes the chassis IPv6 address. Syntax: Options: Sample Output: NOTES: Changing the chassis IPv6 address may drop the connection to the CLI if not using the console port, and may cause the device to become unreachable. This command does not affect link-local or autoconfigured addresses. showChassisIpv6Addr Displays the chassis IPv6 address. Syntax: Options: The new IPv6 address in notation format 'a:b:c:d:e:f:g:h', embedded 0s can be shortened, eg a:b::g:h. Network mask length. (0-128). -> setChassisIpv6Addr delChassisIpv6Addr None. -> delChassisIpv6Addr showChassisIpv6Addr None.

Groups and Commands 1-44 D000103-000 E Sample Output: autoConfIPv6Enable Enables IPv6 address autoconfiguration. Syntax: Options: Sample Output: NOTES: This command allows prefix learning from attached routers, and does not affect link-local or manually configured addresses. autoConfIPv6Disable Disables IPv6 address autoconfiguration. Syntax: Options: Sample Output: NOTES: Prevents prefix learning from attached routers, and does not affect link-local or manually configured addresses. autoConfIPv6Show Displays IPv6 address autoconfiguration setting(s). Syntax: -> showChassisIpv6Addr autoConfIPv6Enable None. -> autoConfIPv6Enable autoConfIPv6Disable None. -> autoConfIPv6Disable autoConfIPv6Show

Groups and Commands D000103-000 E 1-45 Options: Sample Output: ndpShow Displays the IPv6 Neighbors table. Syntax: Options: Sample Output: showDefaultRoute Displays the default gateway IP address. Syntax: Options: Sample Output: NOTES: This is the IP address for the default gateway to route packets from the OOB mangement port to an external network. setDefaultRoute Change the default gateway IP address. None. -> autoConfIPv6Show ndpShow None. -> ndpShow showDefaultRoute None. -> showDefaultRoute Gateway IP Address: 172.26.0.254

Groups and Commands 1-46 D000103-000 E Syntax: Options: Sample Output: NOTES: This allows the user to configure the IP address for the default gateway to route packets from the OOB management port to an external network. arpShow Displays the contents of the ARP table. Syntax: Options: Sample Output: hostShow Displays a list of remote hosts names, internet address and alias(es). Syntax: setDefaultRoute -h ipaddress -h ipaddress The default gateway IP address in dotted decimal format (xxx.xxx.xxx.xxx). setDefaultRoute -h 172.26.0.235 arpShow None. -> arpShow LINK LEVEL ARP TABLE destination gateway flags Refcnt Use Interface -------------------------------------------------------------------------- 127.1.1.1 02:06:6a:ff:ff:fd 405 3 12121958 sbe1 127.2.0.2 02:06:6a:ff:ff:fd c05 2 71421 sbe1 172.26.0.1 00:19:e8:a0:69:f9 405 1 0 sbe0 172.26.3.35 00:06:6a:01:99:c8 405 1 0 lo0 -------------------------------------------------------------------------- hostShow

Groups and Commands 1-48 D000103-000 E Sample Output: -> hostShow hostname inet address aliases -------- ------------ ------- localhost 127.0.0.1 CHASSIS slot1 127.1.0.1 slot2 127.1.0.2 slot3 127.1.0.3 slot4 127.1.0.4 slot5 127.1.0.5 slot6 127.1.0.6 slot7 127.1.0.7 slot8 127.1.0.8 slot9 127.1.0.9 slot10 127.1.0.10 slot11 127.1.0.11 slot12 127.1.0.12 slot13 127.1.0.13 slot14 127.1.0.14 slot15 127.1.0.15 slot16 127.1.0.16 slot17 127.1.0.17 slot18 127.1.0.18 slot19 127.1.0.19 slot20 127.1.0.20 slot21 127.1.0.21 slot22 127.1.0.22 slot23 127.1.0.23 slot24 127.1.0.24 slot25 127.1.0.25 slot26 127.1.0.26 slot27 127.1.0.27 slot28 127.1.0.28 slot29 127.1.0.29 slot30 127.1.0.30 slot31 127.1.0.31 slot32 127.1.0.32 slot33 127.1.0.33 slot34 127.1.0.34 slot35 127.1.0.35 slot36 127.1.0.36 mm1 127.1.1.1 switchA mm2 127.1.1.2 switchB Master 127.2.0.1 Slave 127.2.0.2 WRS-Template 172.26.3.35 home 10.32.2.150

Groups and Commands D000103-000 E 1-49 dhcpEnable Enable the DHCP client for this system. Syntax: Options: Sample Output: NOTES: Enables the DHCP client subsystem, requests a DHCP lease, and then configures the interface with the lease data from the server, dhcpDisable Disable the DHCP client and release any acquired IP address Syntax: Options: Sample Output: NOTES: Any DHCP-acquired IP address will be released. The interface will then be configured to the default static values from the current bootline. dhcpShow Display DHCP client information. Syntax: dhcpEnable None. MasterMM202-> dhcpEnable DHCP is enabled dhcpDisable None. MasterMM202-> dhcpDisable DHCP is disabled dhcpShow [-v]

Groups and Commands 1-50 D000103-000 E Options: Sample Output: dnsParamsShow Displays the stored domain named server (DNS) parameters. Syntax: Options: Sample Output: dnsParamsSet Changes the DNS configuration parameters. Syntax: -v verbose output MasterMM202-> dhcpShow Client state = BOUND Assigned IP address: 172.26.3.35 Client subnet mask: 255.255.240.0 DHCP server: 172.26.1.20 Default IP router: 172.26.0.1 Client lease duration: 518400 secs (421299 remaining) dnsParamsShow None. MasterMM202-> dnsParamsShow DNS Resolver : Enabled DNS Server Address : xxx.xxx.xxx.xxx Local Domain Name : st.qlogic.com NOTE: This command retrieves the stored configuration parameters used for domain name resolution. dnsParamsSet [-s ] [-d ] [-e <1 or 0>]

Groups and Commands D000103-000 E 1-51 Options: Sample Output: -s DNS server IP address in dotted notation format (xxx.xxx.xxx.xxx) -d The local domain name where this switch is installed (limit 32 chars). -e <1 or 0> 1 = enable the DNS resolver, 0 = disable the DNS resolver. dnsParamsSet -e 0 MasterMM202-> dnsParamsShow DNS Resolver : Disabled DNS Server Address : xxx.xxx.xxx.xxx Local Domain Name : st.qlogic.com NOTE: The DNS resolver cannot be enabled until both the server address and local domain name have been configured. It is necessary to manually reboot the switch in order to start or stop the DNS resolver.

Groups and Commands 1-52 D000103-000 E Firmware fwUpdate (12300) Updates the firmware. Syntax: Options: Sample Output: NOTES: Firmware update works by using ftp to retrieve the firmware file, then writes the file to flash. Omitting any of the options causes the user to be prompted for the information. fwUpdateSlot Updates the firmware on a specific line card. Syntax: fwUpdate [host user password dir filename] host The name of the host where the firmware file resides. user The FTP user name. password The FTP user password. dir After logging in, the directory to cd to. filename The name of the firmware file. -> fwUpdate Enter 1 for FTP, 2 for local file: 1 Ftp Server IP Address:[192.168.0.195] Ftp username:[ftp] xxxxx Ftp password:[ftp] xxxxx File Directory:[PATH TO FIRMWARE FILE] File name:[xxx.pkg] fwUpdateSlot slotnumber [host user password dir filename]

Groups and Commands D000103-000 E 1-53 Options: Sample Output: NOTES: Firmware update works by using ftp to retrieve the firmware file, then writes the file to flash. Omitting any of the options causes the user to be prompted for the information. fwUpdateChassis Updates the firmware for all cards in a chassis of a particular type, or everything. Syntax: Options: slotnumber The chassis slot numberto update. [host] The name of the host where the firmware file resides. [user] The FTP user name. [password] The FTP user password. [dir] After logging in, the directory to cd to. [filename] The name of the firmware file. -> fwUpdateSlot 1 Enter 1 for FTP, 2 for local file: 1 Ftp Server IP Address:[192.168.0.195] Ftp username:[ftp] xxxxx Ftp password:[ftp] xxxxx File Directory:[PATH TO FIRMWARE FILE] File name:[xxxx.pkg] fwUpdateChassis (all,management,evic, fvic) [noprompt] [reboot] (all,management,evic, fvic) Type of card to update. See notes for details. [noprompt] Will not prompt the user for ftp information (uses the saved values). [reboot] Upon successful completion, reboots the updated cards .

Groups and Commands 1-54 D000103-000 E Sample Output: NOTES: Firmware update works by retrieving the firmware file from an ftp server. The file is saved locally and then written to flash. Using the ’all’ option, all cards in the chassis will be updated. This assumes that all firmware files are in the same location. The user will be prompted for the names of each file for each line card type present. The system can save the values entered as defaults for future firmware updates. fwListFiles Lists the contents of the firmware directory. Syntax: Options: Sample Output: NOTES: The firmware directory temporarily stores firmware files before they are written to flash. fwShowUpdateParams Display the default update firmware settings. Syntax: Options: -> fwUpdateChassis all reboot fwListFiles None. -> fwListFiles Listing Directory /firmware: [PATH TO FIRMWARE FILE] / [FIRMWARE FILE NAME] fwShowUpdateParams None.

Groups and Commands D000103-000 E 1-55 Sample Output: fwSetUpdateParams Change the default update firmware settings. Syntax: Options: NOTES: Modifies the default update firmware parameters. Except for the filename option, all parameters are shared across all card types. The cardtype parameter is only required when specifying the filename. showCapability Display capability and feature information for a specific release. Syntax: -> fwShowUpdateParams Firmware update ftp configuration settings: host:[0.0.0.0] user:[ftp] password:[ftp] directory:[] filename management:[] filename evic:[] filename fvic:[] fwSetUpdateParams -c cardtype [-h hostname] [-u username] [-p password] [-d directory] [-f filename] -c - cardtype Choices are: 'management', 'fvic', 'evic' -h - hostname The host name or IP address of the FTP server. -u - username The name of the user accessing the ftp server. -p - password The password of the user accessing the ftp server. -d - directory The directory containing the firmware file. -f - filename The firmware file name. showCapability [-key feature]

Groups and Commands 1-56 D000103-000 E Options: Sample Output: showLastScpRetCode Display the return code from the last SCP Firmware Push. Syntax: Options: Sample Output: NOTES: This allows for automated systems to determine if a SCP firmware push was successful or not. fwVersion Displays the firmware versions for a unit. Syntax: Options: [-key feature] Displays information for a particular feature. -> showCapability fwPush: 1 showLastScpRetCode slot | -all slot The slot number in the chassis. -all All slots in the chassis. -> showLastScpRetCode 101 SCP: Slot 101 Last Exit Code: 0: Success fwVersion [slot] slot Slot number.

Groups and Commands D000103-000 E 1-57 Sample Output: bootQuery Displays boot image version information. Syntax: Options: Sample Output: bootSelect Select the next boot image to be used. Syntax: Management Module 201 Information ----------------- Firmware Version: 5.0.0.0.73 Firmware build: 5_0_0_0_73 Firmware BSP: xt3 MBC Version: None Bootrom Version: 5.0.0.0.57 bootQuery [slot] [-active | -alternate | -all] [slot] Slot number. [-active] Displays the version of the active firmware image. [-alternate] Displays t]he version of the alternate firmware image. [-all Displays the versions for the primary and alternate firmware images. MasterMM202-> bootQuery 201 Primary firmware version: 5.0.0.0.73 bootSelect [slot] [-i index] [-alternate] [-version version] [-noprompt]

Groups and Commands 1-58 D000103-000 E Options: Sample Output: NOTES: This command allows the user to set the next boot image for the device. A '*' next to the image entry indicates the currently selected bootimage. A '#' indicates the currently active boot image. [slot] The slot number using the next boot image. [-i index] The index of the boot image to be used next. [-alternate] Chooses the alternate image to be used next. [-version version] Chooses a specific version to be the image to be used next. [-noprompt] Displays the current configuration only. MasterMM202-> bootSelect 201 Currently installed firmware versions index : alias : version -------------------------- *# 1 : image1 : 5.0.0.0.73; 2 : image2 : 5.0.0.0.72; * - indicates Primary image (will run at next reboot) # - indicates Active image Default boot image index = 1 ...

Groups and Commands D000103-000 E 1-59 Subnet Management smControl Starts and stops the embedded subnet manager. Syntax: Options: Sample Output: smConfig Configure startup parameters of the embedded subnet manager. Syntax: Options: Sample Output 1: smControl start | stop | restart | status Start Start the SM. Stop Stop the SM. restart Restarts the SM. status Prints out the SM Status. -> smControl start Starting the SM... smConfig [query] [startAtBoot yes|no] [startOnSlaveCmu yes|no] query Display present settings, no change startAtBoot Start the subnet manager at chassis boot startOnSlaveCmu Start subnet manager on the slave CMU -> smConfig Start at boot? [Y] Start on slave CMU? [N]

Groups and Commands 1-60 D000103-000 E Sample Output 2: NOTES: Use this command to configure the subnet manager. Changes to these parameters do not take effect until the chassis management card(s) is rebooted. This command is only available on the master chassis management card. smShowLids Displays the LID of the subnet manager. Syntax: Options: Sample Output: NOTES: Use this command to display the current LID of the subnet manager. -> smconfig startAtBoot yes startOnSlaveCmu yes Saving.... Saving complete... smShowLids None. sm_state = MASTER count = 572781 LMC = 0, Topology Pass count = 339, Priority = 0, Mkey = 0x0 ----------------------------------------------------------------------------------------- QLogic 12300 GUID=0x00066a00da000000 172.26.2.2 MM 1, Ch ----------------------------------------------------------------------------------------- Node[ 0] => 00066a000600013c (2) ports=24, path= Port ---- GUID ---- (S) LID LMC _VL_ __MTU__ _WIDTH_ ____SPEED____ CAP_MASK N# P# 0 00066a000600013c 4 LID=0001 LMC=0000 8 8 2k 2k 4X 4X 2.5 2.5 00000a4a 0 0 4 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 1 22 4 22 5 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 1 23 4 23 6 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 1 24 4 24 7 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 2 24 7 24 8 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 2 23 7 23 9 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 2 22 7 22 22 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 3 16 22 16 23 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 3 18 22 18 24 0000000000000000 4 8 8 2k 2k 4X 4X 2.5/5 5.0 00000000 3 17 22 17 ...

Groups and Commands D000103-000 E 1-61 smPriority Display the priority of the embedded subnet manager. Syntax: Options: Sample Output 1: NOTES: The priority of the Subnet Manager (SM) determines which subnet manager will become the master SM for the fabric. Zero is the lowest priority and fifteen is the highest. The SM with the highest priority becomes the master SM for the fabric. The elevated priority value determines what the priority of the SM will be if it becomes the Master. This allows persistent failovers that do not automatically fail back by configuring the elevated priority to be higher than all normal priorities. This feature is effectively disabled when set to the default of zero. The subnet manager must be running to display the priority. smSweepRate Display or dynamically set the sweep rate of the subnet manager. Syntax: Options: Sample Output: smPriority None. -> smPriority The SM Priority is 0 smSweepRate [sweepRate] sweepRate The sweep rate (in seconds) of the subnet manager. Valid values are 3-86400, or 0 to turn the sweep off. The sweepRate is the interval between the end of one sweep and the start of the next sweep. -> smSweepRate 300 The SM sweep rate has been set to 300 seconds

Groups and Commands 1-62 D000103-000 E NOTES: The sweep rate determines how often the subnet manager scans the fabric for changes and events. The subnet manager must be running to display or dynamically set the sweep rate of the embedded subnet manager. Changes to sweepRate made with the smSweepRate command will only affect the subnet manager that is currently running and will not be persistent. smForceSweep Force a fabric sweep by the embedded subnet manager. Syntax: Options: Sample Output: NOTES: Use this command to force a sweep by the subnet manager. bmForceSweep Force a fabric sweep by the embedded baseboard manager. Syntax: Options: Sample Output: NOTES: Use this command to force a sweep by the baseboard manager. smShowGroups Display multicast group information in the embedded subnet manager. Syntax: smForceSweep None. -> smForceSweep bmForceSweep None. -> bmForceSweep smShowGroups [-h]

Groups and Commands D000103-000 E 1-63 Options: Sample Output: NOTES: Use this command to display multicast group information in the subnet manager. This command is not available unless the subnet manager is in the Master mode. smShowServices Display subnet administration service records of the subnet manager. Syntax: Options: -h Display the host name as part of the output. -> smShowGroups Multicast Groups: join state key: F=Full N=Non S=SendOnly Member 0xff12601bffff0000:00000001ffffd5bb (c001) qKey = 0x00000000 pKey = 0xFFFF mtu = 4 rate = 3 life = 19 sl = 0 0x0011750000ffd5bb F 0xff12401bffff0000:00000000ffffffff (c000) qKey = 0x00000000 pKey = 0xFFFF mtu = 4 rate = 3 life = 19 sl = 0 0x00066a01a0007116 F 0x0002c902003fffd5 F 0x00066a00a00001ac F 0x00066a01a000015d F 0x00066a00a00001a3 F 0x00066a00a00001dc F 0x00066a00a000035a F 0x0011750000ffd5c2 F 0x0011750000ffd664 F 0x0011750000ffd9c2 F 0x0011750000ffd9f8 F 0x0011750000ffd5b9 F 0x0011750000ffda4a F 0x0011750000ffd5bb F 0x0011750000ffd9de F smShowServices None.

Groups and Commands 1-64 D000103-000 E Sample Output: NOTES: The components(fields) of each service record are displayed. Each service record is stored in a location identified by a 'Slot' number which is displayed before any component of that Service Record. If a group of slots do not contain Service Records, the first slot of the empty group is displayed as 'empty'. This command is not available unless the subnet manager is in the Master mode. smShowSubscriptions Display event forwarding (subscription) table in the embedded subnet manager. Syntax: Options: -> smShowServices ****************************************************************** There is 1 Service Records ********************************************************* Service ID = 0x1100D03C34834444 Service GID = 0xFE80000000000000:00066A000600013C Service P_Key = 0x0000 Service Lease = infinite Service Key = 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Service Name = QLogic Fabric Executive service Rev 1.1 Service Data 8 = 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Service Data 16 = 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 0x0000 Service Data 32 = 0x0000 0x0000 0x0000 0x0000 Service Data 64 = 0x0000000000000000 0x0000000000000000 Service Expire Time = 0x0100000000000000 smShowSubscriptions None.

Groups and Commands D000103-000 E 1-65 Sample Output: NOTES: Use this command to display the event forwarding (subscription) table in the subnet manager. This command is not available unless the subnet manager is in the Master mode. smMasterLMC Display the LMC value of the subnet manager to be used on CA ports. Syntax: Options: -> smShowSubscriptions ****************************************************************** There are 2 subscriptions ****************************************************************** Subscriber GID = 0xFE80000000000000:00066A00D8000163 Subscriber LID = 0x0071 Subscriber PKey = 0xFFFF Subscriber Start LID = 0x0001 Subscriber End LID = 0xBFFF Subscriber Record ID = 0x00000001 Subscriber Inform Info = GID = 0x0000000000000000:0000000000000000 Start LID = 0xFFFF End LID = 0x0000 Is Generic? = Yes Subscribe? = Subscribe Type = All Types Trap Number = 0x0040 Queue Pair Number = 0x000001 Response Time Value = 19 Producer Type = Subnet Management ****************************************************************** Subscriber GID = 0xFE80000000000000:00066A01A0007116 Subscriber LID = 0x0007 Subscriber PKey = 0xFFFF Subscriber Start LID = 0x0001 Subscriber End LID = 0xBFFF Subscriber Record ID = 0x00000036 Subscriber Inform Info = GID = 0x0000000000000000:0000000000000000 Start LID = 0xFFFF End LID = 0x0000 Is Generic? = Yes Subscribe? = Subscribe Type = All Types Trap Number = 0x0043 Queue Pair Number = 0x000001 Response Time Value = 18 Producer Type = Channel Adapter ****************************************************************** There are 2 subscriptions smMasterLMC None.

Groups and Commands 1-66 D000103-000 E Sample Output: NOTES: The value of the LMC determines how many LID's are assigned to an endport; 2 LMC LIDs are assigned to endports based on this value. For example, setting the LMC to a value of 3 will assign 8 LIDs per endport. The allowable LMC values are between 0 and 7, inclusive. The subnet manager must be running as MASTER to display the LMC value. smShowMasterLid Display the LID of the subnet manager. Syntax: Options: Sample Output: NOTE: Use this command to display the LID of the master subnet manager. smShowLidMap Display the LID-to-port GUID map for the subnet manager. Syntax: Options: -> smMasterLMC smShowMasterLid None. -> smShowMasterLid The SM LID is 0x0001 smShowLidMap None.

Groups and Commands D000103-000 E 1-67 Sample Output: NOTES: Use this command to display the LID-to-port GUID map of the subnet manager. This command is not available unless the subnet manager is in the Master mode. smShowMaxLid Display the highest LID allocated by the subnet manager. Syntax: Options: Sample Output: NOTES: Use this command to display the highest LID allocated by the subnet manager. This command is not available unless the subnet manager is in the Master mode. smSwitchLifetime Allows the user to display/dynamically set the default switch lifetime of the subnet manager. Syntax: -> smShowLidMap ---------------------------------------------------------------------------------- SM is currently in the MASTER state, with Topology Pass count = 341 ---------------------------------------------------------------------------------- Lid 0x0001: guid = 0x00066a000600013c, pass = 341, QLogic 12300 GUID=0x00066a00da000100 172.26.2.2 Spine 1, Ch Lid 0x0002: guid = 0x00066a0007000170, pass = 341, QLogic 12300 GUID=0x00066a00da000100 172.26.2.2 Leaf 4, Chi Lid 0x0003: guid = 0x00066a100600013c, pass = 341, QLogic 12300 GUID=0x00066a00da000100 172.26.2.2 Spine 1, Ch Lid 0x0006: guid = 0x00066a00a0000248, pass = 229 Lid 0x0007: guid = 0x00066a01a0007116, pass = 341, st149 Lid 0x0008: guid = 0x0000000000000000, pass = 0 Lid 0x0028: guid = 0x0000000000000000, pass = 0 Lid 0x002a: guid = 0x0000000000000000, pass = 0 smShowMaxLid None. -> smShowMaxLid The maximum LID is 0x0138 smSwitchLifetime [lifetime}

Groups and Commands 1-68 D000103-000 E Options: Sample Output: NOTES: The switch lifetime value determines the maximum time a packet may remain within a switch, calculated using the formula: 4.096 * (2 switchlifetime) in microseconds. The packet lifetime values may be between 0 and 31, inclusive. The subnet manager must be running to display or dynamically set the default switch lifetime. Changes will only affect the SM that is currently running and will not be persistent. smHoqLife Display or dynamically set the head of queue packet lifetime for switch ports. Syntax: Options: Sample Output: NOTES: Use this command to display the maximum lifetime that a packet may remain at the head of a virtual lane transmission queue before it is discarded by a switch. Packet lifetime values are between 0 and 31, inclusive. These are calculated using the formula: 4.096 * (2 ^ switchlifetime) in microseconds. The subnet manager must be running to display, or to dynamically set the Hoq lifetime. Changes to Hoq lifetime set with the smHoqLife command only affect the currently running SM and will not be persistent. lifetime The packet lifetime value between 0 and 31, inclusive. -> smSwitchLifetime 15 SM switch packet lifetime: 15 (~134217 microseconds) smHoqLife [lifetime] lifetime The packet lifetime value between 0 and 31, inclusive. -> smHoqLife 9 SM HOQ Liftime: 9 (~2097 microseconds)

Groups and Commands D000103-000 E 1-69 smVLStall Allows the user to display/dynamically set the VL stall value of the subnet manager. Syntax: Options: Sample Output: NOTES: Use this command to set the VL stall value for ports in the fabric. This value determines the how quickly a virtual lane for a particular switch or endport enters a 'stalled' state after dropping packets. The subnet manager must be running to display or to dynamically set VLStall. Changes to VLStall with the smVLStall command only affect the currently-running subnet manager and will not be persistent. smShowSMParms Display subnet manager parameters switch lifetime, HOQ lifetime, VLStall val, pkt lifetime, and dynamic PLT. Syntax: Options: smVLStall [packets] packets The number of sequential packets dropped before port enters VL stalled state. -> smVLStall 5 SM VL Stall Threshhold: 5 packets smShowSMParms None.

Groups and Commands 1-70 D000103-000 E Sample Output: NOTES: Use this command to display a sampling of subnet manager parameters. smPKeys Configure a partition key (PKey) in the PKey table. Syntax: Options: Sample Output: NOTES: PKeys are used for partitioning the subnet. Only configure PKeys if the host driver supports this. Invalid configuration of the PKey may render the fabric inoperable. The subnet manager must be running to display PKeys. smInfoKey Set the subnet manager key (SMInfo) value. Syntax: Options: -> smShowSMParms SM priority is set to 4 SM LMC is set to 0 SM sweep rate is set to 300 SM max retries on receive set to 3 SM max receive wait interval set to 250 millisecs switchLifetime set to 15 HoqLife set to 9 VL Stall set to 5 packetLifetime constant is set to 18 Dynamic PLT ON using values: 1 hop=16, 2 hops=17, 3 hops=17, 4 hops=18, 5 hops=18, 6 hops=18, 7 hops=18, 8+hops=19 SM DBSync interval set to 900 SM topology errors threshold set to 0, max retry to 3 smPKeys None. -> smPKeys smInfoKey None.

Groups and Commands D000103-000 E 1-71 Sample Output: NOTES: Use this command to set the SM key. SM must be offline and key value is up to 8 byte hex. The subnet manager must be running to display the SMInfo key value. smMgmtKey Set the subnet manager management key (portInfo) value. Syntax: Options: Sample Output: NOTES: Use this command to set the SM management key. SM must be offline and mkey value is up to 8 byte hex. The subnet manager must be running to display the SMInfo key value. smOptionConfig Use this command to configure support for non-default modes of operation. Syntax: -> smInfoKey SM Key: 0x0000000000000001 (1 decimal). smMgmtKey None. -> smMgmtKey 0x11 SM management key: 0x0000000000000011 (17 decimal) smOptionConfig [clear | default | [def-mcgrp-create] [dyn-plt]]

Groups and Commands 1-72 D000103-000 E Options: Sample Output: NOTES: The subnet manager must be running to display the non-default modes of operation. smDefBcGroup Displays the default multicast group configuration. Syntax: Options: Sample Output: NOTES: The subnet manager must be running to display default multicast group information. „ Valid MTU values are 1(256), 2(512), 3(1024), 4(2048), and 5(4096) „ Valid RATE values are 2(2.5GB), 3(10GB), 4(30GB), 5(5GB), 6(20GB), 7(40GB), 8(60GB), 9(80GB), 10(120GB) „ Valid Values for SL are 0 to 0xF „ Valid Values for QKEY are 0 to 0xFFFFFFFF „ Valid Values for FlowLabel are 0 to 0xFFFFF clear Clears all set options. default Enable the default set of options (i.e., def-mcgrp-create and dyn-pit). def-mcgrp-create Auto create default multicast group. If using only this option, dyn-pit will be disabled. dyn-pit Enable dynamic packet lifetimes for pathrecord queries. If using only this option, def-mcgrp-create will be disabled. -> smOptionConfig dyn-plt [dyn-plt] Dynamic packet lifetime support is enabled smDefBcGroup None. -> smDefBcGroup

Groups and Commands D000103-000 E 1-73 „ Valid Values for TClass are 0 to 0xff smGidPrefix Set the Subnet Prefix (default=0xfe80000000000000). Syntax: Options: Sample Output: NOTES: Use this command to set the subnet prefix of the SM. The SM must be offline and the subnet prefix value is 8 byte hex. The subnet manager must be running to display default multicast group information. smSubnetSize Set/display the subnet size for the subnet manager. Syntax: Options: Sample Output: NOTES: Use this command to tune the SM to handle the configured fabric size. The subnet manager must be running to display subnet size information. smTopoErrorThresh Set/display the error threshold for a topology sweep. Syntax: smGidPrefix [prefix] None. -> smGidPrefix Subnet Prefix: 0xfe80000000000001 smSetSubnetSize None. -> smSubnetSize smTopoErrorThresh

Groups and Commands 1-74 D000103-000 E Options: Sample Output: NOTES: Sets the maximum number of errors the SM may encounter during a sweep before abandoning the sweep. The subnet manager must be running to display the error threshold for a topology sweep. smTopoAbandonThresh Set/display the max consecutive times the SM can abandon a sweep due to too many errors. Syntax: Options: Sample Output: NOTES: The subnet manager must be running to display this information. smMaxRetries Displays the maximum number of subnet manager receive retries Syntax: Options: None. -> smTopoErrorThresh 100 Set topology error threshold to:100 smTopoAbandonThresh None. -> smTopoAbandonThresh 3 Set topology sweep abandonment threshold to:3 smMaxRetries None.

Groups and Commands D000103-000 E 1-75 Sample Output: NOTES: The subnet manager must be running to display this information. smRcvWaitTime Displays the maximum time (in milliseconds) to wait for a reply to a subnet manager packet. Syntax: Options: Sample Output: NOTES: The subnet manager must be running to display this information. smNonRespDropTime Displays the seconds to wait before dropping a non-responsive node. Syntax: Options: Sample Output: -> smMaxRetries 3 Set max retries to:3 -> smMaxRetries Max retries: 3 smRcvWaitTime None. -> smRcvWaitTime 250 Set recieve wait time to: 250 milliseconds -> smRcvWaitTime Recieve wait time: 250 milliseconds smNonRespDropTime None. -> smNonRespDropTime 300 Set Nonresponsive node drop time to: 300 seconds -> smNonRespDropTime Non-responsive node drop time: 300 seconds

Groups and Commands 1-76 D000103-000 E NOTES: The subnet manager must be running to display this information. smNonRespDropSweeps Displays the sweeps to wait before dropping a non-responsive node. Syntax: Options: Sample Output: NOTES: The subnet manager must be running to display this information. smLogLevel Displays or dynamically sets the Subnet Manager logging level. Syntax: Options: Sample Output: NOTES: Levels: 1=WARN+, 2=INFINI_INFO+, 3=INFO+, 4=VERBOSE+, 5=DEBUG2+, 6=DEBUG3+, 7=TRACE+. The subnet manager (SM) must be running to use this command. Changes made with this command will only affect the currently running SM, and will be forgotten if the FM is restarted or the chassis is rebooted. To make persistent changes edit the FM XML configuration file. smNonRespDropSweeps None. -> smNonRespDropSweeps 3 Set Nonresponsive node drop sweeps to: 3 sweeps -> smNonRespDropSweeps Non-responsive node drop sweeps: 3 sweeps smLogLevel [] loglevel logging level 1-7 -> smLogLevel 4

Groups and Commands D000103-000 E 1-77 smLogMode Displays or dynamically sets the Subnet Manager logging mode. Syntax: Options: Sample Output: NOTES: 0 - use normal logging levels 1 - logging is quieted by downgrading the majority of fatal, error, warn and infiniinfo log messages to level 3 (INFO) and only outputting user actionable events when LogLevel is 1 or 2. The Subnet manager must be running to use this command. Changes made with this command will only affect the currently running SM, and will will be forgotten if the FM is restarted or the chassis is rebooted. To make persistent changes edit the FM XML config file. smLogMask Displays or dynamically sets the Subnet Manager logging mask for a specific subsystem. Syntax: Options: Sample Output: smLogMode [] logmode logging mode 0 or 1 -> smLogMode 1 smLogMask [] subsystem The Fabric Manager (FM) subsystem. mask The bit mask needed for logging to enable. -> smLogMask SM

Groups and Commands 1-78 D000103-000 E NOTES: Subsystems: CS, MAI, CAL, DVR, IF3, SM, SA, PM, PA, BM, FE, APP The Subnet manager must be running to use this command. Changes made with this command will only affect the currently running SM, and will will be forgotten if the FM is restarted or the chassis is rebooted. To make persistent changes edit the FM XML config file. smMcLidTableCap Displays the limit of the multicast LIDs that are available for allocation. Syntax: Options: Sample Output: NOTES: Setting this value to zero disables limiting multicast LIDs. The subnet manager must be running to display this information. smMcLidTableCap None. -> smMcLidTableCap 1024 Set mc lid limit to 1024 -> smMcLidTableCap Mc lid limit: 1024

Groups and Commands D000103-000 E 1-79 smMasterPingInterval Displays the ping interval (in seconds) of the subnet manager. Syntax: Options: Sample Output: NOTES: Value must be between 3 and 10. The subnet manager must be running to display this information. smMasterPingFailures Displays the number of allowable master ping failures. Syntax: Options: Sample Output: NOTES: Value must be between 2 and 5. The subnet manager must be running to display this information. smMasterPingInterval None. -> smMasterPingInterval 4 Set master ping interval to 3 seconds -> smMasterPingInterval Master ping interval: 4 seconds smMasterPingFailures None. -> smMasterPingFailures 3 Set master ping failures to 3 failures -> smMasterPingFailures Master ping failures: 3 failures

Groups and Commands 1-80 D000103-000 E smDbSyncInterval Displays how often a Master subnet manager should perform a full synchronization with the standby subnet manager(s). Syntax: Options: Sample Output: NOTES: Value must be between 0 and 60 minutes (0=OFF). The subnet manager must be running to display this information. smDbSyncInterval None. -> smDbSyncInterval SM DB full sync interval currently set to 15 minutes -----SM DB SYNCHRONIZATION interval set to 900 seconds, 2 SM(s) in fabric----- MASTER SM node at QLogic 12300 GUID=0x00066a00d90003fa, LID 0x0008, PortGuid 0x00066a00d90003fa Sync Capability is SUPPORTED STANDBY SM node at st44, LID 0x0100, PortGuid 0x00066a00a0000357 Sync Capability is SUPPORTED Full sync status is SYNCHRONIZED Time of last Full sync is THU APR 10 15:37:47 2008 Time of last INFORM records sync is THU APR 10 15:37:47 2008 Time of last GROUP records sync is THU APR 10 15:37:47 2008 Time of last SERVICE records sync is THU APR 10 15:37:47 2008

Groups and Commands D000103-000 E 1-81 smDynamicPlt Set/display dynamic packet lifetime values. Syntax: Options: Sample Output: NOTES: Setting values to numbers greater than 19 give an effectively-infinite packet lifetime. The subnet manager must be running to display dynamic packet lifetime values. smDynamicPlt [index] [plt] index The index of the entry in the table to be changed. Range is 1-9.. plt The packet lifetime value. The range is 0-63. -> smDynamicPlt Index: 1 PLT Value: 16 (~268435 usec) Index: 2 PLT Value: 17 (~536870 usec) Index: 3 PLT Value: 17 (~536870 usec) Index: 4 PLT Value: 18 (~1073741 usec) Index: 5 PLT Value: 18 (~1073741 usec) Index: 6 PLT Value: 18 (~1073741 usec) Index: 7 PLT Value: 18 (~1073741 usec) Index: 8 PLT Value: 19 (~2147483 usec) Index: 9 PLT Value: 19 (~2147483 usec) Dynamic packet lifetime values for pathrecord queries are enabled (use the smOptionConfig command to change) -> smDynamicPlt 1 15 Index: 1 PLT Value: 15 (~134217 usec) Index: 2 PLT Value: 17 (~536870 usec) Index: 3 PLT Value: 17 (~536870 usec) Index: 4 PLT Value: 18 (~1073741 usec) Index: 5 PLT Value: 18 (~1073741 usec) Index: 6 PLT Value: 18 (~1073741 usec) Index: 7 PLT Value: 18 (~1073741 usec) Index: 8 PLT Value: 19 (~2147483 usec) Index: 9 PLT Value: 19 (~2147483 usec) Dynamic packet lifetime values for pathrecord queries are enabled (use the smOptionConfig command to change)

Groups and Commands 1-82 D000103-000 E sm1xLinkMode Displays how the subnet manager handles 1x links. Syntax: Options: Sample Output: NOTES: When set to 'off', all links come up normally. When set to 'ignore', links that only come up at 1x (when they were enabled for a higher rate) are forced down. These downed ports can be queried to aid debugging errors in the fabric. The subnet manager must be running to display this information. smTrapThreshold Display the port auto-disable urgent trap threshold value (in minutes). Syntax: Options: Sample Output: NOTES: When enabled, ports generating urgent traps at a rate higher than the threshold will be disabled. This value can range from 10 to 100 traps/minute. Set sm1xLinkMode None. -> sm1xLinkMode Mode is 'off'. Erroneous 1x links will be activated normally. -> sm1xLinkMode ignore -> sm1xLinkMode Mode is 'ignore'. Erroneous 1x links will not be activated. smTrapThreshold None. -> smTrapThreshold Trap Threshold is 0 (disabled). -> smTrapThreshold 20 -> smTrapThreshold Trap Threshold is 20 traps/minute.

Groups and Commands D000103-000 E 1-83 the value to 0 to disable this feature. The subnet manager must be running to display this information. smAppearanceMsgThresh Displays the threshold for appearance and disappearance messages. Syntax: Options: Sample Output: NOTES: This command sets the threshold for the number of fabric appearance and disappearance log messages that may be logged as NOTICEs per sweep by the SM. A value of zero causes all such messages to be logged at the NOTICE level. A value greater than zero will cause the priority of any subsequent messages to be logged at the INFO priority. The subnet manager must be running to display this information. smPmBmStart Allows the user to set/display whether performance manager and baseboard manager starts along with the subnet manager. Syntax: Options: smAppearanceMsgThresh None. -> smAppearanceMsgThresh Message Threshold is 0 (disabled). -> smAppearanceMsgThresh 3 -> smAppearanceMsgThresh Message Threshold is 3 messages/sweep. smPmBmStart [enable] [disable] enable Enable the start of the PM and BM at SM start-up. disable Disable the start of the PM and BM at SM start-up.

Groups and Commands 1-84 D000103-000 E Sample Output: smShowRemovedPorts Displays the ports that have been automatically removed from the fabric.. Syntax: Options: Sample Output: NOTES: This displays ports that have been removed from the fabric automatically by the SM, such as when a 1x link mode is set to 'ignore' or when a port has exceeded its urgent trap threshold. This command is not available unless the subnet manager is in Master mode. smShowCounters Display various statistics and counters maintained by the subnet manager. Syntax: Options: -> smPmBmStart SM is enabled PM is enabled BM is enabled FE is enabled -> smPmBmStart disable SM is enabled PM is disabled BM is disabled FE is enabled smShowRemovedPorts None. -> smShowRemovedPorts Disabled Ports: Node 0x00066a0007000001: QLgoic 12300 GUID=0x00066a00da000001 Leaf 1, Chip A Port 12: Trap Threshold Exceeded Port 23: 1x Link Width smShowCounters None.

Groups and Commands D000103-000 E 1-85 Sample Output: NOTES: This command is not available unless the subnet manager is in Master mode. smResetCounters Resets various statistics and counters maintained by the subnet manager. Syntax: Options: Sample Output: pmShowCounters Displays various statistics and counters about the performance manager (PM). Syntax: -> smShowCounters COUNTER: THIS SWEEP LAST SWEEP TOTAL ------------------------------------ ---------- ---------- ---------- SM State transition to DISCOVERY: 0 0 2 SM State transition to MASTER: 0 0 1 SM State transition to STANDBY: 0 0 1 SM State transition to INACTIVE: 0 0 0 Total transmitted SMA Packets: 123 711 2181 Direct Routed SMA Packets: 123 711 2122 LID Routed SMA Packets: 0 0 40 SMA Query Retransmits: 0 0 18 SMA Query Retransmits Exhausted: 0 0 3 SM TX GET(Notice): 0 0 0 SM TX SET(Notice): 0 0 0 SM RX TRAP(Notice): 0 0 0 SM TX TRAPREPRESS(Notice): 0 0 0 SM TX GET(NodeDescription): 0 148 444 SM TX GET(NodeInfo): 0 148 444 SM TX GET(SwitchInfo): 0 6 18 ... smResetCounters None. -> smResetCounters pmShowCounters

Groups and Commands 1-86 D000103-000 E Options: Sample Output: pmResetCounters Resets various statistics and counters about the performance manager (PM). Syntax: Options: Sample Output: pmShowRunningTotals Displays Running Total Counters for the performance manager (PM) for all ports in a fabric. Syntax: Options: Sample Output: bmPriority Display the priority of the embedded baseboard manager. Syntax: None. -> pmShowCounters pmResetCounters None. -> pmResetCounters pmShowRunningTotals None. -> pmShowRunningTotals bmPriority

Groups and Commands D000103-000 E 1-87 Options: Sample Output: NOTES: The priority of the Baseboard Manager (BM) determines which BM will become the master BM for the fabric. The priority values are 0 (lowest) and 15 (highest). The BM with the highest priority becomes the master BM for the fabric. The elevated priority value determines what the priority of the BM will be if it becomes Master. This allows persistent failovers that do not automatically fail back by configuring the elevated priority to be higher than all normal priorities. This feature is effectively disabled when set to the default of zero. The subnet manager must be running to display the priority. pmPriority Display the priority of the embedded performane manager. Syntax: Options: Sample Output: NOTES: The priority of the Performance Manager(PM) determines which PM will become the master PM for the fabric. The priority values are 0 (lowest) and 15 (highest). The PM with the highest priority becomes the master PM for the fabric. The elevated priority value determines what the priority of the PM will be if it becomes Master. This allows persistent failovers that do not automatically fail back by configuring the elevated priority to be higher than all normal priorities. This feature is effectively disabled when set to the default of zero. The subnet manager must be running to display the priority. None. -> bmPriority The BM Priority is 0 The BM Elevated Priority is disabled pmPriority None. -> pmPriority The PM Priority is 0 The PM Elevated Priority is disabled

Groups and Commands 1-88 D000103-000 E smRestorePriority Restore normal priorities from elevated states for the SM, BM, and PM. Syntax: Options: Sample Output: NOTES: This command restores the normal priorities of various subnet managers after they have elevated their priority following a failover. Issuing this command allows the 'unsticking' of a sticky failover. Issuing this command without arguments will restore the normal priorities of the SM, BM, and PM. smResetConfig Resets the XML configuration for the embedded subnet manager (ESM) to factory defaults. This command is only available on the Master chassis management card. Syntax: Options: Sample Output: smRestorePriority [sm | bm | pm | all] sm Restore normal SM priority bm Restore normal BM priority pm Restore normal PM priority all Restore normal priorities for the SM, BM and PM. -> smRestorePriority smResetConfig [-noprompt] -noprompt proceed with a configuration reset without a confirmation prompt. -> smResetConfig Proceed with configuration reset? [N] y Default XML configuration file has been generated.

Groups and Commands D000103-000 E 1-89 smShowConfig Displays the XML configuration file. Syntax: Options: Sample Output: NOTES: With no arguments, the XML configuration file timestamp and contents will be displayed, one screen at a time. Enter Y or Enter at the prompt to continue displaying command output. Enter N at the prompt to terminate the output. The -infoOnly and -contentOnly flags will limit the information displayed. Use the smShowConfig [-infoOnly | -contentOnly] [-noprompt] -infoOnly Displays the timestamp for the XML configuration file. -contentOnly Displays the contents of the XML configuration file. -noprompt Do not prompt to 'Continue' for each page of displayed output. -> smShowConfig Continue? [Y] ...

Groups and Commands 1-90 D000103-000 E -noprompt flag to send all output to the screen at once.This command is only available on the Master Chassis management card.

Groups and Commands D000103-000 E 1-91 Log logShow Displays the log file. Syntax: Options: Sample Output: NOTES: This command displays the log file that is contained in RAM. logShow None. -> logshow W|2006/10/04 20:26:31.176U: Thread "Log" (0x8fdab3b0) Log: Unable to Send Trap: 523:Bad:65535 W|2006/10/04 20:26:31.176U: Thread "CPU1" (0x1) Fcpi: Target Device 1 (2e7 p1) NPort Id 0x0106d1: Connection Restored W|2006/10/04 20:26:31.196U: Thread "Log" (0x8fdab3b0) Log: Unable to Send Trap: 523:Bad:65535 W|2006/10/04 20:26:31.216U: Thread "CPU1" (0x1) Fcpi: Target Device 2 (b31 p2) NPort Id 0x0106d2: Connection Restored W|2006/10/04 20:26:31.236U: Thread "CPU1" (0x1) Fcpi: Target Device 3 (d94 p3) NPort Id 0x0106d3: Connection Restored W|2006/10/04 20:26:31.246U: Thread "Log" (0x8fdab3b0) Log: Unable to Send Trap: 523:Bad:65535 W|2006/10/04 20:26:31.256U: Thread "CPU1" (0x1) Fcpi: Target Device 6 (ac6 p6) NPort Id 0x0106d6: Connection Restored W|2006/10/04 20:26:31.276U: Thread "Log" (0x8fdab3b0) Log: Unable to Send Trap: 523:Bad:65535 W|2006/10/04 20:26:31.326U: Thread "Log" (0x8fdab3b0) Log: Unable to Send Trap: 523:Bad:65535 W|2006/10/04 20:28:29.912U: Thread "tTelnetd" (0x8fe143e0) Osa: telnetd: connection requested by 192.168.0.107 W|2006/10/04 20:46:26.113U: Thread "tTelnetd" (0x8fe143e0) Osa: telnetd: connection requested by 192.168.0.107 W|2006/10/05 19:37:08.727U: Thread "tTelnetd" (0x8fe143e0) Osa: telnetd: connection requested by 192.168.0.46 W|2006/10/05 20:19:20.101U: Thread "tTelnetd" (0x8fe143e0)

Groups and Commands 1-92 D000103-000 E logClear Clears the log file. Syntax: Options: Sample Output: NOTES: This command deletes all entries in the log file. logConfigure Configures the log settings. Syntax: Options: logClear [-noprompt] -noprompt delete all log messages without prompting the user -> logClear Ram Log cleared logConfigure None.