Q-Logic 5602 manual

Simplify R 59183-01 A Page i SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Firmware V ersion 6.7[...]

Page ii 59183-01 A S SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide © 2000–2007 QLogic Corporation. All Rights Reserved Worldwide. First Published: December 2005 QLogic Corporation, 26650 Aliso Viejo Parkway , Al iso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000 Information fu rnished in this manual is believed to be ac[...]

59183-01 A Page iii T able of Content s Section 1 Introduction 1.1 Switch Models and Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2 1.2 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2 1.3 Related Materials . . . . . . . . . . . . . . . . . . . . . . . . [...]

Page iv 59183-01 A SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide S 5.1.4 Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-5 5.1.4.1 Switch Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . .5-5 5.1.4.2 Zoning Configuration Parameters . . . . . . . . . . . . . [...]

59183-01 A Page v SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A 6.6.1 Online T ests for Port s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12 6.6.2 Offline T est s for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13 6.6.3 Display Port T est Results. . . . [...]

Page vi 59183-01 A SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide S 7.8.5 Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18 7.8.6 Remove Members from an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18 Section 8 Connection Secu rity Configuration 8.1 Managing SSL[...]

59183-01 A Page vii SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A Section 1 1 Event Log Configuration 1 1.1 S ta rting and S topping Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 1-1 1 1.2 Displaying the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 1-[...]

Page viii 59183-01 A SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide S Lip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-37 Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-38 Passwd . . . . . . . . . . . . . . [...]

59183-01 A Page ix SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A Show FDMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-1 1 1 Show Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-1 13 Show Log. . . . . . . . . . . . . . . . . . [...]

Page x 59183-01 A SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide S List of T ables T able Page 2-1 Command-Line Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3 3-1 Factory User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

59183-01 A 1-1 Section 1 Introduction This guide describes the feature s and use of the command line interface for SANbox 5000 Series switches running fi rmware version 6.7. This guide is organized as follows:  Section 1 describes switch models and features, the inten ded audience, related materials, new items in this release, and technical supp[...]

1 – Introduction Switch Models and Examples 1-2 59183-01 A S 1.1 Switch Models and Examples The commands and displays of the command line interface vary depending on the switch model. All examples in this gu ide are t aken from a SANbox 5600 switch unless state d otherwise. 1.2 Intended Audience This guide is intended for individ uals who are res[...]

1 – Introduction New in This Release 59183-01 A 1-3 A 1.4 New in This Release The following features are new in this relea se:  The switch is equipped with the Qu ickT ools embedded graphical user interface. QuickT ools is a web applet that provides basic fabric managemen t tools.  The following optional features ar e a vailable with the pu[...]

1 – Introduction T echnical Support 1-4 59183-01 A S 1.5 T echnical Support Customers should cont act their authorized maintenance provider for technical support of their QLogic switch product s. QLogic-direct customers may contact QLogic T echnical Support; others will be redire cted to their authorized maintenance provider . Visit the QLogic su[...]

1 – Introduction T echnical Support 59183-01 A 1-5 A 1.5.3 Cont act Information Support Headquarters QLogic Cor poration 12984 V alley View Road Eden Prairie, MN 55344-3657 USA QLogic Web Site www .qlogic.com T echnical Support Web Site support.qlogic.com T echnical Support Email support@qlog ic.com T echnical Tra ining Email tech.training@qlogic[...]

1 – Introduction T echnical Support 1-6 59183-01 A S Notes[...]

59183-01 A 2-1 Section 2 Command Line Interface Usage This section describes the f ollowing tasks:  Logging In to the Switch  Opening and Closing an Admin Session  Entering Commands  Getting Help  Setting Page Breaks  Creating a Support File  Downloading and Uploading Files NOTE: Throughout this document, references in text to [...]

2 – Command Line Interface Usage Logging In to the Switch 2-2 59183-01 A S 2.1 Logging In to the Switch T o log in to a switch through T elnet, open a command line window on the workstation and e nter the T elnet command followed by the switch IP address: # telnet ip_address The T elnet window opens prompting you for a login. Enter an account nam[...]

2 – Comma nd Line I nterface Usage Opening and Closing a n Admin Session 59183-01 A 2-3 A 2.2 Opening and Closing an Admin Session The command line interface performs mon itoring and configuration tasks. Commands that perform monitoring t asks are available to all user accounts. Commands that perform configuratio n tasks are available only af ter[...]

2 – Command Line Interface Usage Getting Help 2-4 59183-01 A S 2.4 Getting Help T o display help for a command, enter the Help command follo wed by the command. The following is an example of the help th at is available for the Config Edit command. SANbox #> help config edit config edit [CONFIG_NAME] This command initiates a configuration sess[...]

2 – Comma nd Line I nterface Usage Creating a Support Fil e 59183-01 A 2-5 A 2.6 Creating a Support File If you contact tech nical support about a pr oblem with your switch, they may request that you create and send a support file. This support file cont ains all of the switch configuration information which can be he lpful in diagnosing the prob[...]

2 – Command Line Interface Usage Creating a Support File 2-6 59183-01 A S If your workstation does no t have an FT P server , enter the Create Support command to create the support file, an d use FTP to download the support file from the switch to your workstatio n as shown in the following example: SANbox #> create support Log Msg:[Creating t[...]

