SilverStorm 9000 CLI Reference Guide D000025-002 Rev.
S 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.
Table of Contents 1 Introduction Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contact Information . . . . . . . . . . . . . . . . . .
SilverStorm 9000 CLI Reference Guide S Linecard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FibreChannel . . . . . . . . . . . . . . . . . . . .
1 Introduction This manual describes the command line interface (CLI) task information for the SilverStorm™ 9024 and Silverstom Multi-Protocol Fabric Director (MPFD) family of switches. This manual is organized as follows: Section 1 describes the intended audience and technical support. Section 2 describes the 9000 switch CLI commands. Section 3 describes all the Virtual I/O (EVIC and FVIC) CLI commands.
S 1 – Introduction Technical Support Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch 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.
2 Switch Command Line Interface Overview This section details the usage of the Command Line Interface (CLI) feature for the SilverStorm 9000 family of switches: The SilverStorm 9024 The SilverStorm 9000 Multi-protocol Fabric Director (MPFD) Series: SilverStorm 9020 SilverStorm 9040 SilverStorm 9080 SilverStorm 9120 SilverStorm 9240 The CLI allows the user to perform remote configuration and management tasks, which in many respects mirrors the functionality of the Chassis Viewer
S 2 – Switch Command Line Interface Commands and Functional Groups 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.
A 2 – Switch Command Line Interface Commands and Functional Groups 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.
S 2 – Switch Command Line Interface Online Help 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.
A 2 – Switch Command Line Interface Groups and Commands 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 The following section lists all CLI functional groups along with the commands for each group. Commands for all 9000 switches are listed.
S 2 – Switch Command Line Interface Groups and Commands Sample Output: -> 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. NOTES: General Help Type list or ? for the list of commands. To get help on a particular command type: commandname help.
A 2 – Switch Command Line Interface Groups and Commands Options: 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. Sample Output: 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.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> history command history [30 max lines]: list Deprecated Network Firmware Log IbSwitchInfo TimeManagement Snmp Ethernet help list history reboot Reboots the device. Syntax: reboot [now][-m][slot n][-s][-n][all] Options: now Does not prompt the user before rebooting. -m Reboot Master (local) Spine 1 (non-disruptive). slot n reset specific device where n = slotNumber (disruptive). -s Reboot Slave (remote) Spine 2.
A 2 – Switch Command Line Interface Groups and Commands NOTES: You may reboot the local (Master) Spine or the remote (Slave) Spine with one or multiple arguments. Non-disruptive arguments will not interfere with switch traffic. Providing the argument all performs disruptive reboot of all present Spines 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.
2 – Switch Command Line Interface Groups and Commands S Sample Output: 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 NOTES: Displays a list of currently active CLI sessions.
A 2 – Switch Command Line Interface Groups and Commands swapBsDel Swaps the backspace and delete character key bindings. Syntax: swapBsDel Options: None. Sample Output: -> swapBsDel 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.
2 – Switch Command Line Interface Groups and Commands S getTermWidth Displays the terminal width for text formatting purposes. Syntax: getTermWidth Options: None. Sample Output: -> getTermWidth Current terminal width: 80 characters. 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: prompt str Options: str The new prompt.
A 2 – Switch Command Line Interface Groups and Commands case Display or change the case sensitivity for the command interpreter for the CLI session. Syntax: case [off | on] Options: off | on Turn case sensitivity off or on. Sample Output: -> case off Case sensitivity is now off NOTES: This displays or changes the case sensitivity for the command interpreter for the CLI session.
2 – Switch Command Line Interface Groups and Commands S echo Echoes text back to the output.. Syntax: echo [ ...] Options: [ ...] Text to be echoed.. Sample Output: MasterSpine1-> echo test test 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: rlogin [hostName] Options: hostName The name of the device to connect to.
A 2 – Switch Command Line Interface Groups and Commands rcmd Creates I/O terminal to local cards. Syntax: rcmd [hostName] Options: hostName The name of the device to connect. Sample Output: -> rcmd Host1 NOTES: This command allows users to open a terminal to local I/O devices within the chassis/hemisphere. The command rcmd is an alias of rlogin. See also hostShow. resetCard Reboot a specific slot in the chassis. Syntax: resetCard n [now] Options: n Chassis slot number.
2 – Switch Command Line Interface Groups and Commands S Options: None. Sample Output: logout user Change user accounts. Syntax: user [user] Options: [user] Name of user account to change to. Sample Output: -> user operator User changed to: operator NOTES: Use this command to change to the 'operator' account, or to the 'admin' account. passwd Change users password(s). Syntax: passwd [username] Options: [username] Name of the user whose password needs to be changed.
A 2 – Switch Command Line Interface Groups and Commands userAdd Add a user account. Syntax: userAdd [role] [username] [password] Options: [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. Sample Output: -> userAdd admin Bob User added: Bob Password is set to the default password for this role: admin userRem Remove a user account.
S 2 – Switch Command Line Interface Groups and Commands Options: None. Sample Output: -> userListShow username operator1 USERID Bob role operator admin admin sshKey Syntax: sshKey [-u ] [] Options: 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.
A 2 – Switch Command Line Interface Groups and Commands loginMode Allows the user to change the user interface authentication requirements. Syntax: loginMode [mode] Options: [mode] Determines how users are able to login. Sample Output: -> loginMode 1 Mode successfully changed to: 1 = Password is not required 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.
2 – Switch Command Line Interface Groups and Commands S NOTES: This sets the ldap server ip address. The ldap server will be contacted for remote authentication. setldapSvrPort Modify the LDAP Server Port. Syntax: setldapSvrPort [port] Options: [port] The port of the LDAP server to be authenticated. Sample Output: -> setldapSvrPort 389 NOTES: Sets the LDAP server port. The LDAP server will be contacted for remote authentication. idleTimeoutGet Retrieves the UI idle timeout value.
A 2 – Switch Command Line Interface Groups and Commands idleTimeoutSet Set the UI idle timeout value. Syntax: idleTimeoutSet [--all | --cli | --gui] seconds] Options: [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. Sample Output: -> idleTimeoutSet --all 700 Timeout is set to 700 seconds.
2 – Switch Command Line Interface Groups and Commands S sessionTimeoutEnable Enable the idle timeout for the CLI session. Syntax: sessionTimeoutEnable Options: None. Sample Output: -> sessionTimeoutEnable Enabled session idle timeout. 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.
A 2 – Switch Command Line Interface Groups and Commands Options: [message] The login message (should be encapsulated in quotes “ “). Sample Output: -> loginMsgSet "Be certain to logout when you are finished using the CLI." Welcome message set successfully 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.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> loginNameSet Switch1 login-name set successfully 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. serialAuthGet Displays the current serial authentication status. Syntax: serialAuthGet Options: None. Sample Output: -> serialAuthGet Serial authentication is currently disabled.
A 2 – Switch Command Line Interface Groups and Commands uiConfig View or configure the user interfaces to this device. Syntax: uiConfig [-telnet 0|1] [-https 0|1] [-http 0|1] [-ftp 0|1] [-snmp 0|1] Options: [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. Sample Output: -> uiconfig -telnet 0 Successfully modified configuration.
2 – Switch Command Line Interface Groups and Commands S IpoIbConfigShow (9000 MPFD only) Displays the IpoIb Enable/Disable setting. Syntax: IpoIbConfigShow Options: None. Sample Output: -> IpoIbConfigShow IpoIbConfigEnable (9000 MPFD only) Enable IpoIb feature. Syntax: IpoIbConfigEnable <- IpoIb enable> Options: [- IpoIb enable] Sample Output: -> IpoIbConfigEnable - IpoIb enable NOTES: Only allowed trasition at run time is from disable to enable, by default it is disabled.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> IpoIbAddressShow IpoIbAddressSet (9000 MPFD only) Change the IpoIb IP address and associated network mask. Syntax: IpoIbAddressSet -h ipaddress -m netMask Options: [-h ipaddress] the new IP address in dotted notation format 'xxx.xxx.xxx.xxx'. [-m netMask] network mask. (in hexidecimal format). Sample Output: -> IpoIbAddressSet -h 123.45.6.789 exit Exit the CLI. Syntax: exit Options: None. Sample Output: exit D000025-002 Rev.
2 – Switch Command Line Interface Groups and Commands S Chassis hwCheck Runs a system check at the chassis level and returns current hardware status. Syntax: hwCheck Options: [n - 0=default, 1=verbose] Sample Output: MasterSpine1-> hwCheck Chassis hardware status: GOOD NOTES: Returns OK or provides detailed status/warning/error information. If an error/warning is detected, this command automatically provides verbose information.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> hwMonitor 0 [2J[0;0H [7mSystem monitor, Uptime: 1 days 23 hours, 33 minutes[27m PS1 Fan Speed: [5m -1 RPM[0m PS2 Fan Speed: [5m -1 RPM[0m PS3 Fan Speed: [5m -1 RPM[0m PS4 Fan Speed: 9642 RPM[0m PS5 Fan Speed: 9642 RPM[0m PS6 Fan Speed: 9507 RPM[0m FT1 Fan Speeds: 8940 RPM[0m 8820 RPM[0m FT2 Fan Speeds: 9120 RPM[0m 8880 RPM[0m FT3 Fan Speeds: 9060 RPM[0m 8700 RPM[0m FT4 Fan Speeds: 8640 RPM[0m 8760 RPM[0m Device T1 T2 A1 A2 1.2V 1.
2 – Switch Command Line Interface Groups and Commands S Options: None. Sample Output: -> setIBNodeDesc "SilverStorm 9080 GUID=0x00066a00da000" IB Node (SMA) Description successfully changed to = SilverStorm 9080 NOTES: New node name must be enclosed in quotes. Node name must be less than 128 characters. setIBNodeDescFormat Changes the IB Node (SMA) description format modifier. Syntax: setIBNodeDescFormat [format] Options: None.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> fruInfo Display chassis info xInfo_ChassisInfo: RecType: 1LastRec: 0LenMult: 0 ReadOnly: 1RecordFormat: 2RecLen: 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 inter
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> chassisQuery slots: 2 4 8 101 102 -> chassisQuery 101 -showType type: InfinIO9000.t3 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: showInventory Options: None.
A 2 – Switch Command Line Interface Groups and Commands Network ifShow Displays information for all the network interfaces for the switch, including the management port and the internal Ethernet network. Syntax: ifShow [ifName] Options: [ifName] The network interface name. Sample Output: -> ifShow lo2 (unit number 0): Flags: (0x8069) UP LOOPBACK MULTICAST ARP RUNNING Type: SOFTWARE_LOOPBACK Internet address: 127.0.0.
2 – Switch Command Line Interface Groups and Commands S 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: routeShow Options: None.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: 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.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> setChassisIpAddr -h 172.26.0.221 -m 255.255.240.0 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. showDefaultRoute Displays the default gateway IP address. Syntax: showDefaultRoute Options: None. Sample Output: -> showDefaultRoute Gateway IP Address: 172.26.0.
A 2 – Switch Command Line Interface Groups and Commands arpShow Displays the contents of the ARP table. Syntax: arpShow Options: None. Sample Output: -> arpShow LINK LEVEL ARP TABLE destination gateway flags Refcnt Use Interface -------------------------------------------------------------------------172.26.0.203 00:11:25:c3:07:c5 405 0 0 mgmt_eth1 172.26.0.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> hostShow hostname -------localhost home slot1 slot2 slot3 slot4 slot5 slot6 slot7 slot8 slot9 slot10 slot11 slot12 slot13 slot14 slot15 slot16 slot17 slot18 slot19 slot20 slot21 slot22 slot23 slot24 switchA switchB switchC Master Slave 2-38 inet address -----------127.0.0.1 10.90.90.0 127.1.0.1 127.1.0.2 127.1.0.3 127.1.0.4 127.1.0.5 127.1.0.6 127.1.0.7 127.1.0.8 127.1.0.9 127.1.0.10 127.1.0.11 127.1.0.12 127.1.0.13 127.1.0.
A 2 – Switch Command Line Interface Groups and Commands Firmware fwUpdate (9024 Only) Updates the firmware. Syntax: fwUpdate [host user password dir filename] Options: 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. D000025-002 Rev.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> fwupdate Enter 1 for FTP, 2 for local file: 1 Ftp Server IP Address:[0.0.0.0] 192.168.0.10 Ftp username:[ftp] ftp Ftp password:[ftp] ftp File Directory:[] /firmware/switches/ File name:[] InfinIO9000.t3.pkg Save changes? [Y] n Attempting to initiate firmware update Product = InfinIO9000 Version = 4.2.1.1.
A 2 – Switch Command Line Interface Groups and Commands 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. Sample Output: -> fwUpdateSlot 1 Enter 1 for FTP, 2 for local file: 1 Ftp Server IP Address:[192.168.0.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> fwUpdateChassis all reboot 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.
A 2 – Switch Command Line Interface Groups and Commands Syntax: fwSetUpdateParams -c cardtype [-h hostname] [-u username] [-p password] [-d directory] [-f filename] Options: -c - cardtype Choices are: 'manangement', 'vfx', 'vex', 'ibx'. -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.
2 – Switch Command Line Interface Groups and Commands S showLastScpRetCode Display the return code from the last SCP Firmware Push. Syntax: showLastScpRetCode slot | -all Options: slot The slot number in the chassis. -all All slots in the chassis. Sample Output: -> showLastScpRetCode 101 SCP: Slot 101 Last Exit Code: 0: Success 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.
A 2 – Switch Command Line Interface Groups and Commands bootQuery Displays boot image version information. Syntax: bootQuery slot [-active | -alternate | -all] Options: slot Slot number. -active Displays the version of the active firmware image. -alternate Displays the version of the alternate firmware image. -all Displays the versions for the primary and alternate firmware images. Sample Output: -> bootQuery 2 -all Primary firmware version: 4.2.2.0.2 Alternate firmware version: 4.2.1.0.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> bootSelect 3 -noprompt Currently installed firmware versions index : alias : version -------------------------1 : image1 : 4.0.0.0.28; *# 2 : image2 : 4.0.0.0.32; * - indicates Default image (will run at next reboot) # - indicates Active image Default boot image index = 2 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 2 – Switch Command Line Interface Groups and Commands Subnet Management smControl Starts and stops the embedded subnet manager. Syntax: smControl start | stop | restart | status Options: Start Start the SM. Stop Stop the SM. restart Restarts the SM. status Prints out the SM Status. Sample Output: -> smControl start Starting the SM... D000025-002 Rev.
2 – Switch Command Line Interface Groups and Commands S smConfig Configure startup parameters of the embedded subnet manager. Syntax: smConfig [startAtBoot yes|no] [startOnSlaveCmu yes|no] Options: startAtBoot Start the subnet manager at chassis boot startOnSlaveCmu Start subnet manager on the slave CMU Sample Output 1: -> smConfig Start at boot? [Y] Start on slave CMU? [N] MasterSpine1-> Sample Output 2: -> smconfig startAtBoot yes startOnSlaveCmu yes Saving.... Saving complete...
A 2 – Switch Command Line Interface Groups and Commands smShowLids Display all fabric LID information as known by the subnet manager. Syntax: smShowLids Options: None. Sample Output: sm_state = MASTER count = 572781 LMC = 0, Topology Pass count = 339, Priority = 0, Mkey = 0x0 ----------------------------------------------------------------------------------------SilverStorm 9080 GUID=0x00066a00da000100 172.26.2.
2 – Switch Command Line Interface Groups and Commands S smPriority Set/display the priority of the subnet manager. Syntax: smPriority Options: priority-value priority must be between 0 and 15, inclusive. Sample Output 1: -> smPriority The SM Priority is 0 Sample Output 2: -> smPriority 4 SM Priority has been set to 4 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.
A 2 – Switch Command Line Interface Groups and Commands NOTES: The sweep rate determines how often the subnet manager scans the fabric for changes and events. bmSetSweepRate Set/display the sweep rate of the baseboard manager. Syntax: bmSetSweepRate [sweepRate} Options: sweepRate The sweep rate (in seconds) of the baseboard manager. Valid values are 30-86400, or 0 to turn the sweep off.
S 2 – Switch Command Line Interface Groups and Commands bmForceSweep Force a fabric sweep by the embedded baseboard manager. Syntax: bmForceSweep Options: None. Sample Output: -> bmForceSweep NOTES: Use this command to force a sweep by the baseboard manager. smShowGroups Display multicast group information in the embedded subnet manager. Syntax: smShowGroups [-h] Options: -h Display the host name as part of the output.
A 2 – Switch Command Line Interface Groups and Commands NOTES: Use this command to display multicast group information in the subnet manager. smShowServices Display subnet administration service records of the subnet manager. Syntax: smShowServices Options: None.
2 – Switch Command Line Interface Groups and Commands S smShowSubscriptions Display event forwarding (subscription) table in the embedded subnet manager. Syntax: smShowSubscriptions Options: None.
A 2 – Switch Command Line Interface Groups and Commands smMasterLMC Set/display the Master SM's LMC value to be used on CA ports. Syntax: smMasterLMC [lmc] Options: lmc The LMC value between 0 and 7, inclusive. Sample Output: -> smMasterLMC 2 Master SM LMC: 2 (4 LID(s) per port) 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 2^3 or 8 LID's per endport.
2 – Switch Command Line Interface Groups and Commands S smShowLidMap Display the LID-to-port GUID map for the subnet manager. Syntax: smShowLidMap Options: None.
A 2 – Switch Command Line Interface Groups and Commands smShowMaxLid Display the highest LID allocated by the subnet manager. Syntax: smShowMaxLid Options: None. Sample Output: -> smShowMaxLid The maximum LID is 0x0138 NOTES: Use this command to display the highest LID allocated by the subnet manager. smSwitchLifetime Set/Display the default switch lifetime in the SM. Syntax: smSwitchLifetime [lifetime} Options: lifetime The packet lifetime value between 0 and 31, inclusive.
2 – Switch Command Line Interface Groups and Commands S smHoqLife Set/Display the head of queue packet lifetime for switch ports. Syntax: smHoqLife [lifetime] Options: lifetime The packet lifetime value between 0 and 31, inclusive. Sample Output: -> smHoqLife 9 SM HOQ Liftime: 9 (~2097 microseconds) NOTES: Use this command to set the maximum lifetime that a packet may remain at the head of virtual lane's transmission queue before it is discarded by a switch, calculated using the formula: 4.
A 2 – Switch Command Line Interface Groups and Commands smShowSMParms Display subnet manager parameters switch lifetime, HOQ lifetime, VLStall val, pkt lifetime, and dynamic PLT. Syntax: smShowSMParms Options: None.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> smPKeys 0 0xffff "Default PKey" Successfully set PKey index: 0 to 0xffff 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. smInfoKey Set the subnet manager key (SMInfo) value. Syntax: smInfoKey [key] Options: key The SmInfo key (8 byte value in hex or decimal).
A 2 – Switch Command Line Interface Groups and Commands NOTES: Use this command to set the SM management key. SM must be offline and mkey value is up to 8 byte hex. smOptionConfig Use this command to configure support for non-default modes of operation. Syntax: smOptionConfig [clear | default | [def-mcgrp-create] [dyn-plt]] Options: 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.
2 – Switch Command Line Interface Groups and Commands S smDefBcGroup Set/display default multicast group configuration. Syntax: smDefBcGroup [enable | disable] [default | pKey [mtu [rate [sl [qKey] [fl [tc] Options: enable Enable auto-creation of multicast group at SM startup. disable Disable auto-creation of multicast group at SM startup. default Set PKey, MTU, rate, SL, QKey FlowLabel, and TClass to default values. pkey Partition Key. If no value entered, defaults to use the default PKey (0xFFFF).
A 2 – Switch Command Line Interface Groups and Commands 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 Valid Values for TClass are 0 to 0xff NOTE:DO NOT CREATE THIS GROUP WITH PARAMETERS THAT YOUR FABRIC CANNOT SUPPORT! smGidPrefix Set the Subnet Prefix (default=0xfe80000000000000).
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> smSubnetSize 288 Subnet Size: 288 NOTES: Use this command to tune the SM to handle the configured fabric size. This should be expressed in terms of the upper limit of HCA ports on the subnet. Setting this value will not take effect until the Subnet Manager is restarted. smTopoErrorThresh Set/display the error threshold for a topology sweep. Syntax: smTopoErrorThresh [threshold] Options: None.
A 2 – Switch Command Line Interface Groups and Commands smMaxRetries Set/display maximum number of SM receive retries. Syntax: smMaxRetries [retries] Options: None. Sample Output: -> smMaxRetries 3 Set max retries to:3 -> smMaxRetries Max retries: 3 smRcvWaitTime Set/display max time to wait for a reply to an SM packet in millisecs. Syntax: smRcvWaitTime [msecs] Options: None.
2 – Switch Command Line Interface Groups and Commands S smNonRespDropTime Set/display seconds to wait before dropping a non-responsive node. Syntax: smNonRespDropTime [seconds] Options: None. Sample Output: -> smNonRespDropTime 300 Set Nonresponsive node drop time to: 300 seconds -> smNonRespDropTime Non-responsive node drop time: 300 seconds smNonRespDropSweeps Set/display sweeps to wait before dropping a non-responsive node. Syntax: smNonRespDropSweeps [sweeps] Options: None.
A 2 – Switch Command Line Interface Groups and Commands smLogLevel (9000 MPFD Series Only) Set and display log level settings. Syntax: smLogLevel [level] Options: None. Sample Output: -> smLogLevel 1 NOTES: Level settings are 1 for errors and warnings; 2 for errors, warnings and sweep info. Values 3, 4 and 5 are unused. smMcLidTableCap Set/display the limit of multicast LIDs available for allocation. Syntax: smMcLidTableCap [limit] Options: None.
2 – Switch Command Line Interface Groups and Commands S smMasterPingInterval Set/displays SM ping interval in seconds. Syntax: smMasterPingInterval [seconds] Options: None. Sample Output: -> smMasterPingInterval 4 Set master ping interval to 3 seconds -> smMasterPingInterval Master ping interval: 4 seconds NOTES: Value must be between 3 and 10. smMasterPingFailures Set/display number of master ping failures allowed. Syntax: smMasterPingFailures [failures] Options: None.
A 2 – Switch Command Line Interface Groups and Commands smDbSyncInterval Set/display how often a Master SM should perform a full sync with standby SMs. Syntax: smDbSyncInterval [minutes] Options: None.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> smDynamicPlt Index: 1 PLT Value: Index: 2 PLT Value: Index: 3 PLT Value: Index: 4 PLT Value: Index: 5 PLT Value: Index: 6 PLT Value: Index: 7 PLT Value: Index: 8 PLT Value: Index: 9 PLT Value: 16 17 17 18 18 18 18 19 19 (~268435 usec) (~536870 usec) (~536870 usec) (~1073741 usec) (~1073741 usec) (~1073741 usec) (~1073741 usec) (~2147483 usec) (~2147483 usec) Dynamic packet lifetime values for pathrecord queries are enabled (use t
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> sm1xLinkMode Mode is 'off'. Erroneous 1x links will be activated normally. -> sm1xLinkMode ignore -> sm1xLinkMode Mode is 'ignore'. Erroneous 1x links will not be activated. 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.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> smAppearanceMsgThresh Message Threshold is 0 (disabled). -> smAppearanceMsgThresh 3 -> smAppearanceMsgThresh Message Threshold is 3 messages/sweep. 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 2 – Switch Command Line Interface Groups and Commands smShowRemovedPorts Display ports that have been automatically removed from the fabric. Syntax: smShowRemovedPorts Options: None.
2 – Switch Command Line Interface Groups and Commands S Log logShow Displays the log file. Syntax: logShow Options: None. Sample Output: -> 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.
A 2 – Switch Command Line Interface Groups and Commands logClear Clears the log file. Syntax: logClear [-noprompt] Options: -noprompt delete all log messages without prompting the user Sample Output: -> logClear Ram Log cleared logConfigure Configures the log settings. Syntax: logConfigure Options: None. D000025-002 Rev.
S 2 – Switch Command Line Interface Groups and Commands Sample Output: -> logConfigure Type Q or X to exit. Please enter the number corresponding to what you want to configure. index : name : description -------------------------1 : Device : Logging device. (IE. Ram, syslog, etc) 2 : Preset : General log filter.
A 2 – Switch Command Line Interface Groups and Commands logResetToDefaults Restores the log file default settings. Syntax: logResetToDefaults [-noprompt] Options: -noprompt Restore the defaults without prompting the user. Sample Output: -> logResetToDefaults Log configuration has been reset logSyslogConfig Configure the syslog host IP address. Syntax: logSyslogConfig [-h xxx.xxx.xxx.xxx] [-p xxxx] [-f xx] [-m x] Options: -h ip_address Sets the host IP address in dotted decimal format (xxx.xxx.xxx.
2 – Switch Command Line Interface Groups and Commands S logShowConfig Display the current log configuration settings. Syntax: logShowConfig Options: None.
A 2 – Switch Command Line Interface Groups and Commands Options: -e Send Error severity CSM test message to Syslog. -w Send Warning severity CSM test message to Syslog -n Send Warning severity CSM test message to Syslog. Sample Output: -> logSyslogTest -e Currently configured Syslog host is: 0.0.0.0 port 514 facility 22 Syslog configuration has been tested D000025-002 Rev.
S 2 – Switch Command Line Interface Groups and Commands Key Management showKeys Display the license keys for the unit. Syntax: showKeys Options: None. Sample Output: -> showKeys -------------------------------------------------------Key number: 1 Key: FV7P91-2V9H6F-946QS3-3SCEV5-YZMZ5R-S Description: Subnet Manager License Status: Active NOTES: License keys unlock various software features of the product. addKey Add a license key. Syntax: addKey [key] Options: key The license key to add.
A 2 – Switch Command Line Interface Groups and Commands Options: None. Sample Output: -> removeKey -------------------------------------------------------Key number: 1 Key: XX7P91-2V9H6F-946QS3-3SCEV5-YZMZ5R-S Description: Subnet Manager License Status: Active Please enter the key number you wish to remove: NOTES: After entering this command a list of available keys will be displayed. The keys are shown along with an associated number. At the prompt, enter the number of the key you wish to remove.
2 – Switch Command Line Interface Groups and Commands S IbSwitchInfo ismPortStats Displays link error information associated with each switch port. These statistics include errors, dropped packets, discarded packets, and invalid packets. Syntax: ismPortStats [-clear] [-noprompt] [-cols X] [-port X] [-leaf X] [-spine X] Options: -clear Clears the statistics. Statistics are displayed first, then cleared. -noprompt Does not give the user a 'Continue' prompt for each page of display.
A 2 – Switch Command Line Interface Groups and Commands NOTES: Port statistic descriptions: D000025-002 Rev. A PhysState - The physical state of the port. PortState - The state of the link on this port. LinkWidth - The currently active link width on this port. LinkSpeed - The currently active link speed on this port. Port speed is LinkWidth * LinkSpeed. SymblErrors - The number of times a 8B10B encoding violation, or a disparity violation was detected.
S 2 – Switch Command Line Interface Groups and Commands ismPortCounters Displays a table comparision of transmit, receive and error counters cooresponding to each port of the module. Syntax: ismPortCounters [-clear] [-active] [-errors] [-potential] [-noprompt] Options: -clear Clears the counters. Counters are first displayed, then cleared. -active Displays only the counters for ports in the active state. -errors Displays only the counters for ports with receive symbol errors.
A 2 – Switch Command Line Interface Groups and Commands Errors, Rmt - Number of switch relay errors received on the port. For MPFD switches, the counters for the cable ports as well as the ports for each line card are shown. For switches with more than 24 ports, the user is prompted to continue the output after each group of 24 ports are displayed. This command is best displayed with a terminal width of at least 120 columns. ismLinearFwdb Displays the entries in the linear forwarding table.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> ismMultiFwdb Switch Leaf 3 Multicast Fwdb: c000 12 (L03P12 ) 19 (L03S1Aa) c001 12 (L03P12 ) 19 (L03S1Aa) Switch Spine 1-A Multicast Fwdb: c000 9 (S1AL03a) c001 9 (S1AL03a) NOTES: This command is best displayed with a terminal width of at least 120 columns. ismAutoClearConf This feature will clear the InfiniBand port statistic counters that have reached their maximum.
A 2 – Switch Command Line Interface Groups and Commands ismPortSet12x Allows the user to view, set and unset port link width to 12X for specific port(s). Syntax: ismPortSet12x portName [enable12xBit] Options: portName A valid 6 or 7 character port name (e.g., S1AL01a or L01P01). enable12xBit 2=enable(12X only) 1=enable(AUTO 1X/4X/12X), 0=disable. Sample Output: -> ismPortSet12x S1AL01a S1AL01a 12x mode is DISABLED NOTES: This command works only on platforms supporting 12X link aggregation.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> ismChassisSet12x L01P01 12x mode is L01P02 12x mode is L01P03 12x mode is L01P04 12x mode is L01P05 12x mode is L01P06 12x mode is L01P07 12x mode is L01P08 12x mode is L01P09 12x mode is L01P10 12x mode is L01P11 12x mode is DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED NOTES: This command works only on platforms supporting 12X link aggregation (currently the 9024 and 9080).
A 2 – Switch Command Line Interface Groups and Commands NOTE: DDR links (5.0) are only available on chassis supporting DDR. This command sets link speeds for both internal and external ports .Each external DDR port must be connected to another DDR port to establish a 5.0 link. Using this function without the speed option displays the current values of the port(s).A reboot of the chassis is required to activate changes made with this command. ismPortEnable Allows the user to enable or disable a port.
2 – Switch Command Line Interface Groups and Commands S Sample Output: -> ismChassisSetEnable L01P01 is ENABLED L01P02 is ENABLED L01P03 is ENABLED L01P04 is ENABLED L01P05 is ENABLED L01P06 is ENABLED L01P07 is ENABLED. NOTE: Using this command without the enable option displays current value of the port(s). A reboot is required to activate changes made with this command. ismChassisSetDdrPreemphasis Allows the user to view and set the preemphasis for all cable side DDR ports.
A 2 – Switch Command Line Interface Groups and Commands NOTE: Calling this function with no parameters will display the current value for each port. A reboot is required to activate changes made with this command. ismPortDisable Allows the user to view and disable ports for entire chassis. Syntax: ismPortDisable port Options: port Port name. Sample Output: -> ismPortDisable S3BL10a NOTE: The option port is case sensitive. If it contains spaces, it must be bounded by quotes (e.g.
S 2 – Switch Command Line Interface Groups and Commands NOTE: The option port is case sensitive. If it contains spaces, it must be bounded by quotes (e.g., ismPortSetSpeed "Cable 1"). Using this command with only the port option displays its current values. A reboot is required to activate changes made with this command. ismPortSetDdrPreemphasis Allows the user to view and set preemphasis for a cable side DDR port. Syntax: ismPortSetDdrPreemphasis [port] [preemphasis] Options: port Port name.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> ismIslSet12x L01S2Ba 12x mode L01S2Bb 12x mode L01S2Bc 12x mode L01S1Ba 12x mode L01S1Bb 12x mode L01S1Bc 12x mode L01S2Aa 12x mode L01S2Ab 12x mode is is is is is is is is DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED DISABLED NOTE: This command works only on chassis supporting 12X link aggregation. This command enables 12X link aggregation so that internal switching will be 12X.
2 – Switch Command Line Interface Groups and Commands NOTE: S This command will set the MTU capability for both internal and external switching. If the vlCap option is not specified, the command defaults to the maximumVL(s) for the selected mtuCap. Calling this function without an mtuCap designator displays the current value for each port. A reboot is required to activate changes made with this command. ismIslSetSpeed Allows the user to view and set internal port link speeds to 2.5 (SDR), 5.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> ismShowPStatThresh Field Threshold ------------1 portXmitData: 0 2 portRecvData: 0 3 portXmitPkts: 0 4 portRecvPkts: 0 5 portXmitWait: 0 6 portSymbolErr: 0 7 portLinkErrRecv: 0 8 portLinkDowned: 0 9 portRecvErr: 0 10 portRecvRemPhysErr: 0 12 portXmitDiscard: 0 13 portPKeyViolIn: 0 14 portPKeyViolOut: 0 15 portRawViolIn: 0 16 portRawViolOut: 0 17 portLocalLinkInteg: 0 18 portExcBufferOverrun: 0 19 portRelayedVL15Dropped: 0 20 portLoc
2 – Switch Command Line Interface Groups and Commands S 18 portExcBufferOverrun: excessive buffer overrun errors 19 portRelayedVL15Dropped: remote VL15 packet was dropped 20 portLocalVL15Dropped: local VL15 packet was dropped 21 portNonSMPDropped: non SMP packet was dropped ismSetPStatThresh Modifies the port statistic thresholds. Syntax: ismSetPStatThresh field threshold Options: -field The name of the port status threshold field. -threshold The numeric threshold value.
A 2 – Switch Command Line Interface Groups and Commands portRawViolOut portLocalLinkInteg portExcBufferOverrun portRelayedVL15Dropped portLocalVL15Dropped portNonSMPDropped ismRemoveStateDump Removes switch ASIC state dumps files. Syntax: ismRemoveStateDump [all] [-leaf X] [-spine X] Options: all Removes all switch ASIC state dump files. -leaf X Removes a switch ASIC state dump file for a specific leaf X. -spine X Removes the switch ASIC state dump files for a specific spine X.
2 – Switch Command Line Interface Groups and Commands S ismShowStateDump Shows contents of switch ASIC state dumps. Syntax: ismShowStateDump [-full] [all] [-leaf X] [-spine X] Options: -full Shows the full contents of the switch ASIC state dump file. Without this option, just the header is displayed. all Removes all switch ASIC state dump files. -leaf X Removes a switch ASIC state dump file for a specific leaf X. -spine X Removes the switch ASIC state dump files for a specific spine X.
A 2 – Switch Command Line Interface Groups and Commands TimeManagement time Configure the time on the device. Syntax: time -S ipaddr | -T hhmmss[mmddyyyy] Options: -S ipaddr Sets the NTP Server IP address. -T hhmmss[mmddyyyy] Set the local clock time hour, minutes, and seconds along with the month, day, and year. Sample Output: -> time -S 172.26.0.254 Configured the NTP server ip address successfully 13:53:02 10/06/2006 Configured to use NTP server IP address: 172.26.0.
2 – Switch Command Line Interface Groups and Commands NOTE: S The offset parameter specifies a time zone the system should use when setting the time. In the U.S. the following time zones are in effect: Eastern Standard Time = GMT -5; Central Standard Time = GMT -6; Mountain Standard Time = GMT -7; Pacific Standard Time = GMT -8. GMT = GreenwichMean Time.. timeDSTConf Configure and display the Daylight Saving Time settings.
A 2 – Switch Command Line Interface Groups and Commands Syntax: timeNtpTimeout numSeconds Options: numSeconds New timeout setting. Sample Output: -> timeNtpTimeout Current NTP timeout value: 2 seconds -> timeNtpTimeout 3 Current NTP timeout changed to 3 seconds NOTE: With no arguments, this command displays the current NTP timeout settings. This is the amount of time (in seconds) for the system to wait for a response from the NTP server.
2 – Switch Command Line Interface Groups and Commands S command with the new refresh time (in whole seconds) as the only argument. The NTP refresh time is not used on linecards or slave CMUs. 2-102 D000025-002 Rev.
A 2 – Switch Command Line Interface Groups and Commands SNMP snmpCommunityConf Displays and allows the changing of the SNMP community strings. Syntax: snmpCommunityConf [-r readonly_comm_str] [-w read_write_comm_str] Options: -r A read-only community string. -w A read/write community string.
2 – Switch Command Line Interface Groups and Commands S Options: show Displays the contents of the snmpTargetAddrTable. add Adds a row to the snmpTargetAddrTable. edit Modifies an existing row in the snmpTargetAddrTable. delete Removes an existing row of the snmpTargetAddrTable. -n Name. A unique name used to identify a row. Any name with a space (e.g. xxx v3) must be surrounded by double quotes ("). -a Address. The target machine IP address in dotted decimal form. -p Port.
A 2 – Switch Command Line Interface Groups and Commands snmpTargetParams Displays the snmpTargetParamsTable entries. Syntax: snmpTargetParams [show] Options: show Displays the contents of the snmpTargetParamsTable.
S 2 – Switch Command Line Interface Groups and Commands NOTE: The output is in the form: 'mib : mib_object : table_index : value' . For more details on the snmpNotifyFilterProfileTable see SNMP-NOTIFICATION-MIB, RFC-2573. snmpNotifyFilter Displays the snmpNotifyFilterTable entries. Syntax: snmpNotifyFilter [show] Options: show Displays the contents of the snmpNotifyFilterTable.
A 2 – Switch Command Line Interface Groups and Commands Sample Output: -> snmpNotify rfc2573n:snmpNotifyTag: switch : rfc1493 rfc2573n:snmpNotifyTag: interfaces : rfc2233 rfc2573n:snmpNotifyTag: rmon : rfc1757 rfc2573n:snmpNotifyTag: snmp : rfc1907 rfc2573n:snmpNotifyTag: tms : tmscom rfc2573n:snmpNotifyType: switch : 1 NOTE: The output is in the form: 'mib : mib_object : table_index : value' . For more details on the snmpNotifyTable see SNMP-NOTIFICATION-MIB, RFC-2573.
2 – Switch Command Line Interface Groups and Commands NOTE: S The output is in the form: 'mib : mib_object : table_index : value'. snmpUsrSec Configure and display SNMP V3 users. Syntax: snmpUsrSec [add | show | edit | delete] [name] [-a algo [key]] Options: add add an entry to the V3 user table. show show entries in the V3 user table. edit modify an entry in the V3 user table. delete remove an entry in the V3 user table. -a authentication algorithm and key. Options: MD5, SHA, NONE.
A 2 – Switch Command Line Interface Groups and Commands Capture capture Display information for this device. Syntax: capture Options: None. NOTE: This command is intended for support personnel. captureFw Display firmware information for this device. Syntax: captureFw Options: None. NOTE: This command is intended for support personnel. captureLog Display log information for this device. Syntax: captureLog Options: None. NOTE: D000025-002 Rev. A This command is intended for support personnel.
2 – Switch Command Line Interface Groups and Commands S captureSm Display Subnet Management information for this device. Syntax: captureSm Options: None. NOTE: This command is intended for support personnel. captureIsm Display Infiniband switch information for this device. Syntax: captureIsm Options: None. NOTE: This command is intended for support personnel. captureChassis Display chassis information for this device. Syntax: captureChassis Options: None.
A 2 – Switch Command Line Interface Groups and Commands Options: None. NOTE: This command is intended for support personnel. captureMisc Display miscellaneous information for this device. Syntax: captureMisc Options: None. NOTE: This command is intended for support personnel. captureSnmp Display SNMP information for this device. Syntax: captureSnmp Options: None. NOTE: This command is intended for support personnel. captureShell Display shell command information for this device.
2 – Switch Command Line Interface Groups and Commands 2-112 S D000025-002 Rev.
3 Virtual I/O Command Line Interface Overview This section details the usage of the Command Line Interface (CLI) feature for the EVIC and FVIC virtual I/O (VIO) modules. 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 VIO CLI is accessed via the rlogin command executed from the 9000 switch CLI. Commands and Functional Groups The list of available commands can be accessed by typing list.
S 3 – Virtual I/O Command Line Interface Commands and Functional Groups SubnetManagement: InfiniBand subnet manager configuration and management. NOTE: For 9020 users, the subnet manager CLI commands are accessed via the VIO modules. Log: Provides commands for viewing log files as well as configuring logging parameters. KeyManagement: License key management. NOTE: For 9020 users, the Key Management CLI commands are accessed via the VIO modules.
A 3 – Virtual I/O Command Line Interface Online Help Online Help The online help for the CLI provides, for each command, all necessary information to successfully execute the command. For example, typing help fwVersion displays the following information for the firmware update command: NAME fwVersion SYNOPSIS fwVersion DESCRIPTION Displays the firmware versions for the unit. OPTIONS None. Keyboard Shortcuts n The CLI keeps a history of recently executed commands.
S 3 – Virtual I/O Command Line Interface Groups and Commands 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. 4. At the system prompt enter the following command:: rlogin where corresponds to the switch slot where the VIO card resides. The system responds with: Welcome to the CLI. Type 'list' for the list of commands..
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> cardInfo Out of Band LAN IP Net Mask MAC Address Description Alias IB Node Description Non-Fatal Errors Fatal Errors Card Description Card Uptime Card Contact Card Name Card Location : : : : : : : : : : : : : 172.26.2.87 255.255.240.
3 – Virtual I/O Command Line Interface Groups and Commands S Sample Output: -> cardFatalErrGet Fatal Errors : 0 NOTE: cardInfo is a related command. cardUptimeGet Displays linecard uptime. Syntax: cardUptimeGet Options: None. Sample Output: -> cardUptimeGet Card Uptime : 0 Day(s), 0 Hour(s), 12 Minute(s), 36 Second(s) NOTE: cardInfo is a related command. cardDescGet Displays linecard description. Syntax: cardDescGet Options: None.
A 3 – Virtual I/O Command Line Interface Groups and Commands cardDescSet Modifies the linecard description. Syntax: cardDescSet Options: string Decription text string. Sample Output: -> cardDescSet "EVIC" Description : EVIC NOTE: cardInfo is a related command. cardAliasGet Displays the linecard alias. Syntax: cardAliasGet Options: None. Sample Output: -> cardAliasGet Alias : FVIC-6 NOTE: D000025-002 Rev. A cardInfo is a related command.
3 – Virtual I/O Command Line Interface Groups and Commands S cardAliasSet Modifies the linecard Alias. Syntax: cardAliasSet Options: string Decription text string. Sample Output: -> cardAliasSet "EVIC-4" Alias : EVIC-4 NOTE: cardInfo is a related command. cardIbNodeDescGet Displays the linecard IB node description. Syntax: cardIbNodeDescGet [] Options: default Default string.
A 3 – Virtual I/O Command Line Interface Groups and Commands Options: default Default string. string Description text string. Sample Output: -> cardIbNodeDescSet "EVIC, slot 4, 0x133" IB Node Description : EVIC, slot 4, 0x133 NOTE: cardInfo is a related command. cardCardDescGet Shows Linecard "card" description. Syntax: cardCardDescGet Options: None. Sample Output: -> cardCardDescGet NOTE: cardInfo is a related command. cardCardDescSet Modifies the linecard IB Node Description.
3 – Virtual I/O Command Line Interface Groups and Commands NOTE: S cardInfo is a related command. cardContactGet Displays linecard contact information. Syntax: cardContactGet Options: None. Sample Output: -> cardContactGet Card Contact : John Doe NOTE: cardInfo is a related command. cardContactSet Modifies the linecard contact information. Syntax: cardContactSet Options: string Contact text string.
A 3 – Virtual I/O Command Line Interface Groups and Commands Options: None. Sample Output: -> cardNameGet Card Name : FVIC-6 NOTE: cardInfo is a related command. cardNameSet Modifies the linecard name. Syntax: cardNameSet Options: string Name text string. Sample Output: -> cardNameSet EVIC-6 Card Name : EVIC-6 NOTE: cardInfo is a related command. cardLocationGet Displays the linecard location. Syntax: cardLocationGet Options: None.
3 – Virtual I/O Command Line Interface Groups and Commands NOTE: S cardInfo is a related command. cardLocationSet Modifies the linecard location information. Syntax: cardLocationSet Options: string Location text string. Sample Output: -> cardLocationSet "Lower Chassis, Slot 6" Card Location : Lower Chassis, Slot 6 NOTE: 3-12 cardInfo is a related command. D000025-002 Rev.
A 3 – Virtual I/O Command Line Interface Groups and Commands Firmware fwVersion Displays the firmware versions for a unit. Syntax: fwVersion [slot] Options: slot Slot number. Sample Output: -> fwVersion 3 Slot 3 Information ----------------Firmware Version: 4.0.0.0.32 Firmware build: 4_0_0_0_32 Firmware BSP: VIO MBC Version: None Bootrom Version: 4.0.0.0.28 D000025-002 Rev.
3 – Virtual I/O Command Line Interface Groups and Commands S bootQuery Displays boot image version information. Syntax: bootQuery slot [-active | -alternate | -all] Options: -active Displays the version of the active firmware image. -alternate Displays the version of the alternate firmware image. -all Displays the versions for the primary and alternate firmware images. Sample Output: -> bootQuery -all Primary firmware version: 4.0.0.0.32 Alternate firmware version: 4.0.0.0.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> bootSelect 103 -noprompt Currently installed firmware versions index : alias : version -------------------------1 : image1 : 4.0.0.0.28; *# 2 : image2 : 4.0.0.0.32; * - indicates Default image (will run at next reboot) # - indicates Active image Default boot image index = 2 D000025-002 Rev.
3 – Virtual I/O Command Line Interface Groups and Commands S Log NOTE: For detailed information on commands for the Log group, refer to page 2-74. Capture capture Display information for this device. Syntax: capture Options: None. NOTE: This command is intended for support personnel. captureFw Display firmware information for this device. Syntax: captureFw Options: None. NOTE: 3-16 This command is intended for support personnel. D000025-002 Rev.
A 3 – Virtual I/O Command Line Interface Groups and Commands captureSm Displays all available subnet manager information for module. Syntax: captureSm Options: None. NOTE: This command is intended for support personnel. captureLog Display log information for this device. Syntax: captureLog Options: None. NOTE: This command is intended for support personnel. captureMisc Display miscellaneous information for this device. Syntax: captureMisc Options: None.
3 – Virtual I/O Command Line Interface Groups and Commands S Options: None. NOTE: This command is intended for support personnel. captureFibreChannel Display pertinent Fibre Channel information for an FVIC. Syntax: captureFibreChannel Options: None. NOTE: This command is intended for support personnel. captureLinecard Displays pertinent linecard information for module. Syntax: captureLinecard Options: None. NOTE: This command is intended for support personnel.
A 3 – Virtual I/O Command Line Interface Groups and Commands FibreChannel fcPortSpeedGet Retrieve the Fibre Channel port speed settings. Syntax: fcPortSpeedGet [Port Number] Options: PortNumber Displays the current speed settings for a specific port.
S 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcPortSpeedSet 1 1 Setting speed to 1 Updated the topology.
A 3 – Virtual I/O Command Line Interface Groups and Commands Options: PortNumber The Fibre Channel port number to set. Topology New port topology: 0 = Private Loop 1 = Public Loop 2 = Point to Point 3 = Fabric Sample Output: -> fcPortTopologySet 5 1 Updated the topology.
S 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcPortAliasGet Port Alias PortWWN NPortId Topology Admin Link Oper Speed Status Speed SFP Status 1 plc2a 0x500066A1DD000019 0x000000 Fabric Auto Down --- OK 2 plc2b 0x500066A2DD000019 0x000000 Fabric Auto Down --- Not Installed 3 plc2c 0x500066A3DD000019 0x000000 Fabric Auto Down --- Not Installed 4 plc2d 0x500066A4DD000019 0x000000 Fabric Auto Down --- Not Installed 5 plc2e 0x500066A5DD000019 0xF
A 3 – Virtual I/O Command Line Interface Groups and Commands fcDeviceDiscoveryStart Initiates a discovery cycle for Fibre Channel devices. Syntax: fcDeviceDiscoveryStart Options: None. Sample Output: -> fcDeviceDiscoveryStart Fibre Channel Device Discovery cycle started... fcDiscoveredDevicesGet Display Fibre Channel devices found during the last discovery cycle. Syntax: fcDiscoveredDevicesGet Options: Index Optional index of the device from the discovered device list.
S 3 – Virtual I/O Command Line Interface Groups and Commands Options: Index Optional index of the device from the configured device list.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcConfiguredDeviceRem 2 Removed FC Target Device 2. fcConfiguredDeviceRename Rename Fibre Channel devices that have already been configured Syntax: fcConfiguredDeviceRename Options: Device Index Index number from the results of the configured device list. Name New name for the device.
3 – Virtual I/O Command Line Interface Groups and Commands S fcSrpDiscoveredInitiatorsGet Displays the SRP Initiators found during the last discovery cycle. Syntax: fcSrpDiscoveredInitiatorsGet Options: None.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcSrpConfiguredInitiatorsGet Ref# 1 2 3 4 5 6 7 8 11 12 13 14 15 16 IB GUID SRP Extension ActiveConnections Name (00066A00A0006801:0000000000009601) 0 st96 (00066A00A0006801:0000000000009602) 1 st9602 (00066A00A0006801:0000000000009603) 0 st9603 (00066A00A0006801:0000000000009604) 0 st9604 (00066A00A0006801:0000000000009605) 0 st9605 (00066A00A0006801:0000000000009606) 0 st9606 (00066A00A0007115:0000000000013601) 0 st136 01 (0
3 – Virtual I/O Command Line Interface Groups and Commands S fcSrpInitiatorCreate Create an new SRP Initiator by specifying the GUID, extension, and name. Syntax: fcSrpInitiatorCreate [Initiator GUID] [SRP Extension] [Name] Options: Initiator GUID The InfiniBand globally unique identifier (GUID) of the SRP Initiator. SRP Extension The SRP extension ID to use with the GUID. Name The SRP initiator name.
A 3 – Virtual I/O Command Line Interface Groups and Commands fcSrpMapShowConnections Retrieve SRP initiator connection information. Syntax: fcSrpMapShowConnections Options: Initiator Index An initiator number from the configured initiator list. Executing this command without this option will display all initiator connections. Sample Output: -> fcSrpMapShowConnections fcSrpMapConfigGet Retrieve SRP map configuration information.
S 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcSrpMapConfigGet Initiator 1, (st96) using GUID: 00066A00A0006801 SRP Ext:0000000000009601 IOC 1 SRP Map, (p1 hitachi) is a DIRECT type. It contains 1 LUN map(s). All Host LUNs are passed directly to the Target (Hitachi P1 via p1) Initiator 2, (st9602) using GUID: 00066A00A0006801 SRP Ext:0000000000009602 IOC 1 SRP Map, (st96 hit over p2) is a DIRECT type. It contains 1 LUN map(s).
A 3 – Virtual I/O Command Line Interface Groups and Commands fcSrpMapConfigCreate Create and configure a new SRP map association. Syntax: fcSrpMapConfigCreate [Initiator Index] [IOC] [FC Target Device Index] [MapType] [MapName] Options: Initiator Index The index number from the Configured SRP Initiators list. IOC The IOC number (either 1 or 2). FC Target Device Index The index number from the Configured FC Target Device list. MapType The type of SRP Map (D=Direct or E=Explicit).
3 – Virtual I/O Command Line Interface Groups and Commands S fcSrpMapConfigStatus Change the status of a map. Syntax: fcSrpMapConfigStatus [SRP Initiator Index] [IOC] [Status] Options: SRP Initiator Index The index number from the Configured SRP Initiators list. IOC The IOC number (either 1 or 2). Status The type of SRP Map (A=Active or I=Inactive) Sample Output: -> fcSrpMapConfigStatus 18 1 I De-activating Map...
A 3 – Virtual I/O Command Line Interface Groups and Commands Options: Initiator Index The index number from the Configured SRP Initiators list. IOC The IOC number (either 1 or 2). FC Target Device Index The index number from the Configured FC Target Device list. HostLUN The host Logical Unit Number. TargetLUN The target Logical Unit Number.
3 – Virtual I/O Command Line Interface Groups and Commands S Sample Output: -> fcSrpMapConfigRowRem 18 1 15 1 0 Initiator 18, (uc blade ext2) using GUID: 0005AD000002BA4E SRP Ext:0000000000000002 IOC 1 SRP Map, (jupiter) is a EXPLICIT type. It contains 1 LUN map(s). STATUS: INACTIVE Host LUN 0 is mapped to Target LUN 0 on (b57 p4) NOTE: The specified SRP map must be explicit type and already exist fcSrpMapConfigRem Delete a SRP map from an existing map configuration.
A 3 – Virtual I/O Command Line Interface Groups and Commands Options: SRP Initiator Index The index number from the Configured SRP Initiators list. IOC The IOC number (either 1 or 2). MapType Type of SRP Map (D=Direct or E=Explicit). Host LUN Optional: if not used, the Host LUN will be set to 0. Target LUN Optional: if not used, the Target LUN will set to 0.
S 3 – Virtual I/O Command Line Interface Groups and Commands fcTargetDeviceStatsGet Display the Fibre Channel Target Device statistics. Syntax: fcTargetDeviceStatsGet Options: Optional Device Index.
A 3 – Virtual I/O Command Line Interface Groups and Commands fcSrpInitiatorStatsGet Display the SRP Initiator Statistics. Syntax: fcSrpInitiatorStatsGet Options: Optional Initiator Index.
3 – Virtual I/O Command Line Interface Groups and Commands S fcPortStatsGet Display Fibre Channel Port Statistics. Syntax: fcPortStatsGet [PortNumber] Options: PortNumber The Fibre Channel port number for the device.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcTrapStatusGet Valid Traps: 1) Interconnect Link Up 2) Interconnect Link Down 3) Target Device Link Up 4) Target Device Link Down : : : : enabled enabled enabled enabled fcTrapEnable Enable specified Fibre Channel traps. Syntax: fcTrapEnable [Trap Index] Options: Trap Index The index number of the trap to enable.
S 3 – Virtual I/O Command Line Interface Groups and Commands fcTrapGenerate Generate a specified Fibre Channel trap. Syntax: fcTrapGenerate Options: Trap Index The index number of the trap to enable. Sample Output: -> fcTrapGenerate 1 Generated trap for Interconnect Link Up NOTE: The Trap Index may be retrieved using fcTrapStatusGet. fcVirtPortShow Displays information about the virtual ports in the pool Syntax: fcVirtPortShow Options: Index Optional Virtual Port Index.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcVirtPortShow WWN Key: T4WD5G-S6A5U2-QA28A7-32QKS8-ZS8AW7-G Index | WWN | Alias | PhyPort | Status | Name ----------------------------------------------------------------------0001 | 0x500066A0E2000199 | Ext-1 | 1 | Active | Test-0001 0002 | 0x500066A0E2200199 | | Unassigned | Inactive | WWN-0002 0003 | 0x500066A0E2400199 | | Unassigned | Inactive | WWN-0003 0004 | 0x500066A0E2600199 | | Unassigned | Inactive | WWN-0004 0005 |
3 – Virtual I/O Command Line Interface Groups and Commands S fcVirtPortNameSet Set the text name field of the virtual port Syntax: fcVirtPortNameSet Options: Index The index from the Virtual Port list. Name The text name for the Virtual Port.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcVirtPortPhyPortSet 1 2 Index | VirtPort WWN | PhyPort | Status | VirtPort Name -------------------------------------------------------------------------0001 | 500066A0E2000199 | 2 | Inactive | WWN-0001 NOTE: The virtual port must be inactive for the assignment to be successful. Use port zero to unassign a virtual port. fcVirtPortStatusSet Activates or deactivates the virtual port.
S 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcVirtPortPoolCreate Virtual Port Pool key accepted. Virtual Port Pool Key: Index | VirtPort WWN | PhyPort | Status | VirtPort Name ----------------------------------------------------------------0001 | 500066A0E2000199 | Unassigned | Inactive | WWN-0001 0002 | 500066A0E2200199 | Unassigned | Inactive | WWN-0002 0003 | 500066A0E2400199 | Unassigned | Inactive | WWN-0003 . . .
A 3 – Virtual I/O Command Line Interface Groups and Commands Ethernet ethMtuGet Read the current and saved maximum transfer unit (MTU) sizes. Syntax: ethMtuGet Options: None. Sample Output: ethMtuGet Ethernet MTU size: Current : 9500 Saved : 9500 NOTE: Prints the current and saved Ethernet MTU sizes for the system. The current MTU is the size currently in use, while the saved MTU is the size that will be used following a reboot.
S 3 – Virtual I/O Command Line Interface Groups and Commands ethViPortsGet Displays the VIPORT counts. Syntax: ethViPortsGet Options: None. Sample Output: -> ethViPortsGet ViPorts: Current : 250 Saved : 250 Maximum : 400 MAC Addr: 250 NOTE: Prints the current and saved VIPORT counts for the system. The current VIPORT count is the number of active host connections. The saved VIPORT count is the number that can be used following a reboot.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethExtPauseGet Read whether PAUSE is enabled or disabled Syntax: ethExtPauseGet Options: port The external Ethernet port(s) to display the PAUSE state. Sample Output: ethExtPauseGet "1 2" External Ethernet port 1 [Ext-1] PAUSE: enabled External Ethernet port 2 [Ext-2] PAUSE: enabled NOTE: Displays the PAUSE state for an external Ethernet port.
3 – Virtual I/O Command Line Interface Groups and Commands S ethExtPrioritySet Set default user priority for the specified ethernet port. Syntax: ethExtPrioritySet [port] [priority] Options: port The Ethernet port(s) to set a default user priority. priority A new default user priority. Sample Output: ethExtPrioritySet 1 3 External Ethernet port 1: default user priority changed to 3 NOTE: Sets the default user priority for an external Ethernet port. Valid settings are in the range [0,7].
A 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtPrioritySet Modifies the default user priority for the specified virtual port. Syntax: ethVirtPrioritySet [port] [priority] Options: port The virtual port(s) used to set the default user priority. priority A new default user priority. Sample Output: ethVirtPrioritySet 1 7 Virtual Ethernet port 1: default user priority changed to 7 NOTE: Sets the default user priority for a specified virtual port.
S 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: ethExtStatsGet 1 Current stats for External Ethernet port 1 [Ext-1]: Drop Events Octets Packets Broadcast Pkts Multicast Pkts CRC Align Errors Undersize Pkts Oversize Pkts Fragments Jabbers Collisions 64 Octets 65-127 Octets 128-255 Octets 256-511 Octets 512-1023 Octets 1024-1518 Octets : : : : : : : : : : : : : : : : : 0x00000000 0x00019a51 0x0000048b 0x00000054 0x00000437 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
A 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtStatsGet Print statistics for a specified virtual port(s). Syntax: ethVirtStatsGet [port] Options: port The virtual port(s) from which to have the statistics displayed.
3 – Virtual I/O Command Line Interface Groups and Commands S vlanDot1qPvidGet View/Set VLAN Dot1qPvid for a port. Syntax: vlanDot1qPvidGet Options: target eth|vi|ioc instance(s) port number/IOC GUID NOTE: Displays the default VLAN Dot1qPvid for a specified external Ethernet port, Virtual Ethernet port, or IOC. The port parameter can be either a single port, or a list of ports separated by spaces and enclosed in double quotes. vlanDot1qPvidSet View/Set VLAN Dot1qPvid for a port.
A 3 – Virtual I/O Command Line Interface Groups and Commands vlanMapTaggedGet Show VLAN PVID tagged map.
3 – Virtual I/O Command Line Interface Groups and Commands S vlanMapTaggedSet Update VLAN PVID tagged map. Syntax: vlanMapTaggedSet Options: target eth|vi instance(s) port number pvid(s) VLAN tag(s) flag 0-remove|1-add NOTE: Update the VLAN PVID tagged map for Ethernet port(s). Related commands: vlanDot1qPvid, vlanMapMember. vlanMapMemberGet Show VLAN PVID member map.
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> vlanMapMemberGet vi 56 vlanMapMemberGet(0): vi(2) flag=0 ------------------------Port=56 Total PVID=1 11 -----------------------------> vlanMapMemberGet eth 1 vlanMapMemberGet(0): eth(1) flag=0 ------------------------Port=1 [Ext-1] Total PVID=2 11 36 NOTE: Displays the VLAN PVID member map for Ethernet or vitrual port(s). Related commands: vlanDot1qPvid, vlanMapMember. vlanMapMemberSet Update VLAN PVID member map.
3 – Virtual I/O Command Line Interface Groups and Commands NOTE: S Updates the VLAN PVID member map for Ethernet or virtual port(s). Related commands: vlanDot1qPvid, vlanMapMember. vlanInfo Display an overview of the VLAN configuration.. Syntax: vlanInfo target Options: target Determine whether to show External or Virtual Ethernet port configuration. NOTE: Displays an overview of the VLAN configuration for all ports of the specified type.
A 3 – Virtual I/O Command Line Interface Groups and Commands vlanEgressRuleGet View/Set VLAN Egress rule(s).
3 – Virtual I/O Command Line Interface Groups and Commands S vlanEgressRuleSet View/Set VLAN Egress rule(s). Syntax: vlanEgressRuleSet Options: target eth|vi|ioc instance(s) port number(s)/IOC GUID flag 1-enable|0-disable NOTE: Displays the VLAN egress rule(s) for Ethernet/host port(s). Related commands: vlanIngressRule, vlanIngressFrame, vlanDot1qPvid. vlanIngressRuleGet View/Set VLAN Ingress rule(s).
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> vlanIngressRuleGet vi 56 vlanIngressRuleGet(0): vi(2) flag[1-enable|2-disable] ------------------------vi:56 1 -> vlanIngressRuleGet eth 1 vlanIngressRuleGet(0): eth(1) flag[1-enable|2-disable] ------------------------eth:1 [Ext-1] 2 NOTE: Displays the VLAN Ingress rule flag for port(s) (Ethernet port/virtual port/IOC GUID). Related commands: vlanEgressRule, vlanIngressFrame, vlanDot1qPvid.
3 – Virtual I/O Command Line Interface Groups and Commands S vlanIngressFrameGet View/Set VLAN Ingress Frame type. Syntax: vlanIngressFrameGet Options: target eth|vi|ioc instance(s) port number(s)/IOC GUID NOTE: Displays the VLAN Ingress acceptable frame type for port(s)(Ethernet port/ViPort/IOC GUID). Related commands: vlanEgressRule, vlanIngressRule, vlanDot1qPvid. vlanIngressFrameSet View/Set VLAN Ingress Frame type.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethMaxPacketAgeGet Show the maximum packet age for a LAN switch. Syntax: ethMaxPacketAgeSet NOTE: Displays the maximum packet age (in milliseconds) for all LAN switches. ethMaxPacketAgeSet View/Set Ethernet maximum packet age. Syntax: ethMaxPacketAgeSet Options: value in millisecond Sample Output: ethMaxPacketAgeSet 54999 ethMaxPacketAgeSet(1): ------------------------max. packet age: System=54999 ms NOTE: D000025-002 Rev.
3 – Virtual I/O Command Line Interface Groups and Commands S vlanGet View VLAN configuration.
A 3 – Virtual I/O Command Line Interface Groups and Commands vlanSet Set the VLAN configuration. Syntax: vlanSet [] [] Options: type name|guid host host name/guid ioc IOC number vlan type default|host pvid default PVID admit 1=tagged | 0=all (optional) instance host interface instance (optional) D000025-002 Rev.
3 – Virtual I/O Command Line Interface Groups and Commands S Sample Output: vlanSet name st130 1 13 13 1 0 vlanSet: action=1 target=4 defVlan=1 admitAll=0 IOC=1 PVID=13 hostInst=0 [Vi=81] [HostGUID=0x0002c90200216e18] [IOC=1] [Inst=0] [Name=st130] --ViPort: DefPVID=13 EgressFilter=yes IngressFilter=yes IngressFrame=tagged VLAN Map Membership:11 VLAN Map allowed tagging:--Empty-ExtPort[1]: DefPVID=11 EgressFilter=yes IngressFilter=yes IngressFrame=tagged VLAN Map Membership:11,13 VLAN Map allowed tagging:
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> vlanRem name st130 1 0 vlanRem: action=2 target=4 defVlan=1 admitAll=1 IOC=1 PVID=1 hostInst=0 [Vi=81] [HostGUID=0x0002c90200216e18] [IOC=1] [Inst=0] [Name=st130] --ViPort: DefPVID=1 EgressFilter=no IngressFilter=no IngressFrame=all VLAN Map Membership:--Empty-VLAN Map allowed tagging:--Empty-ExtPort[1]: DefPVID=1 EgressFilter=no IngressFilter=no IngressFrame=all VLAN Map Membership:--Empty-VLAN Map allowed tagging:--Empty— N
3 – Virtual I/O Command Line Interface Groups and Commands S Sample Output: ethExtInfoGet 1 External Ethernet port Alias Enabled Mac Address MTU Size Default User Priority Pvid STP Port State Acceptable Frame Types Ingress Filtering Lcl Queues Lcl Queue Idx Ag Idx Vlan Map Idx TpHCPortInDiscards Span Port Cos Count Ep Idx Switch Port Idx Operator Status Error No Ls Index : : : : : : : : : : : : : : : : : : : : : : NOTE: 1 Ext-1 1 00:06:6a:00:45:50 1518 2 1 0 1 2 0 0 0 0 0 0 0 0 1 2 0 1 Prints informat
A 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: ethVirtInfoGet 1 Virtual Nic Operator Status Error No External Ethernet port Remote Host Types MTU Size Pvid Default User Priority Acceptable Frame Types Ingress Filtering Vi L2r Paths Vi L2r Path Index Ag Index Vlan Map Index TpHCPortInDiscards Span Port Vi Port Index Cos Count In Use Last Host Name Last Host GUID Last Host Instance Date Last Used : : : : : : : : : : : : : : : : : : : : : : : 1 2 0 6 0 1 1 0 1 2 0 0 0 0 0 0 1 0
3 – Virtual I/O Command Line Interface Groups and Commands S Sample Output: ---------------------------------------------------------------------EP|Up| MTU|PVID|Pri|Sts| SwP| MAC |Ang|DefSpd|CurSpd| Alias ---------------------------------------------------------------------1 3 1518 1 2 2 1 00:06:6a:00:b6:42 * 1G f 1G f Ext-1 2 3 1518 1 2 2 2 00:06:6a:00:b6:43 * 1G f 1G f Ext-2 ---------------------------------------------------------------------Enbl: "*"=> enabled, "-"=> disabled Speed: "f"=> full duplex,
A 3 – Virtual I/O Command Line Interface Groups and Commands ethExtMirrorGet Print mirror information for the specified Ethernet port Syntax: ethExtMirrorGet or ethExtMirrorGet " , -> ethExtMirrorGet "1 2" Options: port External Ethernet port (or list of ports) to retrieve mirror information for. Sample Output: External Ethernet port 1 [Ext-1] is not participating in a mirror. External Ethernet port 2 [Ext-2] is not participating in a mirror.
3 – Virtual I/O Command Line Interface Groups and Commands NOTE: S Sets up a mirror between the specified monitor and mirror external Ethernet port. Neither port can be a part of an existing mirror or aggregration. Note that mirror configurations are not saved across a reboot of the EVIC. ethExtMirrorRem Destroy a mirror between two Ethernet ports.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethExtEnable Enable an Ethernet port(s). Syntax: ethExtEnable [port] Options: port The Ethernet port(s) to enable. Sample Output: -> ethExtEnable 1 Enabled External Ethernet port 1 [Ext-1]. NOTE: Enables the external Ethernet port. The port parameter can be either a single port, or a list of ports separated by spaces and enclosed in double quotes. ethExtDisable Disables the specified Ethernet port(s).
3 – Virtual I/O Command Line Interface Groups and Commands S ethExtCurrentSpeedGet Display the speed/duplex mode currently in use by the specified Ethernet port. Syntax: ethExtCurrentSpeedGet or ethExtCurrentSpeedGet " ..." Options: port External Ethernet port to read the speed/duplex mode currently in use. NOTE: Displays the current speed/duplex values in use by the specified external Ethernet port.
A 3 – Virtual I/O Command Line Interface Groups and Commands PartnerKey: 802.3ad partner key. PartnerID: 802.3ad partner system Id. For a manually configured aggregation, the following columns are displayed: Port: The external Ethernet port that this line refers to. Link: Link status for the port (i.e. up or down) Agg#: Aggregation the port currently belongs to Manual Agg #: Requested manual aggregation index Failover: Minimum number of ports for failover to run (if link is down).
3 – Virtual I/O Command Line Interface Groups and Commands S ethExtLacpDisable Disable 802.3ad for the specified Ethernet port. Options: port External Ethernet port (or list of ports) to disable Lacp. Sample Output: thExtLacpDisable 1 802.3ad Lacp disabled for External Ethernet port 1 [Ext-1]. NOTE: Disable 802.3ad Lacp for the specified port(s). If any of the ports are part of an aggregation, they will be removed before disabling Lacp.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethExtLacpKeyGet Read the 802.3ad Lacp actor key for the specified port. Syntax: Usage: ethExtLacpKeyGet or ethExtLacpKeyGet " ..." Options: port Displays the current Lacp actor key for the specified External Ethernet port. Sample Output: -> ethExtLacpKeyGet "1 2" 802.3ad Lacp actor key for External Ethernet port 1 [Ext-1]: 1 (00000001) 802.3ad Lacp actor key for External Ethernet port 2 [Ext-2]: 1 (00000001) NOTE: 802.
3 – Virtual I/O Command Line Interface Groups and Commands NOTE: S 802.3ad allows for ports to be configured with an actor key, designating which ports can be apart of the same aggregation (i.e., only ports with the same actor key can be a part of the same aggregation, regardless of how the partner's information matches up). This command modifies the Lacp key for the specified port(s). The port parameter can be either a single port, or a list of ports separated by spaces and enclosed in double quotes.
A 3 – Virtual I/O Command Line Interface Groups and Commands Options: port External Ethernet port (or list of ports) to configure into a manual aggregation. aggIdx Index/identifier for the manual aggregation to configure the port(s) into. Sample Output: -> ethExtAggregationSet 1 1 External Ethernet port 1 [Ext-1] manually configured into aggregation 1 NOTE: Link aggregation can be configured on a per-port basis to be determined automatically (via 802.3ad Lacp) or manually configured.
3 – Virtual I/O Command Line Interface Groups and Commands S Sample Output: -> ethExtLacpFailoverGet Port Min Ports for Failover -------------------------------------1 [Ext-1 ] : 0 2 [Ext-2 ] : 0 NOTE: When an external Ethernet link is removed or otherwise goes down, aggregation failover can take over and distribute the Ethernet traffic through other ports in the aggregation.
A 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: When an external Ethernet link is removed or otherwise goes down, aggregation failover can take over and distribute the Ethernet traffic through other ports in the aggregation. This setting controls the minimum number of ports that must be remaining in an aggregation for aggregation failover to run on the specified port.
3 – Virtual I/O Command Line Interface Groups and Commands S ethVirtAssignedHostSet Set assignment of the virtual port.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtAssignedHostRem Remove assignment of the virtual port. Syntax: ethVirtAssignedHostRem Options: instance port number Sample Output: ethVirtAssignedHostRem(2): -----------------------------------------Port Host(2) Inst IOC 84 (none) 0 0 ------------------------------------------ NOTE: Remove the assignment of virtual port to attach to a host.
3 – Virtual I/O Command Line Interface Groups and Commands NOTE: S Displays the port alias for all specified Ethernet ports. The port parameter can be either a single port, or a list of ports separated by spaces and enclosed in double quotes. ethExtAliasSet Modifies the alias for the specified Ethernet port(s). Syntax: ethExtAliasSet port alias Options: port External Ethernet port to assign the alias.
A 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: Show IGNORE VLAN flag for a host port. The port parameter can be either a single port, or a list of ports separated by spaces and enclosed in double quotes. ethVirtIgnoreVlanSet Allows the user to set the IGNORE VLAN flag for a host port(s). Syntax: ethVirtIgnoreVlanSet Options: port(s) Host port number(s). The port option can be a single port, or a list of ports separated by spaces and enclosed in double quotes.
3 – Virtual I/O Command Line Interface Groups and Commands S ethVirtIgnoreVlanRem Allows the user to remove the IGNORE VLAN flag for a host port(s). Syntax: ethVirtIgnoreVlanRem Options: port(s) Host port number(s). The port option can be a single port, or a list of ports separated by spaces and enclosed in double quotes. Sample Output: -> ethVirtIgnoreVlanRem 1 Port Ignore VLAN 1 No NOTE: Remove IGNORE VLAN flag from a host port.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtVnic2McastSet Enables the Vnic2Mcast feature for a virtual port. Syntax: ethVirtVnic2McastSet [portNumber] Options: portNumber The port that has the Vnic2Mcast feature enabled.. Sample Output: -> ethVirtVnic2McastSet "1 2 3" Port Vnic2 Multicast 1 Yes 2 Yes 3 Yes NOTE: A reboot is required to activate changes. ethVirtVnic2McastRem Removes the Vnic2Mcast feature for a virtual port.
3 – Virtual I/O Command Line Interface Groups and Commands S ethVnic2McastMtuGet Reads the current Vnic2Mcast MTU size. Syntax: ethVnic2McastMtuGet Options: None. Sample Output: -> ethVnic2McastMtuGet Link MTU for VNIC2 multicast groups : 4 (=> 2048) ethVnic2McastMtuSet Modifies the current Vnic2Mcast MTU size. Syntax: ethVnic2McastMtuSet [Vnic2McastMtu size] Options: Vnic2McastMtu size The Vnic2McastMtu size. Type the command with no size to display options.
A 3 – Virtual I/O Command Line Interface Groups and Commands ethVnic2McastRateGet Reads the current Vnic2Mcast rate setting used during registration. Syntax: ethVnic2McastRateGet Options: None. Sample Output: -> ethVnic2McastRateGet Link rate for VNIC2 multicast groups : 3 (=> 4x or 10G) ethVnic2McastRateSet Modifies the Vnic2Mcast rate setting used during registration. Syntax: ethVnic2McastRateSet Options: Vnic2Mcast rate The Vnic2Mcast rate setting to use.
S 3 – Virtual I/O Command Line Interface Groups and Commands Configuration confFileSave Saves the current configuration to a file on the local ramdisk in the /config directory. Syntax: confFileSave Options: file Name of the file in the /config directory to save the current configuration to. Sample Output: -> confFileSave NOTE: This routine generates a text-based configuration file from the current configuration. It is saved into the /config directory.
A 3 – Virtual I/O Command Line Interface Groups and Commands confFileCommit Loads and commits a configuration file to memory. Syntax: confFileCommit Options: filename Name of the configuration file to commit. Sample Output: -> confFileCommit NOTE: Loads, validates, and applies a configuration file to the system. confFileList List contents of the /config directory. Syntax: confFileList Options: None. Sample Output: -> confFileList NOTE: List the contents of the /config directory.
S 3 – Virtual I/O Command Line Interface Groups and Commands Options: filename The name of the file to display Sample Output: -> confFileShow NOTE: Displays the contents of a configuration file to the console. confFileBackup Transfer a saved configuration file to a remote FTP server. Syntax: confFileBackup Options: host The IP address of the FTP server. user User name for login to the FTP server. pass Password for login to the FTP server.
A 3 – Virtual I/O Command Line Interface Groups and Commands confFileRetrieve Retrieve a configuration file from an FTP server. Syntax: confFileRetrieve Options: host The IP address of the FTP server. user User name for login to the FTP server. pass Password for login to the FTP server. dir Remote directory location to retrieve the file from. file File name of the configuration file to be retrieved. Sample Output: -> confFileRetrieve NOTE: D000025-002 Rev.
3 – Virtual I/O Command Line Interface Groups and Commands 3-92 S D000025-002 Rev.
