How it Works
Q-Logic
Loading...
5602
User Manual
2 pgs89.15 Kb0
User Manual
312 pgs1.02 Mb0
Table of contents
Loading...

Q-Logic 5602 User Manual

Download
R
Simplify
SANbox 5000 Series
Fibre Channel Switch
Command Line Interface Guide
Firmware Version 6.7
59183-01 A Page i
SANbox 5000 Series 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. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.
This SANbox switch is covered by one or more of the following patents: 6697359; other patents pending.
QLogic and SANbox are trademarks or registered trademarks of QLogic Corporation. Microsoft, Windows NT, and Windows 2000/2003, and Internet Explorer are registered trademarks of Microsoft
Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners.
Document Revision History
Release, Revision A, July 25, 2007 Firmware Version 6.7
Enterprise Fabric Suite 2007 version 6.07
© 2000–2007 QLogic Corporation. All Rights Reserved Worldwide.
QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000
Page ii 59183-01 A
First Published: December 2005

Table of Contents

Section 1 Introduction
1.1 Switch Models and Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
1.2 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
1.3 Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
1.4 New in This Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
1.5 Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
1.5.1 Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
1.5.2 Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
1.5.3 Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
Section 2 Command Line Interface Usage
2.1 Logging In to the Switch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
2.2 Opening and Closing an Admin Session . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
2.3 Entering Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
2.4 Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4
2.5 Setting Page Breaks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4
2.6 Creating a Support File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
2.7 Downloading and Uploading Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7
Section 3 User Account Configuration
3.1 Displaying User Account Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
3.2 Creating User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3
3.3 Modifying User Accounts and Passwords . . . . . . . . . . . . . . . . . . . . . . . . . .3-4
Section 4 Network and Fabric Configuration
4.1 Displaying Name Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2
4.2 Displaying the Ethernet Network Configuration . . . . . . . . . . . . . . . . . . . . . .4-3
4.3 Configuring the Ethernet Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-4
4.4 Verifying a Switch in the Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5
4.5 Verifying and Tracing Fibre Channel Connections. . . . . . . . . . . . . . . . . . . .4-5
Section 5 Switch Configuration
5.1 Displaying Switch Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1
5.1.1 Switch Operational Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-2
5.1.2 System Process Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3
5.1.3 Elapsed Time Between Resets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4
59183-01 A Page iii
SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide
5.1.4 Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-5
5.1.4.1 Switch Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . .5-5
5.1.4.2 Zoning Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . .5-6
5.1.4.3 Security Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . .5-6
5.1.5 Hardware Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7
5.1.6 Firmware Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-8
5.2 Managing Switch Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-9
5.3 Managing Switch Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-11
5.3.1 Display a List of Switch Configurations. . . . . . . . . . . . . . . . . . . . . . . .5-11
5.3.2 Activate a Switch Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-11
5.3.3 Copy a Switch Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
5.3.4 Delete a Switch Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
5.3.5 Modify a Switch Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
5.3.6 Back Up and Restore a Switch Configuration . . . . . . . . . . . . . . . . . . .5-14
5.3.6.1 Creating the Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-14
5.3.6.2 Downloading the Configuration File . . . . . . . . . . . . . . . . . . . . . .5-15
5.3.6.3 Restoring the Configuration File. . . . . . . . . . . . . . . . . . . . . . . . .5-16
5.4 Paging a Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-17
5.5 Setting the Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-17
5.6 Resetting a Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-20
5.7 Installing Firmware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-20
5.7.1 Nondisruptive Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21
5.7.2 One-Step Firmware Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-21
5.7.3 Custom Firmware Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-23
5.8 Managing Switch Feature Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-24
5.8.1 Display Feature Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-24
5.8.2 Install a Feature License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-25
Section 6 Port Configuration
6.1 Displaying Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1
6.1.1 Port Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-2
6.1.2 Port Operational Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3
6.1.3 Port Threshold Alarm Configuration Parameters. . . . . . . . . . . . . . . . .6-4
6.1.4 Port Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-5
6.1.5 Transceiver Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-6
6.2 Modifying Port Operating Characteristics. . . . . . . . . . . . . . . . . . . . . . . . . . .6-7
6.3 Port Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-8
6.4 Resetting a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-9
6.5 Configuring Port Threshold Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-10
6.6 Testing a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12
Page iv 59183-01 A
SANbox 5000 Series Fibre Channel Switch
6.6.1 Online Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12
6.6.2 Offline Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-13
6.6.3 Display Port Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-14
6.6.4 Cancel a Port Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-14
6.7 Extending Port Transmission Distance. . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-15
Command Line Interface Guide
Section 7 Zoning Configuration
7.1 Displaying Zoning Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . .7-2
7.1.1 Configured Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-2
7.1.2 Active Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-4
7.1.3 Zone Set Membership Information . . . . . . . . . . . . . . . . . . . . . . . . . . .7-5
7.1.4 Zone Membership Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-5
7.1.5 Alias and Alias Membership Information. . . . . . . . . . . . . . . . . . . . . . .7-6
7.1.6 Zoning Modification History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-7
7.1.7 Zoning Database Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-8
7.2 Configuring the Zoning Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-9
7.3 Modifying the Zoning Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-11
7.4 Resetting the Zoning Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-12
7.5 Removing Inactive Zone Sets, Zones, and Aliases . . . . . . . . . . . . . . . . . . .7-12
7.6 Managing Zone Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-13
7.6.1 Create a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-13
7.6.2 Delete a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-13
7.6.3 Rename a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-14
7.6.4 Copy a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-14
7.6.5 Add Zones to a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-14
7.6.6 Remove Zones from a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-14
7.6.7 Activate a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-14
7.6.8 Deactivate a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-15
7.7 Managing Zones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-15
7.7.1 Create a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-15
7.7.2 Delete a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-15
7.7.3 Rename a Zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-16
7.7.4 Copy a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-16
7.7.5 Add Members to a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-16
7.7.6 Remove Members from a Zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-16
7.8 Managing Aliases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-17
7.8.1 Create an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-17
7.8.2 Delete an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-17
7.8.3 Rename an Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-17
7.8.4 Copy an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18
59183-01 A Page v
SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide
7.8.5 Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18
7.8.6 Remove Members from an Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18
Section 8 Connection Security Configuration
8.1 Managing SSL and SSH Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-1
8.2 Displaying SSL and SSH Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-3
8.3 Creating an SSL Security Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-3
Section 9 Device Security Configuration
9.1 Displaying Security Database Information . . . . . . . . . . . . . . . . . . . . . . . . . .9-2
9.1.1 Configured Security Set Information . . . . . . . . . . . . . . . . . . . . . . . . . .9-2
9.1.2 Active Security Set Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-4
9.1.3 Security Set Membership Information . . . . . . . . . . . . . . . . . . . . . . . . .9-5
9.1.4 Group Membership Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-5
9.1.5 Security Database Modification History. . . . . . . . . . . . . . . . . . . . . . . .9-6
9.1.6 Security Database Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-6
9.2 Configuring the Security Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-7
9.3 Modifying the Security Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-9
9.4 Resetting the Security Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-9
9.5 Managing Security Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-10
9.5.1 Create a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-10
9.5.2 Delete a Security Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-10
9.5.3 Rename a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-10
9.5.4 Copy a Security Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-10
9.5.5 Add Groups to a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-11
9.5.6 Remove Groups from a Security Set. . . . . . . . . . . . . . . . . . . . . . . . . .9-11
9.5.7 Activate a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-11
9.5.8 Deactivate a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-11
9.6 Managing Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-12
9.6.1 Create a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-12
9.6.2 Delete a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-12
9.6.3 Rename a Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-12
9.6.4 Copy a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-13
9.6.5 Add Members to a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-13
9.6.6 Modify a Group Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-14
9.6.7 Remove Members from a Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-14
Section 10 RADIUS Server Configuration
10.1 Displaying RADIUS Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-2
10.2 Configuring a RADIUS Server on the Switch. . . . . . . . . . . . . . . . . . . . . . . .10-3
Page vi 59183-01 A
SANbox 5000 Series Fibre Channel Switch
Command Line Interface Guide
Section 11 Event Log Configuration
11.1 Starting and Stopping Event Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-1
11.2 Displaying the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-2
11.2.1 Filtering the Event Log Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-3
11.2.2 Controlling Messages in the Output Stream . . . . . . . . . . . . . . . . . . . .11-3
11.3 Managing the Event Log Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-4
11.3.1 Configure the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-4
11.3.2 Display the Event Log Configuration. . . . . . . . . . . . . . . . . . . . . . . . . .11-5
11.3.3 Restore the Event Log Configuration . . . . . . . . . . . . . . . . . . . . . . . . .11-5
11.4 Clearing the Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-5
11.5 Logging to a Remote Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-6
11.6 Creating and Downloading a Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-7
Section 12 Simple Network Management Protocol Configuration
12.1 Managing the SNMP Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-1
12.2 Displaying SNMP Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-3
12.3 Modifying the SNMP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-4
12.4 Resetting the SNMP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-5
Section 13 Command Reference
13.1 Access Authority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-1
13.2 Syntax and Keywords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-2
13.3 Notes and Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-2
13.4 Command Listing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-3
Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-4
Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-5
Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-7
Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-10
Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-13
Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-14
Fcping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-15
Fctrace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-16
Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-18
Firmware Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-20
Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-22
Hardreset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-30
Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-31
History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-32
Hotreset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-33
Image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-34
59183-01 A Page vii
SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide
Lip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-37
Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-38
Passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-39
Ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-40
Ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-41
Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-42
Reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-43
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-52
Securityset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-56
Set Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-59
Set Beacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-60
Set Config Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-61
Set Config Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-67
Set Config Security Portbinding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-69
Set Config Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-70
Set Config Threshold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-72
Set Config Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-74
Set Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-76
Set Pagebreak. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-80
Set Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-82
Set Setup Radius. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-84
Set Setup Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-87
Set Setup SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-90
Set Setup System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-93
Set Switch State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-95
Set Timezone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-96
Show About. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-97
Show Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-98
Show Broadcast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-99
Show Chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-100
Show Config Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-101
Show Config Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-103
Show Config Security Portbinding. . . . . . . . . . . . . . . . . . . . . . . . . . . .13-104
Show Config Switch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-105
Show Config Threshold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-106
Show Config Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-107
Show Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-108
Show Donor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-109
Show Fabric. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-110
Page viii 59183-01 A
SANbox 5000 Series Fibre Channel Switch
Command Line Interface Guide
Show FDMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-111
Show Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-113
Show Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-114
Show LSDB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-117
Show Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-118
Show Mem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-122
Show NS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-123
Show Pagebreak. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-125
Show Perf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-126
Show Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-129
Show Post Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-134
Show Setup Mfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-135
Show Setup Radius. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-136
Show Setup Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-137
Show Setup SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-138
Show Setup System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-139
Show Steering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-140
Show Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-141
Show Timezone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-143
Show Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-144
Show Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-146
Show Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-147
Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-148
Test Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-149
Test Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-150
Test Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-153
Uptime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-154
User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-155
Whoami . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-158
Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-159
Zoneset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-163
Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-166
Index
59183-01 A Page ix
SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide

