Page is loading ...
59270-00 A
SANbox 3810
Fibre Channel Switch
Command Line Interface Guide
Firmware Version 7.4
ii 59270-00 A
S
SANbox 3810 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.
Document Revision History
Release, Revision A, April 2009 Firmware Version 7.4
59270-00 A PRELIMINARY iii
Table of Contents
1 Command Line Interface Usage
Logging In to the Switch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Opening and Closing an Admin Session . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Entering Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Setting Page Breaks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Creating a Support File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Downloading and Uploading Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
2 User Account Configuration
Displaying User Account Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Creating User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Modifying User Accounts and Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
3 Network Configuration
Displaying the Network Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Configuring the Ethernet Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
IP Version 4 Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
IP Version 6 Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
DNS Server Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Verifying a Switch in the Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Managing IP Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
IP Security Concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Displaying IP Security Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Policy and Association Information. . . . . . . . . . . . . . . . . . . . . . . 3-8
IP Security Configuration History . . . . . . . . . . . . . . . . . . . . . . . . 3-9
IP Security Configuration Limits . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Managing the Security Policy Database . . . . . . . . . . . . . . . . . . . . . . . 3-10
Creating a Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Deleting a Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
Modifying a User-Defined Policy . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Renaming a User-Defined Policy . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Copying a Policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
iv 59270-00 A
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
S
Managing the Security Association Database. . . . . . . . . . . . . . . . . . . 3-14
Creating an Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
Deleting an Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-16
Modifying a User-Defined Association . . . . . . . . . . . . . . . . . . . . 3-17
Renaming a User-Defined Association. . . . . . . . . . . . . . . . . . . . 3-18
Copying an Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
Resetting the IP Security Configuration. . . . . . . . . . . . . . . . . . . . . . . . 3-18
4 Switch Configuration
Displaying Switch Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Name Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Switch Operational Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
System Process Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Elapsed Time Between Resets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Switch Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . 4-6
Zoning Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . 4-6
Security Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . 4-7
Hardware Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
Firmware Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
Managing Switch Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Managing Switch Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Displaying a List of Switch Configurations. . . . . . . . . . . . . . . . . . . . . . 4-11
Activating a Switch Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Copying a Switch Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Deleting a Switch Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Modifying a Switch Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Backing Up and Restoring a Switch Configuration . . . . . . . . . . . . . . . 4-14
Creating the Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
Downloading the Configuration File . . . . . . . . . . . . . . . . . . . . . . 4-14
Restoring the Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Paging a Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
Setting the Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
Displaying the Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
Setting the Date and Time Explicitly . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
Setting the Date and Time through NTP . . . . . . . . . . . . . . . . . . . . . . . 4-18
Resetting a Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Installing Firmware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Non-disruptive Activation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
One-Step Firmware Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
59270-00 A v
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
A
Custom Firmware Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
Testing a Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
Online Tests for Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
Offline Tests for Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
Connectivity Tests for Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
Displaying Switch Test Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
Canceling a Switch Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
Managing Idle Session Timers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28
5 Port Configuration
Displaying Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Port Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
Port Operational Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
Port Threshold Alarm Configuration Parameters. . . . . . . . . . . . . . . . . 5-4
Port Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Modifying Port Operating Characteristics. . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6
Port Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Resetting a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9
Configuring Port Threshold Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
Testing a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Online Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12
Offline Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
Display Port Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
Cancel a Port Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14
6 Zoning Configuration
Displaying Zoning Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Configured Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Active Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
Edited Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
Zone Set Membership Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5
Zone Membership Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
Orphan Zone Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
Alias and Alias Membership Information. . . . . . . . . . . . . . . . . . . . . . . 6-7
Zoning Modification History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
Zoning Database Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9
Configuring the Zoning Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
Modifying the Zoning Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12
Saving the Active and Merged Zone Sets . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13
Resetting the Zoning Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13
vi 59270-00 A
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
S
Removing Inactive Zone Sets, Zones, and Aliases . . . . . . . . . . . . . . . . . . . 6-14
Managing Zone Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15
Create a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15
Delete a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15
Rename a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Copy a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Add Zones to a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Remove Zones from a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Activate a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16
Deactivate a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
Managing Zones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
Create a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
Delete a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
Rename a Zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18
Copy a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18
Add Members to a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18
Remove Members from a Zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18
Managing Aliases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19
Create an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19
Delete an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19
Rename an Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19
Copy an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20
Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20
Remove Members from an Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20
7 Connection Security Configuration
Managing SSL and SSH Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
Displaying SSL and SSH Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
Creating an SSL Security Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3
8 Device Security Configuration
Displaying Security Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
Configured Security Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
Active Security Set Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
Security Set Membership Information . . . . . . . . . . . . . . . . . . . . . . . . . 8-5
Group Membership Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5
Security Database Modification History. . . . . . . . . . . . . . . . . . . . . . . . 8-6
Security Database Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6
Configuring the Security Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
Modifying the Security Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9
59270-00 A vii
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
A
Resetting the Security Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10
Managing Security Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10
Create a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10
Delete a Security Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10
Rename a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Copy a Security Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Add Groups to a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Remove Groups from a Security Set. . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Activate a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Deactivate a Security Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11
Managing Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12
Create a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12
Delete a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12
Rename a Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12
Copy a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12
Add Members to a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13
Modify a Group Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-14
Remove Members from a Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-14
9 RADIUS Server Configuration
Displaying RADIUS Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
Configuring a RADIUS Server on the Switch. . . . . . . . . . . . . . . . . . . . . . . . 9-3
10 Event Log Configuration
Starting and Stopping Event Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
Displaying the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
Filtering the Event Log Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3
Controlling Messages in the Output Stream . . . . . . . . . . . . . . . . . . . . 10-3
Managing the Event Log Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3
Configure the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
Display the Event Log Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
Restore the Event Log Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
Clearing the Event Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5
Logging to a Remote Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6
Creating and Downloading a Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7
11 Call Home Configuration
Call Home Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1
Call Home Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
Call Home Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
Technical Support Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4
viii 59270-00 A
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
S
Configuring the Call Home Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5
Managing the Call Home Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6
Displaying Call Home Database Information. . . . . . . . . . . . . . . . . . . . 11-7
Creating a Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-9
Deleting a Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-10
Modifying a Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-11
Renaming a Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12
Copying a Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12
Adding a Data Capture Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 11-13
Modifying a Data Capture Configuration . . . . . . . . . . . . . . . . . . . . . . . 11-14
Deleting a Data Capture Configuration . . . . . . . . . . . . . . . . . . . . . . . . 11-15
Testing a Call Home Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-15
Changing SMTP Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-16
Clearing the Call Home Message Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . 11-16
Resetting the Call Home Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-16
12 Simple Network Management Protocol Configuration
Managing the SNMP Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2
Displaying SNMP Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
Modifying the SNMP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
Resetting the SNMP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-5
Managing the SNMP Version 3 Configuration . . . . . . . . . . . . . . . . . . . . . . . 12-6
Create an SNMP Version 3 User Account. . . . . . . . . . . . . . . . . . . . . . 12-7
Display SNMP Version 3 User Accounts. . . . . . . . . . . . . . . . . . . . . . . 12-7
Modify an SNMP Version 3 User Account. . . . . . . . . . . . . . . . . . . . . . 12-8
13 Command Reference
Access Authority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1
Syntax and Keywords. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
Notes and Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
Command Listing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3
Alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4
Callhome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6
Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-10
Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-13
Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-17
Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-20
Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-21
Firmware Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-22
59270-00 A ix
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
A
Group. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-24
Hardreset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-32
Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-33
History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-34
Hotreset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-35
Image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-36
Ipsec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-39
Ipsec Association. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-41
Ipsec List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-45
Ipsec Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-48
Lip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-52
Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-53
Passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-54
Ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-55
Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-56
Ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-60
Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-61
Reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-62
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-73
Securityset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-77
Set Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-80
Set Beacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-81
Set Config Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-82
Set Config Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-86
Set Config Security Portbinding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-88
Set Config Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-89
Set Config Threshold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-91
Set Config Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-93
Set Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-95
Set Pagebreak. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-99
Set Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-101
Set Setup Callhome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-103
Set Setup Radius. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-106
Set Setup Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-110
Set Setup SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-113
Set Setup System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-117
Set Switch State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-125
Set Timezone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-126
Show About. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-127
x 59270-00 A
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
S
Show Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-129
Show Broadcast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-130
Show Chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-131
Show Config Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-132
Show Config Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-133
Show Config Security Portbinding. . . . . . . . . . . . . . . . . . . . . . . . . . . .13-134
Show Config Switch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-135
Show Config Threshold. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-136
Show Config Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-137
Show Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-138
Show Donor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-139
Show Fabric. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-140
Show FDMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-141
Show Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-142
Show Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-143
Show LSDB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-146
Show Mem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-147
Show Ns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-148
Show Pagebreak. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-150
Show Perf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-151
Show Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-154
Show Postlog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-159
Show Setup Callhome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-160
Show Setup Mfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-161
Show Setup Radius. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-162
Show Setup Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-163
Show Setup Snmp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-164
Show Setup System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-165
Show Steering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-168
Show Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-169
Show System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-171
Show Testlog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-172
Show Timezone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-173
Show Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-174
Show Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-175
Show Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-176
Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-178
Snmpv3user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-179
Test Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-181
59270-00 A xi
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
A
Test Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-182
Test Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-185
Test Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-186
Uptime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-188
User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-189
Whoami . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-192
Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-193
Zoneset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-196
Zoning Active. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-199
Zoning Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-200
Zoning Clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-201
Zoning Configured. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-202
Zoning Delete Orphans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-203
Zoning Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-204
Zoning Edited . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-205
Zoning History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-206
Zoning Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-207
Zoning List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-208
Zoning Merged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-209
Zoning Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-210
Zoning Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-211
Index
List of Tables
Table Page
1-1 Command-Line Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
2-1 Factory User Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
4-1 Heartbeat LED Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
4-2 Switch Reset Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
10-1 Event Log Message Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
13-1 Data Capture Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-10
13-2 ISL Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-25
13-3 Port Group Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-26
13-4 MS Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-27
13-5 Group Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-28
13-6 Association Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-41
13-7 Policy Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-48
13-8 Profile Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-56
13-9 Call Home Service Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-65
13-10 Switch Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-66
13-11 Port Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-67
xii 59270-00 A
SANbox 3810 Fibre Channel Switch
Command Line Interface Guide
S
13-12 Port Threshold Alarm Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-68
13-13 Zoning Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-69
13-14 SNMP Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-69
13-15 RADIUS Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-70
13-16 Switch Services Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-70
13-17 System Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-71
13-18 Security Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-71
13-19 Port Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-82
13-20 Security Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-86
13-21 Port Binding Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-88
13-22 Switch Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-89
13-23 Port Alarm Threshold Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-91
13-24 Zoning Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-93
13-25 Call Home Service Configuration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-103
13-26 Common RADIUS Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-106
13-27 Specific RADIUS Server Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . .13-107
13-28 Switch Services Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-110
13-29 SNMP Common Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-113
13-30 SNMP Trap Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-114
13-31 DNS Host Name Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-117
13-32 IP Version 4 Ethernet Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . 13-118
13-33 IP Version 6 Ethernet Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . 13-118
13-34 Event Logging Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-119
13-35 NTP Server Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-119
13-36 Timer Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-120
13-37 Show About Display Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-127
13-38 Log Monitoring Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-143
13-39 Show Port Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-154
13-40 Switch Operational Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-169
13-41 Show Version Display Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-176
13-42 SNMP Version 3 User Account Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-179
13-43 Port Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-183
13-44 Switch Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-187
13-45 Zoning Database Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-207
59270-00 A xiii
Preface
This guide describes the features and use of the command line interface for
SANbox
®
3810 Fibre Channel switches running firmware version 7.4. The
SANbox 3810 switch is a standalone, 8-port, 8-Gbps Fibre Channel switch with a
single power supply.
This preface describes the intended audience, related materials, and technical
support. This guide is organized as follows:
î‚„ Section 1 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 2 describes the management of user accounts and passwords.
î‚„ Section 3 describes configuring the switch network configuration.
î‚„ Section 4 describes managing the switch configuration, setting the date and
time, backing up and restoring the switch configuration, resetting the switch,
and installing firmware.
î‚„ Section 5 describes port configurations, resetting a port, initializing a port
loop, configuring port threshold alarms, and testing ports.
î‚„ Section 6 describes managing the zoning database.
î‚„ Section 7 describes managing connection security.
î‚„ Section 8 describes managing device security.
î‚„ Section 9 describes managing the Remote Authentication Dial-In User
Service (RADIUS) server.
î‚„ Section 10 describes events and event logging.
î‚„ Section 11 describes managing Call Home email notification.
î‚„ 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.
An index is also provided.
Preface
Intended Audience
xiv 59270-00 A
S
Intended Audience
This guide is intended for individuals who are responsible for installing and
servicing Fibre Channel equipment using the command line interface.
Related Materials
The following manuals and materials are referenced in the text and/or provide
additional information.
î‚„ SANbox 3810 Fibre Channel Switch Installation Guide, publication number
59268-00
î‚„ SANbox 3810 QuickTools Switch Management User Guide, publication
number 59269-00
î‚„ QLogic Fibre Channel Switch Event Message Guide, publication number
59060-07
î‚„ SANbox Simple Network Management Protocol Reference Guide,
publication number, 59047-10
î‚„ CIM Agent Reference Guide, publication number 59223-03
î‚„ QLogic Switch Interoperability Guide. This PDF document can be
downloaded at http://www.qlogic.com/interoperability/interoperability.aspx.
î‚„ 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
Standard (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.
Preface
Technical Support
59270-00 A xv
A
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.
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours excluding QLogic Observed Holidays.
Training
QLogic offers training for technical professionals for all iSCSI, InfiniBand, and
Fibre Channel products. From the main QLogic web page at www.qlogic.com
,
click the Education and Resources tab at the top, then click the Education &
Training tab on the left. The QLogic Global Training Portal offers online courses,
certification exams, and scheduling of in-person training.
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 e-mail at
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:
Support contact information for other regions of the world is available at the
QLogic website: http://support.qlogic.com
The QLogic knowledge database contains troubleshooting information for the
QLogic adapters. Access the data base from the QLogic web site,
www.qlogic.com
. Click the Support tab, Use the search engine at the top of the
page to look for specific troubleshooting information.
Web http://support.qlogic.com
North America Contact Information
Email support@qlogic.com
Phone (952) 932-4040
Preface
Technical Support
xvi 59270-00 A
S
Notes
59270-00 A 1-1
1 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
Command Line Interface Usage
Logging In to the Switch
1-2 59270-00 A
S
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. Enter an account name and password. The default account name is admin,
and its password is password.
switch login:admin
password: xxxxxxxx
The following warning appears when you log in for the first time:
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, do the following:
1. Configure the workstation port with the following settings:
î‚„ 9600 baud
î‚„ 8-bit character
î‚„ 1 stop bit
î‚„ No parity
2. Enter an account name and password when prompted. The default account
name is admin, and its password is password.
Command Line Interface Usage
Opening and Closing an Admin Session
59270-00 A 1-3
A
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
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.
Command Line Interface Usage
Entering Commands
1-4 59270-00 A
S
Entering Commands
The command-line completion feature makes entering and repeating commands
easier. Table 1-1 describes the command-line completion keystrokes.
Getting Help
To display help for a command, enter the Help command followed by the
command you are inquiring about. 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]
Table 1-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.
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.
/