Page 1 S i m p l i f y SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Firmware Version 6.7 59183-01 A Page i...
Page 2: Document Revision History
QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification.
Page 3: Table Of Contents
Table of Contents Section 1 Introduction Switch Models and Examples ........1-2 Intended Audience .
Page 4 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide 5.1.4 Configuration Information ........5-5 5.1.4.1...
Page 5 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide 6.6.1 Online Tests for Ports ........6-12 6.6.2...
Page 6 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide 7.8.5 Add Members to an Alias ........7-18 7.8.6...
Page 7 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Section 11 Event Log Configuration 11.1 Starting and Stopping Event Logging ......11-1 11.2...
Page 8 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Lip ........... .13-37 Logout .
Page 9 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Show FDMI ..........13-111 Show Interface.
Page 10 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide List of Tables Table Page Command-Line Completion ......... . .2-3 Factory User Accounts.
Page 11 Section 1 Introduction This guide describes the features and use of the command line interface for SANbox 5000 Series switches running firmware version 6.7. This guide is organized as follows: Section 1 describes switch models and features, the intended audience, related materials, new items in this release, and technical support.
Page 12: Introduction
SANbox 5000 Series Fibre Channel Switch Installation Guide, 59096-04 SANbox 5000 Series QuickTools Switch Management User Guide, 59235-01 SANbox 5000 Series Enterprise Fabric Suite 2007 User Guide, 59097-04 SANbox Simple Network Management Protocol Reference Guide, publication number 59047-07 CIM Agent Reference Guide, 59223-01 SANbox CLI Quick Reference Guide, 59261-00 QLogic Switch Interoperability Guide v3.0.
Page 13: New In This Release
1 – Introduction New in This Release New in This Release The following features are new in this release: The switch is equipped with the QuickTools embedded graphical user interface. QuickTools is a web applet that provides basic fabric management tools.
Page 14: Technical Support
Technical Certification courses include installation, maintenance and troubleshooting QLogic SAN products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by email at tech.training@qlogic.com. 59183-01 A...
Page 15: Contact Information
1 – Introduction Technical Support 1.5.3 Contact Information Support Headquarters QLogic Corporation 12984 Valley View Road Eden Prairie, MN 55344-3657 QLogic Web Site www.qlogic.com Technical Support Web Site support.qlogic.com Technical Support Email support@qlogic.com Technical Training Email tech.training@qlogic.com North American Region Email support@qlogic.com...
Page 16 1 – Introduction Technical Support Notes 59183-01 A...
Page 17: Command Line Interface Usage
Section 2 Command Line Interface Usage This section describes the following 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 commands and keywords use initial capitalization for clarity.
Page 18: Logging In To The Switch
2 – Command Line Interface Usage Logging In to the Switch Logging In to the Switch To log in to a switch through Telnet, open a command line window on the workstation and enter the Telnet command followed by the switch IP address: # telnet ip_address The Telnet window opens prompting you for a login.
Page 19: Opening And Closing An Admin Session
2 – Command Line Interface Usage Opening and Closing an Admin Session Opening and Closing an Admin Session The command line interface performs monitoring and configuration tasks. Commands that perform monitoring tasks are available to all user accounts. Commands that perform configuration tasks are available only after entering the Admin Start command to open an Admin session.
Page 20: Getting Help
2 – Command Line Interface Usage Getting Help Getting Help To display help for a command, enter the Help command followed by the command. The following is an example of the help that is available for the Config Edit command. SANbox #>...
Page 21: Creating A Support File
2 – Command Line Interface Usage Creating a Support File Creating a Support File If you contact technical support about a problem with your switch, they may request that you create and send a support file. This support file contains all of the switch configuration information which can be helpful in diagnosing the problem.
Page 22 2 – Command Line Interface Usage Creating a Support File If your workstation does not have an FTP server, enter the Create Support command to create the support file, and use FTP to download the support file from the switch to your workstation as shown in the following example: SANbox #>...
Page 23: Downloading And Uploading Files
2 – Command Line Interface Usage Downloading and Uploading Files Downloading and Uploading Files There are several files that reside on the switch that you can download to the workstation for examination or for safekeeping. These files include the following: Backup configuration file (configdata) Log files (logfile) Support files (dump_support.tgz)
Page 24 2 – Command Line Interface Usage Downloading and Uploading Files To upload a file from the workstation to the switch, do the following Enter the FTP command and the switch IP address or symbolic name. >ftp 10.0.0.1 When prompted for a user and password, enter the FTP account name and password (images, images).
Page 25: User Account Configuration
Section 3 User Account Configuration User accounts and their respective passwords are the first line of switch security. A user account consists of an account name, an authority level, and an expiration date. Switches come from the factory with certain user accounts defined for special purposes.
Page 26: Displaying User Account Information
3 – User Account Configuration Displaying User Account Information Displaying User Account Information You can display all user accounts defined on the switch (User Accounts command) or just those user accounts that are logged on (User List or Show Users commands).
Page 27: Creating User Accounts
3 – User Account Configuration Creating User Accounts Creating User Accounts A user account consists of an account name, an authority level, and an expiration date. The account name can be up to 15 characters and must begin with an alphanumeric character.
Page 28: Modifying User Accounts And Passwords
3 – User Account Configuration Modifying User Accounts and Passwords Modifying User Accounts and Passwords Only the Admin user account can modify a user account, delete a user account, or change the password of another user account. However, all user accounts can change their own passwords.
Page 29: Network And Fabric Configuration
Section 4 Network and Fabric Configuration The switch network configuration consists of the following: Network discovery method IP address Subnet mask IP gateway address The network discovery method determines how the switch acquires its IP address. The IP address can come from the IP address that resides on the switch or from a server.
Page 30: Displaying Name Server Information
4 – Network and Fabric Configuration Displaying Name Server Information Displaying Name Server Information Show NS command displays the list of WWNs in fabric as shown in the following example: SANbox #> show ns all Seq Domain Port Port Type COS PortWWN NodeWWN --- ------ ------ ---- --- -------...
Page 31: Displaying The Ethernet Network Configuration
4 – Network and Fabric Configuration Displaying the Ethernet Network Configuration Displaying the Ethernet Network Configuration 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 Enet IP Addr FC IP Addr...
Page 32: Configuring The Ethernet Port
4 – Network and Fabric Configuration Configuring the Ethernet Port Configuring the Ethernet Port Configure the switch Ethernet port using the Set Setup System command within an Admin session. The following example configures a new IP address, subnet mask, and gateway address. SANbox (admin) #>...
Page 33: Verifying A Switch In The Network
4 – Network and Fabric Configuration Verifying a Switch in the Network Verifying a Switch in the Network You can verify that a switch is communicating in the network using the Ping command. The following example successfully tests the network for a switch with IP address 10.20.11.57.
Page 34 4 – Network and Fabric Configuration Verifying and Tracing Fibre Channel Connections Enter the Fctrace command to display Fibre Channel routing information between two devices as shown in the following example. The devices can be defined as Fibre Channel addresses or WWNs. SANbox#>...
Page 35: Switch Configuration
Section 5 Switch Configuration Switch configuration consists of the following tasks: Displaying Switch Information Managing Switch Services Managing Switch Configurations Paging a Switch Setting the Date and Time Resetting a Switch Installing Firmware Managing Switch Feature Upgrades Displaying Switch Information You can display the following types of the switch information: Switch Operational Information System Process Information...
Page 36: Switch Operational Information
5 – Switch Configuration Displaying Switch Information 5.1.1 Switch Operational Information Show Switch command displays a variety of switch operational information. These include the switch WWN, domain ID, firmware version, administrative state, and operational state as shown in the following example: SANbox #>...
Page 37: System Process Information
5 – Switch Configuration Displaying Switch Information 5.1.2 System Process Information 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 PPID %CPU TIME ELAPSED COMMAND 0.0 00:00:00 3-01:18:35 cns...
Page 38: Elapsed Time Between Resets
5 – Switch Configuration Displaying Switch Information 5.1.3 Elapsed Time Between Resets Uptime command displays the elapsed time since the switch was last reset and the reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed time reported by this command. The following example displays the time since the last reset.
Page 39: Configuration Information
5 – Switch Configuration Displaying Switch Information 5.1.4 Configuration Information The Show Config command displays a variety of configuration information at the port and switch levels. In addition to the basic switch configurations, the Show Config command displays parameters that control how data is maintained in the security and zoning databases.
Page 40: Zoning Configuration Parameters
5 – Switch Configuration Displaying Switch Information 5.1.4.2 Zoning Configuration Parameters Enter the Show Config Zoning command to display zoning configuration parameters. These parameters determine how zoning is applied to the switch. Refer to Table 13-19 for a description of these parameters. SANbox #>...
Page 41: Hardware Information
5 – Switch Configuration Displaying Switch Information 5.1.5 Hardware Information Enter the Show Chassis command to display the status of the switch hardware including fans, power supplies, internal temperature, and Heartbeat LED status. The following is an example of the Show Chassis command for model 5602: SANbox #>...
Page 42: Firmware Information
5 – Switch Configuration Displaying Switch Information 5.1.6 Firmware Information Enter the Show Version command to display a summary of switch identity information including the firmware version. The following is an example of the Show Version command: SANbox #> show version ***************************************************** Command Line Interface SHell (CLISH)
Page 43: Managing Switch Services
5 – Switch Configuration Managing Switch Services Managing Switch Services You can configure your switch to suit the demands of your environment by enabling or disabling a variety of switch services. You manage the switch services using the Show Setup Services Set Setup Services commands.
Page 44 5 – Switch Configuration Managing Switch Services Enter the Set Setup Services command within an Admin session to configure the switch services as shown 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 press the ENTER key to accept the current value.
Page 45: Managing Switch Configurations
5 – Switch Configuration Managing Switch Configurations Managing Switch Configurations The switch configuration determines the basic operational characteristics of the switch. A switch supports up to 10 configurations including the default configuration, named Default Config. The current switch operating characteristics are determined by the active configuration.
Page 46: Copy A Switch Configuration
5 – Switch Configuration Managing Switch Configurations 5.3.3 Copy a Switch Configuration Enter the Config Copy command to create a copy of an existing configuration 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 configuration from the switch as...
Page 47 5 – Switch Configuration Managing Switch Configurations The following is an example of the Set Config Switch command. Refer to Table 13-17 for a description of the switch configuration parameters. SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config switch A list of attributes with formatting and default values will follow.
Page 48: Back Up And Restore A Switch Configuration
5 – Switch Configuration Managing Switch Configurations 5.3.6 Back Up and Restore a Switch Configuration Successful management of switches and fabrics depends on the effective use of switch configurations. Backing up and restoring a configuration is useful to protect your work or for use as a template in configuring other switches. Backing up and restoring the switch configuration involves the following: Creating the Backup File Downloading the Configuration File...
Page 49: Downloading The Configuration File
5 – Switch Configuration Managing Switch Configurations 5.3.6.2 Downloading the Configuration File You use FTP to download the configdata file to your workstation for safe keeping and to upload the file back to the switch for the restore function. To download the configdata file, open an FTP session on the switch and login with the account name images and password images.
Page 50: Restoring The Configuration File
5 – Switch Configuration Managing Switch Configurations 5.3.6.3 Restoring the Configuration File The restore operation begins with FTP to upload the configuration file from the workstation to the switch, then finishes with a Telnet session and the Config Restore command. To upload the configuration file, config_switch_169_10112003 in this case, open and FTP session with account name images and password images.
Page 51: Paging A Switch
5 – Switch Configuration Paging a Switch Paging a Switch To help you locate a particular 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 example of how to turn the beacon on and off.
Page 52 5 – Switch Configuration Setting the Date and Time Enter the Set Timezone to change the time zone as shown in the following example: SANbox (admin) #> set timezone Africa America Antarctica Asia Atlantic Australia Europe Indian Pacific Press ENTER for more options or 'q' to make a selection. America/Grenada America/Guadeloupe America/Guatemala...
Page 53: Set Setup System
5 – Switch Configuration Setting the Date and Time To configure the switch to use an NTP server, enter the Set Setup System command to enable the NTP client and to specify the NTP server IP address. SANbox #> admin start SANbox (admin) #>...
Page 54: Resetting A Switch
Power-on self test Installing Firmware New firmware becomes available periodically either on CD-ROM or from the QLogic web site. Installing firmware on a switch involves the following steps: Download the firmware image file to the switch. Unpack the firmware image file.
Page 55: Nondisruptive Activation
5 – Switch Configuration Installing Firmware 5.7.1 Nondisruptive Activation You can load and activate new firmware on a switch disruptively or nondisruptively depending on the condition of the fabric and the commands you choose. If you attempt to perform a non-disruptive activation without satisfying the following conditions, the activation will fail.
Page 56 5 – Switch Configuration Installing Firmware Pathname for the firmware image file Enter the following commands to download the firmware from a remote host to the switch, install the firmware, then reset the switch to activate the firmware. SANbox #> admin start SANbox #>...
Page 57: Custom Firmware Installation
5 – Switch Configuration Installing Firmware 5.7.3 Custom Firmware Installation A custom firmware installation downloads the firmware image file from a remote host to the switch, unpacks the image file, and resets the switch in separate steps. This allows you to choose the type of switch reset and whether the activation will be disruptive (Reset Switch command) or nondisruptive...
Page 58: Managing Switch Feature Upgrades
5 – Switch Configuration Managing Switch Feature Upgrades Managing Switch Feature Upgrades The following features are available to upgrade your switch through the purchase and installation of a license key: Enterprise Fabric Suite 2007 is a workstation-based Java® application that provides a graphical user interface for fabric management.
Page 59: Install A Feature License Key
5 – Switch Configuration Managing Switch Feature Upgrades 5.8.2 Install a Feature License Key Enter the Feature Add command to install 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 with license upgrade procedure? (y/n): [n] y Alarm Msg:[day mon date time year][A1005.0030][SM][Upgrading Licensed Ports to 20]...
Page 60 5 – Switch Configuration Managing Switch Feature Upgrades Notes 5-26 59183-01 A...
Page 61: Port Configuration
Section 6 Port Configuration This section describes the following topics: Displaying Port Information Modifying Port Operating Characteristics Port Binding Resetting a Port Configuring Port Threshold Alarms Testing a Port Extending Port Transmission Distance Displaying Port Information You can display the following port information: Port Configuration Parameters Port Operational Information Port Threshold Alarm Configuration Parameters...
Page 62: Port Configuration Parameters
6 – Port Configuration Displaying Port Information 6.1.1 Port Configuration Parameters Enter the Show Config Port command to display the port configuration parameters. These parameters determine the operational characteristics of the port. Refer to Table 13-14 for a description of these parameters. SANbox #>...
Page 63: Port Operational Information
6 – Port Configuration Displaying Port Information 6.1.2 Port Operational Information Enter the Show Port command to display port operational information. SANbox #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Offline AsicNumber PerfTuningMode Normal AsicPort PortID 220000 ConfigType PortWWN 20:00:00:c0:dd:07:20:58...
Page 64: Port Threshold Alarm Configuration Parameters
6 – Port Configuration Displaying Port Information 6.1.3 Port Threshold Alarm Configuration Parameters Enter the Show Config Threshold command to display the port threshold alarm parameters. These parameters determine the error thresholds at which the switch issues alarms. Refer to Table 13-18 for a description of these parameters.
Page 65: Port Performance
6 – Port Configuration Displaying Port Information 6.1.4 Port Performance Enter the Show Perf command to display port performance in terms of the volume of data transmitted, data received, or errors. You can display continuous live performance information for one or more ports, or an instantaneous summary. The following example displays an instantaneous summary in bytes and frames.
Page 66: Transceiver Information
6 – Port Configuration Displaying Port Information 6.1.5 Transceiver Information NOTE: The Show Media command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Enter the Show Media command to display operational information about one or more transceivers as shown in the following example.
Page 67: Modifying Port Operating Characteristics
6 – Port Configuration Modifying Port Operating Characteristics Modifying Port Operating Characteristics You can make permanent or temporary changes to port operating characteristics. You make permanent port configuration changes using the Set Config Port command. These changes are saved in the active configuration and are preserved across switch or port resets.
Page 68: Port Binding
6 – Port Configuration Port Binding You can configure all ports based a specified source port using the Set Config Ports command. The following example configures ports 0–20 based on port 3. SANbox #> admin start SANbox (admin) config edit SANbox (admin) #>...
Page 69: Resetting A Port
6 – Port Configuration Resetting a Port Enter the Set Config Security Portbinding command to enable port binding for the selected port and to specify the world wide names of the authorized ports/devices. The following example enables port binding on port 1 and specifies two device world wide names.
Page 70: Configuring Port Threshold Alarms
6 – Port Configuration Configuring Port Threshold Alarms Configuring Port Threshold Alarms The switch can monitor a set of port errors and generates alarms based on user-defined sample windows and thresholds. These port errors include the following: Cyclic Redundancy Check (CRC) errors Decode errors ISL connection count Device login errors...
Page 71 6 – Port Configuration Configuring Port Threshold Alarms Enter the Set Config Threshold 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 will follow. Enter a new value or simply press the ENTER key to accept the current value.
Page 72: Testing A Port
6 – Port Configuration Testing a Port Testing a Port You can test a port using the Test Port command using online or offline tests. The following sections describe the test types, displaying test results, and cancelling a test: Online Tests for Ports Offline Tests for Ports Display Port Test Results Cancel a Port Test...
Page 73: Offline Tests For Ports
6 – Port Configuration Testing a Port 6.6.2 Offline Tests for Ports An offline test is a disruptive test that exercises the port connections. You must place the port in the diagnostics state using the Set Port command before starting the test.
Page 74: Display Port Test Results
6 – Port Configuration Testing a Port 6.6.3 Display Port Test Results You can display the test status while the test is in progress by entering the Test Status Port command as shown in the following example: SANbox (admin) #> test status port 1 Port Test Test...
Page 75: Extending Port Transmission Distance
Extending Port Transmission Distance You can extend the distance over which an F_Port or G_Port port can transmit by borrowing buffer credits from other ports. Refer to the SANbox 5000 Series Fibre Channel Switch Installation Guide for information about extended credits and transmission distance.
Page 76 6 – Port Configuration Extending Port Transmission Distance Enter the Show Donor command to display 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...
Page 77: Zoning Configuration
Section 7 Zoning Configuration This section describes the following tasks: Displaying Zoning Database Information Configuring the Zoning Database Modifying the Zoning Database Resetting the Zoning Database Managing Zone Sets Managing Zones Managing Aliases Consider device access needs within the fabric. Access is controlled by the use of zoning.
Page 78: Displaying Zoning Database Information
7 – Zoning Configuration Displaying Zoning Database Information Displaying Zoning Database Information You can display the following information about the zoning database: Configured Zone Set Information Active Zone Set Information Zone Set Membership Information Zoning Modification History Zoning Database Limits 7.1.1 Configured Zone Set Information Zoneset...
Page 79 7 – Zoning Configuration Displaying Zoning Database Information Enter the Zoning List command to display all zone sets, zones, and zone members in the zoning database as shown in the following example: SANbox #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember --------------------------------...
Page 80: Active Zone Set Information
7 – Zoning Configuration Displaying Zoning Database Information 7.1.2 Active Zone Set Information Zoning Active and Zoneset Active commands display information about the active zone set. Enter the Zoning Active command to display component zones and zone members as shown in the following example: SANbox #>...
Page 81: Zone Set Membership Information
7 – Zoning Configuration Displaying Zoning Database Information 7.1.3 Zone Set Membership Information Zoneset Zones and Zone Zonesets commands display zone set membership information. Enter the Zoneset Zones command to display the member zones for a specified zone set as shown in the following example: SANbox #>...
Page 82: Alias And Alias Membership Information
7 – Zoning Configuration Displaying Zoning Database Information 7.1.5 Alias and Alias Membership Information Alias List and Alias Members commands display information about aliases. Enter the Alias List command to display a list of all aliases as shown in the following example: SANbox #>...
Page 83: Zoning Modification History
7 – Zoning Configuration Displaying Zoning Database Information 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 Remote ZoneSetLastActivated/DeactivatedOn day mon date hh:mm:ss yyyy Database Checksum...
Page 84: Zoning Database Limits
7 – Zoning Configuration Displaying Zoning Database Information 7.1.7 Zoning Database Limits Enter the Zoning Limits command to display a summary of the objects in the zoning database and their maximum limit as shown in the following example: SANbox #> zoning limits Zoning Attribute Maximum Current...
Page 85: Configuring The Zoning Database
7 – Zoning Configuration Configuring the Zoning Database Configuring the Zoning Database You can configure how the zoning database is applied to the switch and exchanged with the fabric through the zoning configuration parameters. The following zoning configuration parameters are available through the Set Config Zoning command.
Page 86 7 – Zoning Configuration Configuring the Zoning Database 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) #>...
Page 87: Modifying The Zoning Database
7 – Zoning Configuration Modifying the Zoning Database Modifying the Zoning Database To modify the zoning database, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time through Telnet, Enterprise Fabric Suite 2007, or another management application.
Page 88: Resetting The Zoning Database
7 – Zoning Configuration Resetting the Zoning Database Resetting the Zoning Database There are two ways to remove all aliases, zones, and zone sets from the zoning database: Enter the Zoning Clear command as shown in the following example: SANbox #> admin start SANbox (admin) #>...
Page 89: Managing Zone Sets
7 – Zoning Configuration Managing Zone Sets Managing Zone Sets Managing Zone Sets consists 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...
Page 90: Rename A Zone Set
7 – Zoning Configuration Managing Zone Sets 7.6.3 Rename a Zone Set Enter the Zoneset Rename command 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 Copy a Zone Set...
Page 91: Deactivate A Zone Set
7 – Zoning Configuration Managing Zones 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 Managing Zones Managing Zones consists of the following tasks: Create a Zone Delete a Zone Rename a Zone...
Page 92: Rename A Zone
7 – Zoning Configuration Managing Zones 7.7.3 Rename a Zone Enter the Zone Rename command to rename zone_1 to 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) #>...
Page 93: Managing Aliases
7 – Zoning Configuration Managing Aliases Managing Aliases Managing aliases consists of the following tasks: 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 Create an Alias Enter the...
Page 94: Copy An Alias
7 – Zoning Configuration Managing Aliases 7.8.4 Copy an Alias Enter the Alias Copy command to copy alias_1 and its 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) #>...
Page 95: Connection Security Configuration
Section 8 Connection Security Configuration NOTE: SSH and SSL connection security require the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. This section describes the following tasks: Managing SSL and SSH Services Displaying SSL and SSH Services Creating an SSL Security Certificate The switch supports secure connections with Telnet and switch management...
Page 96 8 – Connection Security Configuration Managing SSL and SSH Services Enter the Set Setup Services command to manage both SSH and SSL services as shown 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 press the ENTER key to accept the current value.
Page 97: Displaying Ssl And Ssh Services
8 – Connection Security Configuration Displaying SSL and SSH Services 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...
Page 98 8 – Connection Security Configuration Creating an SSL Security Certificate Notes 59183-01 A...
Page 99: Device Security Configuration
Section 9 Device Security Configuration NOTE: Device security requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. This section describes the following tasks: Displaying Security Database Information Configuring the Security Database Modifying the Security Database Resetting the Security Database Managing Security Sets...
Page 100: Displaying Security Database Information
9 – Device Security Configuration Displaying Security Database Information Displaying Security Database Information You can display the following information about the security database: Configured Security Set Information Active Security Set Information Security Set Membership Information Group Membership Information Security Database Modification History Security Database Limits 9.1.1 Configured Security Set Information...
Page 101 9 – Device Security Configuration Displaying Security Database Information Enter the Security List command to display all security sets, groups, and group members in the security database as shown in the following example: SANbox #> security list Active Security Information SecuritySet Group GroupMember...
Page 102: Active Security Set Information
9 – Device Security Configuration Displaying Security Database Information 9.1.2 Active Security Set Information Security Active and Securityset Active commands display information about the active security set. Enter the Security Active command to display component groups and group members as shown in the following example: SANbox #>...
Page 103: Security Set Membership Information
9 – Device Security Configuration Displaying Security Database Information 9.1.3 Security Set Membership Information Securityset Groups and Group Securitysets commands display security set membership information. Enter the Securityset Groups command to display the member groups for a specified security set as shown in the following example: SANbox #>...
Page 104: Security Database Modification History
9 – Device Security Configuration Displaying Security Database Information 9.1.5 Security Database Modification History Enter the Security History command to display a record of security database modifications as shown in the following example: SANbox #> security history Active Database Information --------------------------- SecuritySetLastActivated/DeactivatedBy Remote...
Page 105: Configuring The Security Database
9 – Device Security Configuration Configuring the Security Database Configuring the Security Database You can configure how the security database is applied to the switch and exchanged with the fabric through the security configuration parameters. The following security configuration parameters are available through the Set Config Security command: AutoSave–This parameter enables or disables the saving of changes to...
Page 106 9 – Device Security Configuration Configuring the Security Database To modify the security configuration, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time either through Telnet or Enterprise Fabric Suite 2007. You must also open a Config Edit session with the Config Edit command and...
Page 107: Modifying The Security Database
9 – Device Security Configuration Modifying the Security Database Modifying the Security Database To modify the security database, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time either through Telnet or Enterprise Fabric Suite 2007. You must also open a Security Edit session with the Security Edit command.
Page 108: Managing Security Sets
9 – Device Security Configuration Managing Security Sets Managing Security Sets Managing Security Sets consists 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 a Security Set Deactivate a Security Set...
Page 109: Add Groups To A Security Set
9 – Device Security Configuration Managing Security Sets 9.5.5 Add Groups to a Security Set Enter the Securityset Add command 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 Groups from a Security Set Enter the...
Page 110: Managing Groups
9 – Device Security Configuration Managing Groups Managing Groups Managing Groups consists 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 Security Edit session.
Page 111: Copy A Group
9 – Device Security Configuration Managing Groups 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 involves specifying a group, the member worldwide...
Page 112: Modify A Group Member
9 – Device Security Configuration Managing Groups 9.6.6 Modify a Group Member Modifying a group member involves changing the member attributes. The member attributes define the authentication method, encryption methods, secrets, and fabric binding, depending on the group type. For ISL member attributes, refer to Table 13-1.
Page 113: Section 10 Radius Server Configuration
Section 10 RADIUS Server Configuration NOTE: RADIUS server configuration requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Authentication can be performed locally using the switch’s security database, or remotely using a Remote Dial-In User Service (RADIUS) server such as Microsoft RADIUS.
Page 114: Displaying Radius Server Information
10 – RADIUS Server Configuration Displaying RADIUS Server Information 10.1 Displaying RADIUS Server Information Enter the Show Setup Radius command to display RADIUS server information as shown in the following example. Refer to Table 13-20 for a description of the RADIUS server configuration parameters.
Page 115: Configuring A Radius Server On The Switch
10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch 10.2 Configuring a RADIUS Server on the Switch Enter the Set Setup Radius command to configure a RADIUS server on the switch as shown in the following example. Refer to Table 13-20 for a description of the RADIUS server configuration parameters.
Page 116 10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch Notes 10-4 59183-01 A...
Page 117: Event Log Configuration
Section 11 Event Log Configuration This section describes the following tasks: Starting and Stopping 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 from the management application in response to events that occur in the fabric.
Page 118: Displaying The Event Log
11 – Event Log Configuration Displaying the Event Log 11.2 Displaying the Event Log Enter the Show Log command to display the event log. Each message has the following format: [ordinal][time_stamp][severity][message_ID][source][message_text] [ordinal]–A number assigned to each message in sequence since the last time the alarm history was cleared.
Page 119: Filtering The Event Log Display
11 – Event Log Configuration Displaying the Event Log 11.2.1 Filtering the Event Log Display You can customize what events are displayed according to the component or severity level. Enter the Show Log Display command to filter the events in the display.
Page 120: Managing The Event Log Configuration
11 – Event Log Configuration Managing the Event Log Configuration 11.3 Managing the Event Log Configuration Managing the Event Log Configuration consists of the following tasks: Configure the Event Log Display the Event Log Configuration Restore the Event Log Configuration 11.3.1 Configure the Event Log You can customize what events are recorded in the switch event log according to...
Page 121: Display The Event Log Configuration
11 – Event Log Configuration Clearing the Event Log 11.3.2 Display the Event Log Configuration Enter the Show Log Settings command to display all event log configuration settings as shown in the following example: SANbox #> show log settings Current settings for log ------------------------ Started True...
Page 122: Logging To A Remote Host
11 – Event Log Configuration Logging to a Remote Host 11.5 Logging to a Remote Host The switch comes from the factory with local logging enabled, which instructs the switch firmware to maintain an event log in switch memory. The switch can also be configured to log events to a remote host that supports the syslog protocol.
Page 123: Creating And Downloading A Log File
11 – Event Log Configuration Creating and Downloading a Log File 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 from the switch to your workstation as follows: Log into the switch through Telnet and create an archive of the event log.
Page 124 11 – Event Log Configuration Creating and Downloading a Log File Notes 11-8 59183-01 A...
Page 125: Section 12 Simple Network Management Protocol Configuration
Section 12 Simple Network Management Protocol Configuration This section describes the following 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 through third-party applications that use SNMP. Security consists of a read community string and a write community string that serve as passwords that control read and write access to the switch.
Page 126 12 – Simple Network Management Protocol Configuration Managing the SNMP Service Enter the Set Setup Services command to enable SNMP as shown 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 press the ENTER key to accept the current value.
Page 127: Displaying Snmp Information
12 – Simple Network Management Protocol Configuration Displaying SNMP Information 12.2 Displaying SNMP Information Enter the Show Setup SNMP command to display SNMP configuration information as shown in the following example. Refer to Table 13-22 for a description of the SNMP parameters. SANbox #>...
Page 128: Modifying The Snmp Configuration
12 – Simple Network Management Protocol Configuration Modifying the SNMP Configuration 12.3 Modifying the SNMP Configuration Enter the Set Setup SNMP command to modify the SNMP configuration as shown in the following example. Refer to Table 13-22 for SNMP parameters descriptions. SANbox (admin) #>...
Page 129: Resetting The Snmp Configuration
12 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration 12.4 Resetting the SNMP Configuration Enter the Reset SNMP command to reset the SNMP configuration back to the factory defaults as shown in the following example. Refer to Table 13-9 for a listing of the SNMP configuration factory defaults.
Page 130 12 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration Notes 12-6 59183-01 A...
Page 131: Section 13 Command Reference
Section 13 Command Reference This section describes the commands of the CLI and the format in which they are presented. The command format presents the following: Access Authority Syntax and Keywords Notes and Examples The commands are listed in “Command Listing” on page 13-3.
Page 132: Syntax And Keywords
13 – Command Reference Syntax and Keywords 13.2 Syntax and Keywords The Syntax paragraph defines the command syntax using the following convention: command keyword keyword [value] keyword [value1] [value2] The Command is followed by one or more keywords. Consider the following rules and conventions: Commands and keywords are case insensitive.
Page 133: Command Listing
13 – Command Reference Command Listing 13.4 Command Listing The commands are listed in alphabetical order as follows: Admin, Alias Config Create Date Exit Fcping, Fctrace, Feature, Firmware Install Group Hardreset, Help, History, Hotreset Image Lip, Logout Passwd, Ping, Quit Reset Security, Securityset, Alarm,...
Page 134: Admin
13 – Command Reference Admin Admin Opens and closes an Admin session. The Admin session provides access to commands that change the fabric and switch configurations. Only one Admin session can be open on the switch at any time. An inactive Admin session will time out after a period of time which can be changed using the Set Setup System command.
Page 135: Alias
13 – Command Reference Alias Alias Creates a named set of ports/devices. Aliases make it easier to assign a set of ports/devices to many zones. 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 Syntax alias add [alias] [member_list]...
Page 136 13 – Command Reference Alias delete [alias] Deletes the specified alias given by [alias] from the zoning database. 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.
Page 137: Config
13 – Command Reference Config Config Manages the Fibre Channel configurations on a switch. For information about setting the port and switch configurations, refer to the “Set Config Switch” command on page 13-70. Authority Admin session for all keywords except Backup and List Syntax config activate [config_name]...
Page 138 13 – Command Reference Config edit [config_name] Opens an edit session for the configuration given by [config_name]. If you omit [config_name], the currently active configuration is used. list Displays a list of all available configurations on the switch. This keyword does not require an Admin session.
Page 139 13 – Command Reference Config Examples The following shows an example of how to open and 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.
Page 140: Create
13 – Command Reference Create Create Creates support files for troubleshooting switch problems, and certificates for secure communications for Enterprise Fabric Suite 2007 and SMI-S. Authority Admin session for the Certificate keyword Syntax create certificate support Keywords certificate Creates a security certificate on the switch. The security certificate is required to establish an SSL connection with a management application such as Enterprise Fabric Suite 2007.
Page 141 13 – Command Reference Create Examples The following is an example of the Create Support command when an FTP server is available on the workstation: 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 remote computer: 10.20.33.130 Login name: johndoe...
Page 142 13 – Command Reference Create The following is an example of the Create Support command and how to download the support file to your workstation. When prompted to send the support file to another machine, decline, then close the Telnet session. Open an FTP session on the switch and log in with the account name images and password images.
Page 143: Date
13 – Command Reference Date Date Displays or sets the system date and time. To set the date and time the information string must be provided in this format: MMDDhhmmCCYY. The new date and time takes effect immediately. Authority Admin session except to display the date. Syntax date [MMDDhhmmCCYY]...
Page 144: Exit
13 – Command Reference Exit Exit Closes the Telnet session. Authority None Syntax exit Notes You can also enter Control-D to close the Telnet session. 13-14 59183-01 A...
Page 145: Fcping
13 – Command Reference Fcping Fcping NOTE: This command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Verifies a Fibre Channel connection with another switch or a device and reports status.
Page 146: Fctrace
13 – Command Reference Fctrace Fctrace NOTE: This command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Displays the path from an initiator device port in the fabric to a target device port in the same zone.
Page 147 13 – Command Reference Fctrace 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 ------ ---------------- ---- ---------------...
Page 148: Feature
13 – Command Reference Feature Feature Adds license key features to the switch and displays the license key feature log. To order a license key contact your switch distributor or your authorized reseller. Upgrading a switch is not disruptive, nor does it require a switch reset. Authority Admin session for Add keyword only Syntax...
Page 149 13 – Command Reference Feature The following is an example of the Feature 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 59183-01 A 13-19...
Page 150: Firmware Install
13 – Command Reference Firmware Install Firmware Install 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 for the following: The file transfer protocol (FTP or TFTP) IP address of the remote host An account name and password on the remote host (FTP only) Pathname for the firmware image file...
Page 151 13 – Command Reference Firmware Install The following is an example of the Firmware Install 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, including any Telnet sessions.
Page 152: Group
13 – Command Reference Group Group NOTE: This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Creates groups, manages membership within the group, and manages the membership of groups in security sets.
Page 153: Isl Group Member Attributes
13 – Command Reference Group Keywords add [group] Initiates an editing session in which to specify a group member and its attributes for the existing group given by [group]. ISL, Port, and MS member attributes are described in Table 13-1, Table 13-2, and Table 13-3...
Page 154: Port Group Member Attributes
13 – Command Reference Group Table 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 included in the group, other- wise the switch port will be downed, and none of the devices will be able to log in.
Page 155: Ms Group Member Attributes
13 – Command Reference Group Table 13-3. MS Group Member Attributes Attribute Description Member Port worldwide name for the N_Port device that would attach to the switch. CTAuthentication Common Transport (CT) authentication. Enables (True) or dis- ables (False) authentication for MS group members. The default is False.
Page 156: Group Member Attributes
13 – Command Reference Group 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 [group]. Member attributes that can be changed are described in Table 13-4.
Page 157 13 – Command Reference Group Table 13-4. Group Member Attributes (Continued) Attribute Description Binding Domain ID of the switch to which to bind the ISL group mem- ber worldwide name. This option is available only if (ISL Groups) FabricBindingEnabled is set to True using the Set Config Security command.
Page 158 13 – Command Reference Group Examples The following is an example of the Group 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 the current value with exception of the Group Member WWN field which is mandatory.
Page 159 13 – Command Reference Group The following is an example of the Group List command: SANbox #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Group Members command: SANbox #> group members group_1 Current list of members for Group: group_1 ---------------------------------- 10:00:00:c0:dd:00:71:ed...
Page 160: Hardreset
13 – Command Reference Hardreset Hardreset Resets the switch and performs a power-on self test. This reset disrupts I/O traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, refer to the “Set Log” command on page 13-76.
Page 161: Help
13 – Command Reference Help Help Displays a brief description of the specified command, its keywords, and usage. Authority None Syntax help [command] [keyword] Keywords [command] Displays a summary of the command given by [command] and its keywords. If you omit [command], the system displays all available commands.
Page 162: History
13 – Command Reference History History Displays a numbered list of the previously entered commands from which you can re-execute selected commands. Authority None Syntax history Notes Use the History command to provide context for the ! command: Enter ![command_string] to re-execute the most recent command that matches [command_string].
Page 163: Hotreset
13 – Command Reference Hotreset Hotreset Resets the switch for the purpose of activating the pending firmware without disrupting traffic. This command terminates all management sessions, saves all configuration information, and clears the event log. After the pending firmware is activated, the configuration is recovered.
Page 164: Image
13 – Command Reference Image Image Manages and installs switch firmware. Authority Admin session Syntax image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] install list tftp [ip_address] [file_source] [file_destination] unpack [file] Keywords cleanup Removes all firmware image files from the switch. All firmware image files are removed automatically each time the switch is reset.
Page 165 13 – Command Reference Image unpack [file] Installs the firmware file given by [file]. After unpacking the file, a message appears confirming successful unpacking. The switch must be reset for the new firmware to take effect. Notes To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware.
Page 166 13 – Command Reference Image The following is an example of the Image Fetch 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 unpack 6.7.00.11_mpc Image unpack command result: Passed 13-36 59183-01 A...
Page 167: Lip
13 – Command Reference Reinitializes the specified loop port. Authority Admin session Syntax lip [port_number] Keywords [port_number] The number of the port to be reinitialized. Ports are numbered beginning with 0. Examples The following is an example of the Lip command: SANbox (admin) #>...
Page 168: Logout
13 – Command Reference Logout Logout Closes the Telnet session. Authority None Syntax logout Notes You can also enter Control-D to close the Telnet session. 13-38 59183-01 A...
Page 169: Passwd
13 – Command Reference Passwd Passwd Changes a user account’s password. Authority Admin account name and an Admin session to change another account’s password; You can change you own password without an Admin session. Syntax passwd [account_name] Keywords [account_name] The user account name. To change the password for an account name other than your own, you must open an Admin session with the account name Admin.
Page 170: Ping
13 – Command Reference Ping Ping Initiates an attempt to communicate with another switch over an Ethernet network and reports the result. Authority None Syntax ping [ip_address] Keywords [ip_address] The IP address of the switch to query. Broadcast IP addresses, such as 255.255.255.255, are not valid.
Page 171 13 – Command Reference Displays current system process information. Authority None Syntax Examples The following is an example of the Ps command: SANbox #> ps PPID %CPU TIME ELAPSED COMMAND 0.0 00:00:00 3-01:18:35 cns 0.0 00:00:01 3-01:18:35 ens 0.0 00:00:21 3-01:18:35 dlog 0.1 00:05:35 3-01:18:35 ds...
Page 172: Quit
13 – Command Reference Quit Quit Closes the Telnet session. Authority None Syntax quit Notes You can also enter Control-D to close the Telnet session. 13-42 59183-01 A...
Page 173: Reset
13 – Command Reference Reset Reset Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset config [config_name] factory port [port_list] radius security services snmp switch (default) system zoning Keywords config [config_name] Resets the configuration given by [config_name] to the factory default values for switch, port, port threshold alarm, and zoning configuration as described in...
Page 174 13 – Command Reference Reset factory Resets switch configuration, port configuration, port threshold alarm configuration, zoning configuration, SNMP configuration, system configuration, security configuration, RADIUS configuration, switch services configuration, and zoning to the factory default values as described in Table 13-5 through Table 13-13.
Page 175 13 – Command Reference Reset switch Resets the switch without a power-on self test. This is the default. This reset disrupts traffic and does the following: Activates the pending firmware. Closes all management sessions. Clears the event log. To save the event log before resetting, refer to the “Set Log”...
Page 176: Switch Configuration Defaults
13 – Command Reference Reset Notes The following tables specify the various factory default settings: Enter the Show Config Switch command to display switch configuration values. Table 13-5. Switch Configuration Defaults Parameter Default Admin State Online Broadcast Enabled True InbandEnabled True FDMIEnabled True...
Page 177: Port Configuration Defaults
13 – Command Reference Reset Enter the Show Config Port command to display port configuration values. Table 13-6. Port Configuration Defaults Parameter 1/2/4-Gbps Port Defaults 10-Gbps Port Defaults Admin State Online Online Link Speed Auto 10-Gbps Port Type Symbolic Name Portn, where n is the port 10G-n, where n is the port number...
Page 178: Port Threshold Alarm Configuration Defaults
13 – Command Reference Reset Enter Show Config Threshold command to display threshold alarm configuration values. Table 13-7. Port Threshold Alarm Configuration Defaults Parameter Default ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow ISLMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow LoginMonitoringEnabled...
Page 179: Zoning Configuration Defaults
Parameter Default SNMPEnabled True Contact <syscontact undefined> Location <sysLocation undefined> Description SANbox 5000 Series FC Switch Trap [1-5] Address Trap 1: 10.0.0.254; Traps 2–5: 0.0.0.0 Trap [1-5] Port Trap [1-5] Severity Warning Trap [1-5] Version Trap [1-5] Enabled False ObjectID 1.3.6.1.4.1.1663.1.1.1.1.17 (SANbox 5200)
Page 180: Radius Configuration Defaults
13 – Command Reference Reset Enter the Show Setup Radius command to display RADIUS configuration values. Table 13-10. RADIUS Configuration Defaults Parameter Default DeviceAuthOrder Local UserAuthOrder Local TotalServers DeviceAuthServer False UserAuthServer False AccountingServer False ServerIPAddress 10.0.0.1 ServerUDPPort 1812 Timeout 2 seconds Retries SignPackets False...
Page 181: System Configuration Defaults
13 – Command Reference Reset Enter the Show Setup System command to display system configuration values. Table 13-12. System Configuration Defaults Parameter Default Ethernet Network Enable True Ethernet Network Discovery Static Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.254...
Page 182: Security
13 – Command Reference Security Security NOTE: This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Opens a Security Edit session in which to manage the security database on a switch.
Page 183 13 – Command Reference Security edit Initiates a Security Edit session in which to make changes to the security database. A Security Edit session enables you to use the Group and Securityset commands to create, add, and delete security sets, groups, and group members. To close a Security Edit session and save changes, enter the Security Save command.
Page 184 13 – Command Reference Security Examples The following is an example of the Security 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 Primary Secret ******** Secondary Hash SHA-1 Secondary Secret...
Page 185 13 – Command Reference Security The following is an example of the Security Limits command: SANbox #> security limits Security Attribute Maximum Current [Name] ------------------ ------- ------- ------ MaxSecuritySets MaxGroups MaxTotalMembers 1000 MaxMembersPerGroup 1000 group1 group2 The following is an example of the Security List command: SANbox #>...
Page 186: Securityset
13 – Command Reference Securityset Securityset NOTE: This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Manages security sets in the security database. Authority Admin session and a Security Edit session.
Page 187 13 – Command Reference Securityset copy [security_set_source] [security_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_source]. create [security_set] Creates the security set with the name given by [security_set]. A security set name must begin with a letter and be no longer than 64 characters.
Page 188 13 – Command Reference Securityset Examples The following is an example of the Securityset 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 Securityset Groups command SANbox #>...
Page 189: Set Alarm
13 – Command Reference Set Alarm Set Alarm Controls the display of alarms in the session output stream or clears the alarm log. Authority Admin session for the Clear keyword. Otherwise, none. Syntax set alarm [option] Keywords [option] [option] can be one of the following: clear Clears the alarm log history.
Page 190: Set Beacon
13 – Command Reference Set Beacon Set Beacon Enables or disables the flashing of the Logged-In LEDs for the purpose of locating a switch. Authority None Syntax set beacon [state] Keywords [state] [state] can be one of the following: Enables the flashing beacon. Disables the flashing beacon.
Page 191: Set Config Port
13 – Command Reference Set Config Port Set Config Port Sets the port configuration parameters for one or more ports. 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. Authority Admin session and a Config Edit session Syntax...
Page 192 13 – Command Reference Set Config Port Table 13-14. Port Configuration Parameters (Continued) Parameter Description PortType Port types: 1/2/4-Gbps Ports: GL, G, F, FL, Donor. The default is GL. 10-Gbps Ports: GL, G, F, FL, Donor. The default is GL. The Donor port type disables the port and makes the buffer credits available to other ports.
Page 193 Auto – Suppresses the reception of RSCN messages when the port is connected to an initiator device with a QLogic HBA. For older QLogic HBAs, such as the QLA2200, the DeviceScanEnabled parameter must also be enabled. The default is Auto.
Page 194 13 – Command Reference Set Config Port Table 13-14. Port Configuration Parameters (Continued) Parameter Description PDISCPingEnable Enables (True) or disables (False) the transmission of ping messages from the switch to all devices on a loop port. The (1/2/4-Gbps ports only) default is True.
Page 195 13 – Command Reference Set Config Port 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 to accept the current value.
Page 196 13 – Command Reference Set Config Port 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 the ENTER key to accept the current value.
Page 197: Set Config Security
13 – Command Reference Set Config Security Set Config Security NOTE: This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Configures the security database for the automatic saving of changes to the active security set and fabric binding.
Page 198 13 – Command Reference Set Config Security 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.
Page 199: Set Config Security Portbinding
13 – Command Reference Set Config Security Portbinding Set Config Security Portbinding Configures port binding. Authority Admin session and a Config Edit session Syntax set config security portbinding [port_number] Keywords [port_number] Initiates an editing session in which to change the port binding configuration for the port given by [port_number].
Page 200: Set Config Switch
13 – Command Reference Set Config Switch Set Config Switch Sets the switch configuration parameters. 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.
Page 201 13 – Command Reference Set Config Switch Table 13-17. Switch Configuration Parameters (Continued) Parameter Description SymbolicName Descriptive name for the switch. The name can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is SANbox. R_A_TOV Resource Allocation Timeout Value.
Page 202: Set Config Threshold
13 – Command Reference Set Config Threshold Set Config Threshold Sets the port alarm threshold parameters by which the switch monitors port performance and generates alarms. 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.
Page 203 13 – Command Reference Set Config Threshold Notes The switch will down a port if an alarm condition is not cleared 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 falling trigger.
Page 204: Set Config Zoning
13 – Command Reference Set Config Zoning Set Config Zoning Configures the zoning database. The changes you make with this command are not retained when you reset or power cycle the switch unless you save them using Config Save command. Authority Admin session and a Config Edit session Syntax...
Page 205 13 – Command Reference Set Config Zoning Examples The following is an example of the Set Config Zoning 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.
Page 206: Set Log
13 – Command Reference Set Log Set Log Specifies the events to record in the event log and display on the screen. You determine what events to record in the switch event log using the Component, Level, and Port keywords. You determine what events are automatically displayed on the screen using the Display keyword.
Page 207 13 – Command Reference Set Log Mgmtserver Monitors management server status. Nameserver Monitors name server status. None Monitor none of the component events. Port Monitors all port events. SNMP Monitors all SNMP events. Switch Monitors switch management events. Zoning Monitors zoning conflict events. display [filter] Specifies the log events to automatically display on the screen according to the event severity levels given by [filter].
Page 208 13 – Command Reference Set Log level [filter] Specifies the severity level given by [filter] to use in monitoring and logging events for the specified components or ports. [filter] can be one of the following values: Critical Monitors critical events. The critical level describes events that are generally disruptive to the administration or operation of the fabric, but require no action.
Page 209 13 – Command Reference Set Log save Saves the log settings for the component, severity level, port, and display level. These settings remain in effect after a switch reset. The log settings can be viewed using the Show Log Settings command. To export log entries to a file, use the Set Log Archive command.
Page 210: Set Pagebreak
13 – Command Reference Set Pagebreak Set Pagebreak Specifies how much information is displayed on the screen at a time. This command is useful for disabling pagebreaks to allow command scripts to run without interruption. Authority None Syntax pagebreak [state] Keywords [state] [state] can be one of the following:...
Page 211 13 – Command Reference Set Pagebreak Examples The following is an example of the Set Pagebreak 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 ...
Page 212: Set Port
13 – Command Reference Set Port Set Port Sets port state and speed for the specified port temporarily until the next switch reset or new configuration activation. This command also clears port counters. Authority Admin session Syntax set port clear set port [port_number] bypass [alpa] clear...
Page 213 13 – Command Reference Set Port speed [transmission_speed] Specifies the transmission speed for the specified port. Choose one of the following port speed values: 1Gb/s One gigabit per second. 2Gb/s Two gigabits per second. 4Gb/s Four gigabits per second. 10Gb/s Ten gigabits per second.
Page 214: Set Setup Radius
13 – Command Reference Set Setup Radius Set Setup Radius NOTE: This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key. Configures RADIUS servers on the switch.
Page 215 13 – Command Reference Set Setup Radius Table 13-20. RADIUS Service Settings (Continued) Entry Description DeviceAuthServer Enable (True) or disable (False) this server for device authenti- cation. The default is False. UserAuthServer Enable (True) or disable (False) this server for user account authentication.
Page 216 13 – Command Reference Set Setup Radius Examples The following is an example of the Set Setup 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 process before reaching the end of the attributes for the server being processed, press 'q' or 'Q' and the ENTER key to do so.
Page 217: Set Setup Services
13 – Command Reference Set Setup Services Set Setup Services Configures services on the switch. Authority Admin session Syntax set setup services Prompts you in a line-by-line fashion to enable or disable switch services. Table 13-21 describes the switch service parameters. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets.
Page 218 13 – Command Reference Set Setup Services Table 13-21. Switch Services Settings (Continued) Entry Description SSLEnabled Enables (True) or disables (False) secure SSL connections for management applications including Enterprise Fabric Suite 2007, QuickTools, Application Programming Inter- face, and SMI-S. The default is False. The SSL service requires the Fabric Security license key.
Page 219 13 – Command Reference Set Setup Services Table 13-21. Switch Services Settings (Continued) Entry Description MgmtServerEnabled Enables (True) or disables (False) the management of the switch through third-party applications that use GS-3 Man- agement Server (MS). This parameter is the master control for the Set Config Port command parameter, MSEnable.
Page 220: Set Setup Snmp
13 – Command Reference Set Setup SNMP Set Setup SNMP Configures SNMP on the switch. Authority Admin session Syntax set setup snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table 13-22 describes the SNMP fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets.
Page 221 13 – Command Reference Set Setup SNMP Table 13-22. SNMP Configuration Settings (Continued) Entry Description WriteCommunity Write community password 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 management server must be the same.
Page 222 13 – Command Reference Set Setup SNMP Examples The following is an example of the Set Setup 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 before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
Page 223: Set Setup System
13 – Command Reference Set Setup System Set Setup System Configures the network, session, and logging settings on the switch. Authority Admin session Syntax set setup system Prompts you in a line-by-line fashion to change system configuration settings. Table 13-23 describes the system configuration fields.
Page 224 13 – Command Reference Set Setup System Table 13-23. System Configuration Settings (Continued) Entry Description NTPClientEnabled Enables (True) or disables (False) the Network Time Pro- tocol (NTP) client on the switch. This client enables the switch to synchronize its time with an NTP server. This feature supports NTP version 4 and is compatible with version 3.
Page 225: Set Switch State
13 – Command Reference Set Switch State Set Switch State Changes the administrative state for all ports on the switch. The previous Set Config Switch settings are restored after a switch reset or a reactivation of a switch configuration. Authority Admin session Syntax set switch state [state]...
Page 226: Set Timezone
13 – Command Reference Set Timezone Set Timezone Specifies the time zone for the switch and the workstation. The default is Universal Time (UTC) also known as Greenwich Mean Time (GMT). This keyword prompts you to choose a region, then a subregion to specify the time zone. Changing the time zone converts the current time to the time in the new time zone.
Page 227: Show About
13 – Command Reference Show About Show About Displays an introductory set of information about operational attributes of the switch. This command is equivalent to the Show Version command. Authority None Syntax show about Examples The following is an example of the Show About command: SANbox #>...
Page 228: Show Alarm
13 – Command Reference Show Alarm Show Alarm Displays the alarm log and session output stream display setting. Authority None Syntax show alarm settings Keywords settings Displays the status of the parameter that controls the display of alarms in the session output stream.
Page 229: Show Broadcast
13 – Command Reference Show Broadcast Show Broadcast Displays the broadcast tree information and all ports that are currently transmitting and receiving broadcast frames. Authority None Syntax show broadcast Examples The following is an example of the Show Broadcast command: SANbox #>...
Page 230: Show Chassis
13 – Command Reference Show Chassis Show Chassis Displays chassis component status and temperature. Authority None Syntax show chassis Examples The following is an example of the Show Chassis command for model 5602. SANbox #> show chassis Chassis Information ------------------- BoardTemp (1) - Degrees Celsius FanStatus (1) Good...
Page 231: Show Config Port
13 – Command Reference Show Config Port Show Config Port Displays configuration parameters for one or more ports. Authority None Syntax show config port [port_number] Keywords [port_number] The number of the port. Ports are numbered beginning with 0. If you omit [port_number], all ports are specified.
Page 232 13 – Command Reference Show Config Port The following is an example of the Show Config Port command for a 10-Gbps port: SANbox #> show config port 16 Configuration Name: default ------------------- Port Number: 16 ------------ AdminState Online LinkSpeed 10Gb/s PortType SymbolicName 10G-16...
Page 233: Show Config Security
13 – Command Reference Show Config Security Show Config Security Displays the security database configuration parameters. Authority None Syntax show config security Examples The following is an example of the Show Config Security command: SANbox #> show config security Configuration Name: default ------------------- Switch Security Configuration Information -----------------------------------------...
Page 234: Show Config Security Portbinding
13 – Command Reference Show Config Security Portbinding Show Config Security Portbinding Displays the port binding configuration for one or more ports. Authority None Syntax show config security portbinding [port_number] Keywords [port_number] The number of the port. If you omit [port_number], the port binding configuration for all ports is displayed.
Page 235: Show Config Switch
13 – Command Reference Show Config Switch Show Config Switch Displays the switch configuration parameters. Authority None Syntax show config switch Examples The following is an example of the Show Config Switch command: SANbox #> show config switch Configuration Name: default ------------------- Switch Configuration Information --------------------------------...
Page 236: Show Config Threshold
13 – Command Reference Show Config Threshold Show Config Threshold Displays alarm threshold parameters for the switch. Authority None Syntax show config threshold Examples The following is an example of the Show Config Threshold command: SANbox #> show config threshold Configuration Name: default ------------ Threshold Configuration Information...
Page 237: Show Config Zoning
13 – Command Reference Show Config Zoning Show Config Zoning Displays zoning configuration parameters for the switch. Authority None Syntax show config zoning Examples The following is an example of the Show Config Zoning command: SANbox #> show config zoning Configuration Name: default ------------------- Zoning Configuration Information...
Page 238: Show Domains
13 – Command Reference Show Domains Show Domains Displays list of each domain and its worldwide name in the fabric. Authority None Syntax show domains Examples The following is an example of the Show Domains command: SANbox #> show domains Principal switch is (remote): 10:00:00:60:69:50:0b:6c Upstream Principal ISL is Domain ID List:...
Page 239: Show Donor
13 – Command Reference Show Donor Show Donor Displays list of current donor and extended credit configuration for all ports. Authority None Syntax 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...
Page 240: Show Fabric
13 – Command Reference Show Fabric Show Fabric Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address. Authority None Syntax show fabric Examples The following is an example of the Show Fabric command: SANbox #>...
Page 241: Show Fdmi
(?). Examples The following is an example of the Show FDMI command: SANbox #> show fdmi HBA ID PortID Manufacturer Model Ports -------- ------ --------------- ------- ----- 21:01:00:e0:8b:27:aa:bc 610000 QLogic Corporation QLA2342 21:00:00:00:ca:25:9b:96 180100 QLogic Corporation QL2330 59183-01 A 13-111...
Page 242 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:e0:8b:07:aa:bc HardwareVersion FC5010409-10 DriverVersion 8.2.3.10 Beta 2 (W2K VI) OptionRomVersion 1.21 FirmwareVersion 03.02.13.
Page 243: Show Interface
13 – Command Reference Show Interface Show Interface Displays the status of the active network interfaces. Authority None Syntax show interface Examples The following is an example of the Show Interface command: SANbox #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD:00:BD:ED inet addr:10.20.68.107 Bcast:10.20.68.255 Mask:255.255.255.0...
Page 244: Show Log
13 – Command Reference Show Log Show Log Displays the contents of the log or the parameters used to create and display entries in the log. The log contains a maximum of 1200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest.
Page 245 13 – Command Reference Show Log 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. Warning Displays all warning events. Critical Displays all critical events.
Page 246 13 – Command Reference Show Log port Displays the ports being monitored for events. If an event occurs which is of the defined level and on a defined component, but not on a defined port, no entry is made in the log. settings Displays the current filter settings for component, severity level, port, and display level.
Page 247: Show Lsdb
13 – Command Reference Show LSDB Show LSDB Displays Link State database information, Authority None Syntax show lsdb Examples The following is an example of the Show LSDB command: SANbox #> show lsdb Link State Database Information ------------------------------- LsID 34: Age=1176, Incarnation=0x800000e5 NeighborDomain=36, LocalPort=6, RemotePort=7, Cost=500 NeighborDomain=35, LocalPort=16, RemotePort=16, Cost=100...
Page 248: Show Media
13 – Command Reference Show Media Show Media NOTE: This command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Displays transceiver operational and diagnostic information for one or more ports. Authority None Syntax...
Page 249 13 – Command Reference Show Media Table 13-25. Transceiver Information (Continued) Information Type Description Temp Temperature in degrees Celsius. Voltage Supply voltage in Volts. The range is 0–6.55. Tx Bias Transmitter laster bias current in milliamps. The range is 0–655. Tx Power Transmitter coupled output power in milliWatts.
Page 250 13 – Command Reference Show Media 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 MediaSerialNumber P6G22RL MediaSpeeds 1Gb/s, 2Gb/s, 4Gb/s Temp Voltage...
Page 251 13 – Command Reference Show Media The following is an example of the 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 (mA) (mW) (mW)
Page 252: Show Mem
13 – Command Reference Show Mem Show Mem Displays information about memory activity. Authority None Syntax show mem [count] Keywords [count] The number of seconds for which to display memory information. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units. NOTE: This keyword will display memory activity updates until [count] is reached–it cannot be interrupted.
Page 253: Show Ns
13 – Command Reference Show NS Show NS Displays the WWNs for devices in the fabric. Authority None Syntax show ns [option] Keywords [option] The domain IDs or port IDs for which to display name server information. If you omit [option], name server information for the local domain ID is displayed. [option] can have the following values: Displays WWNs for all switches and ports.
Page 254 13 – Command Reference Show NS The following is an example of the Show NS [port_ID] command: SANbox #> show ns 1301e1 Port ID: 1301e1 -------- PortType 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 PortIPAddress 0.0.0.0 FabricPortName 20:01:00:c0:dd:00:bc:56 FC4Type FC4Desc (NULL)
Page 255: Show Pagebreak
13 – Command Reference Show Pagebreak Show Pagebreak Displays the current pagebreak setting. Authority None Syntax show pagebreak Notes The pagebreak 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 Pagebreak command: SANbox #>...
Page 256: Show Perf
13 – Command Reference Show Perf Show Perf Displays port performance in frames/second and bytes/second. If you omit the keyword, the command displays data transmitted (out), data received (in), and total data transmitted and received in frames/second and bytes per second. Transmission rates are expressed in thousands (K) and millions (M).
Page 257 13 – Command Reference Show Perf outbyte [port_list] Displays continuous performance data 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 ports 0, 2, 10, 11, 12, 13, 14, and 15.
Page 258 13 – Command Reference Show Perf 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) ------ ------- ------- ------- -------- -------- -------- 136M...
Page 259: Show Port
13 – Command Reference Show Port Show Port Displays operational information for one or more ports. Authority None Syntax show port [port_list] Keywords [port_list] The number of the port for which to display information. [port_list] can be a set of port numbers and ranges delimited by spaces.
Page 260 13 – Command Reference Show Port Table 13-26. Show Port Parameters (Continued) Entry Description DecodeError Number of decode errors detected DiagFaultCode Fault code from the most recent Power-on self test DiagStatus Status from the most recent Power-on self test EpConnects Number of times an E_Port connected through ISL negotia- tion.
Page 261 13 – Command Reference Show Port Table 13-26. Show Port Parameters (Continued) Entry Description LIP_F7_F7 A loop initialization primitive frame used to acquire a valid AL_PA. LIP_F8_F7 A loop initialization primitive frame used to indicate that a loop failure has been detected at the receiver. Login Number of device logins LoginStatus...
Page 262 13 – Command Reference Show Port Table 13-26. Show Port Parameters (Continued) Entry Description RxOfflineSeq Number of offline sequences received. An OLS is issued for link initialization, a Receive & Recognize Not_Operational (NOS) state, or to enter the offline state. ShortFramesIn Number of incidents when one or more frames are received that are less than the minimum size.
Page 263 13 – Command Reference Show Port Examples The following is an example of the Show Port command: SANbox #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Offline AsicNumber PerfTuningMode Normal AsicPort PortID 220000 ConfigType PortWWN 20:00:00:c0:dd:07:20:58 DiagStatus Passed RunningType Unknown...
Page 264: Show Post Log
13 – Command Reference Show Post Log Show Post Log Displays the Power On Self Test (POST) log which contains results from the most recently failed POST. Authority None Syntax show post log Examples The following is an example of the Show Post Log command: SANbox #>...
Page 265: Show Setup Mfg
Syntax 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 QLogic BuildDate Unknown PartNumber SANbox 5600 SerialNumber FAM0331000011 LicensedPorts MACAddress...
Page 266: Show Setup Radius
13 – Command Reference Show Setup Radius Show Setup Radius Displays RADIUS server information. Authority None Syntax show setup radius Examples The following is an example of the Show Setup RADIUS command: SANbox #> show setup radius Radius Information ------------------ DeviceAuthOrder RadiusLocal UserAuthOrder...
Page 267: Show Setup Services
13 – Command Reference Show Setup Services Show Setup Services Displays switch service status information. Authority None Syntax show setup services Examples The following is an example of the Show Setup Services command: SANbox #> show setup services System Services ----------------------------- TelnetEnabled True...
Page 268: Show Setup Snmp
13 – Command Reference Show Setup SNMP Show Setup SNMP Displays the current SNMP settings. Authority None Syntax show setup snmp The following is an example of the Show Setup Snmp command: SANbox #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact...
Page 269: Show Setup System
13 – Command Reference Show Setup System Show Setup System Displays the current system settings. Authority None Syntax show setup system Examples The following is an example of the Show Setup System command: SANbox #> show setup system System Information ------------------ EthNetworkEnable True...
Page 270: Show Steering
13 – Command Reference Show Steering Show Steering Displays the routes that data takes in the fabric. Authority None Syntax 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 the fabric. Examples The following is an example of the Show Steering command: SANbox #>...
Page 271: Show Switch
13 – Command Reference Show Switch Show Switch Displays switch operational information. Authority None Syntax show switch Notes Table 13-27 describes the switch operational parameters. Table 13-27. Switch Operational Parameters Parameter Description SymbolicName Descriptive name for the switch SwitchWWN Switch world wide name BootVersion PROM boot version CreditPool...
Page 272 13 – Command Reference Show Switch Table 13-27. Switch Operational Parameters (Continued) Parameter Description PrincipalSwitchRole Principal switch status. True indicates that this switch is the principal switch. BoardTemp (1) - Degrees Celsius Internal switch temperature at circuit board sensor SwitchDiagnosticsStatus Results of the power-on self test SwitchTemperatureStatus Switch temperature status: normal, warning, fail-...
Page 273: Show Timezone
13 – Command Reference Show Timezone Show Timezone Displays the current time zone setting. Authority None Syntax show timezone Examples The following is an example of the Show Timezone command: SANbox #> show timezone America/Chicago 59183-01 A 13-143...
Page 274: Show Topology
13 – Command Reference Show Topology Show Topology Displays all connected devices. Authority None Syntax show topology Examples The following is an example of the Show Topology command: SANbox #> show topology Unique ID Key ------------- A = ALPA, D = Domain ID, P = Port ID Port Local Local...
Page 275 13 – Command Reference Show Topology The following is an example of the Show Topology 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 Remote Link Information ----------------------- Device 0 NodeWWN 50:80:02:00:00:06:d5:38 PortType NL Description (NULL)
Page 276: Show Users
13 – Command Reference Show Users Show Users Displays a list of logged-in users. This is equivalent to the User List command. Authority None Syntax show users Examples The following is an example of the Show Users command: SANbox #> show users User Ethernet Addr-Port Logged in Since...
Page 277: Show Version
13 – Command Reference Show Version Show Version Displays an introductory set of information about operational attributes of the switch. This command is equivalent to the Show About command. Authority None Syntax show version Examples The following is an example of the Show Version command. SANbox #>...
Page 278: Shutdown
13 – Command Reference Shutdown Shutdown Terminates all data transfers on the switch at convenient points and closes the Telnet session. Always power cycle the switch after entering this command. Authority Admin session Syntax shutdown Notes When the shutdown is complete, the Heartbeat LED is extinguished. 13-148 59183-01 A...
Page 279: Test Cancel
13 – Command Reference Test Cancel Test Cancel Cancels a port test that is in progress. Authority Admin session Syntax test cancel port [port_number] Keywords port [port_number] Cancel the test for the port given by [port_number]. [port_number] can be 0–19. Examples The following example cancels the test running on port 15: SANbox (admin) #>...
Page 280: Test Port
13 – Command Reference Test Port Test Port Tests individual ports using an offline or online test. Authority Admin session Syntax test port [port_number] offline [loopback_type] online Keywords [port_number] The port to be tested. [port_number] can be 0–19. offline [loopback_type] Performs an offline test of the type given by [loopback_type] on the port given by [port_number].
Page 281: Port Test Parameters
13 – Command Reference Test Port Notes Table 13-28 describes the port test parameters. Table 13-28. Port Test Parameters Parameter Description LoopCount Number of frames sent FrameSize Number of bytes in each test frame DataPattern Pattern in the payload StopOnError Stops the test when an error occurs (True).
Page 282 13 – Command Reference Test Port Examples The following example performs an online test 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.
Page 283: Test Status
13 – Command Reference Test Status Test Status Displays the status of a test in progress, or if there is no test in progress, the status of the test that was executed last. Authority None Syntax test status port [port_number] Keywords port [port_number] Display test status for the port given by [port_number].
Page 284: Uptime
13 – Command Reference Uptime Uptime Displays the elapsed up time since the switch was last reset and reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed up time reported by this command. Authority None Syntax uptime Examples...
Page 285: User
13 – Command Reference User User Administers and displays user accounts. Authority Admin account name and an Admin session. The Accounts and List keywords are available to all account names without an Admin session. Syntax user accounts delete [account_name] edit list Keywords accounts...
Page 286 13 – Command Reference User Notes Authority level or password changes that you make to an account that is currently logged in do not take effect until that account logs in again. Examples The following is an example of the User Accounts command: SANbox (admin) #>...
Page 287 13 – Command Reference User 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 List command: SANbox (admin) #>...
Page 288: Whoami
13 – Command Reference Whoami Whoami Displays the account name, session number, and switch domain ID for the Telnet session. Authority None Syntax whoami Examples The following is an example of the Whoami command: SANbox #> whoami User name : admin@session2 Switch name : SANbox Switch domain ID: 21 (0x15)
Page 289: Zone
13 – Command Reference Zone Zone Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit session. Refer to the “Zoning” command on page 13-166 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
Page 290 13 – Command Reference Zone delete [zone] Deletes the specified zone given by [zone] from the zoning database. If the zone is a component of the active zone set, the zone will not be removed from the active zone set until the active zone set is deactivated. list Displays a list of all zones and the zone sets of which they are components.
Page 291 13 – Command Reference Zone 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_22412f zone_set_1 The following is an example of the Zone Members command: SANbox #>...
Page 292 13 – Command Reference Zone The following is an example of the Zone Zonesets command: SANbox #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1 13-162 59183-01 A...
Page 293: Zoneset
13 – Command Reference Zoneset Zoneset Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit session. Refer to the “Zoning” command on page 13-166 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session.
Page 294 13 – Command Reference Zoneset deactivate Deactivates the active zone set. Close the Zoning Edit session before using this keyword. delete [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 deactivated. list Displays a list of all zone sets.
Page 295 13 – Command Reference Zoneset Examples The following is an example of the Zoneset Active command: SANbox #> zoneset active ActiveZoneSet Bets LastActivatedBy admin@OB-session6 LastActivatedOn day month date time year The following is an example of the Zoneset List command: SANbox #>...
Page 296: Zoning
13 – Command Reference Zoning Zoning Opens a Zoning Edit session in which to create and manage zone sets 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, History, Limits, and List keywords. The Clear keyword also requires a zoning edit session.
Page 297: Zoning Database Limits
13 – Command Reference Zoning edit Opens a Zoning Edit session. history Displays a history of zoning modifications. This keyword does not require an Admin session. History information includes the following: Time of the most recent zone set activation or deactivation and the user who performed it Time of the most recent modifications to the zoning database and the user who made them.
Page 298 13 – Command Reference Zoning restore Restores the volatile zoning database with the contents of the non-volatile zoning database. If the InteropAutoSave parameter is False (see Table 13-8), you can use this keyword to revert changes to the volatile zoning database that were propagated from another switch in the fabric through zone set activation or merging fabrics.
Page 299 13 – Command Reference Zoning The following is an example of the Zoning Limits command: SANbox #> zoning limits Zoning Attribute Maximum Current [Zoning Name] ---------------- ------- ------- ------------- MaxZoneSets MaxZones 2000 MaxAliases 2500 MaxTotalMembers 10000 MaxZonesInZoneSets 2000 MaxMembersPerZone 2000 D_1_JBOD_1 D_1_Photons D_2_JBOD1...
Page 300 13 – Command Reference Zoning The following is an example of the Zoning List command: SANbox #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember -------------------------------- 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:82:bf:d2:18:d2 10:00:00:00:c9:23:bd:31 wwn_221416 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15:c3 Configured Zoning Information...
Page 301: Index
Index Alias command 13-5 Add example 7-18 account name Copy example 7-18 admin 2-2 Create example 7-17 display 13-155, 13-158 Delete example 7-17 factory 3-1 List example 7-6 maintenance mode 3-1 Members example 7-6 activation Remove example 7-18 firmware 5-20, 5-21 Rename example 7-17 security 9-9, 9-11 ALPA - See Arbitrated Loop Physical Address...
Page 302 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide command Cyclic Redundancy Check errors 6-10 entry 2-3 examples 13-2 listing 13-3 notes 13-2 date 5-17 reference 13-1 Date command 5-17, 13-13 rules and conventions 13-2 decode errors 6-10 syntax 13-2...
Page 303 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide event Feature command 13-18 message format 11-2 Add example 5-25 output stream control 11-3 Log example 5-24 remote logging 11-6 feature upgrade 5-24, 13-18 severity level 11-1 Fibre Channel event log...
Page 304 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide group add members 9-13, 13-23 I/O Stream Guard 13-63 add to security set 9-11 Image command 13-34 copy 9-13, 13-25 Install example 5-20 create 9-12, 13-25 informative event 11-1 delete 9-12...
Page 305 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide logout errors 6-10 non-disruptive activation 5-21, 13-33 loop port NTP - See Network Time Protocol bypass 13-82 enable 13-82 initialization 13-37 loss-of-signal errors 6-10 offline test port 6-13 online test 6-12...
Page 306 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide port RADIUS server administrative state 13-83 configuration 8-1, 10-1, 10-3, 13-84 binding 6-8, 13-69, 13-104 configuration defaults 13-50 configuration 6-1, 13-61 configuration display 13-136 configuration defaults 13-47 information 10-2 configuration display 13-101...
Page 307 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide security security set certificate 8-1, 8-3 activate 9-11, 13-56 configuration 13-67 active 9-4 configuration defaults 13-51 add group 9-11 configuration display 13-103 add member group 13-56 configuration parameters 5-6 configured 9-2...
Page 308 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Set Config Switch command 13-70 Show Config Security command 13-103 example 5-13 example 5-6 Set Config Threshold command 13-72 port binding 6-8 example 6-11 Show Config Security Port command 13-104...
Page 309 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Show Switch command 13-141 switch Show Timezone command 13-143 administrative state 13-95 Show Topology command 13-144 configuration 5-1, 5-11, 13-70 Show Users command 13-146 configuration defaults 13-46 Show Version command 13-147...
Page 310 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Test Port command 13-150 example 6-12 Virtual Interface preference routing 13-63 Test Status command 13-153 TFTP - See Trivial File Transfer Protocol time between resets 5-4 set and display 5-17, 13-13...
Page 311 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide zone set zoning activate 7-14, 13-163 configuration 7-1, 13-74 active 7-1, 7-4, 13-166 configuration defaults 13-49 add member zone 13-163 configuration display 13-107 add zones 7-14 configuration parameters 5-6 configured 7-2...
Page 312 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Notes Index-12 59183-01 A...

Qlogic SANbox 5000 Series Interface Manual

Introduction

Command Line Interface Usage

Table

User Account Configuration

Network and Fabric Configuration

Switch Configuration

Port Configuration

Zoning Configuration

Connection Security Configuration

Device Security Configuration

Section 10 RADIUS Server Configuration

Event Log Configuration

Section 12 Simple Network Management Protocol Configuration

Section 13 Command Reference

Index

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Qlogic SANbox 5000 Series

Summary of Contents for Qlogic SANbox 5000 Series