List of Tables

Table Page
2-1 Command-Line Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
3-1 Factory User Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
5-1 Heartbeat LED Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7
5-2 Switch Reset Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-20
13-1 ISL Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-23
13-2 Port Group Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-24
13-3 MS Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-25
13-4 Group Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-26
13-5 Switch Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-46
13-6 Port Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-47
13-7 Port Threshold Alarm Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-48
13-8 Zoning Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-49
13-9 SNMP Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-49
13-10 RADIUS Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-50
13-11 Services Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-50
13-12 System Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-51
13-13 Security Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-51
13-14 Port Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-61
13-15 Security Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-67
13-16 Port Binding Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-69
13-17 Switch Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-70
13-18 Port Alarm Threshold Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-72
13-19 Zoning Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-74
13-20 RADIUS Service Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-84
13-21 Switch Services Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-87
13-22 SNMP Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-90
13-23 System Configuration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-93
13-24 Log Monitoring Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-114
13-25 Transceiver Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-118
13-26 Show Port Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-129
13-27 Switch Operational Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-141
13-28 Port Test Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-151
13-29 Zoning Database Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-167
Page x 59183-01A
Section 1
Introduction
This guide describes the features and use of the command line interface for SANbox 5000 Series switches running firmware version 6.7. This guide is organized as follows:
Section 1 describes switch models and features, the intended audience,
related materials, new items in this release, and technical support.
Section 2 describes logging on and off of a switch, opening and closing an
Admin session, entering commands, getting help, paging a switch, setting page breaks, and loading and retrieving files.
Section 3 describes the management of user accounts and passwords. Section 4 describes configuring the switch network connection. Section 5 describes managing the switch configuration, setting the date and
time, backing up and restoring the switch configuration, resetting the switch, installing firmware, and installing feature licenses.
Section 6 describes port configurations, resetting a port, initializing a port
loop, configuring port threshold alarms, and testing ports.
Section 7 describes managing the zoning database and configuring
interoperability.
Section 8 describes managing connection security. Section 9 describes managing device security. Section 10 describes managing the Remote Authentication Dial-In User
Service (RADIUS) server.
Section 11 describes events and event logging. Section 12 describes managing the Simple Network Management Protocol
(SNMP) configuration.
Section 13 lists the commands in alphabetical order, including the command
syntax, keywords, notes, and examples.
59183-01 A 1-1
An index and a glossary are also provided.
1 – Introduction Switch Models and Examples
1.1