2 – Comma nd Line I nterface Usage Downloading and Uploading Files 59183-01 A 2-7 A 2.7 Downloading an d Uploading Fi les There are several files that reside on t he switch that you can download to the workstation for examination or f or safe keeping. These files include the following:  Backup configuration file (configdata)  Log files (log[...]

2 – Command Line Interface Usage Downloading and Uploading Files 2-8 59183-01 A S T o upload a file from the workst ation to the switch, do the following 1. Enter the FTP command and the switch IP address or symbolic na me. >ftp 10.0.0.1 2. When prompted for a user and p assword, enter the FTP account name and password (images, image s). user:[...]

59183-01 A 3-1 Section 3 User Account Configuration User accounts and their respective passwords are the first line of switch security . A user account consist s of an account name, an auth ority level, and a n expiration date. Switches come from the factory with cert ain user accounts defined for special purposes. T able 3-1 describes these accoun[...]

3 – User Account Configuration Displaying User Account Information 3-2 59183-01 A S 3.1 Displaying User Account Information Y ou can display all user account s defined on the switch ( User Account s command) or just those user accounts that are logged on (User List or Show Users commands). The following example displays all u ser accounts defined[...]

3 – User Account Configuration Creating User Account s 59183-01 A 3-3 A 3.2 Creating User Account s A user account consist s of an account name, an auth ority level, and a n expiration date. The account name can b e up to 15 characters and must begin with an alphanumeric character . The authority le vel grant s admin authority (true) or denies it[...]

3 – User Account Configuration Modifying User Account s and Passwords 3-4 59183-01 A S 3.3 Modifying User Acco unt s and Passwords Only the Admin user account ca n modify a user account, delete a u ser account, or change the password o f another user account. However , all user accounts can change their own p asswords. The User command modifies a[...]

59183-01 A 4-1 Section 4 Network and Fabric Configuration The switch network configuratio n consists of the following:  Network discovery method  IP address  Subnet mask  IP gateway address The network discovery method determines how the switch acquires it s IP address. The IP address can come from the IP address that resides on the swi[...]

4 – Network and Fabric Configura tion Displaying Name Server Information 4-2 59183-01 A S 4.1 Displaying Name Server Information The Show NS command displays the list of WWNs in fab ric as shown in the following example: SANbox #> show ns all Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN --- ------ ------ ---- --- ------- ------- No e[...]

4 – Network and Fabric Configuration Displaying the Ethernet Netwo rk Configuration 59183-01 A 4-3 A 4.2 Displaying the Ethernet Network Conf iguration The Show Fabric command displays IP addresses (Enet IP Addr) for all switches in the fabric as shown in the following example. SANbox #> show fabric Domain WWN Enet IP Addr FC IP Addr SymbolicN[...]

4 – Network and Fabric Configura tion Configuring the Ethe rnet Port 4-4 59183-01 A S 4.3 Configuring the Ethernet Port Configure the switch Ethernet port using the Set Setup System command within an Admin session. The following exampl e configures a new IP address, subnet mask, and gateway address. SANbox (admin) #> set setup system A list of[...]

4 – Network and Fabric Configuration V erifying a Switch in the Network 59183-01 A 4-5 A 4.4 V erifying a Switch in the Network Y ou can verify that a switch is communicating in the netwo rk using the Ping command. The following example successfully test s the network for a switch with IP address 10.20.1 1.57. SANbox #> ping 10.20.11.57 Ping c[...]

4 – Network and Fabric Configura tion V erifying and T r acing Fi bre Channel Connections 4-6 59183-01 A S Enter the Fctrace command to display Fibre Channel routing information between two devices as shown in the following ex ample. The devices can b e defined as Fibre Channel addresses or WWNs. SANbox#> fctrace 970400 970e00 hops 5 36 bytes [...]

59183-01 A 5-1 Section 5 Switch Configuration Switch configuration consist s of the following tasks:  Displaying Switch Information  Managing Switch Services  Managing Switch Configurations  Paging a Switch  Setting the Date and T ime  Resetting a Switch  Installing Firmware  Managing Switch Feature Upgrades 5.1 Displaying S[...]

5 – Switch Configuration Displaying Switch Information 5-2 59183-01 A S 5.1.1 Switch Operational Information The Show Switch command displays a va riety of switch operational information. These include the switch WWN, domain ID, firmware version, administrative st ate, and operational st ate as shown in the following example: SANbox #> show sw[...]

5 – Switch Configuration Displaying Switch Information 59183-01 A 5-3 A 5.1.2 System Proce ss Information The Ps command displays system process information to help you determine what processes are running and CPU usage. The following example displays current system processes. SANbox #> ps PID PPID %CPU TIME ELAPSED COMMAND 338 327 0.0 00:00:0[...]

5 – Switch Configuration Displaying Switch Information 5-4 59183-01 A S 5.1.3 Elap sed Time Between Reset s The Uptime command displ ays the elapsed time si nce the switch was last reset and the reset method. A hot reset o r non-disruptive firmware activation does not reset the elapsed time reported by this command. The followin g example display[...]

5 – Switch Configuration Displaying Switch Information 59183-01 A 5-5 A 5.1.4 Configuration Information The Show Config command displays a variety of config uration information at the port and switch levels. In addition to t he ba sic switch configurations, the Show Config command displays parameters that control how data is maintained in the sec[...]

5 – Switch Configuration Displaying Switch Information 5-6 59183-01 A S 5.1.4.2 Zoning Configuration Parameters Enter the Show Config Zoning command to display zoning configuration parameters. These p arameters determine how zoning is applied to the switch. Refer to T able 13-19 for a description of these parameters. SANbox #> show config zoni[...]

5 – Switch Configuration Displaying Switch Information 59183-01 A 5-7 A 5.1.5 Hardware Information Enter the Show Chassis command to display the st atus of the switch hardware including fans, power supplies, internal tempe rature, and Heartbeat LED status. The following is an example of th e Show Chassis co mmand for model 5602: SANbox #> show[...]

5 – Switch Configuration Displaying Switch Information 5-8 59183-01 A S 5.1.6 Firmware Information Enter the Show V ersion command to display a sum mary of switch identity information including the firmware ve rsion. The following is an example of the Show V ersion command: SANbox #> show version ***********************************************[...]

5 – Switch Configuration Managing Switch Services 59183-01 A 5-9 A 5.2 Managing Switch Services Y ou can configure your switch to suit the demands of yo ur environment by enabling or disabling a variety of switch services. Y ou manage the switch services using the Show Setup Services and Se t Setup Services commands. Refer to T able 13-21 for a d[...]

5 – Switch Configuration Managing Switch Services 5-10 59183-01 A S Enter the Set Setup Services command within a n Admin session to configure the switch services as shown in the followin g example: SANbox #> admin start SANbox (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new val[...]

5 – Switch Configuration Managing Switch Configurations 59183-01 A 5-1 1 A 5.3 Managing Switch Configurations The switch configuration determin es the basic operational characteristics of the switch. A switch support s up to 10 configurations including the def ault configuration, named Default Config. The current switch operating characteristics [...]

5 – Switch Configuration Managing Switch Configurations 5-12 59183-01 A S 5.3.3 Copy a Switch Configuration Enter the Config Copy command to create a copy of an existing c onfiguration as shown in the following example: SANbox (admin) config copy config_1 config_2 5.3.4 Delete a Switch Configuration Enter the Config Delete command to delete a con[...]

5 – Switch Configuration Managing Switch Configurations 59183-01 A 5-13 A The following is an example of the Set Config Switch comma nd. Refer to T able 13-17 for a description of the switch configuration p arameters. SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config switch A list of attributes with [...]

5 – Switch Configuration Managing Switch Configurations 5-14 59183-01 A S 5.3.6 Back Up and Restore a Switch Configuration Successful management of switches and f abrics depends on th e effective use of switch configurations. Backing up and restor ing a configuration is useful to protect your work or for use as a template in configuring other swi[...]

5 – Switch Configuration Managing Switch Configurations 59183-01 A 5-15 A 5.3.6.2 Downloading the Configuration File Y ou use FTP to download the configda ta file to your workst ation for safe keeping and to upload the file back to the switch for the restore function. T o download the configdata file, ope n an FTP session on the switch and login [...]

5 – Switch Configuration Managing Switch Configurations 5-16 59183-01 A S 5.3.6.3 Restoring the Configuration File The restore operation begins wit h FTP to upload the configuration file from the workstation to the switch, then finishes with a T elnet session and the Config Restore command. T o upload the con figuration file, config_switch_169_10[...]

5 – Switch Configuration Paging a Switch 59183-01 A 5-17 A 5.4 Paging a Switch T o help you locate a particu lar switch in a rack of switches, you can turn on the beacon feature with the Set Beacon command. This causes all port Logged-In LEDs to flash in unison. The following is an examp le of how to turn the be acon on and off. SANbox #> set [...]

5 – Switch Configuration Setting the Date and T ime 5-18 59183-01 A S Enter the Set T imezone to change the time zone as sh own in the following example: SANbox (admin) #> set timezone Africa America Antarctica Asia Atlantic Australia Europe Indian Pacific UTC Press ENTER for more options or 'q' to make a selection. America/Grenada A[...]

5 – Switch Configuration Setting the Date and T ime 59183-01 A 5-19 A T o configure the switch to use an NTP server , enter the Set Setup System command to enable the NTP client an d to specify the NTP server IP address. SANbox #> admin start SANbox (admin) #> set setup system A list of attributes with formatting and current values will fol[...]

5 – Switch Configuration Resetting a Switch 5-20 59183-01 A S 5.6 Resetting a Switch T able 5-2 describes the methods for resetting a switch, the corre sponding command, and the impact on the switch. 5.7 Inst alling Firmware New firmware becomes available periodi cally either on CD-ROM or from the QLogic web site. Installing firmware on a switch [...]

5 – Switch Configuration Installing Firmware 59183-01 A 5-21 A 5.7.1 Nondisruptive Activation Y ou can load an d activate new firmware on a switch disruptively or nondisruptively depending on the condition of the fabric and t he commands you choose. If you attempt to perform a non-disrupt ive acti vation without satisfying the following condition[...]

5 – Switch Configuration Installing Firmware 5-22 59183-01 A S  Pathname for the firmware image file 1. Enter the following commands to downloa d the firmware from a re mote host to the switch, install the firmware, then reset the switch to activate the firmware. SANbox #> admin start SANbox #> firmware install The switch will be reset. [...]

5 – Switch Configuration Installing Firmware 59183-01 A 5-23 A 5.7.3 Custom Firmware Inst allation A custom firmware installation downloads the firmware imag e file from a remote host to the switch, unpacks the image file , and resets the switch in separate step s. This allows you to choose the type of switch reset an d whether the activation wil[...]

5 – Switch Configuration Managing Switch Feature Upg rades 5-24 59183-01 A S 5.8 Managing Switch Feature Upgrades The following features are available to upgrade your switch through the purch ase and installa tion of a license key:  Enterprise Fabric Suite 2007 is a workst ation-based Java® application that provides a graphical user inter fac[...]

5 – Switch Configuration Managing Switch F eature Upgrades 59183-01 A 5-25 A 5.8.2 Inst all a Feature License Key Enter the Feature Add command to inst all a license key on your switch as shown in the following example: SANbox #> admin start SANbox (admin) #> feature add 1-LCVXOWUNOJBE6 License upgrade to 20 ports Do you want to continue wi[...]

5 – Switch Configuration Managing Switch Feature Upg rades 5-26 59183-01 A S Notes[...]

59183-01 A 6-1 Section 6 Port Configuration This section describes the following to pics:  Displaying Port Information  Modifying Port Operating Characteristics  Port Binding  Resetting a Port  Configuring Port Threshold Alarms  T esting a Port  Extending Port T ransmission Distance 6.1 Displaying Port Information Y ou can disp[...]

6 – Port Configur ation Displaying Port Information 6-2 59183-01 A S 6.1.1 Port Configuration Parameters Enter the Show Config Port command to display the port configuration parameters. These p arameters determine t he operational characteristics of the port. Refer to T able 13-14 for a description of these p arameters. SANbox #> show config p[...]

6 – Port Configura tion Displaying Port Information 59183-01 A 6-3 A 6.1.2 Port Operational Information Enter the Show Port command to display port ope rational information. SANbox #> show port 1 Port Number: 1 ------------ AdminState On line OperationalState Offline AsicNumber 0 PerfTuningMode Normal AsicPort 0 PortID 220000 ConfigType GL Por[...]

6 – Port Configur ation Displaying Port Information 6-4 59183-01 A S 6.1.3 Port Threshold Alarm Co nfiguration Parameters Enter the Show Config Threshold command t o display the port threshold alarm parameters. These parameters d etermine the error th resholds at which the switch issues alarms. Refer to T able 13-18 for a description of the se pa[...]

6 – Port Configura tion Displaying Port Information 59183-01 A 6-5 A 6.1.4 Port Performance Enter the Show Perf command to display port performance in t erms of the volume of data transmitted, d ata received, or errors. Y ou can display continuous live performance information for one or more port s, or an instantaneous summar y . The following ex[...]

6 – Port Configur ation Displaying Port Information 6-6 59183-01 A S 6.1.5 T ransceiver Information Enter the Show Media command to disp lay operational information about one or more transceivers as shown in t he following example. Refer to T abl e 13-25 for a description of the transceiver informatio n in the Show Media display . SANbox #> sh[...]

6 – Port Configura tion Modifying Port Operating Characteristics 59183-01 A 6-7 A 6.2 Modifying Port Operati ng Characteristics Y ou can make permanent or temporary cha nges to p ort opera ting characteristics. Y ou make permanent port configuration ch anges using the Set Config Port command. These changes are saved in th e active configuration a[...]

6 – Port Configur ation Port Binding 6-8 59183-01 A S Y ou can configure all ports based a specified so urce port using the Set Config Ports comman d. The following example configures ports 0–20 based on port 3. SANbox #> admin start SANbox (admin) config edit SANbox (admin) #> set config ports 3 . . . SANbox (admin-config)#> config sa[...]

6 – Port Configura tion Resetting a Port 59183-01 A 6-9 A Enter the Set Config Security Portbinding command to e nable p ort binding for the selected port and to specify t he world wide names of the authorized port s/devices. The following example enables port bindi ng on po rt 1 and specifies two device world wide names. SANbox #> admin start[...]

6 – Port Configur ation Configuring Port Threshold Alarms 6-10 59183-01 A S 6.5 Configuring Port Threshold Alarms The switch can monitor a set of port errors and g enerates alarms based on user-defined sample windows and thre sholds. These port e rrors include the following:  Cyclic Redundancy Check (CRC) errors  Decode errors  ISL conne[...]

6 – Port Configura tion Configuring Port Thresh old Alar ms 59183-01 A 6-1 1 A Enter the Set Config Thresho ld command to enable and configure port threshold monitoring on the switch: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config threshold A list of attributes with formatting and current values w[...]

6 – Port Configur ation T esting a Port 6-12 59183-01 A S 6.6 T esting a Port Y ou can test a port using the Te s t P o r t command using online or offline tests. The following sections describe the test types, displaying test result s, and cancelling a test:  Online T ests for Port s  Offline T est s for Ports  Display Port T est Result[...]

6 – Port Configura tion T e stin g a Por t 59183-01 A 6-13 A 6.6.2 Offline T est s for Port s An offline test is a disrup tive test that exercises the port connections. Y ou must place the port in the diagnostics st ate usin g the Set Port command before st arting the test. There are two types of of fline test: internal loopback and extern al loo[...]

6 – Port Configur ation T esting a Port 6-14 59183-01 A S 6.6.3 Display Port T est Result s Y ou can display the test statu s while th e test is in progress by entering the T est S tatus Port command as shown in the following exa mple: SANbox (admin) #> test status port 1 Port Test Test Loop Test Num Port Type Status Count Failures ---- ------[...]

6 – Port Configura tion Extending Port T ransmission Dist ance 59183-01 A 6-15 A 6.7 Extending Port T ransmission Distance Y ou can extend the dist ance over which an F_Port or G_ Port port can transmit by borrowing buf fer credits from other port s. Refer to the SANbox 5000 Series Fibre Channel Switch Installa tion Guide for information about ex[...]

6 – Port Configur ation Extending Port T ransmission Distance 6-16 59183-01 A S Enter the Show Donor command to disp lay the extended credit status for the switch as shown in the following example: SANbox #> show donor Port Config Ext Credit Max Credit Donated Member of Valid Groups to Number Type Requested Available to Port Donor Group Extend[...]

59183-01 A 7-1 Section 7 Zoning Configuration This section describes the f ollowing tasks:  Displaying Zoning Database Info rmation  Configuring the Zoning Dat abase  Modifying the Zoning Dat abase  Resetting the Zoning Dat abase  Managing Zone Sets  Managing Zones  Managing Aliases Consider device access needs within the fa br[...]

7 – Zoning Config ur at ion Displaying Zoning Dat abase Information 7-2 59183-01 A S 7.1 Displaying Zoning Dat abase Information Y ou can display the following information about th e zoning database:  Configured Zone Set Information  Active Zone Set Information  Zone Set Membership Information  Zoning Modification History  Zoning D[...]

7 – Zoning Configuration Displaying Zoning Data base Information 59183-01 A 7-3 A Enter the Zoning List comman d to display all zone sets, zone s, and zone members in the zoning databa se as shown in the following example: SANbox #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember -------------------------------- wwn wwn_b0241f 5[...]

7 – Zoning Config ur at ion Displaying Zoning Dat abase Information 7-4 59183-01 A S 7.1.2 Active Zone Set Information The Zoning Active and Zoneset Active commands displa y information about the active zone set. Enter the Zoning Active command to disp lay component zones and zone members as shown in th e following example: SANbox #> zoning ac[...]

7 – Zoning Configuration Displaying Zoning Data base Information 59183-01 A 7-5 A 7.1.3 Zone Set Membership Information The Zoneset Zo nes and Zone Zone set s commands display zone set membership information. Enter the Zoneset Zones command to display the member zones for a specified zone set as show n in the following example: SANbox #> zones[...]

7 – Zoning Config ur at ion Displaying Zoning Dat abase Information 7-6 59183-01 A S 7.1.5 Alias and Alias Membership Information The Alias List and Alias Membe rs commands display information about aliases. Enter the Alias List command to display a list of all aliases as shown in the following example: SANbox #> alias list Current list of Zon[...]

7 – Zoning Configuration Displaying Zoning Data base Information 59183-01 A 7-7 A 7.1.6 Zoning Modification History Enter the Zoning History command to display a record of zoning modifications as shown in the following example: SANbox #> zoning history Active Database Information --------------------------- ZoneSetLastActivated/DeactivatedBy R[...]

7 – Zoning Config ur at ion Displaying Zoning Dat abase Information 7-8 59183-01 A S 7.1.7 Zoning Dat abase Limit s Enter the Zoning Limit s command to display a summary of the objects in the zoning database an d their maximum limit as shown in the following example: SANbox #> zoning limits Zoning Attribute Maximum Current [Zoning Name] ------[...]

7 – Zoning Configuration Configuring the Zoning Dat abase 59183-01 A 7-9 A 7.2 Configuring the Zoning Dat abase Y ou can configure how the zoning dat abase is applied to the switch and exchanged with the fabric through th e zoning configuration p arameters. The following zoning configuration p ara meters are available through the Set Config Zonin[...]

7 – Zoning Config ur at ion Configuring the Zoning Dat abase 7-10 59183-01 A S The Config Edit session provides access to the Set Config Zoning command as shown in the following example: SANbox #> admin start SANbox (admin) #> config edit The config named default is being edited. SANbox (admin-config) #> set config zoning A list of attri[...]

7 – Zoning Configuration Modifying the Zoning Dat abase 59183-01 A 7-1 1 A 7.3 Modifying the Zoning Dat abase T o modify the zoning databa se, you must open an Admin session with the Admin S tart command. An Admin session prevent s other a ccount s from making changes at the same time through T elnet, Enterprise Fabric Suite 2007, or another mana[...]

7 – Zoning Config ur at ion Resetting the Zoning Database 7-12 59183-01 A S 7.4 Resetting the Zoning Dat abase There are two ways to remove all aliases, zones, and zone set s from the zoning datab ase:  Enter the Zoning Clear command as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoni[...]

7 – Zoning Configuration Managing Zone Sets 59183-01 A 7-13 A 7.6 Managing Zone Set s Managing Zone Sets consist s of the following tasks:  Create a Zone Set  Delete a Zone Set  Rename a Zone Set  Copy a Zone Set  Add Zones to a Zone Set  Remove Zones from a Zone Set  Activate a Zone Set  Deactivate a Zone Set All of these[...]

7 – Zoning Config ur at ion Managing Zone Sets 7-14 59183-01 A S 7.6.3 Rename a Zone Set Enter the Zoneset Rename comma nd to rename a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset rename zoneset_old zoneset_new SANbox (admin-zoning) #>zoning save 7.6.4[...]

7 – Zoning Configuration Managi ng Zones 59183-01 A 7-15 A 7.6.8 Deactivate a Zone Set Enter the Zoneset Deactivate command to deactivate the active zone set and disable zoning in the fabric: SANbox #> admin start SANbox (admin) #> zoneset deactivate 7.7 Managing Zones Managing Zones consists of the following tasks:  Create a Zone  De[...]

7 – Zoning Config ur at ion Managing Zone s 7-16 59183-01 A S 7.7.3 Rename a Zone Enter the Zone Rename command to rename zone_1 t o zone_a as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone rename zone_1 zone_a SANbox (admin-zoning) #> zoning save 7.7.4 Copy a Zone Ent[...]

7 – Zoning Configuration Managing Aliases 59183-01 A 7-17 A 7.8 Managing Aliases Managing aliases consists of the following t asks:  Create an Alias  Delete an Alias  Rename an Alias  Copy an Alias  Add Members to an Alias  Remove Members from an Alias All of these tasks require an Admin session and a Zoning Edit session. 7.8.1 [...]

7 – Zoning Config ur at ion Managing Aliase s 7-18 59183-01 A S 7.8.4 Copy an Alias Enter the Alias Copy command to copy alias_1 an d it s contents to alias_2 as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> alias copy alias_1 alias_2 SANbox (admin-zoning) #> zoning save 7[...]

59183-01 A 8-1 Section 8 Connection Security Configuration This section describes the f ollowing tasks:  Managing SSL and SSH Services  Displaying SSL and SSH Services  Creating an SSL Security Certificate The switch supports secure connections with T elnet and switch management applications. The Secure SHell protocol (SSH) secures T elnet[...]

8 – Connection Secu rity Configuration Managing SSL and SSH Services 8-2 59183-01 A S Enter the Set Setup Services command to man age both SSH and SSL services as shown in the following exa mple: SANbox #> admin start SANbox (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value [...]

8 – Connection Secu r ity Con fig ur a tion Displaying SSL and SSH Services 59183-01 A 8-3 A 8.2 Displaying SSL and SSH Services Enter the Show Setup Services command to display the status of the SSH and SSL services as shown in the following example: SANbox #> show setup services System Services ----------------------------- TelnetEnabled Tru[...]

8 – Connection Secu rity Configuration Creating an SSL Security Certificate 8-4 59183-01 A S Notes[...]

59183-01 A 9-1 Section 9 Device Security Configuration This section describes the f ollowing tasks:  Displaying Security Databa se Information  Configuring the Security Dat abase  Modifying the Security Database  Resetting the Security Database  Managing Security Sets  Managing Groups Device security provides for the authorization[...]

9 – Device Security Configuration Displaying Security Dat abase Information 9-2 59183-01 A S 9.1 Displaying Security Dat abase Information Y ou can display the following information about th e security database:  Configured Security Set Information  Active Security Set Information  Security Set Membership Information  Group Membership[...]

9 – Device Security Configuration Displaying Security Dat abase Information 59183-01 A 9-3 A Enter the Security List command to display all security set s, groups, and group members in the security dat abase as shown in the following example: SANbox #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- --[...]

9 – Device Security Configuration Displaying Security Dat abase Information 9-4 59183-01 A S 9.1.2 Active Security Set Information The Security Active and Securi tyset Active commands display information about the active security set. Enter the Security Active co mmand to display component groups and group members as s hown in the following examp[...]

9 – Device Security Configuration Displaying Security Dat abase Information 59183-01 A 9-5 A 9.1.3 Security Set Membership Information The Securityset Groups a nd Group Securitysets comman ds display security set membership information. Enter the Se curityset Groups command to display the member groups for a specifie d security set as shown in th[...]

9 – Device Security Configuration Displaying Security Dat abase Information 9-6 59183-01 A S 9.1.5 Security Dat abase Modification History Enter the Security History command to displa y a record of security database modifications as shown in the following example: SANbox #> security history Active Database Information -------------------------[...]

9 – Device Security Configuration Configuring the Security Dat abase 59183-01 A 9-7 A 9.2 Configuring the Security Dat abase Y ou can configure how the security da tabase is applied to the switch and exchanged with the fabric through the security co nfiguration parameters. The following security configuration p a rameters are available through th[...]

9 – Device Security Configuration Configuring the Security Database 9-8 59183-01 A S T o modify the security configuration, you must open an Admin session with the Admin S tart command. An Admin session pr event s other accounts from makin g changes at the same time either through T elnet or Enterprise Fabric Suite 2007. Y ou must also open a Con[...]

9 – Device Security Configuration Modifying the Security Da tabase 59183-01 A 9-9 A 9.3 Modifying the Security Dat abase T o modify the security database, you must ope n an Admin session with the Admin S tart command. An Admin session prevent s other a ccount s from making changes at the same time either throug h T elnet or Enterprise Fabric Suit[...]

9 – Device Security Configuration Managing Secu rity Sets 9-10 59183-01 A S 9.5 Managing Security Set s Managing Security Sets consis t s of the following tasks:  Create a Security Set  Delete a Security Set  Rename a Security Set  Copy a Security Set  Add Groups to a Security Set  Remove Groups from a Security Set  Activate [...]

9 – Device Security Configuration Managing Security Sets 59183-01 A 9-1 1 A 9.5.5 Add Group s to a Security Set Enter the Securityset Add comma nd to add a group to a security set as shown in the following example: SANbox (admin-security) #> securityset add securityset_1 group_isl group_port 9.5.6 Remove Group s from a Security Set Enter the S[...]

9 – Device Security Configuration Managing Group s 9-12 59183-01 A S 9.6 Managing Group s Managing Groups consist s of the following tasks:  Create a Group  Delete a Group  Rename a Group  Copy a Group  Add Members to a Group  Modify a Group Member  Remove Members from a Group All of these tasks require an Admin session and a[...]

9 – Device Security Configuration Managing Group s 59183-01 A 9-13 A 9.6.4 Copy a Group Enter the Group Copy command to copy the contents of an existing group (group_port) to a new group (port_1) as shown in the following example: SANbox (admin-security) #> group copy group_port port_1 9.6.5 Add Members to a Group Adding a member to a group in[...]

9 – Device Security Configuration Managing Group s 9-14 59183-01 A S 9.6.6 Modify a Group Member Modifying a group member involve s changing the member attributes. The member attributes define the authent ication method, encryption methods, secret s, and fabric binding, depending on the grou p type.  For ISL member attributes, refer to T able [...]

59183-01 A 10-1 Section 10 RADIUS Server Configuration Authentication can be performe d locally using the switch’s security dat abase, or remotely using a Remote Dial-In User Serv ice (RADIUS) server such as Microsof t RADIUS. With a RADIUS server , the security dat abase for the entire fabric resides on the server . In this way , the security da[...]

10 – RADIUS Server Configuration Displaying RADIUS Server Information 10-2 59183-01 A S 10.1 Displaying RADIUS Server Information Enter the Show Setup Radius comman d to display RADIUS server information as shown in the following example. Refer to T able 13-20 for a description of the RADIUS server configuration p arameters. SANbox #> show set[...]

10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch 59183-01 A 10-3 A 10.2 Configuring a RADIUS Server on the Switch Enter the Set Setu p Radius command to configure a RADIUS server on the switch as shown in the following exa mple. Refer to T able 13-20 for a description of the RADIUS server configuration p arameters. SANbo[...]

10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch 10-4 59183-01 A S Notes[...]

59183-01 A 11 - 1 Section 1 1 Event Log Configuration This section describes the f ollowing tasks:  S tarting and S topping Event Logging  Displaying the Event Log  Managing the Event Log Configuration  Clearing the Event Log  Logging to a Remote Host  Creating and Downloading a Log File Event messages originate from the switch or[...]

1 1 – Event Log Configuration Displaying the Event Log 11 - 2 59183-01 A S 11 . 2 Displaying the Event Log Enter the Show Log command to display the e vent log. Each message has the following format: [ordinal][time_stamp][severity][m essage_ID][source ][message_text] [ordinal] –A number assigned to e ach message in sequence since the last time [...]

1 1 – Event Log Configuration Displaying the Event Log 59183-01 A 11 - 3 A 1 1.2.1 Filtering the Event Log Disp lay Y ou can customize what event s are displayed according to the component or severity level. Enter the Show Log Display command to filter the events in the display . Y ou can choose from the followi ng severity levels and component e[...]

1 1 – Event Log Configuration Managing the Eve nt Log Configuration 11 - 4 59183-01 A S 11 . 3 Managing the Event Log Configuration Managing the Event Log Configuration c onsist s of the following tasks:  Configure the Event Log  Display the Event Log Configuration  Restore the Event Log Configuration 1 1.3.1 Configure the Event Log Y ou[...]

1 1 – Event Log Configuration Clearing the Event Log 59183-01 A 11 - 5 A 1 1.3.2 Display the Event Log Configuration Enter the Show Log Settings command to display a ll event log configuration settings as shown in the following exa mple: SANbox #> show log settings Current settings for log ------------------------ Started True FilterComponent [...]

1 1 – Event Log Configuration Logging to a Remote Ho st 11 - 6 59183-01 A S 11 . 5 Logging to a Remote Host The switch comes from the factory with local lo gging enabled, which instruct s the switch firmware to maint ain an event log in switch memory . The switch can also be configured to log event s to a remote host that support s the syslog pro[...]

1 1 – Event Log Configuration Creating and Dow nloading a Lo g F ile 59183-01 A 11 - 7 A 11 . 6 Creating and Downloading a Log File Enter the Set Log Archive command to collect the event log messages in a file on the switch named logfile . This file can have a maximum of 1200 event messages. Use FTP to download the file fro m the switch to your w[...]

1 1 – Event Log Configuration Creating and Downloading a Log File 11 - 8 59183-01 A S Notes[...]

59183-01 A 12-1 Section 12 Simple Network Management Protocol Configuration This section describes the f ollowing tasks:  Managing the SNMP Service  Displaying SNMP Information  Modifying the SNMP Configuration  Resetting the SNMP Configuration The Simple Network Management Protocol (SNMP) provides for the management of the switch throu[...]

12 – Simple Network Management Proto col Configuration Managing the SNMP Service 12-2 59183-01 A S Enter the Set Setup Services command to enable SNMP as sh own in the following example: SANbox #> admin start SANbox (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value or simply[...]

12 – Simple Network Management Pro tocol Configuration Displaying SNMP Information 59183-01 A 12-3 A 12.2 Displaying SNMP Information Enter the Show Setup SNMP command to display SNMP co nfiguration information as shown in the following examp le. Refer to T able 13-22 fo r a description of the SNMP p arameters. SANbox #> show setup snmp SNMP I[...]

12 – Simple Network Management Proto col Configuration Modifying the SNMP Configuration 12-4 59183-01 A S 12.3 Modifying the SNMP Configuration Enter the Set Setup SNMP command to modify the SNMP co nfiguration as shown in the following example. Refer to T able 13-22 for SNMP parameters descriptions. SANbox (admin) #> set setup snmp A list of [...]

12 – Simple Network Management Pro tocol Configuration Resetting the SNMP Configuration 59183-01 A 12-5 A 12.4 Resetting the SNMP Configuration Enter the Reset SNMP command to reset the SNMP configuration ba ck to the factory defaults a s shown in the following example. Refer to T able 13-9 for a listing of the SNMP configuration factory default [...]

12 – Simple Network Management Proto col Configuration Resetting the SNMP Configuration 12-6 59183-01 A S Notes[...]

59183-01 A 13-1 Section 13 Command Reference This section describes the commands of the CLI an d the format in which they are presented. The command format present s the following:  Access Authority  Syntax and Keywords  Notes and Examples The commands are listed in “Comman d Listing” on page 13-3 . 13.1 Access Authority The Authority [...]

13 – Command Referen ce Syntax and Keyword s 13-2 59183-01 A S 13.2 Synt ax and Keywo r ds The Synt ax paragraph defin es the command syntax using the following convention: command key word keyword [value] keyword [value1] [value2] The Command is followed by one or more keyw ords. Consider the following rule s and conventions:  Commands and ke[...]

13 – Command Reference Command Listing 59183-01 A 13-3 A 13.4 Command Listing The commands are listed in alphab etical order as follows: A Admin , Alias C Config , Create D Date E Exit F Fcping , Fctrace , Feature , Firmware Inst all G Group H Hardreset , Help , History , Hotreset I Image L Lip , Logout P Passwd , Ping , Ps Q Quit R Reset S Secur[...]

13 – Command Referen ce Admin 13-4 59183-01 A S Admin Opens and closes an Admin session. The Admin session provides access to commands that change the fabric and sw itch co nfigurations. Only one Admin session can be open on the switch at any t ime. An inactive Admin session will time out after a pe riod o f time which can be changed using the Se[...]

13 – Command Reference Alias 59183-01 A 13-5 A Alias Creates a named set of port s/devices. Aliases make it easier to assign a set of ports/devices to many zon es. An alias can not have a zone or another alias as a member . Authority Admin session and Zoning Edit session for all keywords except List and Members Synt ax alias add [alias] [member_l[...]

13 – Command Referen ce Alias 13-6 59183-01 A S del ete [alias] Deletes the specified alias given by [alias] from t he zoning dat abase. If the alias is a member of the active zone set, the alias will not be removed from the active zone set until the active zone set is deactivated. list Displays a list of all aliases. This keyword d oes not requi[...]

13 – Command Reference Config 59183-01 A 13-7 A Config Manages the Fibre Channel con figurations on a switch. For information about setting the port and switch configu rations, refer to the “Set Config Switch” command on page 13-70 . Authority Admin session for all keywords except Backup and List Synt ax config act ivate [config_name] backup [...]

13 – Command Referen ce Config 13-8 59183-01 A S edit [config_name] Opens an edit session for the configurat ion given by [ config_name]. If you omit [config_name], the currently active conf iguration is used. list Displays a list of all available configurations on the switch . This keyword does not require an Admin session. restore Restores conf[...]

13 – Command Reference Config 59183-01 A 13-9 A Examples The following shows an example of how to open an d close a Config Edit session: SANbox #> admin start SANbox (admin) #> config edit The config named default is being edited. . . SANbox (admin-config) #> config cancel Configuration mode will be canceled. Please confirm (y/n): [n] y [...]

13 – Command Referen ce Create 13-10 59183-01 A S Create Creates support files for troublesho oting switch problems, and certificates for secure communications for Enterprise Fab ric Suite 2007 and SMI-S. Authority Admin session for the Certificate keywo rd Synt ax create certificate support Keywords certificate Creates a security certificate on [...]

13 – Command Reference Create 59183-01 A 13-1 1 A Examples The following is an example of the Creat e Support comman d when an FTP server is available on the workst ation: SANbox #> create support Log Msg:[Creating the support file - this will take several seconds] FTP the dump support file to another machine? (y/n): y Enter IP Address of remo[...]

13 – Command Referen ce Create 13-12 59183-01 A S The following is an example of the Create Support command and how to download the support file to your work station. W hen prompted to send the support file to another machine, decline, the n close the T elnet session. Open an FTP session on the switch and log in with the accou nt name images and [...]

13 – Command Reference Date 59183-01 A 13-13 A Date Displays or sets the system date and time. T o set the date and time the information string must be provided in this format: MMDDhhmmCCYY . The ne w date and time t akes effect immediately . Authority Admin session except to display the date. Synt ax date [MMDDhhmmCCYY] Keywords [MMDDhhmmCCYY] S[...]

13 – Command Referen ce Exit 13-14 59183-01 A S Exit Closes the T elnet session. Authority None Synt ax exit Notes Y ou can also enter Control-D to close the T elnet session.[...]

13 – Command Reference Fcping 59183-01 A 13-15 A Fcping V erifies a Fibre Channel connection with another switch or a device and report s status. Authority None Synt ax fcping destination [address] count [number] timeout [seconds] Keywords [address] The address of the port or d evice with which to verify the Fibre Channel connection. [address] ca[...]

13 – Command Referen ce Fctrace 13-16 59183-01 A S Fctrace Displays the path from an initiator device port in the fabric to a target device port in the same zone. T o trace the path between two initiator port s, you must disable the I/O S treamGuard feature. Use the Set Config Port command to change the IOS treamGuard parameter . Path information[...]

13 – Command Reference Fctrace 59183-01 A 13-17 A Examples The following is an example of the Fctrace command: SANbox#> fctrace 970400 970e00 hops 5 36 bytes from 0x970400 to 0x970e00, 5 hops max Domain Ingress Port WWN Port Egress Port WWN Port ------ ---------------- ---- --------------- ---- 97 20:04:00:c0:dd:02:cc:2e 4 20:0e:00:c0:dd:02:cc[...]

13 – Command Referen ce Feature 13-18 59183-01 A S Feature Adds license key features to the switch an d displays the license key feature log. T o order a license key contact your switch distributor or your authorized reseller . Upgrading a switch is not disruptive, n or does it require a switch reset. Authority Admin session for Add keyword only [...]

13 – Command Reference Feature 59183-01 A 13-19 A The following is an example of the Feat ure Log command: SANbox #> feature log Mfg Feature Log: ---------------- Switch Licensed for 8 ports Customer Feature Log: --------------------- 1) day month date 19:39:24 year - Switch Licensed for 20 ports 1-LCVXOWUNOJBE6[...]

13 – Command Referen ce Firmware Install 13-20 59183-01 A S Firmware Inst all Downloads firmware from a remote host to the switch, installs the firmware, then resets the switch to activate the firmware. This is disruptive. The command prompts you fo r the following:  The file transfer protocol (FTP or TFTP)  IP address of the remote host ?[...]

13 – Command Reference Firmware Ins tall 59183-01 A 13-21 A The following is an example of the Firmware Inst all command using TFTP: SANbox #> admin start SANbox (admin) #> firmware install The switch will be reset. This process will cause a disruption to I/O traffic. Continuing with this action will terminate all management sessions, inclu[...]

13 – Command Referen ce Group 13-22 59183-01 A S Group Creates group s, manages membership within the group, and manages the membership of gr oups in security set s. Authority Admin session and a Security Edit session. Refe r to the “Security” command on page 13-52 for info rmation about starting a Security Edit session. The List, Members, Se[...]

13 – Command Reference Group 59183-01 A 13-23 A Keywords add [group] Initiates an editing session in which to spe cify a group member and its attributes for the existing group given by [group]. ISL, Port, and MS member attributes are described in T able 13-1 , T able 13-2 , and T able 13-3 respectively . The group name and group type attributes a[...]

13 – Command Referen ce Group 13-24 59183-01 A S T able 13-2. Port Group Member Attributes Attribute Description Member Worldwide port name (WWPN) for the N_Port device that would attach to the switch. A member cannot belong to more than one group. All loop device WWPNs must be in cluded in the g roup, other- wise the switch port will be downed, [...]

13 – Command Reference Group 59183-01 A 13-25 A copy [group_source] [group_destination] Creates a new grou p na med [grou p_destina tion] and copies the membership into it from the group given by [group_source]. create [group] [type] Creates a group with the name given by [group] with the type given by [type]. A group name must begin with a lette[...]

13 – Command Referen ce Group 13-26 59183-01 A S edit [group] [member] Initiates an editing session in which to change the attributes of a worldwide name given by [member] in a group given by [gro up]. Member attributes that can be changed are described in T able 13-4 . T able 13-4. Group Member Attributes Attribute Description Authentication (IS[...]

13 – Command Reference Group 59183-01 A 13-27 A list Displays a list of all groups and the security set s of which they are members. This keyword is available without an Admin sessio n. members [group] Displays all members of the group given by [group]. This keyword is available without an Admin session. remove [group] [member_list] Remove the po[...]

13 – Command Referen ce Group 13-28 59183-01 A S Examples The following is an example of the Gr oup Add command: SANbox #> admin start SANbox (admin) #> security edit SANbox (admin-security) #> group add Group_1 A list of attributes with formatting and default values will follow Enter a new value or simply press the ENTER key to accept t[...]

13 – Command Reference Group 59183-01 A 13-29 A The following is an exampl e of th e Group List command: SANbox #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Gr oup Members command: SANbox #> group members group_1 Current list of members for Group: group_1 -------[...]

13 – Command Referen ce Hardreset 13-30 59183-01 A S Hardreset Resets the switch and performs a power-on self test. This reset disrupt s I/O traffic, activates the pending firmware, and clears the alarm log. T o save the alarm log before resetting, refer to the “Set Log” command on p age 13-76 . Authority Admin session Synt ax hardreset Notes[...]

13 – Command Reference Help 59183-01 A 13-31 A Help Displays a brief description of the specifie d command, its keywords, and usage. Authority None Synt ax help [command] [keyword] Keywords [command] Displays a summary of the comman d given by [command] and its keyword s. If you omit [command], the system disp lays all available commands. [keywor[...]

13 – Command Referen ce History 13-32 59183-01 A S History Displays a numbered list of the previously e ntered commands from which you can re-execute selected commands. Authority None Synt ax history Notes Use the History command to provide co ntext for the ! command:  Enter ![command_string] to re-execute the most recent command that matches [...]

13 – Command Reference Hotreset 59183-01 A 13-33 A Hotreset Resets the switch for th e purpose of activating the pending firmwar e without disrupting traf fic. This command terminates all management sessions, saves all configuration information, a nd clears the event log. After the pen ding firmware is activated, the configuration is recovered. T[...]

13 – Command Referen ce Image 13-34 59183-01 A S Image Manages and insta lls switch firmware. Authority Admin session Synt ax image cleanup fetch [account_name] [ ip_address] [file_source] [file_destination] inst all list tf tp [ip_address] [file_source] [file_destination] unpack [file ] Keywords cleanup Removes all firmware image files from the [...]

13 – Command Reference Image 59183-01 A 13-35 A unp ack [file] Installs the firmware file given by [file]. After unpacking th e file, a message appears confirming successful unp acking. The switch must be reset for the new firmware to take e ffect. Notes T o provide consistent performance throughout the fabric, ensure that all switches are runnin[...]

13 – Command Referen ce Image 13-36 59183-01 A S The following is an example of th e Image Fet ch and Image Unpack commands: SANbox (admin) #> image fetch johndoe 10.0.0.254 6.7.00.11_mpc >ftp 10.0.0.254 user:johndoe password: ******** ftp>bin ftp>put 6.7.00.11_mpc ftp>quit SANbox (admin) $>image list SANbox (admin) $>image u[...]

13 – Command Reference Lip 59183-01 A 13-37 A Lip Reinitializes the specified loop port. Authority Admin session Synt ax lip [port_number] Keywords [port_number] The number of the port to be reinitialize d. Ports are numbered beginning with 0. Examples The following is an example of the Lip command: SANbox (admin) #> lip 2[...]

13 – Command Referen ce Logout 13-38 59183-01 A S Logout Closes the T elnet session. Authority None Synt ax logout Notes Y ou can also enter Control-D to close the T elnet session.[...]

13 – Command Reference Passwd 59183-01 A 13-39 A Passwd Changes a user account’ s password. Authority Admin account name and an Admin sessio n to change another account’s password; Y ou can change you own password with out an Admin session. Synt ax passwd [account_name ] Keywords [account_name] The user account name. T o change the p assword [...]

13 – Command Referen ce Ping 13-40 59183-01 A S Ping Initiates an attempt to communica te with another switch over an Ethernet net work and reports the result. Authority None Synt ax ping [ip_address] Keywords [ip_address] The IP address of the switch to qu ery . Broadcast IP addresses, such as 255.255.255.255, are not va lid. Examples The follow[...]

13 – Command Reference Ps 59183-01 A 13-41 A Ps Displays current system process information. Authority None Synt ax ps Examples The following is an example of the Ps command: SANbox #> ps PID PPID %CPU TIME ELAPSED COMMAND 338 327 0.0 00:00:00 3-01:18:35 cns 339 327 0.0 00:00:01 3-01:18:35 ens 340 327 0.0 00:00:21 3-01:18:35 dlog 341 327 0.1 0[...]

13 – Command Referen ce Quit 13-42 59183-01 A S Quit Closes the T elnet session. Authority None Synt ax quit Notes Y ou can also enter Control-D to close the T elnet session.[...]

13 – Command Reference Reset 59183-01 A 13-43 A Reset Resets the switch configuration pa rameters. If you omit the keywo rd, the default is Reset Switch. Authority Admin session Synt ax reset config [config_name] factory port [port_list] radius security services snmp switch (default) system zoning Keywords config [config_name] Resets the configur[...]

13 – Command Referen ce Reset 13-44 59183-01 A S factory Resets switch con figuration, port configuration, port threshold alarm configuration , zoning configuration, SNMP con figuration, system configuration, security configuration, RADIUS configuration , swit ch services configuration, and zonin g to the factory default values as described in T [...]

13 – Command Reference Reset 59183-01 A 13-45 A switch Resets the switch witho ut a power-on self test. This is the default. This reset disrupts traf fic and does the following:  Activates the pending f irmware.  Closes all management sessions.  Clears the event log. T o save the even t log before resetting, refer to the “Set Log” co[...]

13 – Command Referen ce Reset 13-46 59183-01 A S Notes The following tab les specify the various factory default settings: Enter the Show Config Switch command to display switch configuration values. T able 13-5. Switch Configuration Defaults Parameter Default Admin S tate Online Broadcast Enabled T rue InbandEnabled T rue FDMIEnabled T rue FDMIE[...]

13 – Command Reference Reset 59183-01 A 13-47 A Enter the Show Config Port command to display port configuration values. T able 13-6. Port Configuration Defaults Parameter 1/2/4-Gbp s Port Defaults 10-Gbp s Port Defaults Admin S tate Online Online Link S peed Auto 10-Gbp s Port T ype GL G Symbolic Name Portn, where n is the port number 10G-n, whe[...]

13 – Command Referen ce Reset 13-48 59183-01 A S Enter Show Config Threshold command to display t hreshold alarm configuration values. T able 13-7. Port Threshold Alarm Configuration Defaults Parameter Default ThresholdMonito ringEnabled False CRCErrorsMonitoringEn abled  RisingT rigger  FallingT rigger  SampleWindow Tr u e 25 1 10 Decod[...]

13 – Command Reference Reset 59183-01 A 13-49 A Enter the Show Config Zoning command to display zoning configu ration values. Enter the Show Setup SNMP command to display SNMP configuration values. T able 13-8. Zoning Configuration Defaults Parameter Default InteropAutoSave T rue DefaultZone T rue DiscardInactive False T able 13-9. SNMP Configura[...]

13 – Command Referen ce Reset 13-50 59183-01 A S Enter the Show Setup Radius command to display RADIUS configuration values. Enter the Show Setup Services command to display switch service configuration values. T able 13-10. RADIUS Configuration Defaults Parameter Default DeviceAuthOrde r Local UserAuthOrde r Local T otalServers 1 DeviceAuthServe[...]

13 – Command Reference Reset 59183-01 A 13-51 A Enter the Show Setup System command to display system configuration values. Enter the Show Config Security command to disp lay security configuration values. T able 13-12. System Configuration Defaults Parameter Default Ethernet Network Enable T rue Ethernet Network Discovery S tatic Ethernet Networ[...]

13 – Command Referen ce Security 13-52 59183-01 A S Security Opens a Security Edit session in which to manage the securit y database on a switch. Refer to the “Group” command on page 13-22 and the “Securityset” command on page 13-56 . Authority Admin session. The keywords Active, Histo ry , Limits, and List are availab le without an Admin[...]

13 – Command Reference Securit y 59183-01 A 13-53 A edit Initiates a Security Edit session in which to make changes to the security database. A Security Edit session enables you to use the Gro up and Securityset commands to create, add, and delete security set s, groups, and grou p members. T o close a Security Edit session and save changes, ente[...]

13 – Command Referen ce Security 13-54 59183-01 A S Examples The following is an example of the Secu rity Active command: SANbox #> security active Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Chap Primary Hash MD5 Primary Secret ******** Secon[...]

13 – Command Reference Securit y 59183-01 A 13-55 A The following is an example of the Secu rity Limits command: SANbox #> security limits Security Attribute Maximum Current [Name] ------------------ ------- ------- ------ MaxSecuritySets 4 1 MaxGroups 16 2 MaxTotalMembers 1000 19 MaxMembersPerGroup 1000 4 group1 15 group2 The following is an [...]

13 – Command Referen ce Securityset 13-56 59183-01 A S Securityset Manages security sets in the secu rity database. Authority Admin session and a Security Edit session. Refe r to the “Security” command on page 13-52 for info rmation about starting a Security Edit session. The Active, Groups, and List keyword s are available without an Admin s[...]

13 – Command Reference Securityset 59183-01 A 13-57 A copy [security_set_source] [se curity_set_destination] Creates a new security set named [security_set_ destination] and copies into it the membership from the security set given by [security_set_so urce]. create [security_set] Creates the security set with the name given by [security_set]. A s[...]

13 – Command Referen ce Securityset 13-58 59183-01 A S Examples The following is an example of the Secu rityset Active command SANbox #> securityset active Active SecuritySet Information ------------------------------ ActiveSecuritySet alpha LastActivatedBy Remote LastActivatedOn day month date time year The following is an example of the Secu[...]

13 – Command Reference Set Alarm 59183-01 A 13-59 A Set Alarm Controls the display of alarms in the session ou tput stream or clears the alarm log. Authority Admin session for the Clear keyword. Otherwise , none. Synt ax set alarm [option] Keywords [option] [option] can be one of the following: clear Clears the alarm log history . This value requ[...]

13 – Command Referen ce Set Beacon 13-60 59183-01 A S Set Beacon Enables or disables the flashin g of the Logged-In LEDs for the purpose of locating a switch. Authority None Synt ax set beacon [state] Keywords [st ate] [state] can be o ne of the following: on Enables the flashing beacon. off Disables the flashing beacon. Examples The following is[...]

13 – Command Reference Set Config Port 59183-01 A 13-61 A Set Config Port Sets the port configuration parameters for one or more port s. The changes you make with this command are not ret ained when you reset or power cycle the switch unless you save them using the Config Save command . Authority Admin session and a Config Edit session Synt ax se[...]

13 – Command Referen ce Set Config Port 13-62 59183-01 A S PortT ype Port types:  1/2/4-Gbps Por ts: GL, G , F , FL, Donor . The default is GL.  10-Gbp s Ports: GL, G , F , FL, Donor . The default is GL. The Donor port type disables the port and makes the buf fer credits availabl e to other ports. Refer to the ExtCredit port configurat ion [...]

13 – Command Reference Set Config Port 59183-01 A 13-63 A AutoPerfT uning Automatic performance tu ning for FL_Ports only . The default is T rue.  If AutoPerfT uning is enabled (T rue) and the port is an FL_Port, MFSEnable is automatically enabled. LCFEn- able and VIEnable are overridde n to False.  If AutoPerfT uning is disabled (False), M[...]

13 – Command Referen ce Set Config Port 13-64 59183-01 A S PDISCPingEnable (1/2/4-Gbps ports only) Enables (T rue) or disables (False) the tran smission of ping messages from the switch to a ll devices on a loop port. The default is T rue. T able 13-14. Port Configuration Parameters (Continued) Parameter Description[...]

13 – Command Reference Set Config Port 59183-01 A 13-65 A Examples The following is an example of the Set Config Port command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config port 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key [...]

13 – Command Referen ce Set Config Port 13-66 59183-01 A S The following is an example of the Set Config Port command for a 10-Gbps port: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config port 16 A list of attributes with formatting and current values will follow. Enter a new value or simply press th[...]

13 – Command Reference Set Config Security 59183-01 A 13-67 A Set Config Security Configures the security database fo r the au tomatic saving of changes to the active security set and fabric binding. The changes you make with this command are not retained when you reset or power cycle the swit ch unless you save them using the Config Save command[...]

13 – Command Referen ce Set Config Security 13-68 59183-01 A S If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. FabricBindingEnabled (True / False) [False] AutoSave (True / False) [True ] Finished configuring attributes. This configuration must be saved (see[...]

13 – Command Reference Set Config S ecurity Portb inding 59183-01 A 13-69 A Set Config Security Portbinding Configures port binding. Authority Admin session and a Config Edit session Synt ax set config security portbinding [port_number] Keywords [port_number] Initiates an editing session in which to change the port binding configuration for the p[...]

13 – Command Referen ce Set Config Switch 13-70 59183-01 A S Set Config Switch Sets the switch configuration p arame ters. The changes you make with this command are not ret ained when you reset or power cycle the switch unless you save them using the Config Save command. Authority Admin session and a Config Edit session Synt ax set config switch[...]

13 – Command Reference Set Config Switch 59183-01 A 13-71 A Examples The following is an example of the Set Config Switch co mmand: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config switch A list of attributes with formatting and default values will follow. Enter a new value or simply press the ENTER[...]

13 – Command Referen ce Set Config Threshold 13-72 59183-01 A S Set Config Threshold Sets the port alarm threshold parameters by which the switch monitors po rt performance and generates ala rms. The changes you make with this command are not retained when you reset or power cycle the switch unless you save them using the Config Save command. Aut[...]

13 – Command Reference Set Config Threshold 59183-01 A 13-73 A Notes The switch will down a port if an alarm condition is not clea red within three consecutive sampling windows (by default 30 seconds). Reset the port to bring it back online. An alarm is cleared when the threshold monitoring detects that the error rate has fallen below the fallin [...]

13 – Command Referen ce Set Config Zoning 13-74 59183-01 A S Set Config Zoning Configures the zoning database. The c hanges you make with this command are not retained when you reset or powe r cycle the switch unless you save them using the Config Save command. Authority Admin session and a Config Edit session Synt ax set config zoning Initiates [...]

13 – Command Reference Set Config Zoning 59183-01 A 13-75 A Examples The following is an example of the Set Config Zon ing command. SANbox #> admin start SANbox (admin) #> config edit The config named default is being edited. SANbox (admin-config) #> set config zoning A list of attributes with formatting and current values will follow. E[...]

13 – Command Referen ce Set Log 13-76 59183-01 A S Set Log S pecifies the events to re cord in the event log and display on the screen. Y ou determine what event s to record in the switch event log using the Component, Level, and Port keywords. Y ou determine w hat event s are automatically displayed on the screen using the Display keyword. Ala r[...]

13 – Command Reference Set Log 59183-01 A 13-77 A Mgmtserver Monitors management server st atus. Nameserver Monitors name server st atus. None Monitor none of the component eve nts. Port Monitors all port event s. SNMP Monitors all SNMP events. Switch Monitors switch management event s. Zoning Monitors zoning conflict event s. display [filter] S [...]

13 – Command Referen ce Set Log 13-78 59183-01 A S level [filter] S pecifies the severity level given by [filter ] to use in monitoring and logging event s for the specified component s or ports. [filter] can be one of the following values: Critical Monitors critical event s. The critical level describes events that are generally disruptive to th[...]

13 – Command Reference Set Log 59183-01 A 13-79 A save Saves the log settings for the compone nt, severity level, port, and display level. These settings remain in ef fect after a switch reset. The log settings can be viewed using the Show Log Settings command. T o export log entries to a file, use the Set Log Archive command. st art S tarts the [...]

13 – Command Referen ce Set Pagebreak 13-80 59183-01 A S Set Pagebreak S pecifies how much information is displayed on the screen at a time. This command is useful for disabling p agebrea ks to allow command scripts to run without interruption. Authority None Synt ax pagebreak [st ate] Keywords [st ate] [state] can be o ne of the following: on Li[...]

13 – Command Reference Set Pagebrea k 59183-01 A 13-81 A Examples The following is an example of the Set Page break command: SANbox #> set pagebreak on SANbox #> zone list Zone ZoneSet ---- ------- Zone1 alpha beta Zone2 delta echo Zone3 sierra tango Zone4 gamma delta Press any key to continue, 'q' to quit ...[...]

13 – Command Referen ce Set Port 13-82 59183-01 A S Set Port Sets port st ate and speed for the specified port temporarily u ntil the next switch reset or new configuration activation. Th is command also clears port counters. Authority Admin session Synt ax set port clear or set port [port_number] bypass [alp a] clear enable speed [transmission_s[...]

13 – Command Reference Set Port 59183-01 A 13-83 A speed [transmission_speed] S pecifies the transmission speed for t he specified port. Choose one of the following port speed values: 1Gb/s One gigabit per second. 2Gb/s T wo gigabits per second. 4Gb/s Four gigabit s per second. 10Gb/s T en gigabits per second. This applie s only to ports 16–19.[...]

13 – Command Referen ce Set Setup Radius 13-84 59183-01 A S Set Setup Radius Configures RADIUS servers on the switch. Authority Admin session Synt ax set setup radius Prompts you in a line-by-lin e fashion to configure RADIUS servers for user account and device authentica tion. T able 1 3-20 describes the RADIUS server configuration fields. NOTE:[...]

13 – Command Reference Set Setup Radius 59183-01 A 13-85 A DeviceAuthServer Enable (T rue) or disable (False) this server for de vice authenti- cation. The default is False. UserAuthServer Enable (T rue) or disable (False) this server for use r account authentication. A user authentication RADIUS server r equires a secure mana gement co nnection [...]

13 – Command Referen ce Set Setup Radius 13-86 59183-01 A S Examples The following is an example of the Set Setu p RADIUS command: SANbox (admin) #> set setup radius A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this pro[...]

13 – Command Reference Set Setup Services 59183-01 A 13-87 A Set Setup Services Configures services on the switch. Authority Admin session Synt ax set setup services Prompts you in a line-by-lin e fashion to enable or disable switch services. T able 13-21 describes the switch service p arameters. For each parameter , enter a new value or press th[...]

13 – Command Referen ce Set Setup Services 13-88 59183-01 A S SSLEnabled Enables (T rue) or disables (False ) secure SSL connections for management applicatio ns includ ing Enterprise Fabric Suite 2007, QuickT ools, Application Programming Inter- face, and SMI-S. The default is False.  The SSL service requ ire s th e Fabric Sec urity license k[...]

13 – Command Reference Set Setup Services 59183-01 A 13-89 A Examples The following is an example of the Set Setu p Services command: SANbox #> admin start SANbox (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If [...]

13 – Command Referen ce Set Setup SNMP 13-90 59183-01 A S Set Setup SNMP Configures SNMP on the switch. Authority Admin session Synt ax set setup snmp Prompts you in a line-by-lin e fashion to change SNMP configuration settings. T able 13-22 describes the SNMP fields. For each parameter , enter a new value or press the Enter key to accept the cur[...]

13 – Command Reference Set Setup SNMP 59183-01 A 13-91 A WriteCommuni ty Write community p assword that authorizes an SNMP agent to write information to the switch. This is a write-only field. The value on the switch and the SNMP managemen t server must be the same. The write community passwor d can be up to 32 characters excluding #, semico lon [...]

13 – Command Referen ce Set Setup SNMP 13-92 59183-01 A S Examples The following is an example of the Set Setu p SNMP command: SANbox (admin) #> set setup snmp A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process b[...]

13 – Command Reference Set Setup System 59183-01 A 13-93 A Set Setup System Configures the network, session, and logg ing settings on the switch. Authority Admin session Synt ax set setup system Prompts you in a line-by-lin e fashion to change system configuration settings. T able 13-23 describes the system configuration fields. For each p aramet[...]

13 – Command Referen ce Set Setup System 13-94 59183-01 A S Examples The following is an example of the Set Setup System command: SANbox (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this proc[...]

13 – Command Reference Set Switch S tate 59183-01 A 13-95 A Set Switch St ate Changes the administrative st ate for all ports on the switch . The previous Set Config Switch settings are restored af ter a switch reset or a reactivation of a switch configuration. Authority Admin session Synt ax set switch state [state] Keywords [st ate] [state] can[...]

13 – Command Referen ce Set T imezone 13-96 59183-01 A S Set T imezone S pecifies the time zone for the switch and the workstation. The default is Universal T ime (UTC) also known as Greenwich Me an T i me (GMT). This keyword prompts you to choose a region, then a subregio n to specify the time zone. Changing the time zone converts the curre nt t[...]

13 – Command Reference Show About 59183-01 A 13-97 A Show About Displays an introductory set of information about ope rational attributes of the switch. This command is equivalent t o the Show V ersion command. Authority None Synt ax show about Examples The following is an example of the Show Abou t command: SANbox #> show about **************[...]

13 – Command Referen ce Show Alarm 13-98 59183-01 A S Show Alarm Displays the alarm log and session output stream display setting. Authority None Synt ax show alarm settings Keywords settings Displays the statu s of the parameter that controls the display of alarms in the session output stream. This p arameter is set using the Set Alarm command. [...]

13 – Command Reference Show Broadcast 59183-01 A 13-99 A Show Broadcast Displays the broadcast tree information and all p orts that are currently transmitting and receiving broadcast fra mes. Authority None Synt ax show broadcast Examples The following is an example of the Show Broad cast command: SANbox #> show broadcast Group Member Ports IS[...]

13 – Command Referen ce Show Chassis 13-100 59183-01 A S Show Chassis Displays chassis component sta tus and temperature. Authority None Synt ax show chassis Examples The following is an example of th e Show Chassis co mmand for model 5602. SANbox #> show chassis Chassis Information ------------------- BoardTemp (1) - Degrees Celsius 36 FanSta[...]

13 – Command Reference Show Config Port 59183-01 A 13-101 A Show Config Port Displays configuration parameters for one or more po rts. Authority None Synt ax show config port [port_number] Keywords [port_number] The number of the port. Port s are numbered beginning with 0. If you omit [port_number], all port s are specified. Examples The followin[...]

13 – Command Referen ce Show Config P ort 13-102 59183-01 A S The following is an example of the Show Config Port command f or a 10-Gbps port: SANbox #> show config port 16 Configuration Name: default ------------------- Port Number: 16 ------------ AdminState Online LinkSpeed 10Gb/s PortType G SymbolicName 10G-16 DeviceScanEnabled True ForceO[...]

13 – Command Reference Show Config Security 59183-01 A 13-103 A Show Config Security Displays the security dat abase configuration p arameters. Authority None Synt ax show config security Examples The following is an example of th e Show Config Secu rity command: SANbox #> show config security Configuration Name: default ------------------- Sw[...]

13 – Command Referen ce Show Config S ecurity Por tbinding 13-104 59183-01 A S Show Config Security Portbinding Displays the port binding configuration for one or more p orts. Authority None Synt ax show config security portbinding [port_number] Keywords [port_number] The number of the port. If you omit [p o rt_number], the port binding configura[...]

13 – Command Reference Show Config Switch 59183-01 A 13-105 A Show Config Switch Displays the switch configuration parameters. Authority None Synt ax show config switch Examples The following is an example of the Show Config Switch comma nd: SANbox #> show config switch Configuration Name: default ------------------- Switch Configuration Infor[...]

13 – Command Referen ce Show Config T hreshold 13-106 59183-01 A S Show Config Threshold Displays alarm threshold pa rameters for the switch. Authority None Synt ax show config threshold Examples The following is an example of the Show Config Threshold co mmand: SANbox #> show config threshold Configuration Name: default ------------ Threshold[...]

13 – Command Reference Show Config Zoning 59183-01 A 13-107 A Show Config Zoning Displays zoning configuration p arameters for the switch. Authority None Synt ax show config zoning Examples The following is an example of the Show Config Zoning command: SANbox #> show config zoning Configuration Name: default ------------------- Zoning Configur[...]

13 – Command Referen ce Show Domains 13-108 59183-01 A S Show Domains Displays list of each domain and it s worldwide name in the fabric. Authority None Synt ax show domains Examples The following is an example of the Show Domains comma nd: SANbox #> show domains Principal switch is (remote): 10:00:00:60:69:50:0b:6c Upstream Principal ISL is :[...]

13 – Command Reference Show Donor 59183-01 A 13-109 A Show Donor Displays list of current donor and extended credit config uration for all ports. Authority None Synt ax show donor Examples The following is an example of the Show Donor command: SANbox #> show donor Port Config Ext Credit Max Credit Donated Member of Valid Groups to Number Type [...]

13 – Command Referen ce Show Fabric 13-1 10 59183-01 A S Show Fabric Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address. Authority None Synt ax show fabric Examples The following is an example of the Show Fab ric command: SANbox #> show fabric Domain WWN Enet IP Addr FC IP Addr SymbolicName ------[...]

13 – Command Reference Show FDMI 59183-01 A 1 3 - 111 A Show FDMI Displays detaile d information about the device host bus adapter . Authority None Synt ax show fdmi [port_wwn] Keywords [port_wwn] The device world wide port n ame for which to display information. If you omit [port_wwn], the command displays a summary of host bus ada pter informat[...]

13 – Command Referen ce Show FDMI 13-1 12 59183-01 A S The following is an example of the Show FDMI WWN command: SANbox #> show fdmi 21:00:00:e0:8b:09:3b:17 FDMI Information ---------------- Manufacturer QLogic Corporation SerialNumber [04202 Model QLA2342 ModelDescription QLogic QLA2342 PCI Fibre Channel Adapter PortID 610000 NodeWWN 20:00:00[...]

13 – Command Reference Show Interface 59183-01 A 13-1 13 A Show Interface Displays the statu s of the active network interfaces. Authority None Synt ax show interface Examples The following is an example of the Show Inte rface command: SANbox #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD:00:BD:ED inet addr:10.20.68.107 Bcast:10.20[...]

13 – Command Referen ce Show Log 13-1 14 59183-01 A S Show Log Displays the content s of the log or the parameters used to create and display entries in the log. The log cont ains a maximum of 1200 entries. When the log reaches its e ntry capacity , subsequent entries overwrite the existing entries, beginning with the oldest. Authority None Synt [...]

13 – Command Reference Show Log 59183-01 A 13-1 15 A display [filter] Displays log events on the screen according to the component or severity level filter given by [filter]. [filter] can be one of the following: Info Displays all informative events. War n i n g Displays all warning event s. Critical Displays all critical event s. Eport3 Displays[...]

13 – Command Referen ce Show Log 13-1 16 59183-01 A S port Displays the ports being monitored for events. If an event occurs which is of the defined level and on a defin ed component, but not on a defined port, no entry is made in the log. settings Displays the current filter settings for compon ent, severity level, port, and display level. This [...]

13 – Command Reference Show LSDB 59183-01 A 13-1 17 A Show LSDB Displays Link S tate database inf ormation, Authority None Synt ax show lsdb Examples The following is an example of the Show LSDB co mmand: SANbox #> show lsdb Link State Database Information ------------------------------- LsID 34: Age=1176, Incarnation=0x800000e5 NeighborDomain[...]

13 – Command Referen ce Show Media 13-1 18 59183-01 A S Show Media Displays transceiver operational and diagnostic info rmation for one or more ports. Authority None Synt ax show media [port_list] all inst alled Keywords [port_list] The port or port s for which to display transceiver information. [port_list ] can be a set of port numbers and rang[...]

13 – Command Reference Show Media 59183-01 A 13-1 19 A T e m p T emperatur e in de gr ee s Ce lsius . V oltage Supply voltage in V olts. The range is 0–6.55. Tx Bias T ransmitter laster bias cu rrent in milliamps. The range is 0–655. Tx Power T ransmitter coupled output power in milliWatt s . The range is 0–6.55. Rx Power Received optical p[...]

13 – Command Referen ce Show Media 13-120 59183-01 A S Examples The following is an example of the Show Media command for port 4: SANbox #> show media 4 Port Number: 4 ------------- MediaType 400-M5-SN-I MediaVendor FINISAR CORP. MediaPartNumber FTRJ8524P2BNL MediaRevision A MediaSerialNumber P6G22RL MediaSpeeds 1Gb/s, 2Gb/s, 4Gb/s Temp Voltag[...]

13 – Command Reference Show Media 59183-01 A 13-121 A The following is an example of th e Show Media command for all ports: SANbox #> show media Note: -- LowAlarm; - LowWarning; + HighWarning; ++ HighAlarm Port Vendor Name Temp Voltage Tx Bias Tx Pwr Rx Pwr Num (C) (V) (mA) (mW) (mW) ---- ----------- ------- ------- ------- ------ ------ 0 Not[...]

13 – Command Referen ce Show Mem 13-122 59183-01 A S Show Mem Displays information about memory activity . Authority None Synt ax show mem [count] Keywords [count] The number of seconds for which to disp lay memory information. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units. Examples The following is an ex[...]

13 – Command Reference Show NS 59183-01 A 13-123 A Show NS Displays the WWNs for devices in the fabric. Authority None Synt ax show ns [option] Keywords [option] The domain IDs or port IDs for wh ich to display name server information. If you omit [option], name server information for th e local domain ID is displayed. [option] can have the fo ll[...]

13 – Command Referen ce Show NS 13-124 59183-01 A S The following is an example of the Show NS [port_ ID] command: SANbox #> show ns 1301e1 Port ID: 1301e1 -------- PortType NL PortWWN 21:00:00:20:37:73:13:69 SymbolicPortName NodeWWN 20:00:00:20:37:73:13:69 SymbolicNodeName NodeIPAddress 0.0.0.0 ClassOfService 3 PortIPAddress 0.0.0.0 FabricPor[...]

13 – Command Reference Show Pagebreak 59183-01 A 13-125 A Show Pagebreak Displays the current p agebreak setting. Authority None Synt ax show pagebreak Notes The pagebrea k setting limits the display of information to 20 lines or allows the continuous display of information without a break. Examples The following is an example of the Show Page br[...]

13 – Command Referen ce Show Perf 13-126 59183-01 A S Show Perf Displays port performance in frames/second and byt es/second. If you omit the keyword, the command displays dat a transmitted (out), data received (in ), and total dat a transmitted and received in frames/second and bytes per second. T ransmission rates are expressed in thousands (K)[...]

13 – Command Reference Show Perf 59183-01 A 13-127 A outbyte [port_list] Displays continuous performance dat a in bytes/second transmitted for the ports given by [port_list]. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, [0 2 10-15] specifies port s 0, 2, 10, 1 1, 12, 13, 14, and 15. If you omit [port_list][...]

13 – Command Referen ce Show Perf 13-128 59183-01 A S Examples The following is an example of the Show Perf command: SANbox #> show perf Port Bytes/s Bytes/s Bytes/s Frames/s Frames/s Frames/s Number (in) (out) (total) (in) (out) (total) ------ ------- ------- ------- -------- -------- -------- 0 7K 136M 136M 245 68K 68K 1 58K 0 58K 1K 0 1K 2 [...]

13 – Command Reference Show Port 59183-01 A 13-129 A Show Port Displays operational information for one or more port s. Authority None Synt ax show port [port_list] Keywords [port_list] The number of the port for which to disp lay information. [port_list] can be a set of port numbers and ranges delimited by sp aces. For example, [0 2 10-15] speci[...]

13 – Command Referen ce Show Port 13-130 59183-01 A S DecodeError Number of decod e errors detected DiagFaultCode Fault code from the most recent Power- on self test DiagS tatus S tatus from the mos t recent Power-on self te st EpConnect s Number of times an E_Port connected throu gh ISL negotia- tion. EpConnS tate E_Port connection st atus EpIso[...]

13 – Command Reference Show Port 59183-01 A 13-131 A LIP_F7_F7 A loop initialization primit ive frame used t o acquire a valid AL_P A. LIP_F8_F7 A loop initializat ion primitive fr ame used to ind ica te that a loop failure has been detected at the receiver . Login Number of device logins LoginS tatus Login sta tu s Logout Number of device logout[...]

13 – Command Referen ce Show Port 13-132 59183-01 A S RxOfflin eSeq Number of offline sequ enc es received. An OLS is issued for link initialization, a Receive & Recognize Not_Operational (NOS) state, or to enter the offline state. ShortFramesIn Number of incident s when one or more frames are received that are less than the minimum s ize. Sy[...]

13 – Command Reference Show Port 59183-01 A 13-133 A Examples The following is an example of the Show Port command: SANbox #> show port 1 Port Number: 1 ------------ AdminState On line OperationalState Offline AsicNumber 0 PerfTuningMode Normal AsicPort 0 PortID 220000 ConfigType GL PortWWN 20:00:00:c0:dd: 07:20:58 DiagStatus Pa ssed RunningTy[...]

13 – Command Referen ce Show Post Log 13-134 59183-01 A S Show Post Log Displays the Power On Self T est (POST) log which contains results from th e most recently failed POST . Authority None Synt ax show post log Examples The following is an example of the Show Post Log command : SANbox #> show post log Sat Jan 1 00:18:21 2000: POST log creat[...]

13 – Command Reference Show Setup Mfg 59183-01 A 13-135 A Show Setup Mfg Displays manufacturing information about the switch . Authority None Synt ax show setup mfg Examples The following is an example of the Show Setup Mfg command for a model 5600 switch: SANbox #> show setup mfg Manufacturing Information ------------------------- BrandName Q[...]

13 – Command Referen ce Show Setup Radius 13-136 59183-01 A S Show Setup Radius Displays RADIUS server information. Authority None Synt ax show setup radius Examples The following is an example of the Show Setup RADIUS command: SANbox #> show setup radius Radius Information ------------------ DeviceAuthOrder RadiusLocal UserAuthOrder RadiusLoc[...]

13 – Command Reference Show Setup Services 59183-01 A 13-137 A Show Setup Services Displays switch service statu s information. Authority None Synt ax show setup services Examples The following is an example of the Show Setup Services command: SANbox #> show setup services System Services ----------------------------- TelnetEnabled True SSHEna[...]

13 – Command Referen ce Show Setup SNMP 13-138 59183-01 A S Show Setup SNMP Displays the current SNMP settings. Authority None Synt ax show setup snmp The following is an example of the Show Setup Snmp command: SANbox #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact <sysContact undefined> Location N_107 Syste[...]

13 – Command Reference Show Setup System 59183-01 A 13-139 A Show Setup System Displays the current system settings. Authority None Synt ax show setup system Examples The following is an example of the Show Setup System command: SANbox #> show setup system System Information ------------------ EthNetworkEnable True EthNetworkDiscovery Static E[...]

13 – Command Referen ce Show S teering 13-140 59183-01 A S Show S teering Displays the routes that dat a takes in the fabric. Authority None Synt ax show steering [domain_id] Keywords [domain_id] The domain ID for which to display route information . If you omit [domain_id], the system displays routes for all switches in th e fabric. Examples The[...]

13 – Command Reference Show Switch 59183-01 A 13-141 A Show Switch Displays switch operational information. Authority None Synt ax show switch Notes T able 13-27 describes the switch operational p arameters. T able 13-27. Switch Operational Parameters Parameter Description SymbolicName Descriptive name for the switch SwitchWWN Switch world wide n[...]

13 – Command Referen ce Show Switch 13-142 59183-01 A S Examples The following is an example of the Show Switch co mmand: SANbox #> show switch Switch Information ------------------ SymbolicName SANbox SwitchWWN 10:00:00:c0:dd:00:bc:56 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool 0 DomainID 19 (0x13) FirstPortAddress 130000 Fla[...]

13 – Command Reference Show T ime zone 59183-01 A 13-143 A Show T imezone Displays the current time zone setting. Authority None Synt ax show timezone Examples The following is an example of the Show T imezone command: SANbox #> show timezone America/Chicago[...]

13 – Command Referen ce Show T opology 13-144 59183-01 A S Show T opology Displays all connected devices. Authority None Synt ax show topology Examples The following is an example of the Show T opology command: SANbox #> show topology Unique ID Key ------------- A = ALPA, D = Domain ID, P = Port ID Port Local Local Remote Remote Unique Number [...]

13 – Command Reference Show T opology 59183-01 A 13-145 A The following is an example of the Show T opology command for port 1: SANbox #> show topology 1 Local Link Information ---------------------- PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType F Remote Link Information ----------------------- Device 0 NodeWWN 50:80:02:0[...]

13 – Command Referen ce Show Users 13-146 59183-01 A S Show Users Displays a list of logged-in users. This is equivalent t o the User List command. Authority None Synt ax show users Examples The following is an example of the Show Use rs command: SANbox #> show users User Ethernet Addr-Port Logged in Since ---- ------------------ -------------[...]

13 – Command Reference Show V ersion 59183-01 A 13-147 A Show V ersion Displays an introductory set of information about ope rational attributes of the switch. This command is equivalent t o the Show About command. Authority None Synt ax show version Examples The following is an example of the Show V ersion command. SANbox #> show version ****[...]

13 – Command Referen ce Shutdown 13-148 59183-01 A S Shut down T erminates all data transfers on th e switch at convenient points and closes the T elnet session. Always power cycle the switch af ter entering this command. Authority Admin session Synt ax shutdown Notes When the shut down is complete, the Heartbeat LED is extinguished.[...]

13 – Command Reference T e st Cancel 59183-01 A 13-149 A T est Cancel Cancels a port test that is in progress. Authority Admin session Synt ax test cancel port [port_number] Keywords port [port_number] Cancel the test for the port given by [port_n umber]. [port_number] can be 0–19. Examples The following example cancels the test ru nning on por[...]

13 – Command Referen ce Te s t P o r t 13-150 59183-01 A S Te s t P o r t T ests individual po rts using an offline or online test. Authority Admin session Synt ax test port [port_number] offline [lo opback_type] online Keywords [port_number] The port to be tested. [port_numbe r] can be 0–19. offline [loopback_type] Performs an of fline test of[...]

13 – Command Reference Te s t P o r t 59183-01 A 13-151 A Notes T able 13-28 describes the port test parameters. T o cancel a port test that is in progress, enter the T est Cancel Port command. T o display the status of the most recent port test or port test in progress, enter the T est S tatus Port command. T able 13-28. Port T est Parameters Pa[...]

13 – Command Referen ce Te s t P o r t 13-152 59183-01 A S Examples The following example performs an online te st on port 1: SANbox #> admin start SANbox (admin) #> test port 1 online A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the default value. If you wish[...]

13 – Command Reference T est S tatus 59183-01 A 13-153 A T est St atus Displays the st atus of a test in progress, or if there is no test in progre ss, the status of the test tha t was executed last. Authority None Synt ax test status port [port_number] Keywords port [port_number] Display test status for the port given by [port_number]. [port_num[...]

13 – Command Referen ce Uptime 13-154 59183-01 A S Uptime Displays the elap sed up time since the switch was last reset and reset method. A hot reset or non-disruptive firmware activatio n does not re set t he ela p sed up time reported by this command. Authority None Synt ax uptime Examples The following is an example of the Uptime command: SANb[...]

13 – Command Reference User 59183-01 A 13-155 A User Administers and displays user account s. Authority Admin account name and an Admin session. The Account s and List keywords are available to all account names without an Admin session. Synt ax user accounts add del ete [account_name] edit list Keywords account s Displays all user accounts that [...]

13 – Command Referen ce User 13-156 59183-01 A S Notes Authority level or p asswor d changes t hat you make t o an accoun t that is curren tly logged in do not t ake effect until that account lo gs in again. Examples The following is an example of the User Accou nts command: SANbox (admin) #> user accounts Current list of user accounts -------[...]

13 – Command Reference User 59183-01 A 13-157 A The following is an example of the User Delete command : SANbox (admin) #> user del user3 The user account will be deleted. Please confirm (y/n): [n] y The following is an example of the User L ist command: SANbox (admin) #> user list User Ethernet Addr-Port Logged in Since ---- --------------[...]

13 – Command Referen ce Whoami 13-158 59183-01 A S Whoami Displays the account name, session numb er , and switch domain ID for the T elnet session. Authority None Synt ax whoami Examples The following is an example of the Whoa mi command: SANbox #> whoami User name : admin@session2 Switch name : SANbox Switch domain ID: 21 (0x15)[...]

13 – Command Reference Zone 59183-01 A 13-159 A Zone Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit sessio n. Refer to the “Zoning” command on page 13-166 for informa tion about starting a Zoning Edit session. The List, Members, and Zoneset s keywords are available without an Admin se ssion. Synt ax z[...]

13 – Command Referen ce Zone 13-160 59183-01 A S del ete [zone] Deletes the specified zone given by [zo ne] from the zoning database. If the zone is a component of the active zone set, the zo ne will not be removed from the active zone set until the active zone set is d eactivated. list Displays a list of all zones and the zone set s of which the[...]

13 – Command Reference Zone 59183-01 A 13-161 A Examples The following is an example of the Zone List command: SANbox #> zone list Zone ZoneSet ------------------- wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_set_1 wwn_2[...]

13 – Command Referen ce Zone 13-162 59183-01 A S The following is an example of th e Zone Zonesets command: SANbox #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1[...]

13 – Command Reference Zoneset 59183-01 A 13-163 A Zoneset Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit sessio n. Refer to the “Zoning” command on page 13-166 for information abou t starting a Zonin g Edit session. The Active, List, and Zones keywords are available withou t an Admin sessio[...]

13 – Command Referen ce Zoneset 13-164 59183-01 A S deac t ivate Deactivates the active zone set. Close the Zoning Edit session befo re using this keyword. del ete [zone_set] Deletes the zone set given by [zone_set]. If the specified zone set is active, the command is suspended until the zone set is deactivate d. list Displays a list of all zone [...]

13 – Command Reference Zoneset 59183-01 A 13-165 A Examples The following is an example of the Zone set Active command: SANbox #> zoneset active ActiveZoneSet Bets LastActivatedBy admin@OB-session6 LastActivatedOn day month date time year The following is an example of the Zone set List command: SANbox #> zoneset list Current List of ZoneSe[...]

13 – Command Referen ce Zoning 13-166 59183-01 A S Zoning Opens a Zoning Edit session in which to create and manage zone set s and zones. Refer to the “Zone” command on page 13-159 and the “Zoneset” command on page 13-163 . Authority Admin session except for the Active, Histor y , Limits, and List keywords. The Clear keyword also requires[...]

13 – Command Reference Zoning 59183-01 A 13-167 A edit Opens a Zoning Edit session. history Displays a history of zoning modification s. This keyword does not require an Admin session. History information includes the following:  T ime of the most recent zone set acti vation or deactivation and the user who performed it  T ime of the most r[...]

13 – Command Referen ce Zoning 13-168 59183-01 A S restore Restores the volatile zoning dat abase with the contents of the non-volat ile zoning database. If the InteropAutoSave parameter is False (se e T able 13-8 ), you can use this keyword to revert changes to the volatile zonin g database that were propagated f rom another switch in the fabric[...]

13 – Command Reference Zoning 59183-01 A 13-169 A The following is an example of the Zoning Limit s command: SANbox #> zoning limits Zoning Attribute Maximum Current [Zoning Name] ---------------- ------- ------- ------------- MaxZoneSets 256 6 MaxZones 2000 17 MaxAliases 2500 1 MaxTotalMembers 10000 166 MaxZonesInZoneSets 2000 19 MaxMembersPe[...]

13 – Command Referen ce Zoning 13-170 59183-01 A S The following is an exampl e of th e Zoning List command: SANbox #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember -------------------------------- wwn wwn_b0241f 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2f wwn_23bd31 50:06:04:82:bf:d2:18:c2 50:06:04[...]

59183-01 A Index- 1 Index A account name admin 2-2 display 13-155, 13-158 factory 3-1 maintenance mode 3-1 activation firmware 5-20, 5-21 security 9-9, 9-11 switch configuration 5- 11, 5-12 zoning 7-11 active zone set 7-1, 7-4 Admin account name 3-1, 13-1 authority 2-3, 13-1 session 2-3 session timeout 13-93 Admin command 13-4 administrative st ate[...]

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-2 59183-01 A S command entry 2-3 examples 13-2 listing 13-3 notes 13-2 reference 13-1 rules and conventions 13-2 syntax 13-2 command-line completion 2-3 Config command 13-7 Activate example 5-11 Backup example 5-14 Copy example 5-12 Delete example 5-12 Edit example 5-12, 7-9[...]

59183-01 A Index-3 SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A event message format 11-2 output stream control 11-3 remote logging 11-6 severity level 11-1 event log clear 11-5 configuration 11-1, 11-4 configuration management 11-4 display 11-2 display configuration 11-5 filter 11-3 restore configuration 11-5 event loggi[...]

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-4 59183-01 A S group add members 9-13, 13-23 add to security set 9-11 copy 9-13, 13-25 create 9-12, 13-25 delete 9-12 description 9-1 edit member attributes 13-26 ISL 9-12 list 13-27 list members 13-27 management 9-12 membership 9-5 modify member 9-14 MS 9-12, 13-25 port 9-1[...]

59183-01 A Index-5 SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A logout errors 6-10 loop port bypass 13-82 enable 13-82 initialization 13-37 loss-of-signal errors 6-10 M maintenance mode account name 3-1 Management Server group 9-1, 9-12, 13-25 service 13-89 manufacturer information 13-135 mask address 13-93 MD5 authentica[...]

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-6 59183-01 A S port administrative st ate 13-83 binding 6-8, 13-69, 13-104 configuration 6-1, 13-61 configuration default s 13-47 configuration display 13-101 configuration p arameters 6-2 counters 13-82 external test 13-150 group 9-1, 9-12, 13-25 information 6-1 initialize [...]

59183-01 A Index-7 SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A security certificate 8-1, 8-3 configuration 13-67 configuration default s 13-51 configuration display 13-103 configuration p arameters 5-6 connection 8-1 database 13- 44 edit session 13-1 group 9-1 revert changes 9-7 Security command 13-52 Activate example 9-[...]

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-8 59183-01 A S Set Config Switch command 13-70 example 5-13 Set Config Threshold command 13-72 example 6-11 Set Config Zoning command 13-74 example 7-9 Set Log command 13-76 Archive example 11-7 Clear example 11-5 Display example 11-3 example 11-4 Restore example 11-5 S tart[...]

59183-01 A Index-9 SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A Show Switch command 13-141 Show T imezone command 13-143 Show T opology command 13-144 Show Users command 13-146 Show V ersion command 13-147 example 5-8 Shutdown command 13-148 Simple Network Management Protocol configuration 12-1, 13-90 configuration displa[...]

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-10 59183-01 A S T est Port command 13-150 example 6-12 T est S tatus command 13-1 53 TFTP - See T rivial File T ransfer Protocol time between reset s 5-4 set and display 5-17, 13-13 zone 13-96, 13-143 time zone 5-17 timeout Admin session 13-93 admin session 4-4 inactivity 4-[...]

59183-01 A Index-1 1 SANbox 5000 Series Fibre Channel Switch Command Line Inter face Guide A zone set activate 7-14, 13-163 active 7-1, 7-4, 13-166 add member zone 13-163 add zones 7-14 configured 7-2 copy 7-14, 13-163 create 7-13, 13-163 deactivate 7-15, 13-45, 13-164 definition 7-1 delete 7-13, 13-164 delete member zone 13-164 display 13-164 disp[...]

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-12 59183-01 A S Notes[...]