SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Firmware Version 7.
S SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice.
Table of Contents 1 Introduction Switch Models and Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New in this Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Technical Support. . . . . . . . . . . . . . . . . . . . . .
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Displaying IP Security Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . Policy and Association Information. . . . . . . . . . . . . . . . . . . . . . . IP Security Configuration History . . . . . . . . . . . . . . . . . . . . . . . . IP Security Configuration Limits . . . . . . . . . . . . . . . . . . . . . . . . . Managing the Security Policy Database . . . . . . . . . . . . . . . . . . . . . . .
A SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Backing Up and Restoring a Switch Configuration . . . . . . . . . . . . . . . Creating the Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Downloading the Configuration File . . . . . . . . . . . . . . . . . . . . . . Restoring the Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . Paging a Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Display Port Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cancel a Port Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displaying Extended Credit Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Zoning Configuration Displaying Zoning Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . .
A SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Rename an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copy an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remove Members from an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Configuring a RADIUS Server on the Switch . . . . . . . . . . . . . . . . . . . . . . . . 11 Event Log Configuration Starting and Stopping Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displaying the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Filtering the Event Log Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Managing the SNMP Version 3 Configuration . . . . . . . . . . . . . . . . . . . . . . . Create an SNMP Version 3 User Account. . . . . . . . . . . . . . . . . . . . . . Display SNMP Version 3 User Accounts . . . . . . . . . . . . . . . . . . . . . . . Modify an SNMP Version 3 User Account . . . . . . . . . . . . . . . . . . . . . . 14 Command Reference Access Authority. . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-77 Securityset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-81 Set Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-84 Set Beacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Show Ns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-160 Show Pagebreak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-162 Show Perf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-163 Show Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Zoning List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-222 Zoning Merged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-223 Zoning Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-224 Zoning Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A 14-32 14-33 14-34 14-35 14-36 14-37 14-38 14-39 14-40 14-41 14-42 14-43 14-44 14-45 14-46 SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide IP Version 4 Ethernet Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-124 IP Version 6 Ethernet Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-124 Event Logging Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Notes Page xiv 59263-02 A
1 Introduction This guide describes the features and use of the command line interface for SANbox 5800V Series Fibre Channel switches running firmware version 7.4. The SANbox 5800V Series switch is a 24-port, 8-Gbps Fibre Channel switch. The model 5802V switch has dual, replaceable power supplies; model 5800V has a single non-replaceable power supply.
1 – Introduction Switch Models and Examples S Switch Models and Examples The commands and displays of the command line interface vary depending on the switch model. All examples in this guide are taken from a SANbox 5802V switch unless stated otherwise. Intended Audience This guide is intended for individuals who are responsible for installing and servicing Fibre Channel equipment using the command line interface.
A 1 – Introduction New in this Release New in this Release This release includes support for the single power supply, SANbox 5800V Stackable Fibre Channel Switch. Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider.
S 1 – Introduction Technical Support Contact Information Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods: Web http://support.qlogic.com North America Contact Information Email support@qlogic.com Phone (952) 932-4040 Support contact information for other regions of the world is available at the QLogic website: http://support.qlogic.
2 Command Line Interface Usage This section describes the following tasks: Logging In to the Switch Opening and Closing an Admin Session Entering Commands Getting Help Setting Page Breaks Creating a Support File Downloading and Uploading Files NOTE: Throughout this document, references in text to commands and keywords use initial capitalization for clarity.
S 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: 1. 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 Domain Name System (DNS) host name (requires a DNS server) The Telnet window opens prompting you for a login. # telnet ip_address 2.
A 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™, Application Programming Interface (API) , and Telnet.
S 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 Tab Completes the command line. Enter at least one character and press the tab key to complete the command line. If more than one possibility exists, press the Tab key again to display all possibilities.
A 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. By default, page breaks are turned off.The following is an example of how to turn page breaks on and how it affects the display.
2 – Command Line Interface Usage Creating a Support File S 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. The Create Support command creates the support file (dump_support.tgz) on the switch.
A 2 – Command Line Interface Usage Creating a Support File If your workstation does not have an FTP server, enter the Create Support command to create the support file, and then use FTP to download the support file from the switch to your workstation, as shown in the following example: SANbox #> create support Log Msg:[Creating the support file - this will take several seconds] FTP the dump support file to another machine? (y/n): n To download the support file from the switch to the workstation, do the f
2 – Command Line Interface Usage Downloading and Uploading Files S Downloading and Uploading Files Several files that reside on the switch can be downloaded to the workstation for examination or for safekeeping. These files include the following: Backup configuration file (configdata) Log files (logfile) Support files (dump_support.tgz) You can upload firmware image files or backup configuration files to the switch to reinstall firmware or restore a corrupted configuration.
A 2 – Command Line Interface Usage Downloading and Uploading Files For more information about reinstallation, backup and restore, and creating support and log files: 59263-02 A Refer to “Installing Firmware” on page 5-22 for information about installing firmware. Refer to “Backing Up and Restoring a Switch Configuration” on page 5-16 for information about backing up and restoring a switch configuration.
2 – Command Line Interface Usage Downloading and Uploading Files S Notes 2-10 59263-02 A
3 User Account Configuration User accounts and their respective passwords are the first line of switch security. A user account consists of an account name, an authority level, and an expiration date. Switches come from the factory with certain user accounts defined for special purposes. Table 3-1 describes these accounts, their passwords, and their purposes. These accounts cannot be deleted from the switch. Table 3-1.
S 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). The following example displays all user accounts defined on the switch. Account information includes account name, authority, and expiration date.
A 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; the remaining characters must be ASCII characters except semicolor (;), comma (,), #, and period (.). The authority level grants admin authority (true) or denies it (false). The expiration date sets the date when the user account expires.
S 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. The User command modifies and deletes user accounts. The Passwd command changes passwords. The following example removes the expiration date and admin authority for the user account named user1.
4 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 The Show Fabric command displays IP addresses for all switches in the fabric as shown in the following example.
S 4 – Network Configuration Configuring the Ethernet Port The 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.
A 4 – Network Configuration Configuring the Ethernet Port The network discovery method determines how the switch acquires its IP address. The IP address can come from the IP address that resides on the switch or from a server.
S 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).
A 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: SANbox (admin) #> set setup system dns A list of attributes with formatting and current values will follow.
4 – Network Configuration Verifying a Switch in the Network S 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. SANbox #> ping 10.20.11.57 Ping command issued. Waiting for response... SANbox #> Response successfully received from 10.20.11.57. If the switch was unreachable, you would see the following display. SANbox #> ping 10.20.11.
A 4 – Network Configuration Managing IP Security To remove all IP security policies and associations, enter the Reset Ipsec command.
4 – Network Configuration Managing IP Security S 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.
A 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: 2 Security Policy Count: 2 IP Security Configuration History To display the IP Security configuration history, enter the Ipsec History command to display
S 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 Current --------------- ------- ------- MaxConfiguredSAs 512 0 MaxConfiguredSPs 128 0 In an Ipsec Edit session, Ipsec Limits command displays the number of both configur
A 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. Enter a value or simply press the ENTER key to skip specifying a 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.
4 – Network Configuration Managing IP Security S 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. Please confirm (y/n): [n] y SANbox (admin-ipsec) #> ipsec save The IPsec configuration will be saved and activated.
A 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) #> ipsec policy edit h2h-sh-sp 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 Managing IP Security S 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. Please confirm (y/n): [n] y SANbox (admin-ipsec) #> ipsec save The IPsec configuration will be saved and activated.
A 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. Enter a value or simply press the ENTER key to skip specifying a value.
S 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. Please confirm (y/n): [n] y SANbox (admin-ipsec) #> ipsec save The IPsec configuration will be saved and activated.
A 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) #> ipsec association edit h2h-sh-sa 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.
S 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. Please confirm (y/n): [n] y SANbox (admin-ipsec) #> ipsec save The IPsec configuration will be saved and activated.
A 4 – Network Configuration Managing IP Security The 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 ....
4 – Network Configuration Managing IP Security S Notes 4-20 59263-02 A
5 Switch Configuration Switch configuration consists of the following tasks: Displaying Switch Information Managing Switch Services Managing Switch Configurations Paging a Switch Setting the Date and Time Resetting a Switch Installing Firmware Testing a Switch Verifying and Tracing Fibre Channel Connections Managing Switch Feature Upgrades Managing Idle Session Timers Displaying Switch Information You can display the following types of the switch information: 59
S 5 – Switch Configuration Displaying Switch Information Name Server Information The Show Ns command displays the list of WWNs in fabric as shown in the following example: SANbox #> show ns all Seq Domain No ID --- ------ Port ID Port Type COS PortWWN NodeWWN ------ ---- --- ------- ------- No entries found for domain ID 1. Seq Domain Port Port No ID Type COS PortWWN NodeWWN ------ ---- --- ------- ------- ID --- ------ No entries found for domain ID 4.
A 5 – Switch Configuration Displaying Switch Information Switch Operational Information The 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 #> show switch Switch Information ------------------ 59263-02 A SymbolicName SANbox SwitchWWN 10:00:00:c0:dd:00:bc:56 BootVersion Vx.x.x.
S 5 – Switch Configuration Displaying Switch Information System Process Information The Ps command displays system process information to help you determine what processes are running and CPU usage. The following example displays current system processes. SANbox #> ps PID PPID %CPU %MEM TIME ELAPSED COMMAND 244 224 0.0 0.3 00:00:04 2-03:02:31 cns 245 224 0.0 0.3 00:00:06 2-03:02:31 ens 246 224 0.0 0.3 00:00:09 2-03:02:31 dlog 247 224 0.0 0.6 00:00:33 2-03:02:31 ds 248 224 0.3 2.
A 5 – Switch Configuration Displaying Switch Information Elapsed Time Between Resets The 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.
S 5 – Switch Configuration Displaying Switch Information Configuration Information The Show Config command displays a variety of configuration information at the port and switch levels. In addition to the basic switch configurations, the Show Config command displays parameters that control how data is maintained in the security and zoning databases.
A 5 – Switch Configuration Displaying Switch Information Zoning Configuration Parameters Enter the Show Config Zoning command to display zoning configuration parameters. These parameters determine how zoning is applied to the switch. Refer to Table 14-24 for a description of these parameters.
S 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. Refer to Table 14-21 for a description of the port binding parameters.
A 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.
S 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.
A 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 and Set Setup Services commands. Refer to Table 14-28 for a description of the switch services. NOTE: The SSH and SSL services require the Fabric Security license key.
S 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. 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.
A 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. Only one configuration can be active at one time.
5 – Switch Configuration Managing Switch Configurations S 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 Admin Start command.
A 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. Enter a new value or simply press the ENTER key to accept the current value.
5 – Switch Configuration Managing Switch Configurations S Backing Up and Restoring a Switch Configuration Successful management of switches and fabrics depends on the effective use of switch configurations. Backing up and restoring a configuration is useful to protect your work or for use as a template in configuring other switches.
A 5 – Switch Configuration Managing Switch Configurations Downloading the Configuration File You use FTP to download the configdata file to your workstation for safe keeping and to upload the file back to the switch for the restore function. To download the configdata file, open an FTP session on the switch and login with the account name images and password images.
5 – Switch Configuration Managing Switch Configurations S 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.
A 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.
S 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 and Date commands.
A 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: SANbox (admin) #> set setup system ntp A list of attributes with formatting and current values will follow.
S 5 – Switch Configuration Resetting a Switch Resetting a Switch Table 5-2 describes the methods for resetting a switch, the corresponding command, and the impact on the switch. Table 5-2.
A 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. A disruptive activation interrupts Fibre Channel data traffic on the switch, while a non-disruptive activation does not.
S 5 – Switch Configuration Installing Firmware One-Step Firmware Installation The Firmware Install and 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.
A 5 – Switch Configuration Installing Firmware 4. 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). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. 5. Enter the password for your account name (FTP only). 331 Password required for johndoe. Password:****** 230 User johndoe logged in.
S 5 – Switch Configuration Testing a Switch If your workstation has neither an FTP nor a TFTP server, open an FTP session and download the firmware image file by entering FTP commands: >ftp ip_address or switchname user:images password: images ftp>bin ftp>put filename ftp>quit 2. Display the list of firmware image files on the switch to confirm that the file was loaded. SANbox #> admin start SANbox (admin) $> image list 3. Unpack the firmware image file to install the new firmware in flash memory.
A 5 – Switch Configuration Testing a Switch Online Tests for Switches An online test is a non-disruptive test that exercises port-to-device connections for all ports that are online. The following is an example of an online test: SANbox #> admin start SANbox (admin) #> test switch online A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the default value.
S 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. There are two types of offline test: internal loopback and external loopback. An internal loopback test exercises all internal port connections.
A 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. There are two types of connectivity test: internal loopback and external loopback. An internal loopback test exercises all internal port and inter-port connections.
S 5 – Switch Configuration Testing a Switch 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 Test Test Test Loop Test Level Type Status Count Failures ----- ---- ------ ----- -------- Switch Offline internal NeverRun 33 4 Port Test Test Loop Test Num Type Status Count Failures ---- ---- ------ ----- -------- 0 Offl
A 5 – Switch Configuration Verifying and Tracing Fibre Channel Connections Verifying and Tracing Fibre Channel Connections NOTE: The Fcping and Fctrace commands require the SANdoctor® license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. You can verify Fibre Channel connections between the switch and the fabric and display routing information.
5 – Switch Configuration Managing Switch Feature Upgrades S Managing Switch Feature Upgrades The following features are available to upgrade your switch through the purchase and installation of a license key: Enterprise Fabric Suite 2007 is a workstation-based Java® application that provides a graphical user interface for fabric management. This includes Performance View which graphs port performance. Enterprise Fabric Suite 2007 comes with a free 30-day trial license.
A 5 – Switch Configuration Managing Idle Session Timers Managing Idle Session Timers You can limit the duration of idle login sessions and idle Admin sessions (Admin Start command). You can specify limits up to 1,440 minutes; specifying 0 means unlimited. Idle login sessions that exceed the limit are logged off (InactivityTimeout). An idle Admin session that exceeds the limit is ended, but the login session may be maintained (AdminTimeout).
5 – Switch Configuration Managing Idle Session Timers S Notes 5-34 59263-02 A
6 Port Configuration This section describes the following topics: Displaying Port Information Modifying Port Operating Characteristics Port Binding Resetting a Port Configuring Port Threshold Alarms Testing a Port Displaying Extended Credit Status Displaying Port Information You can display the following port information: 59263-02 A Port Configuration Parameters Port Operational Information Port Threshold Alarm Configuration Parameters Port Performance 6-1
S 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.
A 6 – Port Configuration Displaying Port Information Port Operational Information Enter the Show Port command to display port operational information.
S 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.
A 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. Values are expressed in thousands (K) and millions (M) of bytes or frames per second.
S 6 – Port Configuration Displaying Port Information 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. Refer to Table 14-39 for a description of the transceiver information in the Show Media display.
A 6 – Port Configuration Modifying Port Operating Characteristics Modifying Port Operating Characteristics You can make permanent or temporary changes to port operating characteristics. You make permanent port configuration changes using the Set Config Port command. These changes are saved in the active configuration and are preserved across switch or port resets. The Set Port command makes temporary changes that apply until the next port or switch reset, or until you activate a configuration.
S 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. 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.
A 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) #> set config ports 3 . . .
S 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 example.
A 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. SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config security port 1 A list of attributes with formatting and current values will follow.
6 – Port Configuration Configuring Port Threshold Alarms S Configuring Port Threshold Alarms The switch can monitor a set of port errors and generates alarms based on user-defined sample windows and thresholds.
A 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.
S 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 Online Tests for Ports An online test is a non-disruptive test that exercises the port, transceiver, and device connections.
A 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. An internal loopback test exercises the internal port connections. An external loopback test exercises the port and its transceiver.
S 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) #> test status port 1 Port Test Test Loop Test Num Port Type Status Count Failures ---- -------- ---- ------ ----- -------- 1 1 Offline Internal Passed 12 0 Cancel a Port Test To cancel a port test that is in progress, enter the Test Cancel Port co
A 6 – Port Configuration Displaying Extended Credit Status Displaying Extended Credit Status Enter the Show Donor command to display the extended credit status for the switch as shown in the following example: SANbox #> show donor 59263-02 A Port Config Ext Credit Max Credit Donated Member of Number Type ------ ------ ---------- ---------- ------- ----------- --------------- 0 GL 0 16 None 0 0 1 GL 0 16 None 0 0 2 GL 0 16 None 0 0 3 GL 0 16 None 0 0 4 GL 0 16 None
6 – Port Configuration Displaying Extended Credit Status S Notes 6-18 59263-02 A
7 Zoning Configuration This section describes the following tasks: Displaying Zoning Database Information Configuring the Zoning Database Modifying the Zoning Database Saving the Active and Merged Zone Sets Resetting the Zoning Database Managing Zone Sets Managing Zones Managing Aliases Consider device access needs within the fabric. Access is controlled by the use of zoning. Some zoning strategies include the following: Separate devices by operating system.
7 – Zoning Configuration Displaying Zoning Database Information S 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. Volatile–This zoning database is temporary. This means it is not retained across switch resets.
A 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.
S 7 – Zoning Configuration Displaying Zoning Database Information Active Zone Set Information The Zoning List and Zoneset Active commands display information about the active zone set.
A 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. Refer to “Configuring the Zoning Database” on page 7-10 for more information about the MergeAutoSave parameter.
7 – Zoning Configuration Displaying Zoning Database Information S Zone Set Membership Information The Zoneset Zones, Zone List, and Zone Zonesets commands display zone set membership information.
A 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 21:00:00:e0:8b:02:41:2f Orphan Zone Information Enter the Zone Orphans command to display a list of zones that are not members of any zone set as
S 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 Inactive Database Information ----------------------------ConfigurationLastEditedBy adm
A 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 Current [Zoning Name] ---------------- ------- ------- ------------- MaxZoneSets 256 6 MaxZones 2000 17 MaxAliases 2500 1 MaxTotalMembers 10000 166 MaxZone
7 – Zoning Configuration Configuring the Zoning Database S 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. Refer to Table 14-24 for more information about the zoning configuration parameters.
A 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. You must also open a Config Edit session with the Config Edit command and indicate which configuration you want to modify.
7 – Zoning Configuration Modifying the Zoning Database S Modifying the Zoning Database To modify the non-volatile zoning database, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time through Telnet, Enterprise Fabric Suite 2007, or another management application. You must also open a Zoning Edit session with the Zoning Edit Configured command.
A 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) #> zoning active capture This command will overwrite the configured zoning database in NVRAM. Please confirm (y/n): [n] y The active zoning database has been saved.
7 – Zoning Configuration Removing Inactive Zone Sets, Zones, and Aliases S 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) #> zoning delete orphans This command will remove all zonesets, zones, and aliases that are not currently active.
A 7 – Zoning Configuration Managing Zone Sets Managing Zone Sets Managing zone sets consists of the following tasks: Create a Zone Set Delete a Zone Set Rename a Zone Set Copy a Zone Set Add Zones to a Zone Set Remove Zones from a Zone Set Activate a Zone Set Deactivate a Zone Set All of these tasks except Activate a Zone Set and Deactivate a Zone Set require an Admin session and a Zoning Edit session.
S 7 – Zoning Configuration Managing Zone Sets Rename a Zone Set Enter the Zoneset Rename command to rename a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset rename zoneset_old zoneset_new SANbox (admin-zoning) #>zoning save Copy a Zone Set Enter the Zoneset Copy command to copy a zone set and its contents to a new zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zo
A 7 – Zoning Configuration Managing Zones Deactivate a Zone Set Enter the Zoneset Deactivate command to deactivate the active zone set and disable zoning in the fabric: SANbox #> admin start SANbox (admin) #> zoneset deactivate Managing Zones Managing Zones consists of the following tasks: Create a Zone Delete a Zone Rename a Zone Copy a Zone Add Members to a Zone Remove Members from a Zone All of these tasks require an Admin session and a Zoning Edit session.
7 – Zoning Configuration Managing Zones S Rename a Zone Enter the Zone Rename command to rename zone_1 to zone_a as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone rename zone_1 zone_a SANbox (admin-zoning) #> zoning save Copy a Zone Enter the Zone Copy command to copy the contents of an existing zone (zone_1) to a new zone (zone_2) as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning)
A 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.
S 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) #> zoning save Add Members to an Alias Enter the Alias Add command to add ports/devices to alias_1 as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> alias
8 Connection Security Configuration NOTE: SSH and SSL connection security require the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. This section describes the following tasks: Managing SSL and SSH Services Displaying SSL and SSH Services Creating an SSL Security Certificate The switch supports secure connections with Telnet and switch management applications.
S 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. Refer to “Setting the Date and Time” on page 5-19. The SSL service must be enabled to authenticate users through a RADIUS server.
A 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 True SSHEnabled False GUIMgmtEnabled True SSLEnabled False EmbeddedGUIEnabled True SNMPEnabled True NTPEnabled True CIMEnabled True FTPEnabled True MgmtServerEnabled True Call
8 – Connection Security Configuration Creating an SSL Security Certificate S Notes 8-4 59263-02 A
9 Device Security Configuration NOTE: Device security requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
9 – Device Security Configuration Displaying Security Database Information S 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 The Securityset List and the Security List commands display info
A 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 ----------- ----- ----------- No active securityset defined.
S 9 – Device Security Configuration Displaying Security Database Information Active Security Set Information The Security Active and Securityset Active commands display information about the active security set.
A 9 – Device Security Configuration Displaying Security Database Information Security Set Membership Information The Securityset Groups and Group Securitysets commands display security set membership information.
S 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 day month date time year Database Checksum 00000000 Inactive Database Information ---------------
A 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 active security set in the switch’s non-volatile security database.
S 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. You must also open a Config Edit session with the Config Edit command and indicate which configuration you want to modify.
A 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. You must also open a Security Edit session with the Security Edit command.
S 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. Please confirm (y/n): [n] y SANbox (admin-security) #> security save Enter the Reset Security command as shown in the following example.
A 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: SANbox (admin-security) #> securityset copy securityset_1 securityset_2 Add Groups to a Security Set
S 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. Create a Group Creating a group involves specifying a group name and a group type.
A 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. For ISL member attributes, refer to Table 14-2. For Port member attributes, refer to Table 14-3. For MS member attributes, refer to Table 14-4.
S 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. For Port member attributes, refer to Table 14-3. For MS member attributes, refer to Table 14-4.
10 RADIUS Server Configuration NOTE: RADIUS server configuration requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Authentication can be performed locally using the switch’s security database, or remotely using a Remote Dial-In User Service (RADIUS) server such as Microsoft RADIUS. With a RADIUS server, the security database for the entire fabric resides on the server.
10 – RADIUS Server Configuration Displaying RADIUS Server Information S 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 #> show setup radius Radius Information -----------------DeviceAuthOrder Local UserAuthOrder Local TotalServers 2 Server: 1 ServerIPAddress 10.0.0.
A 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. The second group is server specific. You can configure both groups of parameters for all RADIUS servers, or you can configure the common and server-specific parameters separately.
S 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.
11 Event Log Configuration This section describes the following tasks: Starting and Stopping Event Logging Displaying the Event Log Managing the Event Log Configuration Clearing the Event Log Logging to a Remote Host Creating and Downloading a Log File Event messages originate from the switch or from the management application in response to events that occur in the fabric. Refer to the SANbox Fibre Channel Switch Event Message Guide for a complete listing of switch event messages.
S 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) #> set log stop Enter the Set Log Start command to start recording event message in the switch log as shown in the following example: SANbox (admin) #> set log start Displaying the Event Log Enter the Show Log command to display the event log.
A 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_IDL
11 – Event Log Configuration Managing the Event Log Configuration S 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. Alarms are always included in the output stream.
A 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 FilterComponent NameServer MgmtServer Zoning Switch Port Eport Snmp CLI QFS FilterLevel Info DisplayLevel Critical FilterPort 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 Restore the Ev
S 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. This requires that you enable remote logging on the switch and specify an IP address for the remote host. NOTE: To log event messages on a remote host, you must edit the syslog.
A 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: 1. Log into the switch through Telnet and create an archive of the event log.
11 – Event Log Configuration Creating and Downloading a Log File S Notes 11-8 59263-02 A
12 Call Home Configuration This section describes the following topics: Call Home Concepts Configuring the Call Home Service Managing the Call Home Database Testing a Call Home Profile Changing SMTP Servers Clearing the Call Home Message Queue Resetting the Call Home Database 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 S 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. You must enable and specify an address and service port for at least one SMTP server. Refer to “Configuring the Call Home Service” on page 12-5.
A 12 – Call Home Configuration Call Home Concepts Call Home Messages The Call Home service generates email messages for the specified event severity level and the following switch actions: Switch comes online Switch goes offline Reboot Power up Power down1 SFP failure When a qualifying switch action or event occurs, an email message is created and placed in the Call Home queue to be sent to the active SMTP server.
S 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 SwitchIP: 10.20.30.40 SwitchWWN: 10:00:00:c0:dd:0c:66:f2 Level: Alarm Text: CALLHOME TEST PROFILE MESSAGE ID: 8B00.0002 Time: Wed Jul 25 17:02:40.
A 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. 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.
S 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 25 PrimarySMTPServerEnabled False SecondarySMTPServerAddr 0.0.0.0 SecondarySMTPServerPort 25 SecondarySMTPServerEnabled False ContactEmailAddress nobody@localhost.
A 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.
S 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: SANbox #> callhome list profile ProfileName: group4 -----------Level Warn Format FullText MaxSize any size up to max of 100
A 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. Enter a new value or simply press the ENTER key to accept the current value.
12 – Call Home Configuration Managing the Call Home Database S 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. Please confirm (y/n): [n] y SANbox (admin-callhome) #> callhome save The CallHome database profiles will be saved and activated.
A 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) #> 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.
12 – Call Home Configuration Managing the Call Home Database S 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. Please confirm (y/n): [n] y SANbox (admin-callhome) #> callhome save The CallHome database profiles will be saved and activated.
A 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. SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> capture add A list of attributes with formatting and default values will follow.
S 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) #> callhome edit SANbox (admin-callhome) #> capture edit Capture Entries for Profile: Tech_Support_Center Index TimeOfDay DayOfWeek Interval ----- --------- --------- -------- 1 02:00 Sat 1 (weeks) Please select a cap
A 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) #> callhome edit SANbox (admin-callhome) #> capture remove Capture Entries for Profile: Tech_Support_Center Index TimeOfDay DayOfWeek Interval ----- --------- --------- -------- 1 02:00 Sat 1 (weeks) Please select a ca
S 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. Should the active server lose connection, control passes automatically to the other server.
A 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 #> admin start SANbox (admin) #> reset callhome The callhome configuration will be reset and the default values activated. Please confirm (y/n): [n] y Reset and activation in progress ....
12 – Call Home Configuration Resetting the Call Home Database S Notes 12-18 59263-02 A
13 Simple Network Management Protocol Configuration This section describes the following tasks: Managing the SNMP Service Displaying SNMP Information Modifying the SNMP Configuration Resetting the SNMP Configuration 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.
S 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 or Set Setup Services commands. Refer to “Modifying the SNMP Configuration” on page 13-4 for more information.
A 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.
S 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. The second group is trap specific. You can configure both groups of parameters for all SNMP traps, or you can configure the common and trap-specific parameters separately.
A 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. Current Values: Trap1Enabled True Trap1Address 10.20.33.
S 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.
A 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) #> snmpv3user add A list of SNMPV3 user attributes with formatting and default values as applicable will follow. Enter a new value OR simply press the ENTER key where-ever allowed to accept the default value.
S 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) #> snmpv3user edit A list of SNMPV3 user attributes with formatting and current attribute values for the specified SNMPV3 user will follow.
14 Command Reference This section describes the commands of the CLI and the format in which they are presented. The command format presents the following: Access Authority Syntax and Keywords Notes and Examples Command Listing Access Authority The Authority paragraph in each command description indicates what types of sessions are required to enter that command. Commands associated with monitoring tasks are available to all account names with no special session requirement.
14 – Command Reference Syntax and Keywords S 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 and Ipsec Policy commands. Syntax and Keywords The Syntax paragraph defines the command syntax using the following convention: command keyword keyword [value] keyword [value1] [value2] The Command is followed by one or more keywords.
A 14 – Command Reference Command Listing 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 Command Listing S 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.
A 14 – Command Reference Command Listing 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. This keyword does not require an Admin session. members [alias] Displays all members of the alias given by [alias]. This keyword does not require an Admin session.
14 – Command Reference Command Listing S 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. The Clear keyword also requires a Callhome Edit session.
A 14 – Command Reference Command Listing 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] Lists the configuration for the profile given by [profile].
S 14 – Command Reference Command Listing 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 286 ProcessedLast day mmm dd hh:mm:ss yyyy ProfileName group5 ProfileLevel Alarm ProcessedCount 25 ProcessedLast day mmm dd hh:
A 14 – Command Reference Command Listing 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 RecipientEmail admin3@company.com RecipientEmail admin7@company.com RecipientEmail admin8@company.com RecipientEmail admin9@company.
S 14 – Command Reference Command Listing 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. Authority Admin session and a Callhome Edit session. Refer to the “Callhome” command on page 14-6 for information about starting a Callhome Edit session.
A Examples 14 – Command Reference Command Listing 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. 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.
S 14 – Command Reference Command Listing 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 ----- --------- --------- -------- 1 02:00 Sat 1 (weeks) Please select a capture entry from the list above ('q' to quit): 1 The selected capture entry has been removed from profile Tech_Support_Center.
A 14 – Command Reference Command Listing 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.
14 – Command Reference Command Listing S 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.
A 14 – Command Reference Command Listing 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. Refer to the installation guide for information about using maintenance mode.
14 – Command Reference Command Listing S 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> bin ftp> get configdata ftp> quit The following is an example of how to upload a configuration backup file (configdata) from the workstation to the switch, and then restore the configuration.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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. You then use the Get FTP command to transfer the dump_support.tgz file in binary mode.
14 – Command Reference Command Listing S 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] Keywords [MMDDhhmmCCYY] Specifies the date – this requires an Admin session. If you omit [MMDDhhmmCCYY], the current date is displayed which does not require an Admin session.
A 14 – Command Reference Command Listing Exit Closes the Telnet session. Authority None Syntax exit Notes You can also press Control-D to close the Telnet session.
14 – Command Reference Command Listing S 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.
A 14 – Command Reference Command Listing 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. To trace the path between two initiator ports, you must disable the I/O StreamGuard feature.
S 14 – Command Reference Command Listing 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 14-24 Domain Ingress Port WWN Port Egress Port WWN Port ------ ---------------- ---- --------------- ---- 97 20:04:00:c0:dd:02:cc:2e 4 20:0e:00:c0:dd:02:cc:2e 14 97 20:0e:00:c0:dd:02:cc:2e 14 20:04:00:c0:dd:02:cc:2e 4 59263-02 A
A 14 – Command Reference Command Listing 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 feature add [license_key] log Keywords add [license_key] Adds the feature that corresponds to the value given by [license_key]. [license_key] is case insensitive.
14 – Command Reference Command Listing S 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-02 A
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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. When the firmware activation is complete, you may log in to the switch again.
A 14 – Command Reference Command Listing 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. Authority Admin session and a Security Edit session.
S 14 – Command Reference Command Listing 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 respectively. The group name and group type attributes are read-only fields common to all three tables. Table 14-2.
A 14 – Command Reference Command Listing 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, otherwise the switch port will be downed, and none of the devices will be able to log in.
S 14 – Command Reference Command Listing 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 disables (False) authentication for MS group members. The default is False. Hash The hash function to use to decipher the encrypted Secret sent by the MS group member. Hash values are MD5 or SHA-1.
A 14 – Command Reference Command Listing 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. Table 14-5.
S 14 – Command Reference Command Listing Table 14-5. Group Member Attributes (Continued) Attribute Binding (ISL Groups) Description Domain ID of the switch to which to bind the ISL group member worldwide name. This option is available only if FabricBindingEnabled is set to True using the Set Config Security command. 0 (zero) specifies no binding. list Displays a list of all groups and the security sets of which they are members. This keyword is available without an Admin session.
A Examples 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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 10:00:00:c0:dd:00:72:45 10:00:00:c0:dd:00:90:ef 10:00:00:c0:dd:00:b8:b7 14-36 59263-02 A
A 14 – Command Reference Command Listing 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” on page 14-101. Authority Admin session Syntax hardreset Notes To reset the switch without a power-on self test, refer to the “Reset” command on page 14-67.
S 14 – Command Reference Command Listing 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. [keyword] Displays a summary of the keyword given by [keyword] belonging to the command given by [command].
A 14 – Command Reference Command Listing 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: Examples Enter ![command_string] to re-execute the most recent command that matches [command_string].
S 14 – Command Reference Command Listing 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. This process may take a few minutes. To save the event log to a file before resetting, enter the Set Log Archive command.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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. To install firmware when the management workstation has an FTP server, use the Image Install command or the Firmware Install command.
A 14 – Command Reference Command Listing 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.
14 – Command Reference Command Listing S 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. Authority Admin session except for the History keyword. The Clear keyword also requires an Ipsec Edit session. Syntax ipsec cancel clear edit history limits save Keywords cancel Closes the current Ipsec Edit session.
A 14 – Command Reference Command Listing history Displays a history of IP security modifications. This keyword does not require an Admin session. History information includes the following: Time of the most recent IP security database modification and the user who performed it 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.
S 14 – Command Reference Command Listing Ipsec Association Creates and manages associations in the Security Association database.
A 14 – Command Reference Command Listing Table 14-6. Association Configuration Parameters Parameter Protocol Description 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– RFC 2402 (ah) Authentication Header–RFC 1826 (ah-old) SPI Security parameters index number Authentication Algorithm to use to authenticate the source or destination.
14 – Command Reference Command Listing S 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. configured Displays the configuration for all user-defined associations.
A Examples 14 – Command Reference Command Listing 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. 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 Command Listing S 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]. If you omit [option], the command displays the configuration of all active associations.
A 14 – Command Reference Command Listing 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. configured Displays the configuration for all user-defined policies.
S 14 – Command Reference Command Listing 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 ******** ******** h2h-hs-sa Description: Host-to-host: host->switch Source: fe80::250:daff:feb7:9d02 Destination: fe80::2c0:ddff:fe03:d4c1 P
A 14 – Command Reference Command Listing 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 it from the policy given by [policy_source].
S 14 – Command Reference Command Listing Table 14-7. Policy Configuration Parameters Parameter Protocol Description Protocol or application to which to apply IP security.
A 14 – Command Reference Command Listing Table 14-7. Policy Configuration Parameters Parameter espRuleLevel Description 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.
S 14 – Command Reference Command Listing 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. 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. Required attributes are preceded by an asterisk.
A 14 – Command Reference Command Listing Lip 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.
14 – Command Reference Command Listing S Logout Closes the Telnet session. Authority None Syntax logout Notes You can also press Control-D to close the Telnet session.
A 14 – Command Reference Command Listing 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 Command Listing S 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 (.).
A 14 – Command Reference Command Listing 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” command on page 14-6 for information about starting a Callhome Edit session.
S 14 – Command Reference Command Listing Table 14-8. Profile Configuration Parameters (Continued) Parameter Format Description 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.
A Examples 14 – Command Reference Command Listing 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. 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.
S 14 – Command Reference Command Listing 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. 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.
A 14 – Command Reference Command Listing Ps Displays current system process information. Authority None Syntax ps Examples The following is an example of the Ps command: SANbox #> ps PID 59263-02 A PPID %CPU %MEM TIME ELAPSED COMMAND 244 224 0.0 0.3 00:00:04 2-03:02:31 cns 245 224 0.0 0.3 00:00:06 2-03:02:31 ens 246 224 0.0 0.3 00:00:09 2-03:02:31 dlog 247 224 0.0 0.6 00:00:33 2-03:02:31 ds 248 224 0.3 2.8 00:09:59 2-03:02:31 mgmtApp 249 224 0.0 0.
14 – Command Reference Command Listing S Quit Closes the Telnet session. Authority None Syntax quit Notes You can also press Control-D to close the Telnet session.
A 14 – Command Reference Command Listing 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 Resets the Call Home database configuration to its default values.
S 14 – Command Reference Command Listing 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 Table 14-18. The switch configuration is activated automatically.
A 14 – Command Reference Command Listing 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” command on page 14-101. To reset the switch with a power-on self test, refer to the “Hardreset” command on page 14-37.
S 14 – Command Reference Command Listing 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. Enter the Show Config Switch command to display switch configuration values. Table 14-11 shows the port configuration default values.
A 14 – Command Reference Command Listing Table 14-9. Call Home Service Configuration Defaults (Continued) Parameters Default StreetAddress FromEmailAddress nobody@localhost.localdomain ReplyToEmailAddress nobody@localhost.localdomain ThrottleDupsEnabled True Table 14-10.
S 14 – Command Reference Command Listing Table 14-11.
A 14 – Command Reference Command Listing Table 14-12.
S 14 – Command Reference Command Listing Table 14-13. Zoning Configuration Defaults Parameter Default MergeAutoSave True DefaultZone Allow DiscardInactive False Table 14-14. SNMP Configuration Defaults Parameter Default SNMPEnabled True Contact Location Description SANbox 5800V FC Switch ObjectID 1.3.6.1.4.1.3873.1.14 (5800V) 1.3.6.1.4.1.3873.1.
A 14 – Command Reference Command Listing Table 14-15. RADIUS Configuration Defaults Parameter Default DeviceAuthOrder Local UserAuthOrder Local TotalServers 0 DeviceAuthServer False UserAuthServer False AccountingServer False ServerIPAddress 10.0.0.1 ServerUDPPort 1812 Timeout 2 seconds Retries 0 SignPackets False Table 14-16.
S 14 – Command Reference Command Listing Table 14-17. System Configuration Defaults Parameter Default Ethernet Network Enable True Ethernet Network Discovery Static Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.254 Admin Timeout 30 minutes InactivityTimeout 0 LocalLogEnabled True RemotelogEnabled False RemoteLogHostAddress 10.0.0.254 NTPClientEnabled False NTPServerAddress 10.0.0.254 EmbeddedGUIEnabled True Table 14-18.
A 14 – Command Reference Command Listing 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. Refer to the “Group” command on page 14-29 and the “Securityset” command on page 14-81. Authority Admin session.
14 – Command Reference Command Listing S 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. To close a Security Edit session without saving changes, enter the Security Cancel command.
A Examples 14 – Command Reference Command Listing 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 MD5 Primary Secret ******** Secondary Hash SHA-1 Secondary Secret ******** Binding 0 10:00:00:00:00:10:21:17 Authentication Chap Primary Hash MD5 Primary Secret ******** Secondary Hash
S 14 – Command Reference Command Listing The following is an example of the Security List command: SANbox #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- No active securityset defined.
A 14 – Command Reference Command Listing 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. Refer to the “Security” command on page 14-77 for information about starting a Security Edit session.
14 – Command Reference Command Listing S 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. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -.
A Examples 14 – Command Reference Command Listing 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 #> securityset groups alpha Current list of Groups for SecuritySet: alpha --------------------------------------group1 (ISL) group2 (Port) The foll
14 – Command Reference Command Listing S 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. This value requires an Admin session. on Enables the display of alarms in the session output stream. off Disables the display of alarms in the session output stream.
A 14 – Command Reference Command Listing 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: on Enables the flashing beacon. off Disables the flashing beacon.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing Table 14-19. Port Configuration Parameters (Continued) Parameter LinkSpeed Description 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. XPAK Ports: 10-Gbps, 20-Gbps, or Auto. The default is Auto. PortType Port types: SFP Ports: GL, G, F, FL, Donor. The default is GL.
S 14 – Command Reference Command Listing 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. AutoPerfTuning Automatic performance tuning for FL_Ports only. The default is True. If AutoPerfTuning is enabled (True) and the port is an FL_Port, MFSEnable is automatically enabled.
A 14 – Command Reference Command Listing Table 14-19. Port Configuration Parameters (Continued) Parameter IOStreamGuard Description Enables or disables the suppression of RSCN messages. IOStreamGuard can have the following values: Enable – Suppresses the reception of RSCN messages from other ports for which IOStreamGuard is enabled. Disable – Allows free transmission and reception of RSCN messages.
S 14 – Command Reference Command Listing 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. 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.
A 14 – Command Reference Command Listing 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. 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.
S 14 – Command Reference Command Listing 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.
A Examples 14 – Command Reference Command Listing 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. 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.
S 14 – Command Reference Command Listing 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]. The system displays each parameter one line at a time and prompts you for a value.
A 14 – Command Reference Command Listing 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. Authority Admin session and a Config Edit session Syntax set config switch This command initiates an editing session in which to change switch configuration settings. The system displays each parameter one line at a time and prompts you for a value.
S 14 – Command Reference Command Listing Table 14-22. Switch Configuration Parameters (Continued) Parameter Examples Description R_A_TOV Resource Allocation Timeout Value. The number of milliseconds 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. The number of milliseconds a port is to wait for errors to clear. The default is 2000.
A 14 – Command Reference Command Listing 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. Authority Admin session and a Config Edit session Syntax set config threshold Initiates a configuration session by which to generate and log alarms for selected events.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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 the Config Save command. Authority Admin session and a Config Edit session Syntax set config zoning Initiates an editing session in which to change the zoning database configuration. The system displays each parameter one line at a time and prompts you for a value.
S 14 – Command Reference Command Listing 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. Enter a new value or simply press the ENTER key to accept the current value.
A 14 – Command Reference Command Listing 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. Alarms are always displayed on the screen.
14 – Command Reference Command Listing S Mgmtserver Monitors management server status. Nameserver Monitors name server status. None Monitor none of the component events. Port Monitors all port events. QFS Monitors all QLogic Fabric Service (QFS) events. QFS governs Call Home e-mail notification. SNMP Monitors all SNMP events. Switch Monitors switch management events. Zoning Monitors zoning conflict events.
A 14 – Command Reference Command Listing 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. The critical level describes events that are generally disruptive to the administration or operation of the fabric, but require no action. This is the default severity level.
14 – Command Reference Command Listing S 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. To export log entries to a file, use the Set Log Archive command.
A 14 – Command Reference Command Listing 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: on Limits the display of information to 20 lines at a time.
S 14 – Command Reference Command Listing 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 ...
A 14 – Command Reference Command Listing 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 or set port [port_number] clear speed [transmission_speed] state [state] Keywords [port_number] Specifies the port. Ports are numbered beginning with 0. clear Clears the counters on all ports or the port given by [port_number].
14 – Command Reference Command Listing S 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. Down Disables the port by removing power from the port lasers.
A 14 – Command Reference Command Listing 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. Table 14-25.
S 14 – Command Reference Command Listing Table 14-25. Call Home Service Configuration Settings Entry Notes 14-110 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. Undeliverable messages are returned to this address unless overridden by the ReplayToEmailAddress parameter. ReplyToEmailAddress E-mail address that is to receive replies to the outbound e-mail message.
A Examples 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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. Authority Admin session Syntax set setup radius common server [server_number] Keywords common Prompts you in a line-by-line fashion to configure parameters that are common to all RADIUS servers.
A 14 – Command Reference Command Listing Table 14-26. Common RADIUS Configuration Parameters (Continued) Parameter TotalServers Description Number of RADIUS servers to configure during this session. Setting 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]. [server_number] is a positive integer.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing Table 14-28. Switch Services Settings (Continued) Entry SSLEnabled Description 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. This service must be enabled to authenticate users through a RADIUS server.
S 14 – Command Reference Command Listing Table 14-28. Switch Services Settings (Continued) Entry Examples Description MgmtServerEnabled Enables (True) or disables (False) the management of the switch through third-party applications that use GS-3 Management Server (MS). This parameter is the master control for the Set Config Port command parameter, MSEnable. The default is True. CallHomeEnabled Enables (True) or disables (False) the Call Home service which controls e-mail notification.
A 14 – Command Reference Command Listing 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. To configure common parameters and trap parameters, omit the Common keyword.
S 14 – Command Reference Command Listing 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 (,). The default is “public”.
A Examples 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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. Current Values: Trap1Enabled True Trap1Address 10.20.33.
A 14 – Command Reference Command Listing Set Setup System Configures the network, logging, NTP server, and timer configurations on the switch. Authority Admin session Syntax set setup system dns ipv4 ipv6 logging ntp timers Keywords dns Prompts you in a line-by-line fashion to change DNS host name configuration parameters described in Table 14-31. 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.
S 14 – Command Reference Command Listing 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. NOTE: Changing the IP address will terminate all Ethernet management sessions. Table 14-32.
A 14 – Command Reference Command Listing 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. 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.
S 14 – Command Reference Command Listing Table 14-35. NTP Server Configuration Parameters (Continued) Parameter Description NTPClientEnabled Enables (True) or disables (False) the Network Time Protocol (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. An Ethernet connection to the server is required and you must first set an initial time and date on the switch.
A Examples 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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. Current Values: LocalLogEnabled True RemoteLogEnabled False RemoteLogHostAddress 10.0.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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] Keywords [state] [state] can be one of the following: online Activates and prepares the ports to send data. This is the default. offline Prevents the ports from receiving signal and accepting a device login.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing Examples The following is an example of the Show About command: SANbox #> show about ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** 14-134 SystemDescription SANbox 5800V FC Switch HostName EthIPv4NetworkAddress 10.20.11.
A 14 – Command Reference Command Listing 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. This parameter is set using the Set Alarm command. Notes The alarm log is cleared when the switch is reset or power cycled.
S 14 – Command Reference Command Listing Show Broadcast Displays the broadcast tree information and all ports that are currently transmitting and receiving broadcast frames.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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 ------------ 59263-02 A AdminState Online LinkSpeed 10Gb/s PortType G SymbolicName 10G-20 DeviceScanEnabled True ForceOfflineRSCN False AutoPerfTuning False LCFEnabled False MFSEnabled False MSEnabled True IOStreamGuard Disabled VIEnabled False PDISCPingEnabled True 14-1
S 14 – Command Reference Command Listing Show Config Security Displays the security database configuration parameters.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing Show Config Switch Displays the switch configuration parameters.
A 14 – Command Reference Command Listing Show Config Threshold Displays alarm threshold parameters for the switch.
S 14 – Command Reference Command Listing Show Config Zoning Displays zoning configuration parameters for the switch.
A 14 – Command Reference Command Listing Show Domains Displays list of each domain and its worldwide name in the fabric.
S 14 – Command Reference Command Listing Show Donor Displays list of current donors and extended credit configuration for all ports.
A 14 – Command Reference Command Listing 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. If you omit the Brief keyword, the command displays information for the local switch only.
S 14 – Command Reference Command Listing Show FDMI Displays detailed information about the device host bus adapter. Authority None Syntax show fdmi [port_wwn] Keywords [port_wwn] The device worldwide port name for which to display information. If you omit [port_wwn], the command displays a summary of host bus adapter information for all attached devices in the fabric. Illegal characters in the display appear as question marks (?).
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing Show Log Displays the contents of the log or the parameters used to create and display entries in the log. The log contains a maximum of 1200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest.
A 14 – Command Reference Command Listing 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. Warning Displays all warning events. Critical Displays all critical events. Eport3 Displays all events related to E_Ports.
S 14 – Command Reference Command Listing 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” command on page 14-101 for information about how to configure event logging and display level. port Displays the ports being monitored for events.
A 14 – Command Reference Command Listing 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 mo
S 14 – Command Reference Command Listing 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 NeighborDomain=35, LocalPort=18, RemotePort=19, Cost=100 NeighborDomain=35, Lo
A 14 – Command Reference Command Listing 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 show media [port_list] all installed Keywords [port_list] The port or ports for which to display transceiver information. [port_list] can be a set of port numbers and ranges delimited by spaces.
S 14 – Command Reference Command Listing 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. The range is 0–655.
A Examples 14 – Command Reference Command Listing The following is an example of the Show Media command for port 4: SANbox #> show media 4 Port Number: 4 ------------MediaType 400-M5-SN-I MediaVendor FINISAR CORP. MediaPartNumber FTRJ8524P2BNL MediaRevision A MediaSerialNumber P6G22RL MediaSpeeds 1Gb/s, 2Gb/s, 4Gb/s Temp Voltage Tx Bias Tx Pwr Rx Pwr (C) (V) (mA) (mW) (mW) ----------- ----------- ------------ ----------- ----------Value Status 59263-02 A 3.33 7.30 0.373 0.
S 14 – Command Reference Command Listing The following is an example of the Show Media command for all ports: SANbox #> show media Note: -- LowAlarm; - LowWarning; + HighWarning; ++ HighAlarm 14-158 Port Vendor Name Temp Voltage Tx Bias Tx Pwr Rx Pwr Num (C) (V) ---- ----------- ------- ------- ------- ------ ------ (mA) (mW) (mW) 0 NotInstalled N/A N/A N/A N/A N/A 1 NotApplicable N/A N/A N/A N/A N/A 2 Unknown N/A N/A N/A N/A N/A 3 FINISAR N/A N/A N/A N/A 4 FINISAR
A 14 – Command Reference Command Listing 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. Therefore, avoid using large values for [count].
S 14 – Command Reference Command Listing 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: all Displays WWNs for all switches and ports. [domain_id] Displays WWNs for all devices connected to the switch given by [domain_id].
A 14 – Command Reference Command Listing The following is an example of the Show Ns [port_ID] command: SANbox #> show ns 1301e1 Port ID: 1301e1 -------PortType NL PortWWN 21:00:00:20:37:73:13:69 SymbolicPortName NodeWWN 20:00:00:20:37:73:13:69 SymbolicNodeName 59263-02 A NodeIPAddress diskarray7.anycompany.
14 – Command Reference Command Listing S 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).
A 14 – Command Reference Command Listing 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).
14 – Command Reference Command Listing S 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. If you omit [port_list], the command displays performance data for ports 0–15. Press any key to stop the display.
A Examples 14 – Command Reference Command Listing The following is an example of the Show Perf command: SANbox #> show perf Port Bytes/s Bytes/s Bytes/s Frames/s (out) (total) (in) ------ ------- ------- ------- -------- -------- -------- 0 7K 136M 136M 245 68K 68K 1 58K 0 58K 1K 0 1K 2 0 0 0 0 0 0 3 0 0 0 0 0 0 4 0 0 0 0 0 0 5 0 0 0 0 0 0 6 0 7K 7K 0 245 245 7 136M 58K 136M 68K 1K 70K 8 7K 136M 136M 245 68K 68K 9 58K 0 58K 1
S 14 – Command Reference Command Listing 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. For example, [0 2 10-15] specifies ports 0, 2, 10, 11, 12, 13, 14, and 15. Notes Table 14-40 describes the port parameters. Table 14-40.
A 14 – Command Reference Command Listing Table 14-40. Show Port Parameters (Continued) Entry 59263-02 A 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 Number of times an E_Port connected through ISL negotiation.
S 14 – Command Reference Command Listing Table 14-40. Show Port Parameters (Continued) Entry 14-168 Description LIP_F8_AL_PS This LIP denotes a loop failure detected by the L_Port identified by AL_PS. LIP_F7_F7 A loop initialization primitive frame used to acquire a valid AL_PA. LIP_F8_F7 A loop initialization primitive frame used to indicate that a loop failure has been detected at the receiver.
A 14 – Command Reference Command Listing Table 14-40. Show Port Parameters (Continued) Entry 59263-02 A 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. RxOfflineSeq Number of offline sequences (OLSs) received.
S 14 – Command Reference Command Listing Examples The following is an example of the Show Port command: SANbox #> show port 1 Port Number: 1 ------------ 14-170 AdminState Online OperationalState Offline AsicNumber 0 PerfTuningMode Normal AsicPort 2 PortID 3a0100 ConfigType GL PortWWN 20:01:00:c0:dd:0d:4f:08 POSTFaultCode 00000000 RunningType Unknown POSTStatus Passed MediaPartNumber FTLF8528P2BCV DownstreamISL False MediaRevision A EpConnState None MediaType 800-MX-SN-S
A 14 – Command Reference Command Listing Show Postlog Displays the Power On Self Test (POST) log, which contains results from the most recently failed POST.
S 14 – Command Reference Command Listing 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 PrimarySMTPServerPort 25 PrimarySMTPServerEnabled False SecondarySMTPServerAddr 0.0.0.
A 14 – Command Reference Command Listing Show Setup Mfg Displays manufacturing information about the switch.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing Show Setup Services Displays switch service status information.
S 14 – Command Reference Command Listing 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 for descriptions of the common configuration parameters. trap Displays trap-specific SNMP configuration parameters. To display common and trap-specific parameters, omit the keyword.
A 14 – Command Reference Command Listing Show Setup System Displays network, logging, NTP server, and timer parameters on the switch. Authority None Syntax show setup system dns ipv4 ipv6 logging ntp timers Keywords dns Displays DNS host name configuration parameters. To display all system configuration parameters, omit the keyword. Refer to Table 14-31 for descriptions of the DNS host name configuration parameters. ipv4 Displays switch IPv4 Ethernet configuration parameters.
S 14 – Command Reference Command Listing Examples The following is an example of the Show Setup System Dns command: SANbox #> show setup system dns System Information -----------------DNSClientEnabled False DNSLocalHostname DNSServerDiscovery Static DNSServer1Address DNSServer2Address DNSServer3Address DNSSearchListDiscovery Static DNSSearchList1 DNSSearchList2 DNSSearchList3 DNSSearchList4
A 14 – Command Reference Command Listing The following is an example of the Show Setup System Ntp command: SANbox #> show setup system ntp System Information -----------------NTPClientEnabled False NTPServerDiscovery Static NTPServerAddress 51.68.85.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing Show Switch Displays switch operational information. Authority None Syntax show switch Notes Table 14-41 describes the switch operational parameters. Table 14-41.
S 14 – Command Reference Command Listing Table 14-41. Switch Operational Parameters (Continued) Parameter 14-182 Description PrincipalSwitchRole Principal switch status. True indicates that this switch is the principal switch.
A Examples 14 – Command Reference Command Listing The following is an example of the Show Switch command: SANbox #> show switch Switch Information ------------------ 59263-02 A SymbolicName SANbox SwitchWWN 10:00:00:c0:dd:00:bc:56 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool 0 DomainID 19 (0x13) FirstPortAddress 130000 FlashSize - MBytes 128 LogFilterLevel Critical MaxPorts 24 NumberOfResets 15 ReasonForLastReset PowerUp ActiveImageVersion - build date Vx.x.x.
S 14 – Command Reference Command Listing 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 ----------------------------------- 14-184 Hostname EthIPv4NetworkAddress 10.20.116.
A 14 – Command Reference Command Listing Show Testlog Displays the contents of the diagnostic field test log file.
14 – Command Reference Command Listing S Show Timezone Displays the current time zone setting.
A 14 – Command Reference Command Listing 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].
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing Examples The following is an example of the Show Version command. SANbox #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** 14-190 SystemDescription SANbox 5800V FC Switch HostName EthIPv4NetworkAddress 10.20.11.
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing Snmpv3user Manages SNMP version 3 user accounts on the switch. Authority Admin session except for the List keyword Syntax snmpv3user add delete [account] edit list Keywords add Creates an SNMP version 3 user account, prompting you for the parameters that are described in Table 14-43. Table 14-43. SNMP Version 3 User Account Parameters Parameter Description Username Account user name Group Group type: Read-Only or Read-Write. The default is Read-Only.
A 14 – Command Reference Command Listing 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) #> snmpv3user add A list of SNMPV3 user attributes with formatting and default values as applicable will follow. Enter a new value OR simply press the ENTER key where-ever allowed to accept the default value.
14 – Command Reference Command Listing S 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.
A 14 – Command Reference Command Listing 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]. Use the Set Port command to place the port in the diagnostics state before running the test.
S 14 – Command Reference Command Listing 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). Otherwise, the test continues to completion. LoopForever Restarts the test after completion and continues until you cancel it (True).
A Examples 14 – Command Reference Command Listing The following example performs an online test on port 1: SANbox #> admin start SANbox (admin) #> test port 1 online A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the default value. 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.
S 14 – Command Reference Command Listing 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] Display test status for the port given by [port_number]. [port_number] can be 0–23. switch Display test status for the switch: Passed, Failed, NeverRun.
A 14 – Command Reference Command Listing The following example of the Test Status Switch command: SANbox (admin) #> test status switch 59263-02 A Test Test Test Loop Test Level Type Status Count Failures ----- ---- ------ ----- -------- Switch Offline internal NeverRun 33 4 Port Test Test Loop Test Num Type Status Count Failures ---- ---- ------ ----- -------- 0 Offline internal StoppedOnError 12 2 1 Offline internal NeverRun 1 0 2 Offline internal Passed
14 – Command Reference Command Listing S 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. You must place the switch in the diagnostics state using the Set Switch State command before starting the test.
A Notes 14 – Command Reference Command Listing 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 StopOnError Stops the test when an error occurs (True). Otherwise, the test continues to completion.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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 add delete [account_name] edit list brief Keywords accounts Displays all user accounts that exist on the switch. This keyword is available to all account names without an Admin session. add Add a user account to the switch.
S 14 – Command Reference Command Listing 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. Notes Authority level or password changes that you make to an account that is currently logged in do not take effect until that account logs in again.
A 14 – Command Reference Command Listing The following is an example of the User Edit command: SANbox (admin) #> user edit Press 'q' and the ENTER key to abort this command.
S 14 – Command Reference Command Listing Whoami Displays the account name, session number, and switch domain ID for the Telnet session.
A 14 – Command Reference Command Listing 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-218 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
14 – Command Reference Command Listing S 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. list Displays a list of all zones and the zone sets of which they are components. This keyword does not require an Admin session.
A Examples 14 – Command Reference Command Listing 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 #> 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 21:00:00:e0:8b:02:41:2f The
14 – Command Reference Command Listing S 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-218 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session. You must close the Zoning Edit session before using the Activate and Deactivate keywords.
A 14 – Command Reference Command Listing 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. You must enter the Zoning Save command afterwards to save your changes. deactivate Deactivates the active zone set. Close the Zoning Edit session before using this keyword.
S 14 – Command Reference Command Listing 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 #> zoneset list Current List of ZoneSets -----------------------alpha beta The following is an example of the Zoneset Zones command: SANbox #> zoneset zones s
A 14 – Command Reference Command Listing 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.
S 14 – Command Reference Command Listing 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 #> admin start SANbox (admin) #> zoning edit . . . SANbox (admin-zoning) #> zoning cancel Zoning edit mode will be canceled.
A 14 – Command Reference Command Listing 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. NOTE: The preferred method for clearing the zoning database from the switch is the Reset Zoning command.
S 14 – Command Reference Command Listing Zoning Configured Displays the contents of the non-volatile zoning database.
A 14 – Command Reference Command Listing 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 #> admin start SANbox (admin) #> zoning delete orphans This command will remove all zonesets, zones, and aliases that are not currently active.
14 – Command Reference Command Listing S 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-207 and the “Zoneset” command on page 14-210. Authority Admin session Syntax zoning edit [database] Keywords [database] Opens an edit session for the zoning database given by [database].
A 14 – Command Reference Command Listing Zoning Edited Displays the contents of the edited zoning database.
S 14 – Command Reference Command Listing 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.
A 14 – Command Reference Command Listing 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). If you omit this keyword, the display includes a membership breakdown for each zone.
S 14 – Command Reference Command Listing Zoning List Lists all zoning definitions, including the applicable zoning database.
A 14 – Command Reference Command Listing 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. You must enter the Zoning Save command afterwards to save your changes. If you omit this keyword, this command displays the contents of the merged zone set.
14 – Command Reference Command Listing S 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.
A 14 – Command Reference Command Listing 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 The following is an example of the Zoning Save command: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> . .
14 – Command Reference Command Listing 14-226 S 59263-02 A
Index A account name admin 2-2 display 14-203, 14-206 factory 3-1 maintenance mode 3-1 activation firmware 5-22, 5-23 security 9-9, 9-11 switch configuration 5-13, 5-14 zoning 7-12 active zone set 7-1, 7-4 Admin account name 3-1, 14-1 authority 2-3, 14-1 session 2-3 session timeout 14-126 Admin command 14-3 Admin session 5-33 administrative state port 14-108 switch 14-131 alarm configuration 6-12, 14-97 configuration display 6-4, 14-143 description 11-1, 14-104 log 14-84, 14-135 59263-02 A alias add membe
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide B backup file 5-16 beacon 5-19, 14-85 binding fabric 14-30, 14-34 port 6-10, 14-94 Boot Protocol 14-124, 14-125 broadcast 14-136 C Call Home concepts 12-1 database 12-2, 12-6, 12-7, 12-16 edit session 14-1 message queue 12-8, 12-16 messages 12-3 queue 12-3 requirements 12-2 reset 12-7 service 12-2, 12-5, 14-118 technical support interface 12-4 Callhome command 14-6 Changeover example 12-16 Clear example 12-16 Edit example 12-6
A Create command 14-17 Certificate example 8-3 Support example 2-6 credit 14-146 critical event 11-1 Cyclic Redundancy Check errors 6-12 D data capture add configuration 12-13 delete configuration 12-15 modify configuration 12-14 date 5-19, 5-21 Date command 5-19, 14-20 decode errors 6-12 default switch configuration 14-70 zone 7-10 device access 7-1 security configuration 9-1 discard inactive 7-10 discovery method 4-1 display control 2-5 DNS - See Domain Name System domain ID binding 14-30, 14-34 display
S SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Fctrace command 14-23 example 5-31 FDMI - See Fabric Device Management Interface Feature command 14-25 Add example 5-32 Log example 5-32 feature upgrade 5-32, 14-25 Fibre Channel connection 5-31 routing 5-31 file download and upload 2-8 File Transfer Protocol download files 2-8, 5-17 download firmware 5-24 restore configuration file 5-18 service 14-117 user account 3-1 firmware 5-23 custom installation 5-25 image file 14-41
A I I/O Stream Guard 14-89 idle session limits 5-33 Image command 14-41 Install example 5-22 inactivty limits 5-33 informative event 11-1 internal test 6-14, 14-195, 14-200 Internet Protocol security 4-6, 4-7, 4-18 version 4 4-2 version 6 4-4 Inter-Switch Link connection count 6-12 group 9-1, 9-12, 14-32 IP address 4-1, 4-2, 14-124, 14-125 IP Security configuration history 4-9 configuration limits 4-10 reset 4-7 Ipsec Association command 14-46 Copy example 4-18 Create example 4-15 Delete example 4-16 Edit e
S SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide MD5 authentication 14-31 memory activity 14-159 message format 12-3 queue 12-8, 12-16 MS - See Management Server Multi-Frame Sequence bundling 14-88 N name server information 5-2, 14-160 network configuration 4-1 configuration reset 14-69 discovery 4-1, 4-2, 14-124, 14-125 enable 14-124 gateway address 14-124, 14-125 interfaces 14-149 IP address 14-124, 14-125 mask 14-124, 14-125 Network Time Protocol 5-21 client 14-126 des
A process identifier 5-4 processing time 5-4 profile copy 12-12, 14-61 create 12-9, 14-61 delete 12-10, 14-62 edit 14-62 modify 12-11 rename 12-12, 14-62 Tech_Support_Center 12-4, 12-16 test 12-15 Profile command 14-61 Copy example 12-12 Create example 12-9 Delete example 12-10 Edit example 12-11 Rename example 12-12 Ps command 5-4, 14-65 Q QuickTools 14-117 Quit command 14-66 R RADIUS - See Remote Dial-In User Service RADIUS server configuration 8-2, 10-1, 10-3, 14-109, 14-112, 14-113 configuration displ
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Security command 14-77 Activate example 9-9 Active example 9-4 Clear example 9-10 Edit example 9-9 History example 9-6 Limits example 9-6 List example 9-3 Save example 9-9 security database autosave 9-7 clear 14-77 configuration 9-7 description 9-1 display 14-78 display history 14-78 information 9-2 limits 9-6, 14-78 modification history 9-6 modify 9-9 reset 9-10 restore 9-7 security edit session cancel 14-77 initiate 14-78 rev
A Set Config Switch command 14-95 example 5-15 Set Config Threshold command 14-97 example 6-13 Set Config Zoning command 14-99 example 7-10 Set Log command 14-101 Archive example 11-7 Clear example 11-5 Display example 11-4 example 11-4 Restore example 11-5 Start example 11-2 Stop example 11-2 Set Pagebreak command 14-105 example 2-5 Set Port command 14-107 Set Setup Callhome command 14-109 example 12-5 Set Setup command SNMP example 13-4 Set Setup Radius command 14-112 example 10-3 Set Setup Services comma
S SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Show Setup SNMP command 14-176 example 13-3 Show Setup System command 14-177 example 4-2 Show Steering command 14-180 Show Switch command 14-181 Show System command 14-184 Show Test Log command 14-185 Show Timezone command 14-186 Show Topology command 14-187 Show Users command 14-188 Show Version command 14-189 example 5-10 Shutdown command 14-191 Simple Mail Transfer Protocol server 12-16 Simple Network Management Protocol
A Test Port command 14-195 example 6-14 Test Status command 14-198 Test Switch command 14-200 TFTP - See Trivial File Transfer Protocol time 5-21 between resets 5-5 set and display 5-19, 14-20 zone 14-132, 14-186 time zone 5-19 timeout Admin session 14-126 admin session 4-2 inactivity 4-2 Telnet session 14-126 topology 14-187 transceiver information 6-6 Trivial File Transfer Protocol 5-24 Tsc1 text format 12-3 U Universal Time 5-19 upgrade 5-32, 14-25 Uptime command 14-202 example 5-5 user account add 14-2
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Zone command 14-207 Add example 7-18 Copy example 7-18 Create example 7-17 Delete example 7-17 Members example 7-7 Remove example 7-18 Rename example 7-18 Zonesets example 7-6 zone set activate 7-16, 14-210 active 7-1, 7-4, 7-13, 14-213 add member zone 14-210 add zones 7-16 configured 7-2 copy 7-16, 14-210 create 7-15, 14-211 deactivate 7-17, 14-69, 14-211 definition 7-1 delete 7-15, 14-211 delete member zone 14-211 display 14-
A SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide Zoning Delete command example 7-14 Zoning Delete Orphans command 14-217 Zoning Edit command 14-218 example 7-12 Zoning Edited command 14-219 Zoning History command 14-220 example 7-8 Zoning Limits command 14-221 example 7-9 Zoning List command 14-222 example 7-3 Zoning Merged command 14-223 Capture example 7-13 Zoning Restore command 14-224 Zoning Save command 14-225 59263-02 A Index-13
SANbox 5800V Series Stackable Fibre Channel Switch Command Line Interface Guide S Notes Index-14 59263-02 A
D Corporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo, CA 92656 949.389.6000 Europe Headquarters QLogic (UK) LTD. Quatro House Lyon Way, Frimley Camberley Surrey, GU16 7ER UK www.qlogic.com +44 (0) 1276 804 670 © 2008 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic, the QLogic logo, Enterprise Fabric Suite, QuickTools, and SANdoctor are trademarks or registered trademarks of QLogic Corporation.