Switch Models and Examples

The commands and displays of the command line interface vary depending on the switch model. All examples in this guide are taken from a SANbox 5600 switch unless stated otherwise.
1.2

Intended Audience

This guide is intended for individuals who are responsible for installing and servicing Fibre Channel equipment using the command line interface.
1.3

Related Materials

The following manuals and materials are referenced in the text and/or provide additional information.
SANbox 5000 Series Fibre Channel Switch Installation Guide, 59096-04 SANbox 5000 Series QuickTools Switch Management User Guide,
59235-01
SANbox 5000 Series Enterprise Fabric Suite 2007 User Guide, 59097-04 SANbox Simple Network Management Protocol Reference Guide,
publication number 59047-07
CIM Agent Reference Guide, 59223-01
SANbox CLI Quick Reference Guide, 59261-00 QLogic Switch Interoperability Guide v3.0. This PDF document can be
downloaded at http://www.qlogic.com/interopguide/info.asp#inter.
Fibre Channel-Arbitrated Loop (FC-AL-2) Rev. 7.0. Fibre Channel-10-bit Interface Rev. 2.3. Definitions of Managed Objects for the Fabric Element in Fibre Channel
St a ndard (draft-ietf-ipfc-fabric-element-mib-04.txt).
The Fibre Channel Standards are available from:
Global Engineering Documents, 15 Inverness Way East, Englewood, CO 80112-5776 Phone: (800) 854-7179 or (303) 397-7956 Fax: (303) 397-2740.
1-2 59183-01 A
1.4

