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.
Table of Contents Introduction Intended Audience ..........Related Materials .
Page 4
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Displaying IP Security Information......Policy and Association Information.
Page 5
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Backing Up and Restoring a Switch Configuration ....5-14 Creating the Backup File ......5-15 Downloading the Configuration File .
Page 6
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Display Port Test Results........6-15 Cancel a Port Test .
Page 7
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Copy an Alias ......... . . 7-20 Add Members to an Alias .
Page 8
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Event Log Configuration Starting and Stopping Event Logging ......11-2 Displaying the Event Log .
Page 9
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Create an SNMP Version 3 User Account..... . 13-7 Display SNMP Version 3 User Accounts ..... . . 13-7 Modify an SNMP Version 3 User Account .
Page 10
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Securityset..........14-81 Set Alarm.
Page 11
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Show Pagebreak ......... 14-162 Show Perf .
Introduction This guide describes the features and use of the command line interface for SANbox 5802V switches running firmware version 7.4. 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. Section 2 describes logging on and off of a switch, opening and closing an Admin session, entering commands, getting help, paging a switch, setting...
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. 59263-01 A...
1 – Introduction Technical Support Contact Information Support Headquarters QLogic Corporation 4601 Dean Lakes Boulevard Shakopee, MN 55379 QLogic Web Site www.qlogic.com Technical Support Web Site support.qlogic.com Technical Support Email support@qlogic.com Technical Training Email tech.training@qlogic.com North American Region Email support@qlogic.com...
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.
2 – Command Line Interface Usage Logging In to the Switch Logging In to the Switch To log in to a switch through Telnet, do the following: Open a command line window on the workstation and enter the Telnet command followed by the switch IP address. The IP address can be one of the following: 4-byte IP version 4 address 16-byte IP version 6 address...
2 – Command Line Interface Usage Opening and Closing an Admin Session NOTE: A switch supports a combined maximum of 19 logins or sessions, which are reserved as follows. Additional logins will be refused. 4 logins or sessions for internal applications such as management server and SNMP 9 high priority Telnet sessions 6 logins or sessions for Enterprise Fabric Suite 2007, QuickTools,...
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.
2 – Command Line Interface Usage Setting Page Breaks Setting Page Breaks Some display commands deliver so much information to the screen that it scrolls by too quickly to read it. You can limit the display to 20 lines by turning on page breaks.
2 – Command Line Interface Usage Creating a Support File Creating a Support File If you contact technical support about a problem with your switch, they may request that you create and send a support file. This support file contains all of the switch configuration information, which can be helpful in diagnosing the problem.
2 – Command Line Interface Usage Downloading and Uploading Files If your workstation does not have an FTP server, enter the Create Support command to create the support file, and then use FTP to download the support file from the switch to your workstation, as shown in the following example: SANbox #>...
Page 26
2 – Command Line Interface Usage Downloading and Uploading Files Set binary mode and use the Get command to download the file (configdata). ftp>bin ftp>get configdata xxxxx bytes sent in xx secs. ftp>quit 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.
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.
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).
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;...
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.
Network Configuration Network configuration consists of the IP parameters that identify the switch in the network and provide for IP security. This section describes the following network configuration tasks: Displaying the Network Configuration Configuring the Ethernet Port Verifying a Switch in the Network Managing IP Security Displaying the Network Configuration Show Fabric...
4 – Network Configuration Configuring the Ethernet Port Show Setup System command displays the entire switch network configuration, which includes the following: IP configurations (versions 4 and 6) DNS server configuration To display specific information, add the corresponding keyword. For example, to display IP version 6 configuration information, enter the Show Setup System Ipv6 command: SANbox #>...
Page 33
4 – Network Configuration Configuring the Ethernet Port To configure the IP version 4 parameters, enter the Set Setup System Ipv4 command: SANbox (admin) #> set setup system ipv4 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.
4 – Network Configuration Configuring the Ethernet Port IP Version 6 Configuration The switch supports IP version 6, which includes the following: Network discovery method IP address IP gateway address The network discovery method determines how the switch acquires its IP address. The IP address can come from the IP address (static) that resides on the switch, from a DHCP server, or it can be learned from a router through the Neighbor Discovery Protocol (NDP).
4 – Network Configuration Configuring the Ethernet Port DNS Server Configuration A DNS server manages the host names for a fabric. This enables you to specify servers and switches by a meaningful name rather than IP address. To configure a DNS server, enter the Set Setup System Dns command in an Admin session as shown in the following example:...
4 – Network 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.
4 – Network Configuration Managing IP Security To remove all IP security policies and associations, enter the Reset Ipsec command. SANbox (admin) #> reset ipsec The following subsections present IP security concepts and management tasks: IP Security Concepts Displaying IP Security Information Managing the Security Policy Database Managing the Security Association Database Resetting the IP Security Configuration...
4 – Network Configuration Managing IP Security A security association defines the encryption algorithm and encryption key to apply when called by a security policy. A security policy may call several associations at different times, but each association is related to only one policy. The security association database is the set of all security associations.
4 – Network Configuration Managing IP Security The following example displays all active policies and associations: SANbox #> ipsec list Active IPsec Information Security Association Database ----------------------------- h2h-sh-sa h2h-hs-sa Security Policy Database ------------------------ h2h-hs-sp h2h-sh-sp Summary ------- Security Association Count: Security Policy Count: IP Security Configuration History To display the IP Security configuration history, enter the...
4 – Network Configuration Managing IP Security IP Security Configuration Limits To display a summary of the objects in the IP Security configuration and their maximum limit, enter the Ipsec Limits command to as shown in the following example: SANbox #> ipsec limits Configured (saved) IPsec Information IPsec Attribute Maximum...
4 – Network Configuration Managing IP Security Creating a Policy To create a policy, enter the Ipsec Policy Create command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy create h2h-sh-sp A list of attributes with formatting will follow.
4 – Network Configuration Managing IP Security Deleting a Policy To delete a user-defined policy, enter the Ipsec Policy Delete command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy delete policy_1 The security policy will be deleted.
4 – Network Configuration Managing IP Security Modifying a User-Defined Policy To modify an existing user-defined policy, enter the Ipsec Policy Edit command in an Admin session and an Ipsec Edit session as shown in the following example. An asterisk (*) indicates a required entry. SANbox (admin-ipsec) #>...
4 – Network Configuration Managing IP Security Renaming a User-Defined Policy To rename a policy (policy_1), enter the Ipsec Policy Rename command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy rename policy_1 policy_4 The security policy will be renamed.
4 – Network Configuration Managing IP Security Creating an Association To create an association, enter the Ipsec Association Create command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec association create h2h-sh-sa A list of attributes with formatting will follow.
4 – Network Configuration Managing IP Security Deleting an Association To delete a user-defined association, enter the Ipsec Association Delete command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec association delete association_1 The security association will be deleted.
4 – Network Configuration Managing IP Security Modifying a User-Defined Association To modify an existing user-defined association, enter the Ipsec Association Edit command in an Admin session and an Ipsec Edit session as shown in the following example. An asterisk (*) indicates a required entry. SANbox (admin-ipsec) #>...
4 – Network Configuration Managing IP Security Renaming a User-Defined Association To rename a user-defined association (associaton_1), enter the Ipsec Association Rename command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec association rename association_1 association_4 The security association will be renamed.
Page 49
4 – Network Configuration Managing IP Security Reset Ipsec command deletes all polices and associations from the switch, but does not require an Ipsec Edit session. SANbox #> admin start SANbox (admin) #> reset ipsec The IPsec configuration will be reset and the default values activated. Please confirm (y/n): [n] y Reset and activation in progress ..
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 Testing a Switch Verifying and Tracing Fibre Channel Connections Managing Switch Feature Upgrades Managing Idle Session Timers Displaying Switch Information...
5 – Switch Configuration Displaying Switch Information 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 --- ------ ------ ---- --- ------- ------- No entries found for domain ID 1.
5 – Switch Configuration Displaying Switch Information 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 #>...
5 – Switch Configuration Displaying Switch Information 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 %MEM TIME ELAPSED COMMAND 0.3 00:00:04 2-03:02:31 cns...
5 – Switch Configuration Displaying Switch Information 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.
5 – Switch Configuration Displaying Switch Information Switch Configuration Parameters Enter the Show Config Switch command to display the switch configuration parameters. These parameters determine the operational characteristics of the switch. Refer to Table 14-22 for a description these parameters. SANbox #>...
5 – Switch Configuration Displaying Switch Information Security Configuration Parameters Enter the Show Config Security command to display security configuration and port binding parameters. These parameters determine how security is applied to the switch. Refer to Table 14-20 for a description of the switch security configuration parameters.
5 – Switch Configuration Displaying Switch Information 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. SANbox #> show chassis Chassis Information ------------------- BoardTemp (1) - Degrees Celsius FanStatus (1) Good FanStatus (2)
5 – Switch Configuration Displaying Switch Information 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)
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 61
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.
5 – Switch Configuration Managing Switch Configurations Managing Switch Configurations The switch configuration determines the basic operational characteristics of the switch. A switch can save up to 10 configurations including the default configuration, named Default Config. The current switch operating characteristics are determined by the active configuration.
5 – Switch Configuration Managing Switch Configurations Deleting a Switch Configuration Enter the Config Delete command in an Admin session to delete a configuration from the switch as shown in the following example. You cannot delete the active configuration nor the default configuration (Default Config). SANbox (admin) config delete config_2 Modifying a Switch Configuration To modify a switch configuration, you must open an Admin session with the...
5 – Switch Configuration Managing Switch Configurations The following is an example of the Set Config Switch command. Refer to Table 14-22 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.
5 – Switch Configuration Managing Switch Configurations Creating the Backup File Config Backup command creates a file on the switch, named configdata. This file can be used to restore a switch configuration only from the command line interface; it cannot be used to restore a switch using Enterprise Fabric Suite 2007. SANbox #>...
5 – Switch Configuration Managing Switch Configurations 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.
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.
5 – Switch Configuration Setting the Date and Time Setting the Date and Time Explicitly To set the switch date and time explicitly, use the Set Timezone Date commands. To change the time zone (to America/North Dakota, for example), enter the Set Timezone command in an Admin session, as shown in the following example: SANbox #>...
5 – Switch Configuration Setting the Date and Time Setting the Date and Time through NTP An NTP server can automatically set the switch date and time. To configure the switch to use an NTP server, enter the Set Setup System Ntp command in an Admin session to enable the NTP client on the switch and specify the NPT server IP address, as shown in the following example:...
Performs 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.
5 – Switch Configuration Installing Firmware Non-disruptive Activation You can load and activate firmware upgrades on an operating switch without disrupting data traffic or having to re-initialize attached devices. If the non-disruptive activation fails, you will usually be prompted to try again later. Otherwise, the switch will perform a disruptive activation.
5 – Switch Configuration Installing Firmware One-Step Firmware Installation Firmware Install Image Install commands download the firmware image file from an FTP or TFTP server to the switch, unpacks the image file, and performs a disruptive activation in one step. The one-step installation process prompts you to enter the following: The file transfer protocol (FTP or TFTP) IP address of the remote host...
Page 73
5 – Switch Configuration Installing Firmware When prompted to install the new firmware, enter Yes to continue or No to cancel. Entering Yes will disrupt traffic. This is the last opportunity to cancel. About to install image. Do you want to continue? [y/n] y Connected to 10.20.20.200 (10.20.20.200).
5 – Switch Configuration Installing Firmware 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...
5 – Switch Configuration Testing a Switch 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 Testing a Switch You can test all ports on a switch using the Test Switch command.
5 – Switch Configuration Testing a Switch Offline Tests for Switches An offline test is a disruptive test that exercises all port connections for a switch in the diagnostics state. You must place the switch in the diagnostics state using the Set Switch State command before starting the test.
5 – Switch Configuration Testing a Switch Connectivity Tests for Switches A connectivity test is a disruptive test that exercises all port and inter-port connections for a switch in the diagnostics state. You must place the switch in the diagnostics state using the Set Switch State command before starting the test.
5 – Switch Configuration Verifying and Tracing Fibre Channel Connections Displaying Switch Test Status You can display the test status while the test is in progress by entering the Test Status Switch command as shown in the following example: SANbox (admin) #> test status switch Blade Test Test...
5 – Switch Configuration Managing Switch Feature Upgrades 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#> fctrace 970400 970e00 hops 5 36 bytes from 0x970400 to 0x970e00, 5 hops max Domain Ingress Port WWN...
5 – Switch Configuration Managing Idle Session Timers Displaying Feature Licenses Enter the Feature Log command to display the license keys that are installed on your switch as shown in the following example: SANbox #> feature log Mfg Feature Log: ---------------- Switch Licensed for 8 ports Customer Feature Log:...
Page 81
5 – Switch Configuration Managing Idle Session Timers Enter the Set Setup System Timers command to configure idle login and Admin session limits as shown in the following example: SANbox (admin) #> set setup system timers 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.
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...
6 – Port Configuration Displaying Port Information 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-19 for a description of these parameters. SANbox #>...
6 – Port Configuration Displaying Port Information 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 3a0100 ConfigType PortWWN 20:01:00:c0:dd:0d:4f:08 POSTFaultCode...
6 – Port Configuration Displaying Port Information 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-23 for a description of these parameters.
6 – Port Configuration Displaying Port Information 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.
6 – Port Configuration Modifying Port Operating Characteristics 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 89
6 – Port Configuration Modifying Port Operating Characteristics The following example permanently changes the port 1 administrative state: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config port 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value.
Page 90
6 – Port Configuration Modifying Port Operating Characteristics You can configure all ports based a specified source port using the Set Config Ports command. The following example configures ports 0–23 based on port 3. SANbox #> admin start SANbox (admin) config edit SANbox (admin) #>...
6 – Port Configuration Port Binding Port Binding Port binding establishes up to 32 switches or devices that are permitted to log in to a particular switch port. Switches or devices that are not among the 32 are refused access to the port. Enter the Show Config Security Portbinding command to display the port binding configuration for all ports as shown in the following...
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.
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 94
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.
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...
6 – Port Configuration Testing a Port 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. There are two types of offline test: internal loopback and external loopback.
6 – Port Configuration Testing a Port Display Port Test Results You can display the test status while the test is in progress by entering the Test Status Port command in an Admin session as shown in the following example: SANbox (admin) #>...
Page 98
6 – Port Configuration Testing a Port Notes 6-16 59263-01 A...
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. Access is controlled by the use of zoning.
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 101
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 #>...
7 – Zoning Configuration Displaying Zoning Database Information 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 #>...
7 – Zoning Configuration Displaying Zoning Database Information 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.
7 – Zoning Configuration Displaying Zoning Database Information 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 #>...
7 – Zoning Configuration Displaying Zoning Database Information 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...
7 – Zoning Configuration Displaying Zoning Database Information Zoning Modification History Enter the Zoning History command to display a record of zoning modifications as shown in the following example: SANbox #> zoning history Active Database Information --------------------------- ZoneSetLastActivated/DeactivatedBy Remote ZoneSetLastActivated/DeactivatedOn day mon date hh:mm:ss yyyy Database Checksum 00000000...
7 – Zoning Configuration Displaying Zoning Database Information 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...
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 109
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.
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.
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) #>...
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) #>...
7 – Zoning Configuration Managing Zone Sets Delete a Zone Set Enter the Zoneset Delete command to delete a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset delete zoneset_1 SANbox (admin-zoning) #>zoning save Rename a Zone Set Enter the...
7 – Zoning Configuration Managing Zones Remove Zones from a Zone Set Enter the Zoneset Remove command to remove zones from a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset remove zoneset_1 zone_1 zone_2 SANbox (admin-zoning) #>zoning save Activate a Zone Set Enter the...
7 – Zoning Configuration Managing Zones Create a Zone Enter the Zone Create command to create a new zone as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone create zone_1 SANbox (admin-zoning) #>...
7 – Zoning Configuration Managing Zones Add Members to a Zone Enter the Zone Add command to add ports/devices to zone_1 as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone add zone_1 alias_1 1,4 1,5 SANbox (admin-zoning) #>...
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. Create an Alias Enter the Alias...
7 – Zoning Configuration Managing Aliases 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) #>...
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 applications.
8 – Connection Security Configuration Managing SSL and SSH Services Managing SSL and SSH Services Consider the following when enabling SSH and SSL services: To establish a secure Telnet connection, your workstation must use an SSH client. To enable secure SSL connections, you must first synchronize the date and time on the switch and workstation.
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...
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 Managing Groups...
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 Configured Security Set Information Securityset...
Page 125
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...
9 – Device Security Configuration Displaying Security Database Information 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 #>...
9 – Device Security Configuration Displaying Security Database Information 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 #>...
9 – Device Security Configuration Displaying Security Database Information 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 SecuritySetLastActivated/DeactivatedOn...
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 130
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 the CLI, QuickTools, or Enterprise Fabric Suite 2007.
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 the CLI, QuickTools, or Enterprise Fabric Suite 2007.
9 – Device Security Configuration Resetting the Security Database Resetting the Security Database There are two ways to remove all groups and security sets from the security database: Enter the Security Clear command as shown in the following example: SANbox (admin-security) #> security clear All security information will be cleared.
9 – Device Security Configuration Managing Security Sets Rename a Security Set Enter the Securityset Rename command to rename a security set as shown in the following example: SANbox (admin-security) #> securityset rename securityset_old securityset_new 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:...
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.
9 – Device Security Configuration Managing Groups Add Members to a Group Adding a member to a group involves specifying a group, the member worldwide name, and the member attributes. The member attributes define the authentication method, encryption method, secrets, and fabric binding, depending on the group type.
9 – Device Security Configuration Managing Groups 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-2.
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.
10 – RADIUS Server Configuration Displaying RADIUS Server Information 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-26 for a description of the RADIUS configuration parameters. SANbox #>...
10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch Configuring a RADIUS Server on the Switch Enter the Set Setup Radius command to configure a RADIUS server on the switch. There are two groups of RADIUS configuration parameters. One group of parameters is common to all RADIUS server configurations.
Page 140
10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch The following example configures RADIUS server 1: SANbox (admin) #> set setup radius server 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. 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.
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.
11 – Event Log Configuration Starting and Stopping Event Logging Starting and Stopping Event Logging Enter the Set Log Stop command in an Admin session to stop recording event messages in the switch Log as shown in the following example: SANbox (admin) #>...
11 – Event Log Configuration Displaying the Event 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]...
11 – Event Log Configuration Managing the Event Log Configuration Controlling Messages in the Output Stream Enter the Set Log Display command in an Admin session to specify the severity level filter to use to determine what messages are automatically displayed on the screen when they occur.
11 – Event Log Configuration Clearing the Event Log Display the Event Log Configuration Enter the Show Log Settings command to display all event log configuration settings as shown in the following example: SANbox #> show log settings Current settings for log ------------------------ Started True...
11 – Event Log Configuration Logging to a Remote Host Logging to a Remote Host The switch comes from the factory with local logging enabled, which instructs the switch firmware to maintain an event log in switch memory. The switch can also be configured to log events to a remote host that supports the syslog protocol.
11 – Event Log Configuration Creating and Downloading a Log File Creating and Downloading a Log File Enter the Set Log Archive command to collect the event log messages in a file on the switch named logfile. This file can have a maximum of 1200 event messages. Use FTP to download the file from the switch to your workstation as follows: Log into the switch through Telnet and create an archive of the event log.
Page 148
11 – Event Log Configuration Creating and Downloading a Log File Notes 11-8 59263-01 A...
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 Call Home Concepts The Call Home service improves fabric availability by notifying administrators by email of events that affect switch operation.
12 – Call Home Configuration Call Home Concepts 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.
Call Home profile and SNMP configurations. The short-text and Tsc1 formats contains basic switch and event information; Tsc1 is formatted for automated parsing. 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...
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...
12 – Call Home Configuration Configuring the Call Home Service Configuring the Call Home Service Enter the Set Setup Callhome command in an Admin session to configure the Call Home service as shown in the following example. Refer to Table 14-25 for a description of the Call Home service configuration entries.
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 #> show setup callhome Callhome Information -------------------- PrimarySMTPServerAddr 0.0.0.0 PrimarySMTPServerPort PrimarySMTPServerEnabled False SecondarySMTPServerAddr...
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 156
12 – Call Home Configuration Managing the Call Home Database Enter the Callhome List command to display a list of Call Home profiles as shown in the following example: SANbox #> callhome list Configured Profiles: -------------------- group4 group5 Enter the Callhome List Profile command to display a list of Call Home profiles and their details as shown in the following example:...
12 – Call Home Configuration Managing the Call Home Database Creating 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) #> profile create profile_1 A list of attributes with formatting and default values will follow.
12 – Call Home Configuration Managing the Call Home Database Deleting 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) #> profile delete profile_1 The profile will be deleted.
12 – Call Home Configuration Managing the Call Home Database Modifying 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) #>...
12 – Call Home Configuration Managing the Call Home Database Renaming 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.
12 – Call Home Configuration Managing the Call Home Database Adding a Data Capture Configuration Enter the Capture Add command to add a data capture configuration to the Tech_Support_Center profile as shown in the following example. If the Tech_Support_Center profile does not exist, you must create it using the Profile Create command.
12 – Call Home Configuration Managing the Call Home Database Modifying a Data Capture Configuration Enter the Capture Edit command to modify a data capture configuration in the Tech_Support_Center profile as shown in the following example: SANbox #> admin start SANbox (admin) #>...
12 – Call Home Configuration Testing a Call Home Profile Deleting a Data Capture Configuration Enter the Capture Remove command to delete a data capture configuration from the Tech_Support_Center profile as shown in the following example: SANbox #> admin start SANbox (admin) #>...
12 – Call Home Configuration Changing SMTP Servers 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 165
12 – Call Home Configuration Resetting the Call Home Database Enter the Reset Callhome command to clear all Call Home profiles and resets the Tech_Support_Center profile and Call Home service configuration to the factory defaults as shown in the following example: SANbox #>...
Page 166
12 – Call Home Configuration Resetting the Call Home Database Notes 12-18 59263-01 A...
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 Managing the SNMP Version 3 Configuration The Simple Network Management Protocol (SNMP) provides for the management of the switch through third-party applications that use SNMP.
13 – Simple Network Management Protocol Configuration Managing the SNMP Service Managing the SNMP Service You control the SNMP service SNMPEnabled parameters through the Set Setup SNMP Set Setup Services commands. Refer to “Modifying the SNMP Configuration” on page 13-4 for more information.
13 – Simple Network Management Protocol Configuration Displaying SNMP Information Displaying SNMP Information Enter the Show Setup Snmp command to displays common and trap-specific SNMP configuration information as shown in the following example. Refer to Table 14-30 for a description of the SNMP parameters. SANbox #>...
13 – Simple Network Management Protocol Configuration Modifying the SNMP Configuration Modifying the SNMP Configuration Enter the Set Setup SNMP command in an Admin session to configure SNMP on the switch. There are two groups of configuration parameters. One group is common to all traps.
13 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration The following example configures SNMP trap 1: SANbox (admin) #> set setup snmp trap 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. 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.
13 – Simple Network Management Protocol Configuration Managing the SNMP Version 3 Configuration Managing the SNMP Version 3 Configuration SNMP version 3 is an interoperable standards-based protocol for network management. SNMP version 3 provides secure access to devices by a combination of packet authentication and encryption over the network.
13 – Simple Network Management Protocol Configuration Managing the SNMP Version 3 Configuration Create an SNMP Version 3 User Account To create an SNMP version 3 user account, enter the Snmpv3user Add command as shown in the following example: SANbox #> admin start SANbox (admin) #>...
13 – Simple Network Management Protocol Configuration Managing the SNMP Version 3 Configuration Modify an SNMP Version 3 User Account To modify an SNMP version 3 user account, enter the Snmpv3user Edit command as shown in the following example: SANbox #> admin start SANbox (admin) #>...
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 Access Authority The Authority paragraph in each command description indicates what types of sessions are required to enter that command.
14 – Command Reference Syntax and Keywords Commands that modify the Internet Protocol Security configuration require an Ipsec Edit session, which is opened by the Ipsec Edit command. These commands include the Ipsec, Ipsec Association Ipsec Policy commands. Syntax and Keywords The Syntax paragraph defines the command syntax using the following convention: command...
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.
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 179
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.
14 – Command Reference Callhome Callhome Manages the Call Home database. The Callhome Edit command opens a 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.
Page 181
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 182
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 183
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...
14 – Command Reference Capture Capture Manages the data capture configuration for the Tech_Support_Center Call Home profile. The data capture configuration determines the time and frequency by which status and trend data is collected from the switch and sent to recipients specified in the Tech_Support_Center profile.
Page 185
14 – Command Reference Capture Examples The following is an example of the Capture Add command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> capture add A list of attributes with formatting and default values will follow. Enter a value or simply press the ENTER key to accept the default value.
Page 186
14 – Command Reference Capture The following is an example of the Capture Remove command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> capture remove Capture Entries for Profile: Tech_Support_Center Index TimeOfDay DayOfWeek Interval ----- --------- --------- -------- 02:00...
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-95. Authority Admin session for all keywords except Backup and List Syntax config activate [config_name]...
Page 188
14 – Command Reference Config delete [config_name] Deletes the configuration given by [config_name] from the switch. You cannot delete the default configuration (Default Config) nor the active configuration. 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.
Page 189
14 – Command Reference Config NOTE: If the restore process changes the IP address, use the Set Setup System command to return the IP configuration to the values you want. If the IP address is unknown, you must place the switch in maintenance mode and reset the network configuration to restore the default IP address 10.0.0.1.
Page 190
14 – Command Reference Config The following is an example of how to create a backup file (configdata) and download the file to the workstation. SANbox #> config backup SANbox #> exit #>ftp symbolic_name or ip_address user: images password: images ftp>...
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 192
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 IPv4, IPv6 Address or hostname of remote computer: 10.20.33.130 Login name: johndoe...
Page 193
14 – Command Reference Create The following is an example of the Create Support command to download the support file to your workstation. When prompted to send the support file to another machine, you decline, close the Telnet session, and open an FTP session on the switch and log in with the account name images and password images.
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]...
14 – Command Reference Exit Exit Closes the Telnet session. Authority None Syntax exit Notes You can also press Control-D to close the Telnet session. 59263-01 A 14-21...
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.
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 198
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 ------ ---------------- ---- ---------------...
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 200
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 24 ports 1-LCVXOWUNOJBE6 14-26 59263-01 A...
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 or DNS host name of the remote host An account name and password on the remote host (FTP only) Pathname for the firmware image file...
Page 202
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.
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 204
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-2, Table 14-3, and Table 14-4...
Page 205
14 – Command Reference Group Table 14-3. 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 206
14 – Command Reference Group Table 14-4. 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 207
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-5.
Page 208
14 – Command Reference Group Table 14-5. 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 209
14 – Command Reference Group Examples The following is an example of the Group Add command: SANbox #> admin start SANbox (admin) #> security edit SANbox (admin-security) #> group add Group_1 A list of attributes with formatting and default values will follow Enter a new value or simply press the ENTER key to accept the current value with exception of the Group Member WWN field which is mandatory.
Page 210
14 – Command Reference Group The following is an example of the Group List command: SANbox #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Group Members command: SANbox #> group members group_1 Current list of members for Group: group_1 ---------------------------------- 10:00:00:c0:dd:00:71:ed...
14 – Command Reference Hardreset Hardreset Resets the switch and performs a power-on self test (POST). 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”...
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.
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].
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.
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 216
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 217
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 7.4.00.11_epc >ftp 10.0.0.254 user:johndoe password: ******** ftp>bin ftp>put 7.4.00.11_epc ftp>quit SANbox (admin) $>image list SANbox (admin) $>image unpack 7.4.00.11_epc Image unpack command result: Passed 59263-01 A 14-43...
14 – Command Reference Ipsec Ipsec Manages the IP Security database. The IP Security database consists of the Security Association database and the Security Policy database. The Ipsec Edit command opens a session in which to create and manage associations and policies.
Page 219
14 – Command Reference Ipsec Checksums for the active and inactive IP security databases limits Displays the maximum and current numbers of configured associations and policies. This keyword does not require an Admin session nor an Ipsec Edit session. However, in an Ipsec Edit session, this command displays the number of both configured associations and policies, plus those created in the edit session but not yet saved.
14 – Command Reference Ipsec Association Ipsec Association Creates and manages associations in the Security Association database. Authority Admin session and an Ipsec Edit session Syntax ipsec association copy [association_source] [association_destination] create [association] delete [association] edit [association] list [association] rename [association_old] [association_new] Keywords copy [association_source] [association_destination] Creates a new association named [association_destination] and copies the...
Page 221
14 – Command Reference Ipsec Association Table 14-6. Association Configuration Parameters Parameter Description Protocol IP security protocol to be used to process data. The protocol can be one of the following: Encapsulated Security Payload–RFC 2406 (esp) Encapsulated Security Payload–RFC 1827 (esp-old) Authentication Header–...
Page 222
14 – Command Reference Ipsec Association list [option] Displays the configuration for the policies given by [option]. If you omit [option], the command displays the configuration of all active associations. [option] can be one of the following: [association] Displays the configuration for the association given by [association]. active Displays the configuration for all active associations.
Page 223
14 – Command Reference Ipsec Association Examples The following is an example of the Ipsec Association Create command: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec association create h2h-sh-sa A list of attributes with formatting will follow. Enter a value or simply press the ENTER key to skip specifying a value.
14 – Command Reference Ipsec List Ipsec List Displays information about IP security associations and policies. Authority None Syntax ipsec list active association [option] configured edited policy [option] Keywords active Displays a summary of active associations and policies. This is the default. association [option] Displays the configuration for the associations given by [option].
Page 225
14 – Command Reference Ipsec List policy [option] Displays the configuration for the policies given by [option]. If you omit [option], the command displays the configuration of all active policies. [option] can be one of the following: [policy] Displays the configuration for the policy given by [policy]. active Displays the configuration for all active policies.
Page 226
14 – Command Reference Ipsec List The following is an example of the Ipsec List Association command: SANbox #> ipsec list association Active IPsec Information h2h-sh-sa Description: Host-to-host: switch->host Source: fe80::2c0:ddff:fe03:d4c1 Destination: fe80::250:daff:feb7:9d02 Protocol: esp SPI: 333 (0x14d) Authentication: hmac-sha1 ******** Encryption: 3des-cbc ********...
14 – Command Reference Ipsec Policy Ipsec Policy Manages policies in the Security Policy database. Authority Admin session and an Ipsec Edit session Syntax ipsec policy copy [policy_source] [policy_destination] create [policy] delete [policy] edit [policy] list [option] rename [policy_old] [policy_new] Keywords copy [policy_source] [policy_destination] Creates a new policy named [policy_destination] and copies the configuration into...
Page 228
14 – Command Reference Ipsec Policy Table 14-7. Policy Configuration Parameters Parameter Description Protocol Protocol or application to which to apply IP security. Enter a key- word for one of the following protocols or an integer (0-255): Internet Control Message Protocol for IP version 4 (ICMP) Internet Control Message Protocol for IP version 6 (ICMP6) Internet Protocol, version 4 (IPv4) Transmission Control Protocol (TCP)
Page 229
14 – Command Reference Ipsec Policy Table 14-7. Policy Configuration Parameters Parameter Description espRuleLevel Rule level to apply for ESP protection: Default–use the system wide default for the protocol Use–use a security association if one is available Require–a security association is required whenever a packet is sent that is matched with the policy delete [policy] Deletes the policy given by [policy] from the Security Policy database.
Page 230
14 – Command Reference Ipsec Policy Examples The following is an example of the Ipsec Policy Create command: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy create h2h-sh-sp A list of attributes with formatting will follow. Enter a value or simply press the ENTER key to skip specifying a value.
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) #>...
14 – Command Reference Logout Logout Closes the Telnet session. Authority None Syntax logout Notes You can also press Control-D to close the Telnet session. 14-58 59263-01 A...
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.
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 [host_name] -ipv4 [host_address] -ipv6 [host_address] Keywords [host_name] DNS host name of the switch you want to query. [host_name] is a character string of 2–125 characters made up of one or more subdomains delimited by periods (.).
14 – Command Reference Profile Profile Creates and modifies profiles with which to customize Call Home e-mail notification. A profile defines the event severity level at which to generate e-mails, e-mail subject and text, and e-mail recipients. Authority Admin session and a Callhome Edit session. Refer to the “Callhome”...
Page 236
14 – Command Reference Profile Table 14-8. Profile Configuration Parameters (Continued) Parameter Description Format Level of detail to be included in the e-mail message: ShortText–includes switch and event information. FullText–includes switch information, event information, Call Home contact information, and SNMP contact information. Tsc1–includes switch and event information in a format intended for automated e-mail readers.
Page 237
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 238
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 239
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 %MEM TIME ELAPSED COMMAND 0.3 00:00:04 2-03:02:31 cns 0.3 00:00:06 2-03:02:31 ens 0.3 00:00:09 2-03:02:31 dlog 0.6 00:00:33 2-03:02:31 ds...
14 – Command Reference Quit Quit Closes the Telnet session. Authority None Syntax quit Notes You can also press Control-D to close the Telnet session. 14-66 59263-01 A...
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 ipsec port [port_list] radius security services snmp switch (default) system zoning Keywords callhome...
Page 242
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-10 through...
Page 243
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 244
14 – Command Reference Reset Notes The following tables specify the various factory default settings: Table 14-9 shows the Call Home service configuration defaults. Enter the Show Setup Callhome command to display the Call Home service configuration values. Table 14-10 shows the switch configuration default values.
Page 246
14 – Command Reference Reset Table 14-11. Port Configuration Defaults Parameter SFP Port Defaults XPAK 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 number ALFairness...
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 252
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 253
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 254
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)
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 256
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 257
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 #>...
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.
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.
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 261
14 – Command Reference Set Config Port Table 14-19. Port Configuration Parameters (Continued) Parameter Description LinkSpeed Transmission speed: SFP Ports: 1-Gbps, 2 Gbps, 4-Gbps, 8-Gbps, or Auto. The default is Auto. 8-Gbps SFPs do not support the 1-Gbps setting. Settting a port to 1-Gbps that has an 8-Gbps SFP will down the port.
Page 262
14 – Command Reference Set Config Port Table 14-19. Port Configuration Parameters (Continued) Parameter Description FANEnable Fabric address notification. Enables (True) or disables (False) the communication of the FL_Port address, port name, and node name to the logged-in NL_Port. The default is True.
Page 263
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 264
14 – Command Reference Set Config Port Examples The following is an example of the Set Config Port command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config port 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value.
Page 265
14 – Command Reference Set Config Port The following is an example of the Set Config Port command for an XPAK port: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config port 20 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.
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 267
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.
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].
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 270
14 – Command Reference Set Config Switch Table 14-22. 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.
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 272
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.
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 274
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.
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 276
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 e-mail notification. SNMP Monitors all SNMP events. Switch Monitors switch management events.
Page 277
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 278
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.
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 280
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 ...
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 282
14 – Command Reference Set Port Auto The port speed is automatically detected. 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.
14 – Command Reference Set Setup Callhome Set Setup Callhome Configures the Call Home database for managing e-mail 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-26 describes the Call Home configuration fields.
Page 284
14 – Command Reference Set Setup Callhome Table 14-25. Call Home Service Configuration Settings Entry Description FromEmailAddress E-mail address that is defined as the sending address in the From: field of the e-mail message. The format is account@domain. This field is required.
Page 285
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.
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 287
14 – Command Reference Set Setup Radius Table 14-26. Common RADIUS Configuration Parameters (Continued) Parameter Description TotalServers Number of RADIUS servers to configure during this session. Set- ting TotalServers to 0 disables all RADIUS authentication. The default is 0. server [server_number] Prompts you in a line-by-line fashion to configure parameters for the RADIUS server given by [server_number].
Page 288
14 – Command Reference Set Setup Radius Examples The following is an example of the Set Setup Radius Common command: SANbox (admin) #> set setup radius common 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 289
14 – Command Reference Set Setup Radius The following is an example of the Set Setup Radius Server command: SANbox (admin) #> set setup radius server 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. 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.
14 – Command Reference Set Setup Services Set Setup Services Configures services on the switch. Authority Admin session Syntax set setup services This command prompts you in a line-by-line fashion to enable or disable switch services. Table 14-28 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 291
14 – Command Reference Set Setup Services Table 14-28. 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 292
14 – Command Reference Set Setup Services Table 14-28. 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.
14 – Command Reference Set Setup SNMP Set Setup SNMP Configures SNMP on the switch. Authority Admin session Syntax set setup snmp common trap [trap_number] Keywords common Prompts you in a line-by-line fashion to change SNMP configuration parameters that are common for all traps. For each parameter, enter a new value or press the Enter key to accept the current value.
Page 294
14 – Command Reference Set Setup SNMP Table 14-29. SNMP Common Configuration Parameters (Continued) Parameter Description TrapCommunity Trap community password that authorizes an SNMP agent to receive traps. This is a write-only field. The value on the switch and the SNMP management server must be the same. The trap community password can be up to 32 characters excluding #, semicolon (;), and comma (,).
Page 295
14 – Command Reference Set Setup SNMP Examples The following is an example of the Set Setup Snmp Common command: SANbox (admin) #> set setup snmp common 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 296
14 – Command Reference Set Setup SNMP The following is an example of the Set Setup Snmp Trap command: SANbox (admin) #> set setup snmp trap 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. 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.
14 – Command Reference Set Setup System Set Setup System Configures the network, logging, NTP server, and timer configurations on the switch. Authority Admin session Syntax set setup system ipv4 ipv6 logging timers Keywords Prompts you in a line-by-line fashion to change DNS host name configuration parameters described in Table 14-31.
14 – Command Reference Set Setup System ipv4 Prompts you in a line-by-line fashion to change the switch IPv4 Ethernet configuration parameters described in Table 14-32. To configure all system parameters, omit the keyword. For each parameter, enter a new value or press the Enter key to accept the current value.
14 – Command Reference Set Setup System Table 14-33. IP Version 6 Ethernet Configuration Parameters (Continued) Entry Description EthIPv6NetworkMask Ethernet IP subnet mask address. EthIPv6GatewayAddress Ethernet IP address gateway. logging Prompts you in a line-by-line fashion to change the event logging configuration parameters described in Table 14-34.
14 – Command Reference Set Setup System Table 14-35. NTP Server Configuration Parameters (Continued) Parameter 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 301
14 – Command Reference Set Setup System Examples The following is an example of the Set Setup System Dns command: SANbox (admin) #> set setup system dns 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 302
14 – Command Reference Set Setup System The following is an example of the Set Setup System Ipv4 command: SANbox (admin) #> set setup system ipv4 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 303
14 – Command Reference Set Setup System The following is an example of the Set Setup System Logging command: SANbox (admin) #> set setup system logging 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 304
14 – Command Reference Set Setup System The following is an example of the Set Setup System Timers command: SANbox (admin) #> set setup system timers 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.
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]...
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 currently displayed time to the time in the new time zone.
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-37 describes the entries in the Show About command display. Table 14-37.
Page 308
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 5802V FC Switch HostName <undefined> EthIPv4NetworkAddress 10.20.11.192 EthIPv6NetworkAddress MACAddress 00:c0:dd:00:71:ee WorldWideName 10:00:00:c0:dd:00:71:ed ChassisSerialNumber...
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.
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 #>...
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...
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 313
14 – Command Reference Show Config Port The following is an example of the Show Config Port command for an XPAK port: SANbox #> show config port 20 Configuration Name: default ------------------- Port Number: 16 ------------ AdminState Online LinkSpeed 10Gb/s PortType SymbolicName 10G-20...
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 -----------------------------------------...
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.
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 --------------------------------...
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...
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...
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:...
14 – Command Reference Show Donor Show Donor Displays list of current donors and extended credit configuration for all ports. Authority None Syntax show donor SANbox #> show donor Port Config Ext Credit Max Credit Donated Member of Valid Groups to Number Type Requested...
14 – Command Reference Show Fabric Show Fabric Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address in the fabric. Authority None Syntax show fabric brief Keywords brief Displays a table of switches in the fabric including domain ID, WWN, and symbolic name.
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.
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:00:27 inet addr:10.20.116.131 Bcast:10.20.116.255 Mask:255.255.255.0...
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 e-mail notification. SNMP SNMP events 14-150 59263-01 A...
Page 325
14 – Command Reference Show Log Table 14-38. 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 326
14 – Command Reference Show Log level Displays the severity settings for event logging and the setting for the display level. options Displays the options that are available for configuring event logging and automatic display to the screen. Refer to the “Set Log”...
Page 327
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,...
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...
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 330
14 – Command Reference Show Media Table 14-39. Transceiver Information (Continued) Information Type Description MediaPartNumber Vendor media part number MediaRevision Vender media revision level MediaSerialNumber Vendor media serial number MediaSpeeds Transmission speed capabilities Temp Temperature in degrees Celsius. Voltage Supply voltage in Volts. The range is 0–6.55. Tx Bias Transmitter laster bias current in milliamps.
Page 331
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 332
14 – Command Reference Show Media The following is an example of the Show Media command for all ports: SANbox #> show media Note: -- LowAlarm; - LowWarning; + HighWarning; ++ HighAlarm Port Vendor Name Temp Voltage Tx Bias Tx Pwr Rx Pwr (mA) (mW) (mW)
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.
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 335
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 diskarray7.anycompany.com ClassOfService PortIPAddress FabricPortName 20:01:00:c0:dd:00:bc:56 FC4Type FC4Desc (NULL) 59263-01 A...
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 (On) or allows the continuous display of information without a break (Off). Examples The following is an example of the Show Pagebreak command: SANbox #>...
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/second. Transmission rates are expressed in thousands (K) and millions (M). Authority None Syntax...
Page 338
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 339
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...
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 341
14 – Command Reference Show Port Table 14-40. Show Port Parameters (Continued) Entry Description DecodeError Number of decode errors detected DownstreamISL Downstream ISL state. True indicates a connection to another switch that is not the principal switch. POSTFaultCode Fault code from the most recent Power-on self test POSTStatus Status from the most recent Power-on self test EpConnects...
Page 342
14 – Command Reference Show Port Table 14-40. Show Port Parameters (Continued) Entry Description LIP_F8_AL_PS This LIP denotes a loop failure detected by the L_Port identi- fied by AL_PS. LIP_F7_F7 A loop initialization primitive frame used to acquire a valid AL_PA.
Page 343
14 – Command Reference Show Port Table 14-40. Show Port Parameters (Continued) Entry Description PortWWN Worldwide port name PrimSeqErrors Number of primitive sequence errors detected RunningType Operational port type: F, FL, E, or Unknown RxLinkResets Number of link reset primitives received from an attached device.
Page 344
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 3a0100 ConfigType PortWWN 20:01:00:c0:dd:0d:4f:08 POSTFaultCode 00000000 RunningType Unknown...
14 – Command Reference Show Postlog Show Postlog Displays the Power On Self Test (POST) log, which contains results from the most recently failed POST. Authority None Syntax show postlog show port log Examples The following is an example of the Show Postlog command: SANbox #>...
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 #> show setup callhome Callhome Information -------------------- PrimarySMTPServerAddr 0.0.0.0...
Displays manufacturing information about the switch. Authority None Syntax show setup mfg Examples The following is an example of the Show Setup Mfg command: SANbox #> show setup mfg Manufacturing Information ------------------------- BrandName QLogic BuildDate Unknown ChassisPartNumber SANbox 5802V ChassisSerialNumber 0331000011 CPUBoardSerialNumber 0331000011 LicensedPorts MACAddress...
14 – Command Reference Show Setup Radius Show Setup Radius Displays RADIUS server information. Authority None Syntax show setup radius common server [server_number] Keywords common Displays the configuration parameters that are common for all RADIUS servers. To display common and server-specific information, omit the keyword. Refer to Table 14-26 for a description of the common configuration parameters.
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...
14 – Command Reference Show Setup Snmp Show Setup Snmp Displays the current SNMP settings. Authority None Syntax show setup snmp common trap Keywords common Displays SNMP configuration parameters that are common to all traps. To display common and trap-specific parameters, omit the keyword. Refer to Table 14-29 descriptions of the common configuration parameters.
14 – Command Reference Show Setup System Show Setup System Displays network, logging, NTP server, and timer parameters on the switch. Authority None Syntax show setup system ipv4 ipv6 logging timers Keywords Displays DNS host name configuration parameters. To display all system configuration parameters, omit the keyword.
Page 352
14 – Command Reference Show Setup System Examples The following is an example of the Show Setup System Dns command: SANbox #> show setup system dns System Information ------------------ DNSClientEnabled False DNSLocalHostname <undefined> DNSServerDiscovery Static DNSServer1Address <undefined> DNSServer2Address <undefined> DNSServer3Address <undefined>...
Page 353
14 – Command Reference Show Setup System The following is an example of the Show Setup System Ntp command: SANbox #> show setup system System Information ------------------ NTPClientEnabled False NTPServerDiscovery Static NTPServerAddress 51.68.85.102 The following example of the Show Setup System Timers command: SANbox #>...
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 #>...
14 – Command Reference Show Switch Show Switch Displays switch operational information. Authority None Syntax show switch Notes Table 14-41 describes the switch operational parameters. Table 14-41. Switch Operational Parameters Parameter Description SymbolicName Descriptive name for the switch SwitchWWN Switch worldwide name BootVersion PROM boot version CreditPool...
Page 356
14 – Command Reference Show Switch Table 14-41. Switch Operational Parameters (Continued) Parameter Description PrincipalSwitchRole Principal switch status. True indicates that this switch is the principal switch. POSTFaultCode Fault code from the most recent Power-on self test POSTStatus Status from the most recent Power-on self test TestFaultCode Fault code from the most recent switch test TestStatus...
Page 357
14 – Command Reference Show Switch Examples The following is an example of the Show Switch command: SANbox #> show switch Switch Information ------------------ SymbolicName SANbox SwitchWWN 10:00:00:c0:dd:00:bc:56 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool DomainID 19 (0x13) FirstPortAddress 130000 FlashSize - MBytes LogFilterLevel...
14 – Command Reference Show System Show System Displays the operational status of the Ethernet and DNS host name configuration parameters. Authority None Syntax show system Examples The following is an example of the Show System command: SANbox #> show system Assigned System Network Information ----------------------------------- Hostname...
14 – Command Reference Show Testlog Show Testlog Displays the contents of the diagnostic field test log file. Authority None Syntax show testlog show test log Examples The following is an example of the Show Testlog command: SANbox #> show testlog Queue: Sequence Count: Success Count:...
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 14-186 59263-01 A...
14 – Command Reference Show Topology Show Topology Displays information about devices connected to the switch. Authority None Syntax show topology [port_number] Keywords [port_number] Displays the devices connected to the port given by [port_number]. Examples The following is an example of the Show Topology command: SANbox #>...
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 brief Keywords brief Displays just the account name and client. Examples The following is an example of the Show Users command: SANbox #>...
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-42 describes the Show Version command display entries. Table 14-42.
Page 364
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 5802V FC Switch HostName <undefined> EthIPv4NetworkAddress 10.20.11.192 EthIPv6NetworkAddress MACAddress 00:c0:dd:00:71:ee WorldWideName 10:00:00:c0:dd:00:71:ed ChassisSerialNumber...
14 – Command Reference Shutdown Shutdown Terminates all data transfers on the switch at convenient points and closes the Telnet session. Always power cycle the switch after entering this command. Authority Admin session Syntax shutdown Notes When the shutdown is complete, the Heartbeat LED is extinguished. 59263-01 A 14-191...
14 – Command Reference Snmpv3user Snmpv3user Manages SNMP version 3 user accounts on the switch. Authority Admin session except for the List keyword Syntax snmpv3user delete [account] edit list Keywords Creates an SNMP version 3 user account, prompting you for the parameters that are described in Table 14-43.
Page 367
14 – Command Reference Snmpv3user list Displays SNMP version 3 user accounts, group, authentication type, and privacy type. This keyword does not require an Admin session. Examples The following is an example of the Snmpv3user Add command: SANbox #> admin start SANbox (admin) #>...
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–23. Examples The following example cancels the test running on port 15: SANbox (admin) #>...
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–23. offline [loopback_type] Performs an offline test of the type given by [loopback_type] on the port given by [port_number].
14 – Command Reference Test Port Notes Table 14-44 describes the port test parameters. Table 14-44. 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).
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 last test that was executed. Authority None Syntax test status port [port_number] switch Keywords port [port_number]...
14 – Command Reference Test Switch Test Switch Tests all ports on the switch using a connectivity test, an offline test, or an online test. Authority Admin session Syntax test switch connectivity [loopback_type] offline [loopback_type] online Keywords connectivity [loopback_type] Performs a connectivity test of the type given by [loopback_type] on all switch ports.
14 – Command Reference Test Switch Notes Table 14-45 describes the switch test parameters. Table 14-45. Switch Test Parameters Parameter Description LoopCount Number of frames sent: 1–4294967295. The default is 100. FrameSize Number of bytes in each test frame: 40–2148. The default is 256. DataPattern 32-bit hexadecimal test value, or default, which defines random data...
14 – Command Reference Uptime Uptime Displays the elapsed up time since the switch was last reset and the 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...
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 brief Keywords accounts...
Page 376
14 – Command Reference User list brief Displays the list of users currently logged in, the login date, and the login time. The User List command is equivalent to the Show Users command. This keyword is available to all account names without an Admin session. To display just the account name and client, enter the User List Brief command.
Page 377
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?
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)
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-216 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
Page 380
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 381
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 #>...
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-216 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session.
Page 383
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 384
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 #>...
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 #>...
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 #>...
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.
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...
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 #>...
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-205 and the “Zoneset”...
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 (admin-zoning) #> zoning edited Edited (unsaved) Zoning Information ZoneSet Zone...
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.
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).
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...
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.
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-13), 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.
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. Authority Admin session and a Zoning Edit session. Syntax zoning save Examples...
Page 404
SANbox 5802V Fibre Channel Switch Command Line Interface Guide MD5 authentication 14-31 memory activity 14-159 page break 2-5 message Passwd command 3-4, 14-59 format 12-3 password queue 12-8, 12-16 change 14-59 MS - See Management Server default 2-2 Multi-Frame Sequence bundling 14-88 File Transfer Protocol 2-7 switch 14-59 user account 3-4...
Page 405
SANbox 5802V Fibre Channel Switch Command Line Interface Guide process identifier 5-4 Reset command 14-67 processing time 5-4 Callhome example 12-7, 12-16, 12-17 profile Config example 7-10 copy 12-12, 14-61 Factory example 7-10 create 12-9, 14-61 IP Security example 4-7 delete 12-10, 14-62 Ipsec example 4-19 edit 14-62...
Page 406
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Security command 14-77 security set Activate example 9-9 activate 9-11, 14-81 Active example 9-4 active 9-4 Clear example 9-10 add group 9-11 Edit example 9-9 add member group 14-81 History example 9-6 configured 9-2 Limits example 9-6 copy 9-11, 14-82...
Page 407
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Set Config Switch command 14-95 Show Config Port command 14-138 example 5-14 example 6-2 Set Config Threshold command 14-97 Show Config Security command 14-140 example 6-12 example 5-7 Set Config Zoning command 14-99 port binding 6-9 example 7-10 Show Config Security Port command 14-141...
Page 408
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Show Setup System command 14-177 switch example 4-2 administrative state 14-131 Show Steering command 14-180 configuration 5-1, 5-12, 14-95 Show Switch command 14-181 configuration defaults 14-70 Show System command 14-184 configuration display 14-142 Show Test Log command 14-185 configuration parameters 5-6, 5-14 Show Timezone command 14-186...
Page 409
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Test Port command 14-195 User command 14-201 example 6-13 Accounts example 3-2 Test Status command 14-197 Add example 3-3 Test Switch command 14-198 Delete example 3-4 TFTP - See Trivial File Transfer Protocol Edit example 3-4 time 5-19 List example 3-2...
Page 410
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Zone command 14-205 Zoneset command 14-208 Add example 7-18 Activate example 7-16 Copy example 7-17 Active example 7-4 Create example 7-17 Add example 7-15 Delete example 7-17 Copy example 7-15 Members example 7-7 Create example 7-14 Remove example 7-18 Deactivate example 7-16...
Page 411
SANbox 5802V Fibre Channel Switch Command Line Interface Guide Zoning Delete command example 7-14 Zoning Delete Orphans command 14-215 Zoning Edit command 14-216 example 7-12 Zoning Edited command 14-217 Zoning History command 14-218 example 7-8 Zoning Limits command 14-219 example 7-9 Zoning List command 14-220 example 7-3 Zoning Merged command 14-221...
Need help?
Do you have a question about the SANbox 5802V and is the answer not in the manual?
Questions and answers