Qlogic SilverStorm 9000 Reference Manual

Qlogic SilverStorm 9000 Reference Manual

Silverstorm 9000 series
Hide thumbs Also See for SilverStorm 9000:

Advertisement

SilverStorm 9000

CLI Reference Guide

D000025-002 Rev. A

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SilverStorm 9000 and is the answer not in the manual?

Questions and answers

Summary of Contents for Qlogic SilverStorm 9000

  • Page 1: Cli Reference Guide

    SilverStorm 9000 CLI Reference Guide D000025-002 Rev. A...
  • Page 2: Document Revision History

    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.
  • Page 3: Table Of Contents

    Table of Contents Introduction Intended Audience ..........License Agreements.
  • Page 4 SilverStorm 9000 CLI Reference Guide Linecard..........
  • Page 5: Introduction

    Virtual I/O (EVIC and FVIC) 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 SilverStorm 9000 series switches. License Agreements Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product.
  • Page 6: Technical Support

    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.
  • Page 7: Switch Command Line Interface

    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...
  • Page 8: Commands And Functional Groups

    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.
  • Page 9 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.
  • Page 10: Online Help

    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...
  • Page 11: Groups And Commands

    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 <SWITCH>...
  • Page 12 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.
  • Page 13 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...
  • Page 14 2 – Switch Command Line Interface Groups and Commands Sample Output: -> history command history [30 max lines]: list Deprecated Network Firmware IbSwitchInfo TimeManagement Snmp Ethernet help list history reboot Reboots the device. Syntax: reboot [now][-m][slot n][-s][-n][all] Options: Does not prompt the user before rebooting. Reboot Master (local) Spine 1 (non-disruptive).
  • Page 15 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.
  • Page 16 2 – Switch Command Line Interface Groups and Commands Sample Output: user role index logged in last cmd type ip address --------------------------------------------------------------------------------------------------- admin admin 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. 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).
  • Page 17 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.
  • Page 18 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 19 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: ->...
  • Page 20 2 – Switch Command Line Interface Groups and Commands echo Echoes text back to the output.. Syntax: echo [<text> ...] Options: [<text> ...] 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.
  • Page 21 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.
  • Page 22 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 23 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: ->...
  • Page 24 2 – Switch Command Line Interface Groups and Commands Options: None. Sample Output: -> userListShow username role operator1 operator USERID admin admin sshKey Syntax: sshKey <cmd> [-u <username>] [<input>] Options: show Displays the SSH public keys in the users authorized_keys file. add “<key>”...
  • Page 25 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.
  • Page 26 2 – Switch Command Line Interface Groups and Commands 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: ->...
  • Page 27 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.
  • Page 28 2 – Switch Command Line Interface Groups and Commands 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).
  • Page 29 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.
  • Page 30 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 31 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.
  • Page 32 2 – Switch Command Line Interface Groups and Commands 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: ->...
  • Page 33 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.
  • Page 34: Chassis

    2 – Switch Command Line Interface Groups and Commands 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.
  • Page 35 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 Fan Speed: [5m -1 RPM[0m PS2 Fan Speed: [5m -1 RPM[0m PS3 Fan Speed: -1 RPM[0m Fan Speed: 9642 RPM[0m PS5 Fan Speed:...
  • Page 36 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 37 2 – Switch Command Line Interface Groups and Commands Sample Output: -> fruInfo Display chassis info xInfo_ChassisInfo: RecType: 1LastRec: 0LenMult: ReadOnly: 1RecordFormat: 2RecLen: LogicalLen: HdrChkSum: 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)
  • Page 38 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 39: Network

    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: ->...
  • Page 40 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 41 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.
  • Page 42 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 43 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 Interface -------------------------------------------------------------------------- 172.26.0.203 00:11:25:c3:07:c5 mgmt_eth1 172.26.0.254 00:11:25:c3:07:c5 1419 mgmt_eth1 --------------------------------------------------------------------------...
  • Page 44 2 – Switch Command Line Interface Groups and Commands Sample Output: -> hostShow hostname inet address aliases -------- ------------ ------- localhost 127.0.0.1 home 10.90.90.0 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...
  • Page 45: Firmware

    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.
  • Page 46 2 – Switch Command Line Interface Groups and Commands 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...
  • Page 47 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. After logging in, the directory to cd to. filename The name of the firmware file.
  • Page 48 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 49 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.
  • Page 50 2 – Switch Command Line Interface Groups and Commands 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: ->...
  • Page 51 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.
  • Page 52 2 – Switch Command Line Interface Groups and Commands Sample Output: -> bootSelect 3 -noprompt Currently installed firmware versions index : alias : version -------------------------- : 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.
  • Page 53: Subnet Management

    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.
  • Page 54 2 – Switch Command Line Interface Groups and Commands 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: ->...
  • Page 55 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 Spine 1, Ch -----------------------------------------------------------------------------------------...
  • Page 56 2 – Switch Command Line Interface Groups and Commands 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: ->...
  • Page 57 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.
  • Page 58 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.
  • Page 59 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. Sample Output: -> smShowServices ****************************************************************** There is 1 Service Records *********************************************************...
  • Page 60 2 – Switch Command Line Interface Groups and Commands smShowSubscriptions Display event forwarding (subscription) table in the embedded subnet manager. Syntax: smShowSubscriptions Options: None. Sample Output: -> smShowSubscriptions ****************************************************************** There are 2 subscriptions ****************************************************************** Subscriber GID = 0xFE80000000000000:00066A00D8000163 Subscriber LID = 0x0071 Subscriber PKey = 0xFFFF...
  • Page 61 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: 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;...
  • Page 62 2 – Switch Command Line Interface Groups and Commands smShowLidMap Display the LID-to-port GUID map for the subnet manager. Syntax: smShowLidMap Options: None. Sample Output: -> smShowLidMap ---------------------------------------------------------------------- ------------ SM is currently in the MASTER state, with Topology Pass count = 341 ---------------------------------------------------------------------- ------------ Lid 0x0001: guid = 0x00066a000600013c, pass = 341, SilverStorm 9080...
  • Page 63 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.
  • Page 64 2 – Switch Command Line Interface Groups and Commands 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.096 * (2 ^ switchlifetime) microseconds.
  • Page 65 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. Sample Output: -> 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...
  • Page 66 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 67 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]]...
  • Page 68 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 69 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!
  • Page 70 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 71 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:...
  • Page 72 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 73 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.
  • Page 74 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 75 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. Sample Output: -> smDbSyncInterval 15 Set db sync interval to 15 minutes ->...
  • Page 76 2 – Switch Command Line Interface Groups and Commands Sample Output: -> 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)
  • Page 77 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.
  • Page 78 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 79 2 – Switch Command Line Interface Groups and Commands smShowRemovedPorts Display ports that have been automatically removed from the fabric. Syntax: smShowRemovedPorts Options: None. Sample Output: -> smShowRemovedPorts Disabled Ports: Node 0x00066a0007000001: SilverStorm 9080 GUID=0x00066a00da000001 Leaf 1, Chip A Port 12: Trap Threshold Exceeded Port 23: 1x Link Width 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...
  • Page 80: Log

    2 – Switch Command Line Interface Groups and Commands 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"...
  • Page 81 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.
  • Page 82 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 -------------------------- : Device : Logging device. (IE. Ram, syslog, etc) : Preset : General log filter.
  • Page 83 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]...
  • Page 84 2 – Switch Command Line Interface Groups and Commands logShowConfig Display the current log configuration settings. Syntax: logShowConfig Options: None. Sample Output: Log Configuration for Slot 101: ------------------------------ Configurable devices index : name : |D|F|E|A|W|P|C|I|P|N|1|2|3|4|5| ---------------------------------------------------- : Ram : |X|X|X|X|X| |X|X| |X| | | | | | : BriefRam : |X|X|X|X|X| | | | |X| | | | | | : Console : |X|X|X|X|X|X|X|X|X|X| | | | | |...
  • Page 85 2 – Switch Command Line Interface Groups and Commands Options: Send Error severity CSM test message to Syslog. Send Warning severity CSM test message to Syslog 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.
  • Page 86: Key Management

    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: 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.
  • Page 87 2 – Switch Command Line Interface Groups and Commands Options: None. Sample Output: -> removeKey -------------------------------------------------------- Key number: 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.
  • Page 88: Ibswitchinfo

    2 – Switch Command Line Interface Groups and Commands 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.
  • Page 89 2 – Switch Command Line Interface Groups and Commands NOTES: Port statistic descriptions: 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.
  • Page 90 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.
  • Page 91 0001 0 ( ) 0002 9 (S1AL03a) 0003 9 (S1AL03a) 0004 11 (S1AL03b) NOTES: The 'set' option is not available on the SilverStorm 9000 products. ismMultiFwdb Show Multicast Forwarding Database for switch. Syntax: ismMultiFwdb [switch] Options: switch Switch identifier. D000025-002 Rev. A...
  • Page 92 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 93 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.
  • Page 94 2 – Switch Command Line Interface Groups and Commands Sample Output: -> ismChassisSet12x L01P01 12x mode is DISABLED L01P02 12x mode is DISABLED L01P03 12x mode is DISABLED L01P04 12x mode is DISABLED L01P05 12x mode is DISABLED L01P06 12x mode is DISABLED L01P07 12x mode is DISABLED L01P08...
  • Page 95 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.
  • Page 96 2 – Switch Command Line Interface Groups and Commands 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).
  • Page 97 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:...
  • Page 98 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.
  • Page 99 2 – Switch Command Line Interface Groups and Commands Sample Output: -> ismIslSet12x L01S2Ba 12x mode is DISABLED L01S2Bb 12x mode is DISABLED L01S2Bc 12x mode is DISABLED L01S1Ba 12x mode is DISABLED L01S1Bb 12x mode is DISABLED L01S1Bc 12x mode is DISABLED L01S2Aa 12x mode is DISABLED L01S2Ab 12x mode is DISABLED NOTE:...
  • Page 100 2 – Switch Command Line Interface Groups and Commands NOTE: 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.
  • Page 101 2 – Switch Command Line Interface Groups and Commands Sample Output: -> ismShowPStatThresh Field Threshold Time Unit ----- --------- --------- portXmitData: (Percent of Max) portRecvData: (Percent of Max) portXmitPkts: (Percent of Max) portRecvPkts: (Percent of Max) portXmitWait: (1 Second) portSymbolErr: (1 Second) portLinkErrRecv: (1 Second)
  • Page 102 2 – Switch Command Line Interface Groups and Commands 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:...
  • Page 103 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: 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.
  • Page 104 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 105: Timemanagement

    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: ->...
  • Page 106 2 – Switch Command Line Interface Groups and Commands NOTE: 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;...
  • Page 107 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.
  • Page 108 2 – Switch Command Line Interface Groups and Commands 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...
  • Page 109: Snmp

    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: A read-only community string. A read/write community string. Sample Output: -> snmpCommunityConf -r public Read Only Community String Was Set To: public NOTE: If no options are entered the current SNMP read-only community...
  • Page 110 2 – Switch Command Line Interface Groups and Commands Options: show Displays the contents of the snmpTargetAddrTable. Adds a row to the snmpTargetAddrTable. edit Modifies an existing row in the snmpTargetAddrTable. delete Removes an existing row of the snmpTargetAddrTable. Name. A unique name used to identify a row. Any name with a space (e.g. xxx v3) must be surrounded by double quotes (").
  • Page 111 2 – Switch Command Line Interface Groups and Commands snmpTargetParams Displays the snmpTargetParamsTable entries. Syntax: snmpTargetParams [show] Options: show Displays the contents of the snmpTargetParamsTable. Sample Output: -> snmpTargetParams rfc2573t:snmpTargetParamsMPModel: v1 params : 0 rfc2573t:snmpTargetParamsMPModel: v2 params : 1 rfc2573t:snmpTargetParamsMPModel: v3 params : 3 rfc2573t:snmpTargetParamsSecurityModel: v1 params : 1 rfc2573t:snmpTargetParamsSecurityModel: v2 params : 2 rfc2573t:snmpTargetParamsSecurityModel: v3 params : 3...
  • Page 112 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.
  • Page 113 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.
  • Page 114 2 – Switch Command Line Interface Groups and Commands NOTE: 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 an entry to the V3 user table.
  • Page 115: Capture

    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.
  • Page 116 2 – Switch Command Line Interface Groups and Commands 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.
  • Page 117 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:...
  • Page 118 2 – Switch Command Line Interface Groups and Commands 2-112 D000025-002 Rev. A...
  • Page 119: Virtual I/O Command Line Interface

    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.
  • Page 120 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.
  • Page 121: Online Help

    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...
  • Page 122: Groups And Commands

    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 <SWITCH> CLI. Type 'list' for the list of commands. 4. At the system prompt enter the following command:: rlogin <slot#>...
  • Page 123 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> cardInfo Out of Band LAN IP : 172.26.2.87 Net Mask : 255.255.240.0 MAC Address : 00:06:6a:00:50:ba Description : --Empty; No Value Set-- Alias : VIO IB Node Description : VIO, slot L6, 0x133 Non-Fatal Errors Fatal Errors Card Description...
  • Page 124 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> cardFatalErrGet Fatal Errors 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.
  • Page 125 3 – Virtual I/O Command Line Interface Groups and Commands cardDescSet Modifies the linecard description. Syntax: cardDescSet <string> 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:...
  • Page 126 3 – Virtual I/O Command Line Interface Groups and Commands cardAliasSet Modifies the linecard Alias. Syntax: cardAliasSet <string> 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 [<default>] Options:...
  • Page 127 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"...
  • Page 128 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: 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.
  • Page 129 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 <string> Options: string Name text string. Sample Output: ->...
  • Page 130 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: cardInfo is a related command. cardLocationSet Modifies the linecard location information. Syntax: cardLocationSet <string> Options: string Location text string. Sample Output: -> cardLocationSet "Lower Chassis, Slot 6" Card Location : Lower Chassis, Slot 6 NOTE: cardInfo is a related command.
  • Page 131: Firmware

    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: MBC Version:...
  • Page 132 3 – Virtual I/O Command Line Interface Groups and Commands 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.
  • Page 133 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> bootSelect 103 -noprompt Currently installed firmware versions index : alias : version -------------------------- : 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.
  • Page 134: Log

    3 – Virtual I/O Command Line Interface Groups and Commands 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.
  • Page 135 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.
  • Page 136 3 – Virtual I/O Command Line Interface Groups and Commands 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.
  • Page 137: Fibrechannel

    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. Sample Output: -> fcPortSpeedGet Admin Link Oper Port Alias PortWWN...
  • Page 138 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcPortSpeedSet 1 1 Setting speed to 1 Updated the topology. Note that the board needs to be rebooted in order for the change to take effect Admin Link Oper Port Alias PortWWN...
  • Page 139 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: ->...
  • Page 140 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcPortAliasGet Admin Link Oper Port Alias PortWWN NPortId Topology Speed Status Speed SFP Status 1 plc2a 0x500066A1DD000019 0x000000 Fabric Auto Down 2 plc2b 0x500066A2DD000019 0x000000 Fabric Auto Down Not Installed 3 plc2c...
  • Page 141 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:...
  • Page 142: Device Name

    3 – Virtual I/O Command Line Interface Groups and Commands Options: Index Optional index of the device from the configured device list. Sample Output: -> fcConfiguredDevicesGet Ref# NodeWWN PortWWN Port# NPortId COS ConnectStatus Name 0x20000004CF8C02E7 0x22000004CF8C02E7 0x0106d1 Connected 0x50060E801042B920 0x50060E801042B920 0x0108ef Connected Hitachi P1 via p1...
  • Page 143 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 <Device Index> <Name> Options: Device Index Index number from the results of the configured device list. Name New name for the device.
  • Page 144 3 – Virtual I/O Command Line Interface Groups and Commands fcSrpDiscoveredInitiatorsGet Displays the SRP Initiators found during the last discovery cycle. Syntax: fcSrpDiscoveredInitiatorsGet Options: None. Sample Output: -> fcSrpDiscoveredInitiatorsGet Ref# Initiatorport Identifier (0002C902003FFFFC:0000000000000001) (0002C902003FFFFC:0000000000000002) (0002C902003FFFFC:0000000000000003) (0002C902003FFFFC:0000000000000004) (00066A00A0006C20:0000000000013807) fcSrpConfiguredInitiatorsGet Display SRP Initiators that have already been configured. Syntax: fcSrpConfiguredInitiatorsGet Options:...
  • Page 145 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcSrpConfiguredInitiatorsGet Ref# IB GUID SRP Extension ActiveConnections Name (00066A00A0006801:0000000000009601) st96 (00066A00A0006801:0000000000009602) st9602 (00066A00A0006801:0000000000009603) st9603 (00066A00A0006801:0000000000009604) st9604 (00066A00A0006801:0000000000009605) st9605 (00066A00A0006801:0000000000009606) st9606 (00066A00A0007115:0000000000013601) st136 01 (00066A00A0003F87:0000000000008203) st82 03 (00066A00A0006CA8:0000000000010004) st100 04 (00066A00A0006CA0:0000000000004205) st42 05...
  • Page 146 3 – Virtual I/O Command Line Interface Groups and Commands 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.
  • Page 147 3 – Virtual I/O Command Line Interface Groups and Commands fcSrpMapShowConnections Retrieve SRP initiator connection information. Syntax: fcSrpMapShowConnections <Initiator Index> Options: Initiator Index An initiator number from the configured initiator list. Executing this command without this option will display all initiator connections. Sample Output: ->...
  • Page 148 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.
  • Page 149 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. The IOC number (either 1 or 2).
  • Page 150 3 – Virtual I/O Command Line Interface Groups and Commands 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. The IOC number (either 1 or 2). Status The type of SRP Map (A=Active or I=Inactive) Sample Output:...
  • Page 151 3 – Virtual I/O Command Line Interface Groups and Commands Options: Initiator Index The index number from the Configured SRP Initiators list. 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.
  • Page 152 3 – Virtual I/O Command Line Interface Groups and Commands 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:...
  • Page 153 3 – Virtual I/O Command Line Interface Groups and Commands Options: SRP Initiator Index The index number from the Configured SRP Initiators list. 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.
  • Page 154 3 – Virtual I/O Command Line Interface Groups and Commands fcTargetDeviceStatsGet Display the Fibre Channel Target Device statistics. Syntax: fcTargetDeviceStatsGet Options: <Device> Optional Device Index. Sample Output: -> fcTargetDeviceStatsGet Ref# NodeWWN PortWWN Port# NPortId COS ConnectStatus Name Device 1: 2e7 p1 NodeWWN=20000004CF8C02E7 PortWWN=22000004CF8C02E7 PortIndex=1 ConnectStatus=Connected...
  • Page 155 3 – Virtual I/O Command Line Interface Groups and Commands fcSrpInitiatorStatsGet Display the SRP Initiator Statistics. Syntax: fcSrpInitiatorStatsGet Options: <Initiator> Optional Initiator Index. Sample Output: -> fcSrpInitiatorStatsGet Initiator 1, (st96) using GUID: 00066A00A0006801 SRP Ext:0000000000009601 ActiveConnections TotalRequests SucceededRequests FailedRequests OutstandingRequests = 0 TotalDataIn TotalDataOut Initiator 2, (st9602) using GUID: 00066A00A0006801 SRP...
  • Page 156 3 – Virtual I/O Command Line Interface Groups and Commands fcPortStatsGet Display Fibre Channel Port Statistics. Syntax: fcPortStatsGet [PortNumber] Options: PortNumber The Fibre Channel port number for the device. Sample Output: -> fcPortStatsGet Port Ext1: VIO 00066a00e0000133 Port 1 Alias : Ext-1 NodeWWN : 500066A0E0000133...
  • Page 157 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcTrapStatusGet Valid Traps: 1) Interconnect Link Up : enabled 2) Interconnect Link Down : enabled 3) Target Device Link Up : enabled 4) Target Device Link Down : enabled fcTrapEnable Enable specified Fibre Channel traps.
  • Page 158 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.
  • Page 159 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcVirtPortShow WWN Key: T4WD5G-S6A5U2-QA28A7-32QKS8-ZS8AW7-G Index | | Alias | PhyPort Status | Name ---------------------------------------------------------------------- 0001 | 0x500066A0E2000199 | Ext-1 | | Active | Test-0001 0002 | 0x500066A0E2200199 | | Unassigned | Inactive | WWN-0002 0003 | 0x500066A0E2400199 | | Unassigned | Inactive | WWN-0003...
  • Page 160 3 – Virtual I/O Command Line Interface Groups and Commands fcVirtPortNameSet Set the text name field of the virtual port Syntax: fcVirtPortNameSet <Index> <Name> Options: Index The index from the Virtual Port list. Name The text name for the Virtual Port. Sample Output: ->...
  • Page 161 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcVirtPortPhyPortSet 1 2 Index | VirtPort WWN PhyPort Status | VirtPort Name -------------------------------------------------------------------------- 0001 | 500066A0E2000199 | Inactive | WWN-0001 NOTE: The virtual port must be inactive for the assignment to be successful. Use port zero to unassign a virtual port.
  • Page 162 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: -> fcVirtPortPoolCreate <license key> Virtual Port Pool key accepted. Virtual Port Pool Key: <license 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 0126 | 500066AFE2A00199 | Unassigned | Inactive | WWN-0126...
  • Page 163: Ethernet

    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.
  • Page 164 3 – Virtual I/O Command Line Interface Groups and Commands ethViPortsGet Displays the VIPORT counts. Syntax: ethViPortsGet Options: None. Sample Output: -> ethViPortsGet ViPorts: Current : Saved Maximum : MAC Addr: NOTE: Prints the current and saved VIPORT counts for the system. The current VIPORT count is the number of active host connections.
  • Page 165 3 – Virtual I/O Command Line Interface Groups and Commands ethExtPauseGet Read whether PAUSE is enabled or disabled Syntax: ethExtPauseGet <port> 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.
  • Page 166 3 – Virtual I/O Command Line Interface Groups and Commands 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...
  • Page 167 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...
  • Page 168 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 : 0x00000000 : 0 Octets : 0x00019a51 : 105041 Packets : 0x0000048b : 1163 Broadcast Pkts : 0x00000054 : 84 Multicast Pkts : 0x00000437 : 1079...
  • Page 169 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. Sample Output: ethVirtStatsGet 1 Current stats for virtual port 1: Incoming Broadcast Pkts : 0x00000066 : 102...
  • Page 170 3 – Virtual I/O Command Line Interface Groups and Commands vlanDot1qPvidGet View/Set VLAN Dot1qPvid for a port. Syntax: vlanDot1qPvidGet <target> <instance> 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.
  • Page 171 3 – Virtual I/O Command Line Interface Groups and Commands vlanMapTaggedGet Show VLAN PVID tagged map. Syntax: vlanMapTaggedGet <target> <instance> Options: target eth|vi instance(s) port number Sample Output: -> vlanMapTaggedGet vi 56 vlanMapTaggedGet(0): vi(2) flag=0 ------------------------- Port=56 Total PVID=1 ----------------------------- ->...
  • Page 172 3 – Virtual I/O Command Line Interface Groups and Commands vlanMapTaggedSet Update VLAN PVID tagged map. Syntax: vlanMapTaggedSet <target> <instance(s)> <pvid(s)> <flag 0-remove|1-add> 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.
  • Page 173 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 ----------------------------- -> 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.
  • Page 174 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: 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.
  • Page 175 3 – Virtual I/O Command Line Interface Groups and Commands vlanEgressRuleGet View/Set VLAN Egress rule(s). Syntax: vlanEgressRuleGet <target> <instance(s)> Options: target eth|vi|ioc instance(s) port number(s)/IOC GUID Sample Output: -> vlanEgressRuleGet vi 56 vlanEgressRuleGet(0): Flag=0(1-enable|0-disable) vi(2) Result(>1 => error) ------------------------- vi:56 ->...
  • Page 176 3 – Virtual I/O Command Line Interface Groups and Commands vlanEgressRuleSet View/Set VLAN Egress rule(s). Syntax: vlanEgressRuleSet <target> <instance(s)> <flag 1-enable|0-disable> 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.
  • Page 177 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 -> vlanIngressRuleGet eth 1 vlanIngressRuleGet(0): eth(1) flag[1-enable|2-disable] ------------------------- eth:1 [Ext-1] NOTE: Displays the VLAN Ingress rule flag for port(s) (Ethernet port/virtual port/IOC GUID).
  • Page 178 3 – Virtual I/O Command Line Interface Groups and Commands vlanIngressFrameGet View/Set VLAN Ingress Frame type. Syntax: vlanIngressFrameGet <target> <instance(s)> 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.
  • Page 179 3 – Virtual I/O Command Line Interface Groups and Commands ethMaxPacketAgeGet Show the maximum packet age for a LAN switch. Syntax: ethMaxPacketAgeSet <value> NOTE: Displays the maximum packet age (in milliseconds) for all LAN switches. ethMaxPacketAgeSet View/Set Ethernet maximum packet age. Syntax: ethMaxPacketAgeSet <value>...
  • Page 180 3 – Virtual I/O Command Line Interface Groups and Commands vlanGet View VLAN configuration. Syntax: vlanGet <type> <host> <ioc> [<instance(s)>] Options: type name|guid host host name/guid IOC number instance host interface instance(s) (optional) Sample Output: vlanGet name st130 1 0 vlanGet: action=0 target=4 defVlan=1 admitAll=1 IOC=1 PVID=1 hostInst=0 [Vi=81] [HostGUID=0x0002c90200216e18] [IOC=1] [Inst=0] [Name=st130]...
  • Page 181 3 – Virtual I/O Command Line Interface Groups and Commands vlanSet Set the VLAN configuration. Syntax: vlanSet <type> <host> <ioc> <vlan> <pvid> [<admit>] [<instance(s)>] Options: type name|guid host host name/guid IOC number vlan type default|host pvid default PVID admit 1=tagged | 0=all (optional) instance host interface instance (optional) D000025-002 Rev.
  • Page 182 3 – Virtual I/O Command Line Interface Groups and Commands 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...
  • Page 183 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--...
  • Page 184 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: ethExtInfoGet 1 External Ethernet port : 1 Alias : Ext-1 Enabled Mac Address : 00:06:6a:00:45:50 MTU Size : 1518 Default User Priority Pvid STP Port State Acceptable Frame Types : 1 Ingress Filtering Lcl Queues Lcl Queue Idx...
  • Page 185 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: ethVirtInfoGet 1 Virtual Nic Operator Status Error No External Ethernet port : 6 Remote Host Types MTU Size Pvid Default User Priority Acceptable Frame Types : 1 Ingress Filtering Vi L2r Paths Vi L2r Path Index Ag Index...
  • Page 186 3 – Virtual I/O Command Line Interface Groups and Commands Sample Output: ---------------------------------------------------------------------- EP|Up| MTU|PVID|Pri|Sts| SwP| |Ang|DefSpd|CurSpd| Alias ---------------------------------------------------------------------- 3 1518 1 00:06:6a:00:b6:42 * 1G f 1G Ext-1 3 1518 2 00:06:6a:00:b6:43 * 1G f 1G Ext-2 ---------------------------------------------------------------------- Enbl: "*"=> enabled, "-"=> disabled Speed: "f"=>...
  • Page 187 3 – Virtual I/O Command Line Interface Groups and Commands ethExtMirrorGet Print mirror information for the specified Ethernet port Syntax: ethExtMirrorGet <port> or ethExtMirrorGet "<port1> <port2> , -> 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.
  • Page 188 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: 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.
  • Page 189 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.
  • Page 190 3 – Virtual I/O Command Line Interface Groups and Commands ethExtCurrentSpeedGet Display the speed/duplex mode currently in use by the specified Ethernet port. Syntax: ethExtCurrentSpeedGet <port> or ethExtCurrentSpeedGet "<port1> <port2> ..." 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.
  • Page 191 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...
  • Page 192 3 – Virtual I/O Command Line Interface Groups and Commands 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).
  • Page 193 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 <port> or ethExtLacpKeyGet "<port1> <port2> ..." Options: port Displays the current Lacp actor key for the specified External Ethernet port. Sample Output: ->...
  • Page 194 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: 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).
  • Page 195 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...
  • Page 196 3 – Virtual I/O Command Line Interface Groups and Commands 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.
  • Page 197 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.
  • Page 198 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtAssignedHostSet Set assignment of the virtual port. Syntax: ethVirtAssignedHostSet <instance> <type> <host> <instance> <ioc> Options: instance port number type type=name|guid host host name/GUID instance host instance IOC number Sample Output: ethVirtAssignedHostSet 1 name st61 3 1 ethVirtAssignedHostSet(1): ------------------------------------------...
  • Page 199 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtAssignedHostRem Remove assignment of the virtual port. Syntax: ethVirtAssignedHostRem <instance(s)> Options: instance port number Sample Output: ethVirtAssignedHostRem(2): ------------------------------------------ Port Host(2) Inst IOC (none) ------------------------------------------ NOTE: Remove the assignment of virtual port to attach to a host. Related commands: ethVirtAssignedHostGet, ethVirtAssignedHostSet ethExtAliasGet Display the alias currently assigned for the Ethernet port(s).
  • Page 200 3 – Virtual I/O Command Line Interface Groups and Commands NOTE: 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).
  • Page 201 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.
  • Page 202 3 – Virtual I/O Command Line Interface Groups and Commands ethVirtIgnoreVlanRem Allows the user to remove the IGNORE VLAN flag for a host port(s). Syntax: ethVirtIgnoreVlanRem <port(s)> 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.
  • Page 203 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 NOTE: A reboot is required to activate changes.
  • Page 204 3 – Virtual I/O Command Line Interface Groups and Commands 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:...
  • Page 205 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.
  • Page 206: Configuration

    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 <file> Options: file Name of the file in the /config directory to save the current configuration to. Sample Output: ->...
  • Page 207 3 – Virtual I/O Command Line Interface Groups and Commands confFileCommit Loads and commits a configuration file to memory. Syntax: confFileCommit <filename> 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.
  • Page 208 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 <host>...
  • Page 209 3 – Virtual I/O Command Line Interface Groups and Commands confFileRetrieve Retrieve a configuration file from an FTP server. Syntax: confFileRetrieve <host> <user> <pass> <dir> <file> 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.
  • Page 210 3 – Virtual I/O Command Line Interface Groups and Commands 3-92 D000025-002 Rev. A...

Table of Contents