New in This Release

The following features are new in this release: The switch is equipped with the QuickTools embedded graphical user
interface. QuickTools is a web applet that provides basic fabric management tools.
The following optional features are available with 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.
Fabric Security provides for Secure Socket Layer (SSL) and Secure
Shell (SSH) connection security, device security using Challenge Handshake Authentication Protocol (CHAP), and remote authentication using a Remote Authentication Dial-In User Service (RADIUS) server.
SANdoctor provides tools for Fibre Channel connection verification
(Fcping command), Fibre Channel route tracing (Fctrace command), and transceiver diagnostic information (Show Media command).
Port Activation enables additional Fibre Channel ports up to the
20-port maximum.
You can download firmware image files using Trivial File Transfer Protocol
(TFTP) using the Firmware Install, Image Install, and Image TFTP commands.
1 – Introduction
New in This Release
The Zoning Delete Orphans command removes inactive zone sets and all
zones and aliases not in the active zone set.
Implicit hard zoning enforces soft zone boundaries effectively converting
them to hard zones.
Port binding establishes a list of port/devices that are permitted to log in to a
switch port. Port binding is configured using the
59183-01 A 1-3
Set Config Security Portbinding command.
1 – Introduction Technical Support
1.5

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.
Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.
1.5.1

Availability

QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays.
1.5.2

