Qlogic SANbox 5000 Series Interface Manual

Qlogic SANbox 5000 Series Interface Manual

Fibre channel switch firmware version 6.8
Hide thumbs Also See for SANbox 5000 Series:
Table of Contents

Advertisement

R
S i m p l i f y
SANbox 5000 Series
Fibre Channel Switch
Command Line Interface Guide
Firmware Version 6.8
59183-02 A
Page i

Advertisement

Table of Contents
loading

Summary of Contents for Qlogic SANbox 5000 Series

  • Page 1 S i m p l i f y SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Firmware Version 6.8 59183-02 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 Section 5 Switch Configuration Displaying Switch Information ........5-1 5.1.1 Switch Operational Information .
  • Page 5 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Section 6 Port Configuration Displaying Port Information ........6-1 6.1.1 Port Configuration Parameters .
  • Page 6 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide 7.7.6 Remove Zones from a Zone Set ......7-16 7.7.7 Activate a Zone Set .
  • Page 7 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide 9.5.6 Remove Groups from a Security Set......9-11 9.5.7 Activate a Security Set .
  • Page 8 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Section 12 Call Home Configuration 12.1 Call Home Concepts ......... .12-1 12.1.1 Call Home Requirements .
  • Page 9 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide List of Tables Table Page Command-Line Completion ......... . .2-4 Factory User Accounts.
  • Page 10 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Notes Page x 59183-02 A...
  • 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.8. 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

    59060-04 SANbox Simple Network Management Protocol Reference Guide, publication number, 59047-08 CIM Agent Reference Guide, 59223-01 QLogic Switch Interoperability Guide v3.0. This PDF document can be downloaded at http://www.qlogic.com/interopguide/info.asp#inter. Fibre Channel-Arbitrated Loop (FC-AL-2) Rev. 7.0. Fibre Channel-10-bit Interface Rev. 2.3.
  • Page 13: New In This Release

    1 – Introduction New in This Release New in This Release The following features are new in this release. Call Home Zoning Configuration Parameters Set Port Command Changes 1.4.1 Call Home This feature improves fabric availability by notifying adminstrators by email of events that afffect switch operation.
  • 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-02 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 http:\\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-02 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: Entering Commands

    2 – Command Line Interface Usage Entering Commands Entering Commands The command-line completion feature makes entering and repeating commands easier. Table 2-1 describes the command-line completion keystrokes. Table 2-1. Command-Line Completion Keystroke Effect Completes the command line. Enter at least one character and press the tab key to complete the command line.
  • Page 21: Setting Page Breaks

    2 – Command Line Interface Usage Setting Page Breaks Setting Page Breaks Some display commands deliver so much information to the screen that it scrolls off too quickly to read it. You can limit the display to 20 lines by turning on page breaks.
  • Page 22 2 – Command Line Interface Usage Creating a Support File The following example creates a support file and sends it to a remote host. 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 Enter remote directory name: bin/support...
  • Page 23 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 24: 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 25 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 26 2 – Command Line Interface Usage Downloading and Uploading Files Notes 2-10 59183-02 A...
  • Page 27: 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 28: 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 29: 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: the first character must be alphanumeric;...
  • Page 30: 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 31: 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 32: 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 33: 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 34: 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 35: 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 36 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 37: 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 38: 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 39: 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 40: 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 41: 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 42: 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 14-21 for a description of these parameters. SANbox #>...
  • Page 43: 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 44: 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 45: 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 46 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 47: 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 48: 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 49 5 – Switch Configuration Managing Switch Configurations The following is an example of the Set Config Switch command. Refer to Table 14-19 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 50: 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 51: 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 52: 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 53: 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 54 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 55: 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 56: 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 57: 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 58 5 – Switch Configuration Installing Firmware Do the following: 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 #> firmware install The switch will be reset.
  • Page 59: 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 60: Managing Switch Feature Upgrades

    5 – Switch Configuration Managing Switch Feature Upgrades A message will prompt you to reset the switch to activate the firmware. Use the Hotreset command to attempt a non-disruptive activation. SANbox (admin) $> hotreset 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®...
  • Page 61: 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 62 5 – Switch Configuration Managing Switch Feature Upgrades Notes 5-26 59183-02 A...
  • Page 63: Displaying Port Information

    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 Displaying Port Information You can display the following port information: Port Configuration Parameters Port Operational Information Port Threshold Alarm Configuration Parameters Port Performance...
  • Page 64: 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 14-16 for a description of these parameters. SANbox #>...
  • Page 65: 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 66: 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 14-20 for a description of these parameters.
  • Page 67: 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 68: 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 69: 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 70: 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 71: 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 72: 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 73 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 74: 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 75: 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 76: 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 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 Saving the Active and Merged Zone Sets Resetting the Zoning Database Managing Zone Sets Managing Zones Managing Aliases Consider device access needs within the fabric.
  • Page 78: Displaying Zoning Database Information

    7 – Zoning Configuration Displaying Zoning Database Information Displaying Zoning Database Information A switch maintains three zoning databases: Non-volatile–This zoning database is permanent and contains all zone sets, zones, and aliases that you create and save on a switch. The zone sets in the non-volatile zoning database are known as configured zone sets.
  • 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 active zone set and configured zone sets as shown in the following example. Merged and edited zone sets are displayed if they exist. SANbox #>...
  • Page 80: Active Zone Set Information

    7 – Zoning Configuration Displaying Zoning Database Information 7.1.2 Active Zone Set Information Zoning List 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: Merged Zone Set Information

    7 – Zoning Configuration Displaying Zoning Database Information 7.1.3 Merged Zone Set Information A merged zone set is a zone set that is received from another switch as a result of a change in active zone sets. You can display the merged zone set on your switch if the MergeAutoSave parameter is set to False.
  • Page 82: Zone Set Membership Information

    7 – Zoning Configuration Displaying Zoning Database Information 7.1.5 Zone Set Membership Information Zoneset Zones, Zone List, 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 83: Zone Membership Information

    7 – Zoning Configuration Displaying Zoning Database Information 7.1.6 Zone Membership Information Enter the Zone Members command to display the members for a specified zone as shown in the following example: SANbox #> zone members wwn_b0241f Current List of Members for Zone: wwn_b0241f --------------------------------- 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2...
  • Page 84: Zoning Modification History

    7 – Zoning Configuration Displaying Zoning Database Information Enter the Alias Members command to display the membership for a specified alias as shown in the following example: SANbox #> alias members alias1 Current list of members for Zone Alias: alias1 --------------------------------------- 50:06:04:82:bf:d2:18:c4 50:06:04:82:bf:d2:18:c5...
  • Page 85: Zoning Database Limits

    7 – Zoning Configuration Displaying Zoning Database Information 7.1.10 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 Configured (saved in NVRAM) Zoning Information Zoning Attribute Maximum...
  • Page 86: 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 87 7 – Zoning Configuration Configuring the Zoning Database To modify the zoning 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 through Telnet, QuickTools, Enterprise Fabric Suite 2007, or another management application.
  • Page 88: Modifying The Zoning Database

    7 – Zoning Configuration Modifying the Zoning Database Modifying the Zoning Database To modify the non-volatile zoning database, you must open an Admin session with 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 89: Saving The Active And Merged Zone Sets

    7 – Zoning Configuration Saving the Active and Merged Zone Sets Saving the Active and Merged Zone Sets You can save the active zone set and merged zone set to the non-volatile zoning database. Enter the Zoning Active Capture to save the active zone set as shown in the following example: SANbox (admin) #>...
  • Page 90: Removing Inactive Zone Sets, Zones, And Aliases

    7 – Zoning Configuration Removing Inactive Zone Sets, Zones, and Aliases Removing Inactive Zone Sets, Zones, and Aliases Enter the Zoning Delete Orphans command to delete all objects from the zoning database except those in the active zone set. SANbox #> admin start SANbox (admin) #>...
  • Page 91: 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 92: Rename A Zone Set

    7 – Zoning Configuration Managing Zone Sets 7.7.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.7.4 Copy a Zone Set...
  • Page 93: Activate A Zone Set

    7 – Zoning Configuration Managing Zones 7.7.7 Activate a Zone Set Enter the Zoneset Activate command to apply zoning to the fabric as shown in the following example: SANbox #> admin start SANbox (admin) #> zoneset activate zoneset_1 7.7.8 Deactivate a Zone Set Enter the Zoneset Deactivate command to deactivate the active zone set and...
  • Page 94: Delete A Zone

    7 – Zoning Configuration Managing Zones 7.8.2 Delete a Zone Enter the Zone Delete command to delete zone_1 from the zoning database as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone delete zone_1 SANbox (admin-zoning) #>...
  • Page 95: Remove Members From A Zone

    7 – Zoning Configuration Managing Zones 7.8.6 Remove Members from a Zone Enter the Zone Remove command to remove ports/devices from zone_1 as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone remove zone_1 alias_1 1,4 1,5 SANbox (admin-zoning) #>...
  • Page 96: 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.9.1 Create an Alias Enter the...
  • Page 97: Copy An Alias

    7 – Zoning Configuration Managing Aliases 7.9.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 98 7 – Zoning Configuration Managing Aliases Notes 7-22 59183-02 A...
  • Page 99: 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 100 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 101: 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 102 8 – Connection Security Configuration Creating an SSL Security Certificate Notes 59183-02 A...
  • Page 103: 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 104: 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 105 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 106: 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 107: 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 108: 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 109: 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 110 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 111: 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 112: 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 113: Copy A Security Set

    9 – Device Security Configuration Managing Security Sets 9.5.4 Copy a Security Set Enter the Securityset Copy command to copy a security set and its contents to a new security set as shown in the following example: SANbox (admin-security) #> securityset copy securityset_1 securityset_2 9.5.5 Add Groups to a Security Set Enter the...
  • Page 114: 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 115: 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 116: 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 14-1.
  • Page 117: 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 118: 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 14-23 for a description of the RADIUS server configuration parameters.
  • Page 119: 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 14-23 for a description of the RADIUS server configuration parameters.
  • Page 120 10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch Notes 10-4 59183-02 A...
  • Page 121: 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 122: 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 123: Filtering The Event Log Display

    11 – Event Log Configuration Managing the Event Log Configuration 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 124: Configure The Event Log

    11 – Event Log Configuration Managing 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 component, severity level, and port. Enter the Set Log Component, Set Log Level, and Set Log Port commands to filter the events to be recorded.
  • Page 125: Restore The Event Log Configuration

    11 – Event Log Configuration Clearing the Event Log 11.3.3 Restore the Event Log Configuration Enter the Set Log Restore command to return the event log configuration to the factory default as shown in the following example: SANbox (admin) #> set log restore 11.4 Clearing the Event Log Enter the...
  • Page 126: Creating And Downloading A Log File

    11 – Event Log Configuration Creating and Downloading a Log File Set Setup System command controls local logging through the LocalLogEnabled parameter and remote logging through the RemoteLogEnabled and RemoteLogHostAddress parameters as shown in the following example: SANbox (admin) #> set setup system A list of attributes with formatting and current values will follow.
  • Page 127: Section 12 Call Home Configuration

    Section 12 Call Home Configuration This section describes the following topics: Call Home Concepts Configuring the Call Home Service Managing the Call Home Database Testing a Call Home Profile Changing SMTP Servers Clearing the Call Home Message Queue Resetting the Call Home Database 12.1 Call Home Concepts The Call Home service improves fabric availability by notifying administrators by...
  • Page 128: Call Home Requirements

    12 – Call Home Configuration Call Home Concepts 12.1.1 Call Home Requirements In addition to enabling the Call Home service, you must also do the following to ensure that email messages can be sent: Configure the Call Home service. The Call Home service configuration consists of primary and secondary SMTP server specifications and contact information.
  • Page 129: Call Home Messages

    Call Home profile and SNMP configurations. The following is an example of a short-text email: From: john.doe@qlogic.com [mailto:john.doe@qlogic.com] Sent: Wednesday, July 25, 2007 5:03 PM Subject: [CallHome: Test] Alarm generated on Switch_8 SwitchName: Switch_8_83.215...
  • Page 130 12 – Call Home Configuration Call Home Concepts The following is an example of a full-text email including profile and SNMP contact information: From: john.doe@work.com [mailto:john.doe@work.com] Sent: Wednesday, July 25, 2007 5:03 PM Subject: [CallHome: Test] Alarm generated on Switch_8 ------------ Event Details SwitchName: Switch_8_83.215...
  • Page 131: Configuring The Call Home Service

    12 – Call Home Configuration Configuring the Call Home Service 12.2 Configuring the Call Home Service Enter the Set Setup Callhome command to configure the Call Home service as shown in the following example. Refer to Table 14-22 for a description of the Call Home service configuration entries.
  • Page 132: Managing The Call Home Database

    12 – Call Home Configuration Managing the Call Home Database Enter the Show Setup Callhome command to display the Call Home service configuration as shown in the following example. SANbox (admin) #> show setup callhome Callhome Information -------------------- PrimarySMTPServerAddr 0.0.0.0 PrimarySMTPServerPort PrimarySMTPServerEnabled False...
  • Page 133: Display Call Home Database Information

    12 – Call Home Configuration Managing the Call Home Database The Admin End command releases the Admin session for other administrators when you are done making changes to the switch. To remove all Call Home profiles and restore the Call Home service configuration to its factory state, enter the Reset Callhome command.
  • Page 134 12 – Call Home Configuration Managing the Call Home Database Enter the Callhome List Profile command to display a list of Call Home profiles and their details as shown in the following example: SANbox #> callhome list profile ProfileName: group4 ------------ Level Warn...
  • Page 135: Create A Profile

    12 – Call Home Configuration Managing the Call Home Database 12.3.2 Create a Profile Enter the Profile Create command to create a Call Home profile as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #>...
  • Page 136: Delete A Profile

    12 – Call Home Configuration Managing the Call Home Database 12.3.3 Delete a Profile Enter the Profile Delete command to delete a Call Home profile as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #>...
  • Page 137: Modify A Profile

    12 – Call Home Configuration Managing the Call Home Database 12.3.4 Modify a Profile Enter the Profile Edit command to modify an existing Call Home profile as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #>...
  • Page 138: Rename A Profile

    12 – Call Home Configuration Testing a Call Home Profile 12.3.5 Rename a Profile Enter the Profile Rename command to rename profile_1 as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile rename profile_1 profile_4 The profile will be renamed.
  • Page 139: Changing Smtp Servers

    12 – Call Home Configuration Changing SMTP Servers 12.5 Changing SMTP Servers The Call Home service configuration enables you to specify a primary and a secondary SMTP server to which the switch connects. The active server is the server that receives messages from the switch. By default, the primary SMTP server is the active server.
  • Page 140 12 – Call Home Configuration Resetting the Call Home Database Enter the Reset Callhome command to clear all Call Home profiles and reset the Call Home service configuration to the factory defaults as shown in the following example: SANbox #> admin start SANbox (admin) #>...
  • Page 141: Section 13 Simple Network Management Protocol Configuration

    Section 13 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 142 13 – 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 143: Displaying Snmp Information

    13 – Simple Network Management Protocol Configuration Displaying SNMP Information 13.2 Displaying SNMP Information Enter the Show Setup SNMP command to display SNMP configuration information as shown in the following example. Refer to Table 14-25 for a description of the SNMP parameters. SANbox #>...
  • Page 144: Modifying The Snmp Configuration

    13 – Simple Network Management Protocol Configuration Modifying the SNMP Configuration 13.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 14-25 for SNMP parameters descriptions. SANbox (admin) #>...
  • Page 145: Resetting The Snmp Configuration

    13 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration 13.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 14-11 for a listing of the SNMP configuration factory defaults.
  • Page 146 13 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration Notes 13-6 59183-02 A...
  • Page 147: Section 14 Command Reference

    Section 14 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 Command Listing 14.1 Access Authority The Authority paragraph in each command description indicates what types of sessions are required to enter that command.
  • Page 148: Syntax And Keywords

    14 – Command Reference Syntax and Keywords 14.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 149: Command Listing

    14 – Command Reference Command Listing 14.4 Command Listing The commands are listed in alphabetical order. Admin, Alias Callhome, Config, Create Date Exit Fcping, Fctrace, Feature, Firmware Install Group Hardreset, Help, History, Hotreset Image Lip, Logout Passwd, Ping, Profile, Quit Reset Security, Securityset...
  • Page 150 14 – 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 151 14 – 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 152 14 – 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 153 14 – Command Reference Callhome Callhome Opens a Callhome Edit session in which to create and manage Call Home profiles. Refer to the Profile command for more information about Call Home profiles. Authority Admin session except for the History and List keywords. The Clear keyword also requires a Callhome Edit session.
  • Page 154 14 – Command Reference Callhome history Displays a history of Call Home modifications. This keyword does not require an Admin session. History information includes the following: Time of the most recent Call Home database modification and the user who performed it. Checksum for the Call Home database Profile processing information list profile [profile]...
  • Page 155 14 – Command Reference Callhome Examples The following is an example of the Callhome History command: SANbox #> callhome history CallHome Database History ------------------------- ConfigurationLastEditedBy admin@OB-session2 ConfigurationLastEditedOn day mmm dd hh:mm:ss yyyy DatabaseChecksum 000014a3 ProfileName group4 ProfileLevel Warn ProcessedCount ProcessedLast day mmm dd hh:mm:ss yyyy ProfileName group5...
  • Page 156 14 – Command Reference Callhome The following is an example of the Callhome List Profile command: SANbox #> callhome list profile ProfileName: group4 ------------ Level Warn Format FullText MaxSize any size up to max of 100000 EmailSubject CallHome Warn RecipientEmail admin1@company.com RecipientEmail admin2@company.com...
  • Page 157 14 – Command Reference Callhome The following is an example of the Callhome Queue Stats command: SANbox #> callhome queue stats Callhome Queue Information -------------------------- FileSystemSpaceInUse 534 (bytes) EntriesInQueue 59183-02 A 14-11...
  • Page 158 14 – 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 14-80. Authority Admin session for all keywords except Backup and List Syntax config activate [config_name]...
  • Page 159 14 – 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 160 14 – 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 161 14 – 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 162 14 – 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 163 14 – 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 164 14 – 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 165 14 – Command Reference Exit Exit Closes the switch connection. Authority None Syntax exit Notes You can also enter Control-D to close the switch connection. 59183-02 A 14-19...
  • Page 166 14 – 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 167 14 – 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 168 14 – 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 169 14 – 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 170 14 – 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 14-24 59183-02 A...
  • Page 171: Firmware Install

    14 – 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 172 14 – 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 173 14 – 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 174: Isl Group Member Attributes

    14 – 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 14-1, Table 14-2, and Table 14-3...
  • Page 175: Port Group Member Attributes

    14 – Command Reference Group Table 14-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 176: Ms Group Member Attributes

    14 – Command Reference Group Table 14-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 177: Group Member Attributes

    14 – 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 14-4.
  • Page 178 14 – Command Reference Group Table 14-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 179: Authentication Failure

    14 – Command Reference Group Notes Primary and secondary secrets are not included in a switch configuration backup. Therefore, after restoring a switch configuration, you must re-enter the primary and secondary secrets. Otherwise, the switch will isolate because of an authentication failure.
  • Page 180 14 – Command Reference Group The following is an example of the Group Edit command: SANbox #> admin start SANbox (admin) #> security edit SANbox (admin-security) #> group edit G1 10:00:00:c0:dd:00:90:a3 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 181 14 – 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” on page 14-86.
  • Page 182 14 – 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 183 14 – 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 184 14 – 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 185 14 – 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 186 14 – 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 187 14 – 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.8.00.11_mpc >ftp 10.0.0.254 user:johndoe password: ******** ftp>bin ftp>put 6.8.00.11_mpc ftp>quit SANbox (admin) $>image list SANbox (admin) $>image unpack 6.8.00.11_mpc Image unpack command result: Passed 59183-02 A 14-41...
  • Page 188 14 – 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 189 14 – Command Reference Logout Logout Closes the switch connection. Authority None Syntax logout Notes You can also enter Control-D to close the switch connection. 59183-02 A 14-43...
  • Page 190 14 – 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 191 14 – 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 192: Profile Configuration Settings

    14 – Command Reference Profile Profile Creates and modifies profiles with which to customize Call Home email notification. A profile defines the event severity level at which to generate emails, email subject and text, and email recipients. Authority Admin session and a Callhome Edit session. Refer to the “Callhome”...
  • Page 193 14 – Command Reference Profile Table 14-5. Profile Configuration Settings (Continued) Parameter Description MaxSize Maximum number of characters allowed in the email message. Decreasing this parameter makes for easier reading on small dis- play devices such as cell phones. The minimum is 650. The maxi- mum and default is 100,000.
  • Page 194 14 – Command Reference Profile Examples The following is an example of the Profile Create command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile create profile_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.
  • Page 195 14 – Command Reference Profile The following is an example of the Profile Edit command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile edit profile_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 14 – 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 197 14 – Command Reference Quit Quit Closes the switch connection. Authority None Syntax quit Notes You can also enter Control-D to close the switch connection. 59183-02 A 14-51...
  • Page 198 14 – Command Reference Reset Reset Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset callhome config [config_name] factory port [port_list] radius security services snmp switch (default) system zoning Keywords callhome Resets the Call Home database configuration to its default values.
  • Page 199 14 – 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, zoning configuration, and Call Home configuration to the factory default values as described in Table 14-7 through...
  • Page 200 14 – 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 201: Call Home Service Configuration Defaults

    14 – Command Reference Reset Notes The following tables specify the various factory default settings: Enter the Show Setup Callhome command to display the Call Home database configuration values. Table 14-6. Call Home Service Configuration Defaults Parameters Default PrimarySMTPServerAddr 0.0.0.0 PrimarySMTPServerPort PrimarySMTPServerEnabled False...
  • Page 202: Switch Configuration Defaults

    14 – Command Reference Reset Enter the Show Config Switch command to display switch configuration values. Table 14-7. Switch Configuration Defaults Parameter Default Admin State Online Broadcast Enabled True InbandEnabled True FDMIEnabled True FDMIEntries 1000 DefaultDomain ID 1 (0x Hex) Domain ID Lock False Symbolic Name...
  • Page 203: Port Configuration Defaults

    14 – Command Reference Reset Enter the Show Config Port command to display port configuration values. Table 14-8. 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 204: Port Threshold Alarm Configuration Defaults

    14 – Command Reference Reset Enter Show Config Threshold command to display threshold alarm configuration values. Table 14-9. 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 205: Zoning Configuration Defaults

    14 – Command Reference Reset Enter the Show Config Zoning command to display zoning configuration values. Table 14-10. Zoning Configuration Defaults Parameter Default MergeAutoSave True DefaultZone Allow DiscardInactive False Enter the Show Setup SNMP command to display SNMP configuration values. Table 14-11.
  • Page 206: Radius Configuration Defaults

    14 – Command Reference Reset Enter the Show Setup Radius command to display RADIUS configuration values. Table 14-12. 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 207: Services Configuration Defaults

    14 – Command Reference Reset Enter the Show Setup Services command to display switch service configuration values. Table 14-13. Services Configuration Defaults Parameter Default TelnetEnabled True SSHEnabled False GUIMgmtEnabled True SSLMgmtEnabled False EmbeddedGUIEnabled True SNMPEnabled True NTPEnabled False CIMEnabled True FTPEnabled True.
  • Page 208: System Configuration Defaults

    14 – Command Reference Reset Enter the Show Setup System command to display system configuration values. Table 14-14. 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 209 14 – 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 210 14 – 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 211 14 – 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 212 14 – Command Reference Security The following is an example of the Security List command: SANbox #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- No active securityset defined. Configured Security Information SecuritySet Group GroupMember ----------- ----- ----------- alpha group1 (ISL)
  • Page 213 14 – 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 214 14 – 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 215 14 – 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 216: Set Alarm

    14 – 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 217: Set Beacon

    14 – 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 218: Port Configuration Parameters

    14 – 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 219 14 – Command Reference Set Config Port Table 14-16. 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 220 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 221: Set Config Port

    14 – Command Reference Set Config Port Table 14-16. 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 222 14 – 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 223: Security Configuration Parameters

    14 – 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 224: Set Config Security

    14 – Command Reference Set Config Security Examples The following is an example of the Set Config Security command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config security 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 225: Port Binding Configuration Parameters

    14 – 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 226: Switch Configuration Parameters

    14 – 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 227 14 – Command Reference Set Config Switch Table 14-19. Switch Configuration Parameters (Continued) Parameter Description R_A_TOV Resource Allocation Timeout Value. The number of millisec- onds the switch waits to allow two ports to allocate enough resources to establish a link. The default is 10000. E_D_TOV Error Detect Timeout Value.
  • Page 228: Port Alarm Threshold Parameters

    14 – 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 229: Set Config Threshold

    14 – 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 230: Zoning Configuration Parameters

    14 – 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 231: Set Config Zoning

    14 – 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 232: Set Log

    14 – 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 233 Nameserver Monitors name server status. None Monitor none of the component events. Port Monitors all port events. Monitors all QLogic Fabric Service (QFS) events. QFS governs Call Home email notification. SNMP Monitors all SNMP events. Switch Monitors switch management events.
  • Page 234 14 – Command Reference Set Log None Specifies no severity levels for display on the screen. 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.
  • Page 235 14 – Command Reference Set Log restore Restores and saves the port, component, and level settings to the default values. 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.
  • Page 236: Set Pagebreak

    14 – 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 237 14 – 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 238 14 – 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] clear speed [transmission_speed]...
  • Page 239 14 – Command Reference Set Port state [state] Specifies one of the following administrative states for the specified port: Online Activates and prepares the port to send data. Offline Prevents the port from receiving signal and accepting a device login. Diagnostics Prepares the port for testing and prevents the port from accepting a device login.
  • Page 240: Call Home Service Configuration Settings

    14 – Command Reference Set Setup Callhome Set Setup Callhome Configures the Call Home database for managing email notifications of fabric problems. Authority Admin session Syntax set setup callhome Prompts you in a line-by-line fashion to configure the Call Home database. Table 14-23 describes the Call Home configuration fields.
  • Page 241 14 – Command Reference Set Setup Callhome Table 14-22. Call Home Service Configuration Settings Entry Description FromEmailAddress Email address that is defined as the sending address in the From: field of the email message. The format is account@domain. This field is required.
  • Page 242: Set Setup Callhome

    14 – Command Reference Set Setup Callhome Examples The following is an example of the Set Setup Callhome command: SANbox (admin) #> set setup callhome 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 243: Radius Service Settings

    14 – 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 244 14 – Command Reference Set Setup Radius Table 14-23. 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 245: Set Setup Radius

    14 – 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 246: Switch Services Settings

    14 – 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 14-24 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 247 14 – Command Reference Set Setup Services Table 14-24. 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 Interface, and SMI-S. The default is False. The SSL service requires the Fabric Security license key.
  • Page 248 14 – Command Reference Set Setup Services Table 14-24. 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 249: Snmp Configuration Settings

    14 – 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 14-25 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 250 14 – Command Reference Set Setup SNMP Table 14-25. 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 251: Set Setup Snmp

    14 – 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 252: System Configuration Settings

    14 – 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 14-26 describes the system configuration fields.
  • Page 253 14 – Command Reference Set Setup System Table 14-26. 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 254: Set Switch State

    14 – 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 255: Set Timezone

    14 – 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 256: Show About Display Entries

    14 – 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 Notes Table 14-27 describes the entries in the Show About command display. Table 14-27.
  • Page 257: Show About

    14 – Command Reference Show About Examples The following is an example of the Show About command: SANbox #> show about ***************************************************** Command Line Interface SHell (CLISH) ***************************************************** SystemDescription SANbox 5000 FC Switch EthNetworkAddress 10.20.11.192 (use 'set setup system' to update) EthMACAddress 00:c0:dd:00:71:ee WorldWideName...
  • Page 258: Show Alarm

    14 – 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 259: Show Broadcast

    14 – 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 260: Show Chassis

    14 – 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 261: Show Config Port

    14 – 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 262 14 – 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 263: Show Config Security

    14 – 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 264 14 – 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 265: Show Config Switch

    14 – 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 266: Show Config Threshold

    14 – 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 267: Show Config Zoning

    14 – 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 268: Show Domains

    14 – 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 269 14 – 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 270 14 – 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 271: Show Fdmi

    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 272: Show Interface

    14 – 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 273: Log Monitoring Components

    Chassis hardware components such as fans and power supplies Command line interface events Eport E_Port events Mgmtserver Management server events Nameserver Name server events Other Miscellaneous events Port Port events QLogic Fabric Service events. QFS governs Call Home email notification. SNMP SNMP events 59183-02 A 14-127...
  • Page 274 14 – Command Reference Show Log Table 14-28. Log Monitoring Components (Continued) Component Description Switch Switch management events Zoning Zoning conflict events 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.
  • Page 275 14 – Command Reference Show Log options Displays the options that are available for configuring event logging and automatic display to the screen. Refer to the “Set Log” command on page 14-86 information about how to configure event logging and display level. port Displays the ports being monitored for events.
  • Page 276: Show Log

    14 – Command Reference Show Log The following is an example of the Show Log command: SANbox #> show log [327][day month date time year][I][Eport Port:0/8][Eport State= E_A0_GET_DOMAIN_ID] [328][day month date time year][I][Eport Port: 0/8][FSPF PortUp state=0] [329][day month date time year][I][Eport Port: 0/8][Sending init hello] [330][day month date time year][I][Eport Port: 0/8][Processing EFP, oxid= 0x8] [331][day month date time year][I][Eport Port: 0/8][Eport State = E_A2_IDLE] [332][day month date time year][I][Eport Port: 0/8][EFP,WWN= 0x100000c0dd00b845,...
  • Page 277: Show Lsdb

    14 – 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 278: Transceiver Information

    14 – 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 279 14 – Command Reference Show Media Table 14-29. 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 280: Show Media

    14 – 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 281: Show Mem

    14 – 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 282 14 – 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 283 14 – 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 284: Show Pagebreak

    14 – 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 285: Show Perf

    14 – 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 286 14 – 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 287 14 – 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 288: Show Port Parameters

    14 – 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 289 14 – Command Reference Show Port Table 14-30. 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 290 14 – Command Reference Show Port Table 14-30. 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 291 14 – Command Reference Show Port Table 14-30. 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 292: Show Port

    14 – 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 293: Show Post Log

    14 – 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 294: Show Setup Callhome

    14 – Command Reference Show Setup Callhome Show Setup Callhome Displays the Call Home database configuration. Authority None Syntax show setup callhome Examples The following is an example of the Show Setup Callhome command: SANbox (admin) #> show setup callhome Callhome Information -------------------- PrimarySMTPServerAddr...
  • Page 295: 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 296: Show Setup Radius

    14 – 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 297: Show Setup Services

    14 – 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 298: Show Setup Snmp

    14 – 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 299: Show Setup System

    14 – 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 300: Show Steering

    14 – 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 301: Switch Operational Parameters

    14 – Command Reference Show Switch Show Switch Displays switch operational information. Authority None Syntax show switch Notes Table 14-31 describes the switch operational parameters. Table 14-31. Switch Operational Parameters Parameter Description SymbolicName Descriptive name for the switch SwitchWWN Switch world wide name BootVersion PROM boot version CreditPool...
  • Page 302 14 – Command Reference Show Switch Table 14-31. 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 303: Show Timezone

    14 – 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-02 A 14-157...
  • Page 304: Show Topology

    14 – 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 305 14 – 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 306: Show Users

    14 – 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 307: Show Version Display Entries

    14 – 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 Notes Table 14-32 describes the Show Version command display entries. Table 14-32.
  • Page 308: Show Version

    14 – Command Reference Show Version Examples The following is an example of the Show Version command. SANbox #> show version ***************************************************** Command Line Interface SHell (CLISH) ***************************************************** SystemDescription SANbox 5000 FC Switch EthNetworkAddress 10.20.11.192 (use 'set setup system' to update) EthMACAddress 00:c0:dd:00:71:ee WorldWideName...
  • Page 309 14 – Command Reference Shutdown Shutdown Terminates all data transfers on the switch at convenient points and closes the switch connection. 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. 59183-02 A 14-163...
  • Page 310: Test Cancel

    14 – 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 311: Test Port

    14 – 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 312: Port Test Parameters

    14 – Command Reference Test Port Notes Table 14-33 describes the port test parameters. Table 14-33. 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 313 14 – 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 314: Test Status

    14 – 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 315 14 – 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 316 14 – 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 317 14 – Command Reference User list Displays the list of users currently logged in and their session numbers. Provides the same function as the Show Users command. This keyword is available to all account names without an Admin session. 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.
  • Page 318 14 – Command Reference User The following is an example of the User Edit command: SANbox (admin) #> user edit Press 'q' and the ENTER key to abort this command. account name (1-15 chars) : user1 set account expiration in days (0-2000, 0=never): [0] should this account have admin authority? (y/n): [n] OK to modify user account 'user1' with no admin authority and to expire in 0 days?
  • Page 319 14 – 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 320 14 – Command Reference Zone Zone Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit session. Refer to the “Zoning Edit” command on page 14-185 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
  • Page 321 14 – 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. You must enter the Zoning Save command afterwards to save your changes.
  • Page 322 14 – 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_2 wwn_2215c3 zone_set_2 wwn_0160ed zone_set_3 The following is an example of the Zone Members command: SANbox #>...
  • Page 323 14 – 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 Edit” command on page 14-185 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session.
  • Page 324 14 – Command Reference Zoneset create [zone_set] Creates the zone set with the name given by [zone_set]. A zone set name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The zoning database supports a maximum of 256 zone sets.
  • Page 325 14 – Command Reference Zoneset Examples The following is an example of the Zoneset Active command: SANbox #> zoneset active Active ZoneSet Information -------------------------- ActiveZoneSet Bets LastActivatedBy admin@OB-session6 LastActivatedOn day month date time year The following is an example of the Zoneset List command: SANbox #>...
  • Page 326: Zoning Active

    14 – Command Reference Zoning Active Zoning Active Displays information for the active zone set or saves the active zone set to the non-volatile zoning database. Authority Admin session for the Capture keyword. Syntax zoning active capture Keywords capture Saves the active zone set to the non-volatile zoning data base. Examples The following is an example of the Zoning Active command: SANbox #>...
  • Page 327: Zoning Cancel

    14 – Command Reference Zoning Cancel Zoning Cancel Closes the current Zoning Edit session. Any unsaved changes are lost. Authority Admin session and a Zoning Edit session. Syntax zoning cancel Examples The following is an example of the Zoning Cancel command: SANbox #>...
  • Page 328: Zoning Clear

    14 – Command Reference Zoning Clear Zoning Clear Clears all inactive zone sets from the volatile edit copy of the zoning database. This keyword requires a zoning edit session. This keyword does not affect the non-volatile zoning database. However, if you enter the Zoning Clear command followed by the Zoning Save command, the non-volatile zoning database will be cleared from the switch.
  • Page 329: Zoning Configured

    14 – Command Reference Zoning Configured Zoning Configured Displays the contents of the non-volatile zoning database. Authority None Syntax zoning configured Examples The following is an example of the Zoning Configured command: SANbox #> zoning configured Configured (saved in NVRAM) Zoning Information ZoneSet Zone ZoneMember...
  • Page 330: Zoning Delete Orphans

    14 – Command Reference Zoning Delete Orphans Zoning Delete Orphans Deletes all objects that are not part of the active zone set including zone sets, zones, and aliases. Authority Admin session Syntax zoning delete orphans Examples The following is an example of the Zoning Delete Orphans command: SANbox #>...
  • Page 331: Zoning Edit

    14 – Command Reference Zoning Edit Zoning Edit Opens a Zoning Edit session for the non-volatile zoning database or the merged zone set in which to create and manage zone sets and zones. Refer to the “Zone” command on page 14-174 and the “Zoneset”...
  • Page 332: Zoning Edited

    14 – Command Reference Zoning Edited Zoning Edited Displays the contents of the edited zoning database. Authority Admin session and a Zoning Edit session Syntax zoning edited Examples The following is an example of the Zoning Edited command: SANbox #> zoning edited Edited (unsaved) Zoning Information ZoneSet Zone...
  • Page 333: Zoning History

    14 – Command Reference Zoning History Zoning 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 334: Zoning Database Limits

    14 – Command Reference Zoning Limits Zoning Limits Displays the limits and numbers of zone sets, zones, aliases, members per zone, members per alias, and total members in the zoning database. Authority None Syntax zoning limits brief Keywords brief Displays zoning limits for each category, the current number of objects, and the applicable zoning database (non-volatile or active).
  • Page 335: Zoning List

    14 – Command Reference Zoning List Zoning List Lists all zoning definitions including the applicable zoning database. Authority None Syntax zoning list Examples The following is an example of the Zoning List command: SANbox #> zoning list Active (enforced) ZoneSet Information ZoneSet Zone ZoneMember...
  • Page 336: Zoning Merged

    14 – Command Reference Zoning Merged Zoning Merged Displays the contents of the merged zone set, or saves the merged zone set to the non-volatile zoning database. Authority Admin session for the Capture keyword. Syntax zoning merged capture Keywords capture Saves the merged zone set to the non-volatile zoning database.
  • Page 337: Zoning Restore

    14 – Command Reference Zoning Restore Zoning Restore Restores the volatile zoning database with the contents of the non-volatile zoning database. If the MergeAutoSave parameter is False (see Table 14-10), you can use this command to revert changes to the merged zone set that were propagated from another switch in the fabric through zone set activation or merging fabrics.
  • Page 338: Zoning Save

    14 – Command Reference Zoning Save Zoning Save Saves changes made during the current Zoning Edit session. The system informs you that the zone set must be activated to implement any changes. This does not apply if you entered the Zoning Clear command during the Zoning Edit session.
  • Page 339 Index Alias command 14-5 Add example 7-21 account name Copy example 7-21 admin 2-2 Create example 7-20 display 14-170, 14-173 Delete example 7-20 factory 3-1 List example 7-7 maintenance mode 3-1 Members example 7-8 activation Remove example 7-21 firmware 5-20, 5-21 Rename example 7-20 security 9-9, 9-11 authentication 9-1, 10-1, 14-29...
  • Page 340 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Callhome command 14-7 configuration Changeover example 12-13 activate 5-11, 14-12 Clear example 12-13 backup 5-14, 14-12 Edit example 12-6 copy 5-12, 14-12 History example 12-7 delete 5-12, 14-12 List example 12-7 device security 9-1 List Profile example 12-8 display 5-11...
  • Page 341 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide defaults event log alarm configuration 14-58 clear 11-5 port configuration 14-57 configuration 11-1, 11-4 RADIUS configuration 14-60 configuration management 11-3 security configuration 14-62 display 11-2 services configuration 14-61 display configuration 11-4 SNMP configuration filter 11-3 switch configuration 14-55...
  • Page 342 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Fibre Channel group connection 4-5 add members 9-13, 14-28 routing 4-6 add to security set 9-11 file download and upload 2-8 copy 9-13, 14-30 File Transfer Protocol create 9-12, 14-30 download files 2-8, 5-15 delete 9-12 download firmware 5-21...
  • Page 343 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide logout errors 6-10 loop port initialization 14-42 I/O Stream Guard 14-74 loss-of-signal errors 6-10 Image command 14-39 Install example 5-20 informative event 11-1 internal test 6-12, 14-165 maintenance mode 3-1 Inter-Switch Link Management Server connection count 6-10...
  • Page 344 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide POST - See Power-On Self Test Power-On Self Test log 14-147 offline port test 6-13 preference routing 14-74 online port test 6-12 process identifier 5-3 operational information 5-2 processing time 5-3 orphan zones 7-7 profile output stream control 11-3...
  • Page 345 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Reset command 14-52 Security command 14-63 Callhome example 12-7, 12-13, 12-14 Activate example 9-9 Config example 7-10 Active example 9-4 Factory example 7-10 Clear example 9-9 Port example 6-9 Edit example 9-9 Security example 9-9 History example 9-6 SNMP example 13-5...
  • Page 346 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide security set Set Config Switch command 14-80 activate 9-11, 14-67 example 5-13 active 9-4 Set Config Threshold command 14-82 add group 9-11 example 6-11 add member group 14-67 Set Config Zoning command 14-84 configured 9-2 example 7-10 copy 9-11, 14-68...
  • Page 347 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Show Config Port command 14-115 Show Setup System command 14-153 example 6-2 example 4-3 Show Config Security command 14-117 Show Steering command 14-154 example 5-6 Show Switch command 14-155 port binding 6-8 Show Timezone command 14-157 Show Config Security Port command 14-118 Show Topology command 14-158...
  • Page 348 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide switch TFTP - See Trivial File Transfer Protocol administrative state 14-108 time configuration 5-1, 5-11, 14-80 between resets 5-4 configuration defaults 14-55 set and display 5-17, 14-18 configuration display 14-119 zone 5-17, 14-109, 14-157 configuration parameters 5-5, 5-13 timeout...
  • Page 349 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Zone command 14-174 Add example 7-18 Virtual Interface preference routing 14-74 Copy example 7-18 Create example 7-17 Delete example 7-18 Members example 7-7 Remove example 7-19 warning 11-1 Rename example 7-18 web applet Zonesets example 7-6 enable 14-107...
  • Page 350 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Zoneset command 14-177 Zoning Delete Orphans command 14-184 Activate example 7-17 Zoning Edit command 14-185 Active example 7-4 example 7-12 Add example 7-16 Zoning Edited command 14-186 Copy example 7-16 Zoning History command 14-187 Create example 7-15 example 7-8...

Table of Contents