Training

QLogic offers certification training for the technical professional for both the SANblade™ HBAs and the SANbox switches. From the training link at
www.qlogic.com, you may choose Electronic-Based Training or schedule an
intensive "hands-on" Certification course.
Technical Certification courses include installation, maintenance and troubleshooting QLogic SAN products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by email at tech.training@qlogic.com.
1-4 59183-01 A
1.5.3

Contact Information

Support Headquarters QLogic Corporation
QLogic Web Site www.qlogic.com Technical Support Web Site support.qlogic.com Technical Support Email support@qlogic.com Technical Training Email tech.training@qlogic.com
North American Region
Email support@qlogic.com Phone +1-952-932-4040
1 – Introduction
Technical Support
12984 Valley View Road Eden Prairie, MN 55344-3657 USA
Fax +1 952-974-4910
Europe, Middle East, and Africa Region
Email emeasupport@qlogic.com Phone Numbers by Language +353 1 6924960 - English
+353 1 6924961 - Français +353 1 6924962 - Deutsch +353 1 6924963 - Español +353 1 6924964 - Português +353 1 6924965 - Italiano
Asia Pacific Region
Email apacsupport@qlogic.com Phone Numbers by Language +63-2-885-6712 - English
+63-2-885-6713 - (Mandarin) +63-2-885-6714 - (Japanese) +63-2-885-6715 - (Korean)
Latin and South America Region
Email calasupport@qlogic.com Phone Numbers by Language +52 55 5278 7016 - English
+52 55 5278 7017 - Español +52 55 5278 7015 - Português
59183-01 A 1-5
1 – Introduction Technical Support
Notes
1-6 59183-01 A
Section 2
Command Line Interface Usage
This section describes the following tasks:
Logging In to the Switch Opening and Closing an Admin Session Entering Commands Getting Help Setting Page Breaks Creating a Support File Downloading and Uploading Files
NOTE: Throughout this document, references in text to commands and
keywords use initial capitalization for clarity. Actual command and keyword entries are case insensitive
59183-01 A 2-1
2 – Command Line Interface Usage Logging In to the Switch
2.1

Logging In to the Switch

To log in to a switch through Telnet, open a command line window on the workstation and enter the Telnet command followed by the switch IP address:
# telnet ip_address
The Telnet window opens prompting you for a login. Enter an account name and password. The default account name is admin, and its password is password.
switch login:admin password: xxxxxxxx
Warning: Your user account password has not been changed It is strongly recommended that you do so before proceeding
To log off, enter the Exit command:
SANbox #> exit
To log in to a switch through the serial port, config ure the workst ation port with the following settings:
9600 baud 8-bit character 1 stop bit No parity
Enter an account name and password when prompted.
NOTE: A switch supports a combined maximum of 19 logins or sessions
reserved as follows: 4 logins or sessions for internal applications such as management
server and SNMP
9 high priority Telnet sessions6 logins or sessions for Enterprise Fabric Suite 2007 inband and
out-of-band logins, Application Programming Interface (API) inband and out-of-band logins, and Telnet logins. Additional logins will be refused.
2-2 59183-01 A
2.2

Opening and Closing an Admin Session

The command line interface performs monitoring and configuration tasks. Commands that perform monitoring tasks are available to all user accounts. Commands that perform configuration tasks are available only after entering the
Admin Start command to open an Admin session. A user account must have
Admin authority to enter the Admin Start command. The following is an example of how to open and close an Admin session:
SANbox #> admin start SANbox (admin) #> . . . SANbox (admin) #> admin end
2 – Command Line Interface Usage
Opening and Closing an Admin Session
2.3

Entering Commands

The command-line completion feature makes entering and repeating commands easier. Table 2-1 describes the command-line completion keystrokes.
Keystroke Effect
Tab Completes the command line. Enter at least one character and press
Up Arrow Scrolls backward through the list of previously entered commands. Down Arrow Scrolls forward through the list of previously entered commands. Control-A Moves the cursor to the beginning of the command line Control-E Moves the cursor to the end of the command line. Control-U Clears the command line.
Table 2-1. Command-Line Completion
the tab key to complete the command line. If more than one possibility exists, press the Tab key again to display all possibilities.
59183-01 A 2-3
2 – Command Line Interface Usage Getting Help
2.4

Getting Help

To display help for a command, enter the Help command followed by the command. The following is an example of the help that is available for the
Config Edit command.
SANbox #> help config edit config edit [CONFIG_NAME] This command initiates a configuration session and places the current session into config edit mode. If CONFIG_NAME is given and it exists, it gets edited; otherwise, it gets created. If it is not given, the currently active configuration is edited.
Admin mode is required for this command.
Usage: config edit [CONFIG_NAME]
2.5

Setting Page Breaks

Some display commands deliver so much information to the screen that it scrolls off too quickly to read it. You can limit the display to 20 lines by turning on page breaks. By default, page breaks are turned of f.The followin g is an example of ho w to turn page breaks on and how it affects the display.
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 ...
2-4 59183-01 A
2.6

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 cont ains 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. If your workstation has an FTP server, you can proceed with the command prompts to send the file from the switch to a remote host. Otherwise, you can use FTP to download the support file from the switch to your workstation.
NOTE: Support files are deleted from the switch during a power cycle or
switch reset.
The following example creates a support file and sends it to a remote host.
SANbox #> create support Log Msg:[Creating the support file - this will take several seconds] FTP the dump support file to another machine? (y/n): y Enter IP Address of remote computer: 10.20.33.130 Login name: johndoe Enter remote directory name: bin/support Would you like to continue downloading support file? (y/n) [n]: y Connected to 10.20.33.130 (10.20.33.130).
220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. 331 Password required for johndoe.
Password: xxxxxxx
2 – Command Line Interface Usage
Creating a Support File
230 User johndoe logged in. cd bin/support 250 CWD command successful.
lcd /itasca/conf/images Local directory now /itasca/conf/images bin 200 Type set to I.
put dump_support.tgz local: dump_support.tgz remote: dump_support.tgz 227 Entering Passive Mode (10,20,33,130,232,133) 150 Opening BINARY mode data connection for dump_support.tgz. 226 Transfer complete. 43430 bytes sent in 0.292 secs (1.5e+02 Kbytes/sec) Remote system type is UNIX. Using binary mode to transfer files. 221-You have transferred 43430 bytes in 1 files. 221-Total traffic for this session was 43888 bytes in 1 transfers. 221 Thank you for using the FTP service on localhost.localdomain.
59183-01 A 2-5
2 – Command Line Interface Usage Creating a Support File
If your workstation does not have an FTP server, enter the Create Support command to create the support file, and use FTP to download the support file from the switch to your workstation as shown in the following example:
SANbox #> 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 following:
1. Open a terminal window and move to the directory where you want to download the support file.
2. Enter the FTP command and the switch IP address or symbolic name.
>ftp 10.0.0.1
3. When prompted for a user and password, enter the FTP account name and password (images, images).
user: images password: images
4. Set binary mode and use the Get command to download the file (dump_support.tgz).
ftp>bin ftp>get dump_support.tgz xxxxx bytes sent in xx secs. ftp>quit
2-6 59183-01 A
2.7

Downloading and Uploading Files

There are several files that reside on the switch that you can download to the workstation for examination or for safekeeping. These files include the following:
Backup configuration file (configdata) Log files (logfile) Support files (dump_support.tgz)
You can upload firmware image files or backup configuration files to the switch to reinstall firmware or restore a corrupted configuration. The switch uses FTP to exchange files between the switch and the workstation.
Refer to “Installing Firmware” on page 5-20 for information about installing
firmware.
Refer to “Back Up and Restore a Switch Configuration” on page 5-14 for
information about backing up and restoring a switch configuration.
Refer to “Creating and Downloading a Log File” on page 11 -7 for information
about creating a log file.
Refer to “Creating a Support File” on page 2-5 for information about creating
a support file.
2 – Command Line Interface Usage
Downloading and Uploading Files
To download a file from the switch to the workstation, do the following:
1. Enter the FTP command and the switch IP address or symbolic name.
>ftp 10.0.0.1
2. When prompted for a user and password, enter the FTP account name and password (images, images).
user: images password: images
3. Set binary mode and use the Get command to download the file (configdata).
ftp>bin ftp>get configdata xxxxx bytes sent in xx secs. ftp>quit
59183-01 A 2-7
2 – Command Line Interface Usage Downloading and Uploading Files
To upload a file from the workstation to the switch, do the following
1. Enter the FTP command and the switch IP address or symbolic name.
>ftp 10.0.0.1
2. When prompted for a user and password, enter the FTP account name and password (images, images).
user:images password: images
3. Set binary mode and use the Put command to upload the file (config_switch_169).
ftp>put config_switch_169 configdata xxxxx bytes sent in xx secs. ftp>quit
2-8 59183-01 A
Section 3
User Account Configuration
User accounts and their respective passwords are the first line of switch security. A user account consists of an account name, an authority level, an d an expira tion 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. Factory User Accounts
User Account
Name
admin password This user account provides access to the Telnet
images images This user account provides access to the File Trans-
prom prom This user account provides access to the Mainte-
Password Purpose
server for managing the switch. Admin is the only account name that has permission to create and mod­ify other user accounts. To secure your admin user account, be sure to change the password for this account.
fer Protocol (FTP) server for exchanging files between the switch and the workstation.
nance menu while in Maintenance mode to perform switch recovery tasks. Refer to the SANbox 5000 Series Fibre Channel Switch Installation Guide for information about using Maintenance mode.
This section describes the following user account configuration tasks:
Displaying User Account Information Creating User Accounts Modifying User Accounts and Passwords
59183-01 A 3-1
3 – User Account Configuration Displaying User Account Information
3.1

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.
SANbox (admin) #> user accounts
Current list of user accounts
-----------------------------
images (admin authority = False, never expires) admin (admin authority = True , never expires) chuckca (admin authority = False, expires in < 50 days) gregj (admin authority = True , expires in < 100 days) fred (admin authority = True , never expires)
The following example displays user accounts that are logged on to the switch:
SANbox (admin) #> user list
User Ethernet Addr-Port Logged in Since
---- ------------------ ---------------
admin@OB-session1 10.20.68.108-1031 day month date time year admin@OB-session2 10.20.68.108-1034 day month date time year snmp@OB-session3 Unknown day month date time year snmp@IB-session4 Unknown day month date time year admin@OB-session5 Unknown day month date time year
3-2 59183-01 A
3.2

Creating User Accounts

A user account consists of an account name, an authority level, an d an expira tion date. The account name can be up to 15 characters and must begin with an alphanumeric character. The authority level grants admin authority (true) or denies it (false). The expiration date sets the date when the user account exp ires. Only the Admin user account can create user accounts.
The following example creates a new user account named user1 with admin authority that expires in 100 days.
SANbox (admin) #> user add Press 'q' and the ENTER key to abort this command. account name (1-15 chars) : user1 account password (8-20 chars) : *******
please confirm account password: *******
set account expiration in days (0-2000, 0=never): [0] 100
3 – User Account Configuration
Creating User Accounts
should this account have admin authority? (y/n): [n] y
OK to add user account 'user1' with admin authority and to expire in 100 days?
Please confirm (y/n): [n] y
59183-01 A 3-3
3 – User Account Configuration Modifying User Accounts and Passwords
3.3

Modifying User Accounts and Passwords

Only the Admin user account can modify a user account, delete a u ser 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.
SANbox (admin) #> user edit
Press 'q' and the ENTER key to abort this command.
account name (1-15 chars) : user1 set account expiration in days (0-2000, 0=never): [0] should this account have admin authority? (y/n): [n]
OK to modify user account 'user1' with no admin authority and to expire in 0 days?
Please confirm (y/n): [n]
The following example deletes the user account named user3.
SANbox (admin) #> user delete user3
The user account will be deleted. Please confirm (y/n): [n] y
In the following example, the Admin user account changes the password for the user account named user2.
SANbox #> admin start SANbox (admin) #> passwd user2
Press 'q' and the ENTER key to abort this command.
account OLD password : ******** account NEW password (8-20 chars) : ********
please confirm account NEW password: ******** password has been changed.
3-4 59183-01 A
Section 4
Network and Fabric Configuration
The switch network configuration consists of the following:
Network discovery method IP address Subnet mask IP gateway address
The network discovery method determines how the switch acquires its IP address. The IP address can come from the IP address that resides on the switch or from a server. The switch supports network discovery from the following server types:
Bootstrap Protocol (BootP) Reverse Address Resolution Protocol (RARP) Dynamic Host Configuration Protocol (DHCP)
This section describes the following network configuration tasks:
Displaying Name Server Information Displaying the Ethernet Network Configuration Configuring the Ethernet Port Verifying a Switch in the Network
59183-01 A 4-1
4 – Network and Fabric Configuration Displaying Name Server Information
4.1

Displaying 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 Port Port No ID ID Type COS PortWWN NodeWWN
--- ------ ------ ---- --- ------- -------
No entries found for domain ID 1.
Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN
--- ------ ------ ---- --- ------- -------
No entries found for domain ID 4.
Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN
--- ------ ------ ---- --- ------- -------
1 8 (0x8) 0824ba NL 3 22:00:00:20:37:2b:08:00 20:00:00:20:37:2b:08:00 2 8 (0x8) 0824c3 NL 3 22:00:00:20:37:2b:08:78 20:00:00:20:37:2b:08:78 3 8 (0x8) 0824c5 NL 3 22:00:00:20:37:1b:cf:fd 20:00:00:20:37:1b:cf:fd 4 8 (0x8) 0824c6 NL 3 22:00:00:20:37:2b:07:b4 20:00:00:20:37:2b:07:b4 5 8 (0x8) 0824c9 NL 3 22:00:00:20:37:2b:08:57 20:00:00:20:37:2b:08:57 6 8 (0x8) 0824cb NL 3 22:00:00:20:37:1b:cf:f6 20:00:00:20:37:1b:cf:f6 7 8 (0x8) 0824cc NL 3 22:00:00:20:37:2b:0b:ec 20:00:00:20:37:2b:0b:ec 8 8 (0x8) 0824d6 NL 3 22:00:00:20:37:2b:07:e1 20:00:00:20:37:2b:07:e1 9 8 (0x8) 0824da NL 3 22:00:00:20:37:2b:0b:1a 20:00:00:20:37:2b:0b:1a 10 8 (0x8) 0824e0 NL 3 22:00:00:20:37:1b:f0:7d 20:00:00:20:37:1b:f0:7d 11 8 (0x8) 0824e1 NL 3 22:00:00:20:37:2b:02:f6 20:00:00:20:37:2b:02:f6 12 8 (0x8) 0824e2 NL 3 22:00:00:20:37:1b:ea:b7 20:00:00:20:37:1b:ea:b7 13 8 (0x8) 0824e8 NL 3 22:00:00:20:37:1b:cb:e5 20:00:00:20:37:1b:cb:e5
Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN
--- ------ ------ ---- --- ------- -------
No entries found for domain ID 10.
Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN
--- ------ ------ ---- --- ------- -------
No entries found for domain ID 34.
4-2 59183-01 A
Loading...
+ 282 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use