Qlogic CLI Guide SAN Switch Module 59243-00 A
Qlogic CLI Guide SAN Switch Module 59243-00 A
Qlogic CLI Guide SAN Switch Module 59243-00 A
Simplify
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Firmware Version 6.5
59243-00 A
Page i
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter 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. IBM and IBM BladeCenter are trademarks or registred trademarks of International Business Machines Corporation. QLogic, SANbox, Enterprise Fabric Suite 2007, QuickTools, and SANdoctor are trademarks or registered trademarks of QLogic Corporation. Microsoft, Windows 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.
20002007 QLogic Corporation. All Rights Reserved Worldwide. First Published: February 2007 QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000
Page ii
59243-00 A
Table of Contents
Section 1
1.1 1.2 1.3 1.3.1 1.3.2 1.3.3
Introduction
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1-2 1-3 1-3 1-3 1-4
Section 2
2.1 2.2 2.3 2.4 2.5 2.6 2.7
Section 3
3.1 3.2 3.3
Section 4
4.1 4.2 4.3 4.4 4.5
Section 5
5.1 5.1.1 5.1.2 5.1.3
59243-00 A
Page iii
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
S
5-4 5-5 5-5 5-6 5-7 5-8 5-9 5-11 5-11 5-11 5-12 5-12 5-12 5-14 5-14 5-14 5-15 5-15 5-17 5-17 5-19 5-19 5-20 5-21 5-22 5-23 5-24 5-24
5.1.4 5.1.4.1 5.1.4.2 5.1.4.3 5.1.5 5.1.6 5.2 5.3 5.3.1 5.3.2 5.3.3 5.3.4 5.3.5 5.3.6 5.3.6.1 5.3.6.2 5.3.6.3 5.4 5.5 5.6 5.7 5.8 5.8.1 5.8.2 5.8.3 5.9 5.9.1 5.9.2
Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I/O Module Configuration Parameters . . . . . . . . . . . . . . . . . . . . Zoning Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . Security Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . Hardware Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Firmware Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing I/O Module Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing I/O Module Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display a List of I/O Module Configurations . . . . . . . . . . . . . . . . . . . . Activate an I/O Module Configuration . . . . . . . . . . . . . . . . . . . . . . . . . Copy an I/O Module Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete an I/O Module Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . Modify an I/O Module Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . Back Up and Restore an I/O Module Configuration . . . . . . . . . . . . . . Creating the Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Downloading the Configuration File . . . . . . . . . . . . . . . . . . . . . . Restoring the Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . Converting the SAN Switch Module to a Transparent I/O Module . . . . . . . . Paging an I/O Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting the Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Resetting an I/O Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Nondisruptive Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . One-Step Firmware Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Custom Firmware Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing I/O Module Feature Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . Display Feature License Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Install a Feature License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Section 6
6.1 6.1.1 6.1.2 6.1.3 6.1.4 6.1.5 6.2 6.3 6.4 6.5
Port Configuration
Displaying Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port Operational Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Port Threshold Alarm Configuration Parameters. . . . . . . . . . . . . . . . . Port Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transceiver Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modifying Port Operating Characteristics. . . . . . . . . . . . . . . . . . . . . . . . . . . Port Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Resetting a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring Port Threshold Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 6-2 6-4 6-5 6-6 6-7 6-8 6-11 6-12 6-13
Page iv
59243-00 A
A
6.6 6.6.1 6.6.2 6.6.3 6.6.4 6.7 6.8
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Testing a Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Offline Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display Port Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cancel a Port Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Port Licenses on a 10-Port 4 Gb SAN Switch Module. . . . . . . . . . . Extending Port Transmission Distance. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Section 7
7.1 7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.2 7.3 7.4 7.5 7.6 7.6.1 7.6.2 7.6.3 7.6.4 7.6.5 7.6.6 7.6.7 7.6.8 7.7 7.7.1 7.7.2 7.7.3 7.7.4 7.7.5 7.7.6 7.8 7.8.1 7.8.2
Zoning Configuration
Displaying Zoning Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . Configured Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . Active Zone Set Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Zone Set Membership Information . . . . . . . . . . . . . . . . . . . . . . . . . . . Zone Membership Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Alias and Alias Membership Information . . . . . . . . . . . . . . . . . . . . . . . Zoning Modification History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Zoning Database Limits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the Zoning Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modifying the Zoning Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Resetting the Zoning Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Removing Inactive Zone Sets, Zones, and Aliases . . . . . . . . . . . . . . . . . . . Managing Zone Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Create a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rename a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copy a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Add Zones to a Zone Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remove Zones from a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Activate a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deactivate a Zone Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Zones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Create a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rename a Zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copy a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Add Members to a Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remove Members from a Zone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Managing Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Create an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 7-2 7-4 7-5 7-5 7-6 7-7 7-8 7-9 7-11 7-12 7-12 7-13 7-13 7-13 7-14 7-14 7-14 7-14 7-15 7-15 7-15 7-15 7-16 7-16 7-16 7-16 7-17 7-18 7-18 7-18
59243-00 A
Page v
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
S
7-18 7-19 7-19 7-19
Rename an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copy an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remove Members from an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Section 8
8.1 8.2 8.3
Section 9
9.1 9.1.1 9.1.2 9.1.3 9.1.4 9.1.5 9.1.6 9.2 9.3 9.4 9.5 9.5.1 9.5.2 9.5.3 9.5.4 9.5.5 9.5.6 9.5.7 9.5.8 9.6 9.6.1 9.6.2 9.6.3 9.6.4 9.6.5 9.6.6 9.6.7
Page vi
59243-00 A
A
10.2
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
10-3
Section 11
11.1 11.2 11.2.1 11.2.2 11.3 11.3.1 11.3.2 11.3.3 11.4 11.5 11.6
59243-00 A
Page vii
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-34 Lip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-37 Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-38 Passwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-39 Ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-40 Ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-41 Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-42 Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-43 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-51 Securityset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-55 Set Alarm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-58 Set Beacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-59 Set Config Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-60 Set Config Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-66 Set Config Security Portbinding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-68 Set Config Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-69 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-91 Set Setup System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-94 Set Switch State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-96 Set Timezone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-97 Show About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-98 Show Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-99 Show Broadcast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-100 Show Chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-101 Show Config Port. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-102 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
Page viii
59243-00 A
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Show Fabric. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-110 Show FDMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-111 Show Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-113 Show Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-114 Show LSDB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-118 Show Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-119 Show Mem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-123 Show NS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-124 Show Pagebreak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-126 Show Perf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-127 Show Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-130 Show Post Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-135 Show Setup Mfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-136 Show Setup Radius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-137 Show Setup Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-138 Show Setup SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-139 Show Setup System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-140 Show Steering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-141 Show Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-142 Show Timezone. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-144 Show Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-145 Show Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-147 Show Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-148 Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-149 Test Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-150 Test Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-151 Test Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-153 Uptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-154 User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-155 Whoami . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-158 Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-159 Zoneset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-163 Zoning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-166
Index
59243-00 A
Page ix
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
List of Tables
Table 2-1 3-1 5-1 5-2 13-1 13-2 13-3 13-4 13-5 13-6 13-7 13-8 13-9 13-10 13-11 13-12 13-13 13-14 13-15 13-16 13-17 13-18 13-19 13-20 13-21 13-22 13-23 13-24 13-25 13-26 13-27 13-28 13-29 A-1 Page Command-Line Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Factory User Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Heartbeat LED Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7 I/O Module Reset Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19 ISL Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-23 Port Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-24 MS Group Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-25 Group Member Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-26 I/O Module Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-45 Port Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-46 Port Threshold Alarm Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-47 Zoning Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-48 SNMP Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-48 RADIUS Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-49 Services Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-49 System Configuration Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-50 Security Configuration Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-50 Port Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-61 Security Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-66 Port Binding Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-68 I/O Module Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-69 Port Alarm Threshold Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-72 Zoning Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-74 RADIUS Service Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-84 I/O Module Services Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-87 SNMP Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-91 System Configuration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-94 Log Monitoring Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-114 Transceiver Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-119 Show Port Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-130 I/O Module Operational Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-142 Port Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-151 Zoning Database Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-167 Port Mapping For Server Units. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Page x
59243-00 A
Section 1
Introduction
This guide describes the features and use of the command line interface for the QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter running firmware version 6.5. The SAN Switch Module is a 20-port Fibre Channel I/O module with six external ports and 14 internal ports. The 10-port I/O module has three active external ports and seven active internal ports. You can choose which three of the six external ports are active, or with a license, activate all ports. This product is referred to as the SAN Switch Module or I/O module throughout this guide. This guide is organized as follows: Section 1 describes the I/O module and features, the intended audience, related materials, and technical support. Section 2 describes logging on and off of an I/O module, opening and closing an Admin session, entering commands, getting help, paging an I/O module, setting page breaks, and loading and retrieving files. Section 3 describes the management of user accounts and passwords. Section 4 describes configuring the I/O module network connection. Section 5 describes managing the I/O module configuration, setting the date and time, backing up and restoring the switch configuration, resetting the I/O module, 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. An index is also provided.
59243-00 A
1-1
1.1
Intended Audience
This guide is intended for individuals who are responsible for installing and servicing Fibre Channel equipment using the command line interface.
1.2
Related Materials
The following manuals and materials are referenced in the text and/or provide additional information. QLogic 4 Gb Intelligent Pass-thru Module and SAN Switch Module Installation Guide, IBM part number 43W7814 QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter QuickTools Switch Management Guide, 59241-00 QLogic 4 Gb Intelligent Pass-thru Module and SAN Switch Module for IBM BladeCenter Enterprise Fabric Suite 2007 User Guide, 59242-00 QLogic 4 Gb Intelligent Pass-thru Module for IBM BladeCenter QuickTools TE Switch Management Guide, 59240-00 QLogic 4 Gb Intelligent Pass-thru Module for IBM BladeCenter Command Line Interface Guide, 59245-00 QLogic Fibre Channel Switch Event Message Guide, 59060-03 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 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.
1-2
59243-00 A
A
1.3
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.3.1
Availability
QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays.
1.3.2
Training
QLogic offers certification training for the technical professional for both the SANblade HBAs and the QLogic 4 Gb 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.
59243-00 A
1-3
S
QLogic Corporation 12984 Valley View Road Eden Prairie, MN 55344-3657 USA www.qlogic.com support.qlogic.com support@qlogic.com tech.training@qlogic.com
1.3.3
Contact Information
Support Headquarters
QLogic Web Site Technical Support Web Site Technical Support Email Technical Training Email North American Region Email Phone Fax Europe, Middle East, and Africa Region Email Phone Numbers by Language
emeasupport@qlogic.com +353 1 6924960 +353 1 6924961 +353 1 6924962 +353 1 6924963 +353 1 6924964 +353 1 6924965 - English - Franais - Deutsch - Espaol - Portugus - Italiano
Asia Pacific Region Email Phone Numbers by Language apacsupport@qlogic.com +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 Phone Numbers by Language calasupport@qlogic.com +52 55 5278 7016 - English +52 55 5278 7017 - Espaol +52 55 5278 7015 - Portugus
1-4
59243-00 A
Section 2
59243-00 A
2-1
2.1
1.
Open a command-line window on the network management workstation and log in by entering the Telnet command with the IP address for the corresponding bay: For I/O module bay 3: telnet 192.168.70.129 For I/O module bay 4: telnet 192.168.70.130 Multi-Switch Interconnect Modules also support bays 7, 8, 9, and 10: For I/O module bay 7: telnet 192.168.70.133 For I/O module bay 8: telnet 192.168.70.134 For I/O module bay 9: telnet 192.168.70.135 For I/O module bay 10: telnet 192.168.70.136
2.
At the Login prompt, type the initial default user account, USERID. At the Password prompt, type the initial default password, PASSW0RD (the sixth character is a zero, not the letter O). The user account and password are case sensitive.
This user account provides full access to the I/O module and its configuration. After planning your fabric management needs and creating your own user accounts, consider changing the password for this account. Refer to Access Authority on page 13-1 for more information about authority levels. See the User on page 13-155 for information about creating user accounts. An I/O module 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 sessions 6 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
59243-00 A
A
2.2
59243-00 A
2-3
2.3
Entering Commands
The command-line completion feature makes entering and repeating commands easier. Table 2-1 describes the command-line completion keystrokes. Table 2-1. Command-Line Completion
Keystroke Tab Effect 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. Scrolls backward through the list of previously entered commands. Scrolls forward through the list of previously entered commands. Moves the cursor to the beginning of the command line Moves the cursor to the end of the command line. Clears the command line.
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.
QLogic4GbT #> 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-4
59243-00 A
A
2.5
59243-00 A
2-5
2.6
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.
2-6
59243-00 A
A
QLogic4GbT #> create support
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 I/O module to your workstation as shown in the following example:
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 I/O module to the workstation, do the following: 1. 2. 3. Open a terminal window and move to the directory where you want to download the support file. Enter the FTP command and the I/O module IP address or symbolic name.
>ftp 10.0.0.1
When prompted for a user and password, enter the FTP account name and password (images, images).
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
59243-00 A
2-7
2.7
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
2-8
59243-00 A
A
1. 2.
>ftp 192.168.70.129
To upload a file from the workstation to the I/O module, do the following Enter the FTP command and the I/O module IP address or symbolic name. 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
59243-00 A
2-9
Notes
2-10
59243-00 A
Section 3
images
images
The sixth character in the initial default password character is a zero, not the letter O.
This section describes the following user account configuration tasks: Displaying User Account Information Creating User Accounts Modifying User Accounts and Passwords
59243-00 A
3-1
3.1
The following example displays user accounts that are logged on to the I/O module:
QLogic4GbT (admin) #> user list User ---USERID@OB-session1 USERID@OB-session2 snmp@OB-session3 snmp@IB-session4 user1@OB-session5 Ethernet Addr-Port -----------------10.20.68.108-1031 10.20.68.108-1034 Unknown Unknown Unknown Logged in Since --------------day month date time year day month date time year day month date time year day month date time year day month date time year
3-2
59243-00 A
A
3.2
please confirm account password: ******* set account expiration in days (0-2000, 0=never): [0] 100 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
59243-00 A
3-3
3.3
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]
In the following example, the USERID account changes the password for the user account named user2.
QLogic4GbT #> admin start QLogic4GbT (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
59243-00 A
Section 4
59243-00 A
4-1
4.1
------ ---- --- ------010100 N 010200 N 010300 N 010900 N 010a00 N 010b00 N 010c00 N Port ID Port Type COS PortWWN
21:00:00:09:6b:36:32:d7 20:00:00:09:6b:36:32:d7 21:01:00:e0:8b:a5:a9:6e 20:01:00:e0:8b:a5:a9:6e 21:01:00:e0:8b:a0:ff:35 20:01:00:e0:8b:a0:ff:35 21:01:00:e0:8b:a5:16:6f 20:01:00:e0:8b:a5:16:6f 21:01:00:e0:8b:a5:f3:70 20:01:00:e0:8b:a5:f3:70 21:01:00:e0:8b:a5:31:6f 20:01:00:e0:8b:a5:31:6f
NodeWWN -------
99 (0x63) 630000 N 99 (0x63) 630001 N 99 (0x63) 630002 N 99 (0x63) 630004 N 99 (0x63) 630008 N 99 (0x63) 63000f N 99 (0x63) 630010 N 99 (0x63) 630017 N 99 (0x63) 630800 N 99 (0x63) 630900 N
2,3 20:00:00:c0:dd:0d:2b:54 10:00:00:c0:dd:0d:2b:54 2,3 10:00:00:00:c9:56:49:ca 20:00:00:00:c9:56:49:ca 3 3 3 3 3 3 3 3 21:00:00:09:6b:36:32:d6 20:00:00:09:6b:36:32:d6 21:00:00:e0:8b:85:16:6f 20:00:00:e0:8b:85:16:6f 21:00:00:e0:8b:85:f3:70 20:00:00:e0:8b:85:f3:70 21:00:00:e0:8b:85:a9:6e 20:00:00:e0:8b:85:a9:6e 21:00:00:e0:8b:85:31:6f 20:00:00:e0:8b:85:31:6f 21:00:00:e0:8b:80:ff:35 20:00:00:e0:8b:80:ff:35 20:02:00:a0:b8:0f:7f:9f 20:02:00:a0:b8:0f:7f:9e 20:03:00:a0:b8:0f:7f:9f 20:02:00:a0:b8:0f:7f:9e
4-2
59243-00 A
A
4.2
The Show Setup System command displays the network configuration as shown in the following example:
QLogic4GbT #> show setup system System Information -----------------Eth0NetworkDiscovery Eth0NetworkAddress Eth0NetworkMask Eth0GatewayAddress AdminTimeout InactivityTimeout LocalLogEnabled RemoteLogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled 0 True False 10.0.0.254 True 51.68.85.102 True Static 192.168.70.129 255.255.252.0 0.0.0.0 30
59243-00 A
4-3
4.3
(dec value 0-1440 minutes, 0=never) [0 (dec value 0-1440 minutes, 0=never) [0 (True / False) (True / False) (dot-notated IP Address) (True / False) (dot-notated IP Address) (True / False) [True [False [False [True
[10.0.0.254] [10.0.0.254]
Do you want to save and activate this system setup? (y/n): [n] y
4-4
59243-00 A
A
4.4
If the I/O module was unreachable, you would see the following display.
QLogic4GbT #> ping 10.20.11.57 Ping command issued. Waiting for response... No response from 10.20.11.57. Unreachable.
4.5
You can verify Fibre Channel connections between the I/O module and the fabric and display routing information. Enter the Fcping command to verify a Fibre Channel connection to an I/O module or a device as shown in the following example. The target device can be defined as a Fibre Channel address or a WWN.
QLogic4GbT #> fcping 970400 count 3 28 bytes from local switch to 0x970400 time = 10 usec 28 bytes from local switch to 0x970400 time = 11 usec 28 bytes from local switch to 0x970400 time = 119 usec
59243-00 A
4-5
4 Network and Fabric Configuration Verifying and Tracing Fibre Channel Connections
Enter the Fctrace command to display Fibre Channel routing information between two devices as shown in the following example. The devices can be defined as Fibre Channel addresses or WWNs.
QLogic4GbT#> fctrace 970400 970e00 hops 5 36 bytes from 0x970400 to 0x970e00, 5 hops max Domain -----97 97 Ingress Port WWN ---------------20:04:00:c0:dd:02:cc:2e 20:0e:00:c0:dd:02:cc:2e Port ---4 14 Egress Port WWN --------------20:0e:00:c0:dd:02:cc:2e 20:04:00:c0:dd:02:cc:2e Port ---14 4
4-6
59243-00 A
Section 5
59243-00 A
5-1
5.1.1
5-2
59243-00 A
A
5.1.2
The column titles are as follows: PIDProcess identifier PPIDParent process identifier %CPUPercentage CPU usage TIMEActual processing time ELAPSEDElapsed time since the process started COMMANDThe command that initiated the process.
59243-00 A
5-3
5.1.3
5.1.4
Configuration Information
The Show Config command displays a variety of configuration information at the port and switch levels. In addition to the basic I/O module configurations, the Show Config command displays parameters that control how data is maintained in the security and zoning databases. The Show Config command displays the following types of information: I/O Module Configuration Parameters Zoning Configuration Parameters Security Configuration Parameters Refer to Displaying Port Information on page 6-1 for information about displaying port configuration information.
5-4
59243-00 A
A
5.1.4.1
5.1.4.2
59243-00 A
5-5
5.1.4.3
Enter the Show Config Security command to display security configuration and port binding parameters. These parameters determine how security is applied to the I/O module. Refer to Table 13-15 for a description of the I/O module security configuration parameters. Refer to Table 13-16 for a description of the port binding parameters.
QLogic4GbT #> show config security Configuration Name: default ------------------Switch Security Configuration Information ----------------------------------------FabricBindingEnabled AutoSave Port ---0 15 16 17 18 19 1 2 3 4 5 6 7 8 9 10 11 12 13 14 False True Binding Status -------------False False False False False False False False False False False False False False False False False False False False WWN --No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found.
5-6
59243-00 A
A
5.1.5
Hardware Information
Enter the Show Chassis command to display the status of the I/O module hardware including power supplies, internal temperature, and Heartbeat LED status. The following is an example of the Show Chassis command:
QLogic4GbT #> show chassis Chassis Information ------------------BoardTemp (1) - Degrees Celsius PowerSupplyStatus (1) HeartBeatCode HeartBeatStatus 36 Good 1 Normal
The HeartBeatCode and HeartBeatStatus entries indicate the Power-on Self Test (POST) results revealed by the Heartbeat LED blink patterns. The result is normal operation or a blink pattern indicating a critical error as described in Table 5-1. Refer to your QLogic 4 Gb Intelligent Pass-thru Module and SAN Switch Module Installation Guide for more information about the Heartbeat LED and its blink patterns. Table 5-1. Heartbeat LED Activity
HeartBeatCodeHeartBeatStatus 1Normal 2AppDied 3PostFailed 4CorruptFilesystem 5Overheating Description One blink per secondNormal operation Two blink clusterInternal firmware failure Three blink clusterFatal POST error Four blink clusterConfiguration file system error Five blink cluster Over temperature
59243-00 A
5-7
5.1.6
Firmware Information
Enter the Show Version command to display a summary of I/O module identity information including the firmware version. The following is an example of the Show Version command:
QLogic4GbT #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * *
***************************************************** SystemDescription EthNetworkAddress MACAddress WorldWideName ChassisSerialNumber SymbolicName ActiveSWVersion ActiveTimestamp DiagnosticsStatus QLogic(R)20 Port 4Gb SAN Switch for IBM BladeCenter(R) 10.20.11.192 (use 'set setup system' to update) 00:c0:dd:00:06:07 10:00:00:c0:dd:00:06:07 11S0632A00127 QLogic4GbT V6.5.x.x.xx.xx day month date time year Passed
5-8
59243-00 A
A
5.2
Enter the Show Setup Services command to display the current I/O module service status as shown in the following example:
QLogic4GbT #> show setup services System Services ----------------------------TelnetEnabled SSHEnabled GUIMgmtEnabled SSLEnabled EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled True False True False True True True True True True
59243-00 A
5-9
Enter the Set Setup Services command within an Admin session to configure the I/O module services as shown in the following example1:
QLogic4GbT #> admin start QLogic4GbT (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. PLEASE NOTE: ----------* Further configuration may be required after enabling a service. * If services are disabled, the connection to the switch may be lost. * When enabling SSL, please verify that the date/time settings on this switch and the workstation from where the SSL connection will be started match, and then a new certificate may need to be created to ensure a secure connection to this switch. TelnetEnabled SSHEnabled GUIMgmtEnabled SSLEnabled EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) [True ] [False] [True ] [False] [True ] [True ] [False] [False] [True ] [True ]
Do you want to save and activate this services setup? (y/n): [y]
The SSH and SSL services require the Fabric Security license key.
5-10
59243-00 A
A
5.3
5.3.2
59243-00 A
5-11
5.3.3
The Config Save command saves the changes you made during the Config Edit session. In this case, changes to the configuration named Default are being saved to a new configuration named config_10132003. However, the new configuration does not take effect until you activate it with the Config Activate command:
QLogic4GbT (admin-config)#> config save config_10132003 QLogic4GbT (admin)#> config activate config_10132003 QLogic4GbT (admin)#> admin end
The Admin End command releases the Admin session for other administrators when you are done making changes to the I/O module.
5-12
59243-00 A
A
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config switch
The following is an example of the Set Config Switch command. Refer to Table 13-17 for a description of the I/O module configuration parameters.
A list of attributes with formatting and default values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. TransparentMode AdminState BroadcastEnabled InbandEnabled FDMIEnabled FDMIEntries DefaultDomainID DomainIDLock SymbolicName R_A_TOV E_D_TOV PrincipalPriority ConfigDescription InteropMode (True / False) (1=Online, 2=Offline, 3=Diagnostics) (True / False) (True / False) (True / False) (decimal value, 0-1000) (decimal value, 1-239) (True / False) (string, max=32 chars) (decimal value, 100-100000 msec) (decimal value, 10-20000 msec) (decimal value, 1-255) (string, max=64 chars) (0=Standard) [False [Online [True [True [True [1000 [2 [False [SANbox [10000 [2000 [254 [Standard ] ] ] ] ] ] ] ] ] ] ] ] ]
[Default Config]
To make temporary changes to the I/O module administrative state, enter the Set Switch State command.
59243-00 A
5-13
5.3.6
The configdata file contains the following I/O module configuration information: All named I/O module configurations including port, switch, port threshold alarm, and zoning configurations components. All SNMP and network information defined with the Set Setup command. The zoning database includes all zone sets, zones, and aliases. The security database except the group primary and secondary secrets.
5.3.6.2
You should rename the configdata file on your workstation with the I/O module name and date, config_switch_169_10112003, for example.
5-14
59243-00 A
A
5.3.6.3
5 I/O Module Configuration Converting the SAN Switch Module to a Transparent I/O Module
The restore process replaces all configuration information on the I/O module and afterwards the I/O module is automatically reset. To restore the I/O module, open a Telnet session, then enter the Config Restore command from within an Admin session as shown:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config restore The switch will be reset after restoring the configuration. Please confirm (y/n): [n] y Alarm Msg: [day month date time year][A1005.0021][SM][Configuration is being restored - this could take several minutes] Alarm Msg: [day month date time year][A1000.000A][SM][The switch will be reset in 3 seconds due to a config restore] QLogic4GbT (admin) #> Alarm Msg: [day month date time year][A1000.0005][SM][The switch is being reset]
5.4
59243-00 A
5-15
5 I/O Module Configuration Converting the SAN Switch Module to a Transparent I/O Module
The Pass-thru Module concentrates multiple blade servers into the external ports. The external ports connect to Fibre Channel switches that support N-Port ID Virtualization (NPIV). The internal ports connect directly to server blades through the BladeCenter unit. The Pass-thru Module expands the fabric because, unlike a Fibre Channel switch, it does not count against the fabric domain ID limit. NOTE: After converting a SAN Switch Module to a Pass-thru Module, you must close any open QuickTools sessions.
[Default Config]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin) #> config save QLogic4GbT (admin) #> config activate
5-16
59243-00 A
A
5.5
5.6
Enter the Date command to display the date and time as show in the following example:
QLogic4GbT #> date Mon Apr 07 07:51:24 200x
Enter the Date command within an Admin session to set the date and time as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> date 013110152025 QLogic4GbT (admin) #> date Fri Jan 31 10:15:03 UTC 2025
59243-00 A
5-17
S
#> admin start
To configure the I/O module to use an NTP server, enter the Set Setup System command to enable the NTP client and to specify the NTP server IP address.
QLogic4GbT QLogic4GbT (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. FCNetworkDiscovery AdminTimeout InactivityTimeout LocalLogEnabled RemoteLogEnabled NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled (1=Static, 2=Bootp, 3=Dhcp, 4=Rarp) (dec value 0-1440 minutes, 0=never) (dec value 0-1440 minutes, 0=never) (True / False) (True / False) (True / False) (dot-notated IP Address) (True / False) [Static [30 [0 [True [False [10.0.0.254 [False [10.0.0.254 [True ] ] ] ] ] ] ] True ] 10.2.3.4 ]
Do you want to save and activate this services setup? (y/n): [n] y System setup saved and activated.
5-18
59243-00 A
A
5.7
Description
Activates pending firmware Disrupts I/O traffic Enterprise Fabric Suite 2007 and QuickTools sessions reconnect afterwards Clears the event log Closes all management sessions Power-on self test
5.8
Installing Firmware
New firmware becomes available periodically either on CD-ROM or from the web site. Installing firmware on an I/O module involves the following steps: 1. 2. 3. Download the firmware image file to the I/O module. Unpack the firmware image file. Activate the new firmware. The activation can be disruptive or non-disruptive. Refer to Nondisruptive Activation on page 5-20 for information about the conditions for a non-disruptive activation.
The Firmware Install and the Image Install commands automate the firmware installation process and perform a disruptive activation as described in One-Step Firmware Installation on page 5-21. To perform a nondisruptive activation, refer to Custom Firmware Installation on page 5-22.
59243-00 A
5-19
5.8.1
Nondisruptive Activation
You can load and activate new firmware on an I/O module disruptively or nondisruptively depending on the condition of the fabric and the commands you choose. If you attempt to perform a non-disruptive activation without satisfying the following conditions, the activation will fail. If the non-disruptive activation fails, you will usually be prompted to try again later. Otherwise, the I/O module will perform a disruptive activation. The current firmware version permits the installation and non-disruptive activation of 6.5 firmware. Refer to the 6.5 Firmware Release Notes for previous compatible firmware versions. No changes are being made to switches in the fabric including powering up, powering down, disconnecting or connecting ISLs, changing switch configurations, or installing firmware. No port on the I/O module is in the diagnostic state. No Zoning Edit sessions are open on the I/O module. No changes are being made to attached devices including powering up, powering down, disconnecting, connecting, and HBA configuration changes. Install firmware on one switch at a time in the fabric. If you are installing firmware on one switch, wait 120 seconds after the activation is complete before installing firmware on a second switch. For a fabric in which one or more switches are running firmware prior to version 6.5, only one Enterprise Fabric Suite 2007 session can be open. Ports that are stable when the non-disruptive activation begins, then change states, will be reset. When the non-disruptive activation is complete, Enterprise Fabric Suite 2007 and QuickTools sessions reconnect automatically. However, Telnet sessions must be restarted manually.
5-20
59243-00 A
A
5.8.2
2.
Enter your choice for the file transfer protocol with which to download the firmware image file. FTP requires an user account and a password; TFTP does not.
FTP or TFTP : ftp
3.
Enter your account name on the remote host (FTP only) and the IP address of the remote host. When prompted for the source file name, enter the path for the firmware image file.
User Account IP Address : johndoe : 10.0.0.254 Do you want to continue? [y/n] y
4.
When prompted to install the new firmware, enter Yes to continue or No to cancel. Entering Yes will disrupt traffic. This is the last opportunity to cancel.
About to install image. Do you want to continue? [y/n] y Connected to 10.20.20.200 (10.20.20.200). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready.
59243-00 A
5-21
5.
6.
5.8.3
The firmware will now be downloaded from the remote host to the I/O module, installed, and activated.
If your workstation has a TFTP server, you can enter the Image TFTP command to download the firmware image file.
QLogic4GbT (admin) #> image tftp ip_address filename
If your workstation has neither an FTP nor a TFTP server, open an FTP session and download the firmware image file by entering FTP commands:
>ftp ip_address or switchname user:images password: images ftp>bin ftp>put filename ftp>quit
2.
Display the list of firmware image files on the I/O module to confirm that the file was loaded.
QLogic4GbT #> admin start QLogic4GbT (admin) $> image list
3. 4.
Unpack the firmware image file to install the new firmware in flash memory.
QLogic4GbT (admin) $> image unpack filename
5-22
59243-00 A
A
5.
QLogic4GbT (admin) $> hotreset
5.9
A message will prompt you to reset the I/O module to activate the firmware. Use the Hotreset command to attempt a non-disruptive activation.
59243-00 A
5-23
5.9.1
5.9.2
5-24
59243-00 A
Section 6
Port Configuration
This section describes the following topics: Displaying Port Information Modifying Port Operating Characteristics Port Binding Resetting a Port Configuring Port Threshold Alarms Testing a Port Moving Port Licenses on a 10-Port 4 Gb SAN Switch Module Extending Port Transmission Distance
6.1
59243-00 A
6-1
6.1.1
6-2
59243-00 A
A
QLogic4GbT #> show config port 1 Configuration Name: default ----------------------------Port Number: 1 -----------AdminState LinkSpeed PortType SymbolicName ALFairness DeviceScanEnabled ForceOfflineRSCN ARB_FF InteropCredit ExtCredit FANEnabled AutoPerfTuning LCFEnabled MSEnabled NoClose IOStreamGuard VIEnabled MFSEnabled PDISCPingEnable Online Auto F Port1 False True False False 0 0 True False False True False Disabled False True True
The following example displays port configuration information for internal port 1.
59243-00 A
6-3
6.1.2
BBCR_FrameFailures 0
6-4
59243-00 A
A
6.1.3
59243-00 A
6-5
6.1.4
Port Performance
Enter the Show Perf command to display port performance in terms of the volume of data transmitted, data received, or errors. You can display continuous live performance information for one or more ports, or an instantaneous summary. The following example displays an instantaneous summary in bytes and frames. Values are expressed in thousands (K) and millions (M) of bytes or frames per second.
QLogic4GbT #> show perf Bytes/s Port ---Ext1:0 Ext2:15 Ext3:16 Ext4:17 Ext5:18 Ext6:19 Bay1 Bay2 Bay3 Bay4 Bay5 Bay6 Bay7 Bay8 Bay9 Bay10 Bay11 Bay12 Bay13 Bay14 0 49M 0 0 0 0 2M 0 1M 0 0 0 0 0 0 0 0 0 0 0 (in) ------0 3M 0 0 0 0 23M 0 25M 0 0 0 0 0 0 0 0 0 0 0 Bytes/s (out) ------Bytes/s (total) ------0 52M 0 0 0 0 26M 0 26M 0 0 0 0 0 0 0 0 0 0 0 0 32K 0 0 0 0 1K 0 972 0 0 0 0 0 0 0 0 0 0 0 Frames/s (in) -------0 2K 0 0 0 0 15K 0 16K 0 0 0 0 0 0 0 0 0 0 0 Frames/s (out) -------Frames/s (total) -------0 34K 0 0 0 0 17K 0 17K 0 0 0 0 0 0 0 0 0 0 0
6-6
59243-00 A
A
6.1.5
Transceiver Information
NOTE: The Show Media command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
Enter the Show Media command to display operational information about one or more transceivers as shown in the following example. Refer to Table 13-25 for a description of the transceiver information in the Show Media display.
QLogic4GbT #> show media 19 Port Number: 19 -----------MediaType MediaVendor MediaPartNumber MediaRevision MediaSerialNumber MediaSpeeds AZ6P51300545 1Gb/s, 2Gb/s, 4Gb/s Temp (C) Value Status HighAlarm HighWarning LowWarning LowAlarm 34.62 Normal 95.00 90.00 -25.00 -32.00 Voltage (V) 3.33 Normal 3.63 3.56 3.04 2.97 Tx Bias (mA) 7.10 Normal 13.00 12.00 3.00 2.00 Tx Pwr (mW) 0.348 Normal 0.794 0.631 0.141 0.126 Rx Pwr (mW) 0.210 Normal 1.000 0.794 0.032 0.025 400-M5-SN-S Intel Corp. TXN31115D000000
59243-00 A
6-7
6.2
DeviceScanEnable (True / False) ForceOfflineRSCN (True / False) ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable VIEnable MSEnable NoClose IOStreamGuard PDISCPingEnable (True / False) (decimal value, 0-255) (dec value, increments of 7, non-loop only) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (Enable / Disable / Auto) (True / False)
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config) #> config save QLogic4GbT (admin-config) #> config activate
6-8
59243-00 A
A
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config port 1
The following example changes the administrative state for the internal port 1:
A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. Configuring Port Number: -----------------------AdminState LinkSpeed PortType SymPortName ALFairness (1=Online, 2=Offline, 3=Diagnostics, 4=Down) (2=2Gb/s, 4=4Gb/s, A=Auto) (GL / G / F / FL / Donor) (string, max=32 chars) (True / False) [Online] offline [2Gb/s ] [GL ] [Port1 ] [False ] [True ] [False ] [False ] [0 [0 [True ] ] ] 1
DeviceScanEnable (True / False) ForceOfflineRSCN (True / False) ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable VIEnable MSEnable NoClose IOStreamGuard PDISCPingEnable (True / False) (decimal value, 0-255) (dec value, increments of 7, non-loop only) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (Enable / Disable / Auto) (True / False)
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config) #> config save QLogic4GbT (admin-config) #> config activate
59243-00 A
6-9
You can configure external ports (0, 15, 16, 17, 18, 19) as a group based on port 0, or all internal ports (114) based on port 1 using the Set Config Ports command. The following example configures the external ports based on port 0 and activates the configuration.
QLogic4GbT #> admin start QLogic4GbT (admin) config edit QLogic4GbT (admin) #> set config ports external A list of attributes with formatting and current values for the port number or port type specified at the command line will follow. Each value that is changed will be set for ALL EXTERNAL PORTS. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. Configuring all external ports (displaying values from port number: ------------------------------------------------------------------AdminState LinkSpeed PortType ALFairness (1=Online, 2=Offline, 3=Diagnostics, 4=Down) (1=1Gb/s, 2=2Gb/s, 4=4Gb/s, A=Auto) (GL / G / F / FL / Donor) (True / False) [Online] [Auto [GL [True ] ] ] 0)
DeviceScanEnable (True / False) ForceOfflineRSCN (True / False) ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable VIEnable MSEnable NoClose IOStreamGuard PDISCPingEnable (True / False) (decimal value, 0-255) (dec value, increments of 7, non-loop only) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (Enable / Disable / Auto) (True / False)
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.. QLogic4GbT (admin-config)#> config save QLogic4GbT (admin)#> config activate QLogic4GbT (admin)#> admin end
6-10
59243-00 A
A
QLogic4GbT #> admin start QLogic4GbT (admin) #> set port 0 state down
The following example temporarily changes the external port 0 administrative state to Down:
6.3
Port Binding
NOTE: Port binding requires the Fabric Security license key.
Port binding establishes up to 32 switches or devices that are permitted to log in to a particular port. Switches or devices that are not among the 32 are refused access to the port. Enter the Show Config Security Portbinding command to display the port binding configuration for all ports as shown in the following example.
IBM4GbT: admin> show config security portbinding Configuration Name: default ------------------Port ---Ext1:0 Ext2:15 Ext3:16 Ext4:17 Ext5:18 Ext6:19 Bay1 Bay2 Bay3 Bay4 Bay5 Bay6 Bay7 Bay8 Bay9 Bay10 Bay11 Bay12 Bay13 Bay14 Binding Status -------------False False False False False False False False False False False False False False False False False False False False WWN --No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found.
59243-00 A
6-11
Enter the Set Config Security Portbinding command to enable port binding for the selected port and to specify the world wide names of the authorized ports/devices. The following example enables port binding on port 0 and specifies two device world wide names.
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config security port 0 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. PortBindingEnabled (True / False)[False] true WWN WWN WWN (N=None / WWN)[None ] 10:00:00:c0:dd:00:b9:f9 (N=None / WWN)[None ] 10:00:00:c0:dd:00:b9:f8 (N=None / WWN)[None ] n
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.
6.4
Resetting a Port
Enter the Reset Port command to reinitialize one or more ports and to discard any temporary changes that have been made to the administrative state or link speed. The following example reinitializes port 15:
QLogic4GbT #> reset port 15
6-12
59243-00 A
A
6.5
59243-00 A
6-13
Enter the Set Config Threshold command to enable and configure port threshold monitoring on the I/O module:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config threshold A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. ThresholdMonitoringEnabled CRCErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow ISLMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LoginMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LogoutMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LOSMonitoringEnabled RisingTrigger FallingTrigger SampleWindow (True / False) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) [False [True [25 [1 [True [25 [0 [True [2 [0 [True [5 [1 [True [5 [1 [True [100 [5 ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config) #> config save QLogic4GbT (admin-config) #> config activate
6-14
59243-00 A
A
6.6
Testing a Port
You can perform an online or offline port test using the Test Port command. The following sections describe the test types, displaying test results, and cancelling a test: Online Tests for Ports Offline Tests for Ports Display Port Test Results Cancel a Port Test
6.6.1
Do you want to start the test? (y/n) [n] y The test has been started. A notification with the test result(s) will appear on the screen when the test has completed. QLogic4GbT (admin) #> Test for port 0 Passed.
59243-00 A
6-15
6.6.2
Do you want to start the test? (y/n) [n] y The test has been started. A notification with the test result(s) will appear on the screen when the test has completed. QLogic4GbT (admin) #> Loopback test for port 1 Passed.
When the test is complete, remember to place the port back online.
QLogic4GbT (admin) #> set port 1 state online
6-16
59243-00 A
A
6.6.3
6.6.4
59243-00 A
6-17
6.8
6-18
59243-00 A
A
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config port
Enter the Set Config Port command to borrow and allocate credits. The following example borrows credits from port 1 and allocates them to port 0:
A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the attributes for the port being processed, press 'q' or 'Q' and the ENTER key to do so. If you wish to terminate the configuration process completely, press 'qq' or 'QQ' and the ENTER key to so do. Configuring Port Number: -----------------------AdminState LinkSpeed PortType SymPortName ALFairness (1=Online, 2=Offline, 3=Diagnostics, 4=Down) [Online] (1=1Gb/s, 2=2Gb/s, 4=4Gb/s, A=Auto) (GL / G / F / FL / Donor) (string, max=32 chars) (True / False) [Auto [G ] ] 0
DeviceScanEnable (True / False) ForceOfflineRSCN (True / False) ARB_FF InteropCredit ExtCredit FANEnable (True / False) (decimal value, 0-255) (dec value, increments of 7, non-loop only) (True / False) 1
(1=Online, 2=Offline, 3=Diagnostics, 4=Down) [Online] (1=1Gb/s, 2=2Gb/s, 4=4Gb/s, A=Auto) (GL / G / F / FL / Donor) (string, max=32 chars) [Auto [GL ] ] donor qq
[Port0 ]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config) #> config save QLogic4GbT (admin-config) #> config activate
59243-00 A
6-19
Notes
6-20
59243-00 A
Section 7
Zoning Configuration
This section describes the following tasks: Displaying Zoning Database Information Configuring the Zoning Database Modifying the Zoning Database Resetting the Zoning Database Removing Inactive Zone Sets, Zones, and Aliases Managing Zone Sets Managing Zones Managing Aliases Consider device access needs within the fabric. Access is controlled by the use of zoning. Some zoning strategies include the following: Separate devices by operating system. Separate devices that have no need to communicate with other devices in the fabric or have classified data. Separate devices into department, administrative, or other functional group. Reserve a path and its bandwidth from one port to another. Zoning divides the fabric for purposes of controlling discovery and inbound traffic. A zone is a named group of ports or devices. Members of the same zone can communicate with each other and transmit outside the zone, but cannot receive inbound traffic from outside the zone. A port/device can be a member of up to eight zones whose combined membership does not exceed 64. Zoning is hardware enforced on an I/O module port if the sum of the logged-in devices plus the devices zoned with devices on that port is 64 or less. If a port exceeds this sum, that port behaves as a soft zone member. The port continues to behave as a soft zone member until the sum of logged-in and zoned devices falls back to 64, and the port is reset. A zone can be a component of more than one zone set. Several zone sets can be defined for a fabric, but only one zone set can be active at one time. The active zone set determines the current fabric zoning.
59243-00 A
7-1
7.1
7-2
59243-00 A
A
QLogic4GbT #> zoning list Active ZoneSet Information ZoneSet wwn wwn_b0241f Zone ZoneMember --------------------------------
Enter the Zoning List command to display all zone sets, zones, and zone members in the zoning database as shown in the following example:
50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2f wwn_23bd31 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:23:bd:31 wwn_221416 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15:c3 Configured Zoning Information ZoneSet wwn wwn_b0241f 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2f wwn_23bd31 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:23:bd:31 wwn_221416 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15:16 Zone ZoneMember --------------------------------
59243-00 A
7-3
7.1.2
Enter the Zoneset Active command to display the name of the active zone set and its activation history as shown in the following example:
QLogic4GbT #> zoneset active ActiveZoneSet LastActivatedBy LastActivatedOn Bets admin@OB-session6 day month date time year
7-4
59243-00 A
A
7.1.3
Enter the Zone Zonesets command to display the zone sets for which a specified zone is a member as shown in the following example:
QLogic4GbT #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------zone_set_1
7.1.4
59243-00 A
7-5
7.1.5
Enter the Alias Members command to display the membership for a specified alias as shown in the following example:
QLogic4GbT #> alias members alias1 Current list of members for Zone Alias: alias1 --------------------------------------50:06:04:82:bf:d2:18:c4 50:06:04:82:bf:d2:18:c5 50:06:04:82:bf:d2:18:c6
7-6
59243-00 A
A
7.1.6
History information includes the following: Time of the most recent zone set activation or deactivation and the user account that performed it Time of the most recent modifications to the zoning database and the user account that made them. Checksum for the zoning database
59243-00 A
7-7
7.1.7
7-8
59243-00 A
A
7.2
59243-00 A
7-9
The Config Edit session provides access to the Set Config Zoning command as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit The config named default is being edited. QLogic4GbT (admin-config) #> set config zoning A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. InteropAutoSave DefaultZone DiscardInactive (True / False) (True / False) (True / False) [True ] [True ] [False]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config)#> config save QLogic4GbT (admin)#> config activate QLogic4GbT (admin)#> admin end
7-10
59243-00 A
A
7.3
When you are finished making changes, enter the Zoning Save command to save the changes and close the Zoning Edit session.
QLogic4GbT (admin-zoning)#> zoning save
To close the Zoning Edit session without saving changes, enter the Zoning Cancel command.
QLogic4GbT (admin-zoning)#> zoning cancel
Changes to the active zone set do not take effect until you activate it with the Zoneset Activate command. The active zone set is propagated throughout the fabric.
QLogic4GbT (admin)#> zoneset activate zoneset_1 QLogic4GbT (admin)#> admin end
The Admin End command releases the Admin session for other administrators when you are done making changes to the I/O module. To remove all zoning database objects (aliases, zones, and zone sets) and restore the zoning database to its factory state, enter the Reset Zoning command as shown in the following example:
QLogic4GbT (admin) #> reset zoning
59243-00 A
7-11
7.4
Enter the Reset Zoning command as shown in the following example. The security configuration values, AutoSave, DefaultZone, and DiscardInactive remain unchanged. This is the preferred method.
QLogic4GbT #> admin start QLogic4GbT (admin) #> reset zoning
7.5
7-12
59243-00 A
A
7.6
7.6.2
59243-00 A
7-13
7.6.3
7-14
59243-00 A
A
7.6.7
Managing Zones
Managing Zones consists of the following tasks: Create a Zone Delete a Zone Rename a Zone Copy a Zone Add Members to a Zone Remove Members from a Zone All of these tasks require an Admin session and a Zoning Edit session.
7.7.1
Create a Zone
Enter the Zone Create command to create a new zone as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> zone create zone_1 QLogic4GbT (admin-zoning) #> zoning save
59243-00 A
7-15
7.7.2
Delete a Zone
Enter the Zone Delete command to delete zone_1 from the zoning database as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> zone delete zone_1 QLogic4GbT (admin-zoning) #> zoning save
7.7.3
Rename a Zone
Enter the Zone Rename command to rename zone_1 to zone_a as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> zone rename zone_1 zone_a QLogic4GbT (admin-zoning) #> zoning save
7.7.4
Copy a Zone
Enter the Zone Copy command to copy the contents of an existing zone (zone_1) to a new zone (zone_2) as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> zone copy zone_1 zone_2 QLogic4GbT (admin-zoning) #> zoning save
7.7.5
7-16
59243-00 A
A
7.7.6
59243-00 A
7-17
7.8
Managing Aliases
Managing aliases consists of the following tasks: Create an Alias Delete an Alias Rename an Alias Copy an Alias Add Members to an Alias Remove Members from an Alias All of these tasks require an Admin session and a Zoning Edit session.
7.8.1
Create an Alias
Enter the Alias Create command to create a new alias as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> alias create alias_1 QLogic4GbT (admin-zoning) #> zoning save
7.8.2
Delete an Alias
Enter the Alias Delete command to delete alias_1 from the zoning database as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> alias delete alias_1 QLogic4GbT (admin-zoning) #> zoning save
7.8.3
Rename an Alias
Enter the Alias Rename command to rename alias_1 to alias_a as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> alias rename alias_1 alias_a QLogic4GbT (admin-zoning) #> zoning save
7-18
59243-00 A
A
7.8.4
Copy an Alias
Enter the Alias Copy command to copy alias_1 and its contents to alias_2 as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> zoning edit QLogic4GbT (admin-zoning) #> alias copy alias_1 alias_2 QLogic4GbT (admin-zoning) #> zoning save
7.8.5
1,4 1,5
59243-00 A
7-19
Notes
7-20
59243-00 A
Section 8
NOTE:
SSH and SSL connection security require the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
This section describes the following tasks: Managing SSL and SSH Services Displaying SSL and SSH Services Creating an SSL Security Certificate The I/O module supports secure connections with Telnet and I/O module management applications. The Secure SHell protocol (SSH) secures Telnet connections to the I/O module. The Secure Sockets Layer (SSL) protocol secures I/O module connections to the following management applications: Enterprise Fabric Suite 2007 QuickTools Application Programming Interface Storage Management Initiative-Specification (SMI-S)
8.1
59243-00 A
8-1
Enter the Set Setup Services command to manage both SSH and SSL services as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. PLEASE NOTE: ----------* Further configuration may be required after enabling a service. * If services are disabled, the connection to the switch may be lost. * When enabling SSL, please verify that the date/time settings on this switch and the workstation from where the SSL connection will be started match, and then a new certificate may need to be created to ensure a secure connection to this switch. TelnetEnabled SSHEnabled GUIMgmtEnabled SSLEnabled EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) [True ] [False] True [True ] [False] True [True ] [True ] [False] [False] [True ] [True ]
Do you want to save and activate this services setup? (y/n): [n] y
8-2
59243-00 A
A
8.2
8.3
To ensure the creation of a valid certificate, be sure that the I/O module and the workstation time and date are the same. Refer to Setting the Date and Time on page 5-17.
59243-00 A
8-3
Notes
8-4
59243-00 A
Section 9
NOTE:
Device security requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
This section describes the following tasks: Displaying Security Database Information Configuring the Security Database Modifying the Security Database Resetting the Security Database Managing Security Sets Managing Groups Device security provides for the authorization and authentication of devices that you attach to an I/O module. You can configure an I/O module with a group of devices against which the I/O module authorizes new attachments by devices, other switches, or devices issuing management server commands. Device security is defined through the use of security sets and groups. A group is a list of device worldwide names that are authorized to attach to an I/O module. There are three types of groups: one for other switches (ISL), another for devices (port), and a third for devices issuing management server commands (MS). A security set is a set of up to three groups with no more than one of each group type. The security database is made up of all security sets on the I/O module. In addition to authorization, the I/O module can be configured to require authentication to validate the identity of the connecting switch, device, or host. Authentication can be performed locally using the I/O modules security database, or remotely using a Remote Dial-In User Service (RADIUS) server such as Microsoft RADIUS.
59243-00 A
9-1
9.1
9-2
59243-00 A
A
QLogic4GbT #> security list Active Security Information SecuritySet ----------Group ----GroupMember -----------
Enter the Security List command to display all security sets, groups, and group members in the security database as shown in the following example:
No active securityset defined. Configured Security Information SecuritySet ----------alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret Binding Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret Binding Chap MD5 ******** SHA-1 ******** 0 Chap MD5 ******** SHA-1 ******** 0 Group ----GroupMember -----------
10:00:00:00:00:10:21:17
59243-00 A
9-3
9.1.2
10:00:00:00:00:10:21:17
Enter the Securityset Active command to display the name of the active security set and its activation history as shown in the following example:
QLogic4GbT #> securityset active Active SecuritySet Information -----------------------------ActiveSecuritySet alpha LastActivatedBy LastActivatedOn Remote day month date time year
9-4
59243-00 A
A
9.1.3
Enter the Group Securitysets command to display the security sets for which a specified group is a member as shown in the following example:
QLogic4GbT #> group securitysets group_1 Current list of SecuritySets for Group: group_1 --------------------------------------SecuritySet_1 SecuritySet_2 SecuritySet_A SecuritySet_B
9.1.4
59243-00 A
9-5
9.1.5
00000000
History information includes the following: Time of the most recent security set activation or deactivation and the user account that performed it Time of the most recent modifications to the security database and the user account that made them Checksum for the security database
9.1.6
9-6
59243-00 A
A
9.2
59243-00 A
9-7
To modify the security configuration, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time either through Telnet, QuickTools, or Enterprise Fabric Suite 2007. You must also open a Config Edit session with the Config Edit command and indicate which configuration you want to modify. If you do not specify a configuration name, the active configuration is assumed. The Config Edit session provides access to the Set Config Security command as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config security A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. FabricBindingEnabled AutoSave (True / False) (True / False) [False] [True ]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config)#> config save QLogic4GbT (admin)#> config activate QLogic4GbT (admin)#> admin end
9-8
59243-00 A
A
9.3
When you are finished making changes, enter the Security Save command to save the changes and close the Security Edit session.
QLogic4GbT (admin-security)#> security save
To close the session without saving changes, enter the Security Cancel command.
QLogic4GbT (admin-security)#> security cancel
Changes to the active security set do not take effect until you activate it with the Security Activate command. The Admin End command releases the Admin session for other administrators when you are done making changes to the switch.
QLogic4GbT (admin)#> security activate QLogic4GbT (admin)#> admin end
9.4
Enter the Reset Security command as shown in the following example. The security configuration values, autosave and fabric binding remain unchanged.
QLogic4GbT (admin) #> reset security
59243-00 A
9-9
9.5
9.5.4
9-10
59243-00 A
A
9.5.5
9.5.6
9.5.7
59243-00 A
9-11
9.6
Managing Groups
Managing Groups consists of the following tasks: Create a Group Delete a Group Rename a Group Copy a Group Add Members to a Group Modify a Group Member Remove Members from a Group All of these tasks require an Admin session and a Security Edit session.
9.6.1
Create a Group
Creating a group involves specifying a group name and a group type. There are three types of groups: ISL groupsecures connected switches Port groupsecures connected devices MS groupsecures management server commands Enter the Group Create command to create a new port group as shown in the following example:
QLogic4GbT (admin-security) #> group create group_port port
9.6.2
Delete a Group
Enter the Group Delete command to delete group_port from the security database as shown in the following example:
QLogic4GbT (admin-security) #> group delete group_port
9.6.3
Rename a Group
Enter the Group Rename command to rename group_port to port_1 as shown in the following example:
QLogic4GbT (admin-security) #> group rename group_port port_1
9-12
59243-00 A
A
9.6.4
Copy a Group
Enter the Group Copy command to copy the contents of an existing group (group_port) to a new group (port_1) as shown in the following example:
QLogic4GbT (admin-security) #> group copy group_port port_1
9.6.5
Finished configuring attributes. To discard this configuration use the security cancel command.
59243-00 A
9-13
9.6.6
(40 hex or 20 ASCII char value) [ (32 hex or 16 ASCII char value) [
Finished configuring attributes. To discard this configuration use the security cancel command.
9.6.7
9-14
59243-00 A
Section 10
NOTE:
RADIUS server configuration requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
Authentication can be performed locally using the switchs security database, or remotely using a Remote Dial-In User Service (RADIUS) server such as Microsoft RADIUS. With a RADIUS server, the security database for the entire fabric resides on the server. In this way, the security database can be managed centrally, rather than on each switch. You can configure up to five RADIUS servers to provide failover. You can configure the RADIUS server to authenticate just the I/O module or both the I/O module and the initiator device if the device supports authentication. When using a RADIUS server, every switch in the fabric must have a network connection. A RADIUS server can also be configured to authenticate user accounts. Refer to Section 3 for information about user accounts. A secure connection is required to authenticate user logins with a RADIUS server. Refer to Section 8 for information about secure connections. This section describes the following tasks: Displaying RADIUS Server Information Configuring a RADIUS Server on the Switch
59243-00 A
10-1
10.1
10-2
59243-00 A
A
10.2
Do you want to save and activate this radius setup? (y/n): [y]
59243-00 A
10-3
Notes
10-4
59243-00 A
Section 11
Enter the Set Log Start command to start recording event message in the I/O module log as shown in the following example:
QLogic4GbT (admin) #> set log start
59243-00 A
11-1
11.2
You can also filter the event log display with the Show Log Display command and customize the messages that display automatically in the output stream. Filtering the Event Log Display Controlling Messages in the Output Stream
11-2
59243-00 A
A
11.2.1
59243-00 A
11-3
11.3
11-4
59243-00 A
A
11.3.2
11.3.3
59243-00 A
11-5
11.5
Consult your host operating system documentation for information on how to configure remote logging. The Set Setup System command controls local logging through the LocalLogEnabled parameter and remote logging through the RemoteLogEnabled and RemoteLogHostAddress parameters as shown in the following example:
QLogic4GbT (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. FCNetworkDiscovery AdminTimeout InactivityTimeout LocalLogEnabled RemoteLogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled (1=Static, 2=Bootp, 3=Dhcp, 4=Rarp) (dec value 0-1440 minutes, 0=never) (dec value 0-1440 minutes, 0=never) (True / False) (True / False) (dot-notated IP Address) (True / False) (dot-notated IP Address) (True / False) [Static [30 [0 [True [False [10.0.0.254 [False [10.0.0.254 [True ] ] ] ] ] ] ] ] ]
11-6
59243-00 A
A
11.6
2.
Open an FTP session on the I/O module and log in with the account name images and password images. Transfer the file logfile in binary mode with the Get command.
>ftp ip_address user:images password: images ftp>bin ftp>get logfile xxxxx bytes sent in xx secs. ftp>quit
59243-00 A
11-7
Notes
11-8
59243-00 A
Section 12
59243-00 A
12-1
Enter the Set Setup Services command to enable SNMP as shown in the following example:
QLogic4GbT #> admin start QLogic4GbT (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. PLEASE NOTE: ----------* Further configuration may be required after enabling a service. * If services are disabled, the connection to the switch may be lost. * When enabling SSL, please verify that the date/time settings on this switch and the workstation from where the SSL connection will be started match, and then a new certificate may need to be created to ensure a secure connection to this switch. TelnetEnabled SSHEnabled GUIMgmtEnabled SSLEnabled EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) [True ] [False] [True ] [False] [True ] [True ] [False] [False] [True ] [True ]
Do you want to save and activate this services setup? (y/n): [y]
You can display the SNMPEnabled parameters using the Show Setup SNMP or Show Setup Services commands.
12-2
59243-00 A
A
12.2
59243-00 A
12-3
12.3
12-4
59243-00 A
A
12.4
59243-00 A
12-5
Notes
12-6
59243-00 A
Section 13
Command Reference
This section describes the commands of the CLI and the format in which they are presented. The command format presents the following: Access Authority Syntax and Keywords Notes and Examples The commands are listed in Command Listing on page 13-3.
13.1
Access Authority
The Authority paragraph in each command description indicates what types of sessions are required to enter that command. Commands associated with monitoring tasks are available to all account names with no special session requirement. Commands associated with configuration tasks are available only within an Admin session. An account must have Admin authority to enter the Admin Start command, which opens an Admin session. Some commands require that you open additional editing sessions within an Admin session such as the following: Commands that modify zoning require a Zoning Edit session, which is opened by the Zoning Edit command. These commands include the Alias, Zone, Zoneset, and Zoning commands. Commands that modify device security require a Security Edit session, which is opened by the Security Edit command. These command include the Group, Security, and Securityset commands. Commands that modify the I/O module configuration require a Config Edit session, which is opened by the Config Edit command. These command include all of the Set Config commands.
59243-00 A
13-1
13.2
13-2
59243-00 A
A
13.4
Command Listing
The commands are listed in alphabetical order as follows: A C D E F G H I L P Q R S Admin, Alias Config, Create Date Exit Fcping, Fctrace, Feature, Firmware Install Group Hardreset, Help, History, Hotreset Image Lip, Logout Passwd, Ping, Ps Quit Reset Security, Securityset, Set Alarm, Set Beacon Set Config Port through Set Config Zoning Set Log, Set Pagebreak, Set Port Set Setup Radius through Set Setup System Set Switch State, Set Timezone Sh Show About, Show Alarm, Show Broadcast, Show Chassis Show Config Port through Show Config Zoning Show Domains, Show Donor, Show Fabric, Show FDMI Show Interface, Show Log, Show LSDB, Show Media, Show Mem, Show NS Show Pagebreak, Show Perf, Show Port, Show Post Log Show Setup Mfg through Show Setup System Show Switch, Show Timezone, Show Topology, Show Users, Show Version, Shutdown T Test Cancel, Test Port, Test Status
59243-00 A
13-3
Admin
Opens and closes an Admin session. The Admin session provides access to commands that change the fabric and I/O module configurations. Only one Admin session can be open on the I/O module at any time. An inactive Admin session will time out after a period of time which can be changed using the Set Setup System command.
Authority Syntax
User account with Admin authority admin start (or begin) end (or stop) cancel start (or begin) Opens the Admin session end (or stop) Closes the Admin session. The Hardreset, Hotreset, Quit, Shutdown, and Reset Switch commands will also end an Admin session. cancel Terminates an Admin session opened by another user. Use this keyword with care because it terminates the Admin session without warning the other user and without saving pending changes.
Keywords
Notes
Closing a Telnet window during an Admin session does not release the session. In this case, you must either wait for the Admin session to time out, or use the Admin Cancel command. The following example shows how to open and close an Admin session:
QLogic4GbT #> admin start QLogic4GbT (admin) #> . . . QLogic4GbT (admin) #> admin end
Examples
13-4
59243-00 A
A
Alias
Creates a named set of ports/devices. Aliases make it easier to assign a set of ports/devices to many zones. An alias can not have a zone or another alias as a member.
Authority Syntax
Admin session and Zoning Edit session for all keywords except List and Members alias add [alias] [member_list] copy [alias_source] [alias_destination] create [alias] delete [alias] list members [alias] remove [alias] [member_list] rename [alias_old] [alias_new] add [alias] [member_list] Specifies one or more ports/devices given by [member_list] to add to the alias named [alias]. Use a <space> to delimit ports/devices in [member_list]. An alias can have a maximum of 2000 members. A port/device in [member_list] can have any of the following formats: Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1239; port numbers can be 0255. 6-character hexadecimal device Fibre Channel address (hex) 16-character hexadecimal worldwide port name (WWPN) with the format xx:xx:xx:xx:xx:xx:xx:xx. The application verifies that the [alias] format is correct, but does not validate that such a port/device exists. copy [alias_source] [alias_destination] Creates a new alias named [alias_destination] and copies the membership into it from the alias given by [alias_source]. create [alias] Creates an alias with the name given by [alias]. An alias name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The zoning database supports a maximum of 256 aliases.
Keywords
59243-00 A
13-5
delete [alias] Deletes the specified alias given by [alias] from the zoning database. If the alias is a member of the active zone set, the alias will not be removed from the active zone set until the active zone set is deactivated. list Displays a list of all aliases. This keyword does not require an Admin session. members [alias] Displays all members of the alias given by [alias]. This keyword does not require an Admin session. remove [alias] [member_list] Removes the ports/devices given by [member_list] from the alias given by [alias]. Use a <space> to delimit ports/devices in [member_list]. A port/device in [member_list] can have any of the following formats: Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1239; port numbers can be 0255. 6-character hexadecimal device Fibre Channel address (hex) 16-character hexadecimal worldwide port name (WWPN) for the device with the format xx:xx:xx:xx:xx:xx:xx:xx. rename [alias_old] [alias_new] Renames the alias given by [alias_old] to the alias given by [alias_new].
Examples
13-6
59243-00 A
A
Config
Manages the Fibre Channel configurations on an I/O module. For information about setting the port and I/O module configurations, refer to the Set Config Switch command on page 13-69.
Authority Syntax
Admin session for all keywords except Backup and List config activate [config_name] backup cancel copy [config_source] [config_destination] delete [config_name] edit [config_name] list restore save [config_name] activate [config_name] Activates the configuration given by [config_name]. If you omit [config_name], the currently active configuration is used. Only one configuration can be active at a time. backup Creates a file named configdata, which contains the system configuration information. This keyword does not require an Admin session. cancel Terminates the current configuration edit session without saving changes that were made. copy [config_source] [config_destination] Copies the configuration given by [config_source] to the configuration given by [config_destination]. The I/O module supports up to 10 configurations including the default configuration. delete [config_name] Deletes the configuration given by [config_name]. You cannot delete the default configuration (Default Config) nor the active configuration. edit [config_name] Opens an edit session for the configuration given by [config_name]. If you omit [config_name], the currently active configuration is used.
Keywords
59243-00 A
13-7
list Displays a list of all available configurations. This keyword does not require an Admin session. restore Restores configuration settings to an out-of-band I/O module from a backup file named configdata, which must be first uploaded on the I/O module using FTP. You create the backup file using the Config Backup command. Use FTP to load the backup file on an I/O module, then enter the Config Restore command. After the restore is complete, the I/O module automatically resets. Refer to Back Up and Restore an I/O Module Configuration on page 5-14. NOTE: Configuration archive files created with the Enterprise Fabric Suite 2007 Archive function are not compatible with the Config Restore command. The configdata backup file does not include the security group primary or secondary secrets, and therefore are not restored. You must edit the security database and reconfigure the secrets. If they are not, the I/O module will isolate from the fabric. save [config_name] Saves changes made during a configuration edit session in the configuration given by [config_name]. If you omit [config_name], the value for [config_name] you chose for the most recent Config Edit command is used. [config_name] can be up to 31 characters excluding #, semicolon (;), and comma (,). The I/O module supports up to 10 configurations including the default configuration.
Notes Examples
Changes you make to an active or inactive configuration can be saved, but will not take effect until you activate that configuration. The following shows an example of how to open and close a Config Edit session:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit The config named default is being edited. . . QLogic4GbT (admin-config) #> config cancel Configuration mode will be canceled. Please confirm (y/n): [n] y QLogic4GbT (admin) #> admin end
13-8
59243-00 A
A
QLogic4GbT #> config backup QLogic4GbT #> exit #>ftp symbolic_name or ip_address user: images password: images ftp> bin ftp> get configdata ftp> quit
The following is an example of how to create a backup file (configdata) and download the file to the workstation.
The following is an example of how to upload a configuration backup file (configdata) from the workstation to the I/O module, and then restore the configuration.
#> ftp symbolic_name or ip_address user: images password: images ftp> bin ftp> put configdata ftp> quit QLogic4GbT #> admin start QLogic4GbT (admin) #> config restore The switch will be reset after restoring the configuration. Please confirm (y/n): [n] y Alarm Msg: [day month date time year][A1005.0021][SM][Configuration is being restored - this could take several minutes] Alarm Msg: [day month date time year][A1000.000A][SM][The switch will be reset in 3 seconds due to a config restore] QLogic4GbT (admin) #> Alarm Msg: [day month date time year][A1000.0005][SM][The switch is being reset]
59243-00 A
13-9
Create
Creates support files for troubleshooting I/O module problems, and certificates for secure communications for Enterprise Fabric Suite 2007 and SMI-S.
Authority Syntax
Admin session for the Certificate keyword create certificate support certificate Creates a security certificate on the I/O module. The security certificate is required to establish an SSL connection with a management application such as Enterprise Fabric Suite 2007. The certificate is valid 24 hours before the certificate creation date and expires 365 days after the creation date. Should the current certificate become invalid, use the Create Certificate command to create a new one. NOTE: To insure the creation of a valid certificate, be sure that the I/O module and the workstation time and date are the same. Refer to the following: Date command on page 13-13 for information about setting the time and date Set Timezone command on page 13-97 for information about setting the time zone on the I/O module and workstation Set Setup System command on page 13-94 (System keyword) for information about enabling the Network Time Protocol for synchronizing the time and date on the I/O module and workstation from an NTP server. support Assembles all log files and I/O module memory data into a file (dump_support.tgz) on the I/O module. If your workstation has an FTP server, you can proceed with the command prompts to send the file from the I/O module to a remote host. Otherwise, you can use FTP to download the support file from the I/O module to your workstation. The support file is useful to technical support personnel for troubleshooting I/O module problems. Use this command when directed by your authorized maintenance provider. This keyword does not require an Admin session.
Keywords
13-10
59243-00 A
A
Examples
QLogic4GbT #> create support 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
The following is an example of the Create Support command when an FTP server is available on the workstation:
Log Msg:[Creating the support file - this will take several seconds]
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
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.
59243-00 A
13-11
The following is an example of the Create Support command and how to download the support file to your workstation. When prompted to send the support file to another machine, decline, then close the Telnet session. Open an FTP session on the I/O module and log in with the account name images and password images. Transfer the dump_support.tgz file in binary mode with the Get command.
QLogic4GbT #> create support Log Msg:[Creating the support file - this will take several seconds] FTP the dump support file to another machine? (y/n): n QLogic4GbT (admin) #> quit >ftp switch_ip_address user: images password: images ftp>bin ftp>get dump_support.tgz xxxxx bytes sent in xx secs. ftp> quit
13-12
59243-00 A
A
Date
Displays or sets the system date and time. To set the date and time the information string must be provided in this format: MMDDhhmmCCYY. The new date and time takes effect immediately.
Admin session except to display the date. date [MMDDhhmmCCYY] [MMDDhhmmCCYY] Specifies the date this requires an Admin session. If you omit [MMDDhhmmCCYY], the current date is displayed which does not require an Admin session.
Notes
Network Time Protocol (NTP) must be disabled to set the time with the Date command. Enter the Set Setup System command to disable the NTPClientEnabled parameter. When setting the date and time on a I/O module that is enabled for SSL connections, the I/O module time must be within 24 hours of the workstation time. Otherwise, the connection will fail.
Examples
59243-00 A
13-13
Exit
Closes the Telnet session.
None exit You can also enter Control-D to close the Telnet session.
13-14
59243-00 A
A
Fcping
NOTE:
This command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Verifies a Fibre Channel connection with another switch or a device and reports status.
Authority Syntax
None fcping destination [address] count [number] timeout [seconds] [address] The address of the port or device with which to verify the Fibre Channel connection. [address] can have one of the following formats: 6-character hexadecimal device Fibre Channel address (hex). Enter addresses with or without the 0x prefix. 16-character hexadecimal worldwide port name (WWPN) with the format xx:xx:xx:xx:xx:xx:xx:xx or xxxxxxxxxxxxxxxx. count [number] Number of times given by [number] to repeat the command. If you omit this keyword, the command is repeated once. timeout [seconds] Number of seconds given by [seconds] to wait for a response. If you omit this keyword, the I/O module waits 1 second for a response.
Keywords
Examples
59243-00 A
13-15
S
This command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Fctrace
NOTE:
Displays the path from one port in the fabric to another in the same zone. Path information includes the following: Domain IDs Incoming port name and physical port number Outgoing port name and physical port number
None fctrace [port_source] [port_destination] [hop_count] [port_source] The Fibre Channel port from to begin the trace. [port_source] can have the following formats: 6-character hexadecimal device Fibre Channel address (hex). Enter addresses with or without the 0x prefix. 16-character hexadecimal worldwide port name (WWPN) with the format xx:xx:xx:xx:xx:xx:xx:xx or xxxxxxxxxxxxxxxx. [port_destination] The Fibre Channel port at which to end the trace. [port_destination] can have the following formats: 6-character hexadecimal device Fibre Channel address (hex). Enter addresses with or without the 0x prefix. 16-character hexadecimal worldwide port name (WWPN) with the format xx:xx:xx:xx:xx:xx:xx:xx or xxxxxxxxxxxxxxxx. [hop_count] Maximum number of hops before stopping the trace. If you omit [hop_count], 20 hops is used.
13-16
59243-00 A
A
Examples
The following is an example of the Fctrace command:
QLogic4GbT#> fctrace 970400 970e00 hops 5 36 bytes from 0x970400 to 0x970e00, 5 hops max Domain -----97 97 Ingress Port WWN ---------------20:04:00:c0:dd:02:cc:2e 20:0e:00:c0:dd:02:cc:2e Port ---4 14 Egress Port WWN ---------------
Port ---14 4
20:0e:00:c0:dd:02:cc:2e 20:04:00:c0:dd:02:cc:2e
59243-00 A
13-17
Feature
Adds license key features to the I/O module and displays the license key feature log. To order a license key contact your switch distributor or your authorized reseller. Upgrading an I/O module is not disruptive, nor does it require an I/O module reset.
Authority Syntax
Admin session for Add keyword only feature add [license_key] log add [license_key] Adds the feature that corresponds to the value given by [license_key]. [license_key] is case insensitive. log Displays a list of installed license key features.
Keywords
Notes
The following license keys are available: Enterprise Fabric Suite 2007 for IBM BladeCenter provides access to a workstation-based Java application that provides a graphical user interface for fabric management. This includes Performance Viewer which graphs port performance. Fabric Security for IBM BladeCenter provides the following: Connection security using Secure Shell (SSH) and Secure Socket Layer (SSL). Device security using Challenge Handshake Authentication Protocol (CHAP) Remote device and user authentication using a Remote Authentication Dial-In User Service (RADIUS) server SANdoctor for IBM BladeCenter provides tools for Fibre Channel connection verification (Fcping command), Fibre Channel route tracing (Fctrace command), and transceiver diagnostics (Show Media command). 4 Gb 10-Port Upgrade for IBM BladeCenter upgrades a 10-port SAN Switch Module to a 20-port SAN Switch Module.
13-18
59243-00 A
A
Examples
QLogic4GbT #> admin start QLogic4GbT (admin) #> feature add 1-LCVXOWUNOJBE6 License upgrade to 20 ports
Do you want to continue with license upgrade procedure? (y/n): [n] y Alarm Msg:[day mon date time year][A1005.0030][SM][Upgrading Licensed Ports to 20]
59243-00 A
13-19
Firmware Install
Downloads firmware from a remote host to the I/O module, installs the firmware, then resets the I/O module to activate the firmware. This is disruptive. The command prompts you for the following: The file transfer protocol (FTP or TFTP) IP address of the remote host An account name and password on the remote host (FTP only) Pathname for the firmware image file
Admin session firmware install The following is an example of the Firmware Install command using FTP:
QLogic4GbT #> admin start QLogic4GbT (admin) #> firmware install The switch will be reset. to I/O traffic. This process will cause a disruption
Continuing with this action will terminate all management sessions, including any Telnet sessions. When the firmware activation is complete, you may log in to the switch again. Do you want to continue? [y/n]: y Press 'q' and the ENTER key to abort this command. FTP or TFTP User Account IP Address : ftp : johndoe : 10.0.0.254 Do you want to continue? [y/n] y
Connected to 10.0.0.254 (10.0.0.254). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. 331 Password required for johndoe. Password: xxxxxxxxx 230 User johndoe logged in. bin 200 Type set to I. verbose Verbose mode off. This may take several seconds... The switch will now reset. Connection closed by foreign host.
13-20
59243-00 A
A
QLogic4GbT #> admin start QLogic4GbT (admin) #> firmware install The switch will be reset. to I/O traffic.
Continuing with this action will terminate all management sessions, including any Telnet sessions. When the firmware activation is complete, you may log in to the switch again. Do you want to continue? [y/n]: y Press 'q' and the ENTER key to abort this command. FTP or TFTP IP Address : tftp : 10.0.0.254 Do you want to continue? [y/n] y
Connected to 10.0.0.254 (10.0.0.254). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. bin 200 Type set to I. verbose Verbose mode off. This may take several seconds... The switch will now reset. Connection closed by foreign host.
59243-00 A
13-21
S
This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Group
NOTE:
Creates groups, manages membership within the group, and manages the membership of groups in security sets.
Authority
Admin session and a Security Edit session. Refer to the Security command on page 13-51 for information about starting a Security Edit session. The List, Members, Securitysets, and Type keywords are available without an Admin session. group add [group] copy [group_source] [group_destination] create [group] [type] delete [group] edit [group] [member] list members [group] remove [group] [member_list] rename [group_old] [group_new] securitysets [group] type [group]
Syntax
13-22
59243-00 A
A
Keywords
add [group]
Initiates an editing session in which to specify a group member and its attributes for the existing group given by [group]. ISL, Port, and MS member attributes are described in Table 13-1, Table 13-2, and Table 13-3 respectively. The group name and group type attributes are read-only fields common to all three tables. Table 13-1. ISL Group Member Attributes
Attribute Member Authentication Description Worldwide name of the switch that would attach to the I/O module. A member cannot belong to more than one group. Enables (CHAP) or disables (None) authentication using the Challenge Handshake Authentication Protocol (CHAP). The default is None. The preferred hash function to use to decipher the encrypted Primary Secret sent by the ISL member. The hash functions are MD5 or SHA-1. If the ISL member does not support the Primary Hash, the I/O module will use the Secondary Hash. Hexadecimal string that is encrypted by the Primary Hash for authentication with the ISL group member. The string has the following lengths depending on the Primary Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte Secondary Hash Hash function to use to decipher the encrypted Secondary Secret sent by the ISL group member. Hash values are MD5 or SHA-1. The Secondary Hash is used when the Primary Hash is not available on the ISL group member. The Primary Hash and the Secondary Hash cannot be the same. Hex string that is encrypted by the Secondary Hash and sent for authentication. The string has the following lengths depending on the Secondary Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte Binding Domain ID of the switch to which to bind the ISL group member worldwide name. This option is available only if FabricBindingEnabled is set to True using the Set Config Security command. 0 (zero) specifies no binding.
Primary Hash
Primary Secret
Secondary Secret
59243-00 A
13-23
S
Table 13-2. Port Group Member Attributes
Description Port worldwide name for the N_Port device that would attach to the I/O module. A member cannot belong to more than one group. Enables (CHAP) or disables (None) authentication using the Challenge Handshake Authentication Protocol (CHAP). The default is None. The preferred hash function to use to decipher the encrypted Primary Secret sent by the Port group member. The hash functions are MD5 or SHA-1. If the Port group member does not support the Primary Hash, the I/O module will use the Secondary Hash. Hexadecimal string that is encrypted by the Primary Hash for authentication with the Port group member. The string has the following lengths depending on the Primary Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte
Primary Hash
Primary Secret
Secondary Hash
Hash function to use to decipher the encrypted Secondary Secret sent by the Port group member. Hash values are MD5 or SHA-1. The Secondary Hash is used when the Primary Hash is not available on the Port group member. The Primary Hash and the Secondary Hash cannot be the same. Hex string that is encrypted by the Secondary Hash and sent for authentication. The string has the following lengths depending on the Secondary Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte
Secondary Secret
13-24
59243-00 A
A
Attribute Member CTAuthentication Description
Port worldwide name for the N_Port device that would attach to the I/O module. Common Transport (CT) authentication. Enables (True) or disables (False) authentication for MS group members. The default is False. The hash function to use to decipher the encrypted Secret sent by the MS group member. Hash values are MD5 or SHA-1. Hexadecimal string that is encrypted by the Hash function for authentication with MS group members. The string has the following lengths depending on the Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte
Hash Secret
copy [group_source] [group_destination] Creates a new group named [group_destination] and copies the membership into it from the group given by [group_source]. create [group] [type] Creates a group with the name given by [group] with the type given by [type]. A group name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The security database supports a maximum of 16 groups. If you omit [type], ISL is used. [type] can be one of the following: isl Configures security for attachments to other switches. Port Configures security for attachments to N_Port devices. ms Configures security for attachments to N_Port devices that are issuing management server commands.
59243-00 A
13-25
edit [group] [member] Initiates an editing session in which to change the attributes of a worldwide name given by [member] in a group given by [group]. Member attributes that can be changed are described in Table 13-4. Table 13-4. Group Member Attributes
Attribute Authentication (ISL and Port Groups) CTAuthentication (MS Groups) Primary Hash (ISL and Port Groups) Description Enables (CHAP) or disables (None) authentication using the Challenge Handshake Authentication Protocol (CHAP). CT authentication. Enables (True) or disables (False) authentication for MS group members. The default is False. The preferred hash function to use to decipher the encrypted Primary Secret sent by the member. The hash functions are MD5 or SHA-1. If the member does not support the Primary Hash, the I/O module will use the Secondary Hash. The hash function to use to decipher the encrypted Secret sent by the MS group member. Hash values are MD5 or SHA-1. Hexadecimal string that is encrypted by the Primary Hash for authentication with the member. The string has the following lengths depending on the Primary Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte Secondary Hash (ISL and Port Groups) Hash function to use to decipher the encrypted Secondary Secret sent by the group member. Hash values are MD5 or SHA-1. The Secondary Hash is used when the Primary Hash is not available on the group member. The Primary Hash and the Secondary Hash cannot be the same. Hex string that is encrypted by the Secondary Hash and sent for authentication. The string has the following lengths depending on the Secondary Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte Secret (MS Groups) Hexadecimal string that is encrypted by the Hash function for authentication with MS group members. The string has the following lengths depending on the Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte
13-26
59243-00 A
A
Attribute Binding (ISL Groups)
list Displays a list of all groups and the security sets of which they are members. This keyword is available without an Admin session. members [group] Displays all members of the group given by [group]. This keyword is available without an Admin session. remove [group] [member_list] Remove the port/device worldwide name given by [member] from the group given by [group]. Use a <space> to delimit multiple member names in [member_list] rename [group_old] [group_new] Renames the group given by [group_old] to the group given by [group_new]. securitysets [group] Displays the list of security sets of which the group given by [group] is a member. This keyword is available without an Admin session. type [group] Displays the group type for the group given by [group]. This keyword is available without an Admin session.
Notes
Primary and secondary secrets are not included in a I/O module configuration backup. Therefore, after restoring an I/O module configuration, you must re-enter the primary and secondary secrets. Otherwise, the I/O module will isolate because of an authentication failure. Refer to the Securityset command on page 13-55 for information about managing groups in security sets.
59243-00 A
13-27
Examples
Finished configuring attributes. To discard this configuration use the security cancel command.
(40 hex or 20 ASCII char value) [ (32 hex or 16 ASCII char value) [
Finished configuring attributes. To discard this configuration use the security cancel command.
13-28
59243-00 A
A
The following is an example of the Group List command:
QLogic4GbT #> group list Group ----group1 (ISL) alpha group2 (Port) alpha SecuritySet -----------
59243-00 A
13-29
Hardreset
Resets the I/O module and performs a power-on self test. This reset disrupts I/O traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, refer to the Set Log command on page 13-76.
Admin session hardreset To reset the I/O module without a power-on self test, refer to the Reset command on page 13-43. To reset the I/O module without disrupting traffic, refer to the Hotreset command on page 13-33.
13-30
59243-00 A
A
Help
Authority Syntax Keywords
None help [command] [keyword] [command]
Displays a brief description of the specified command, its keywords, and usage.
Displays a summary of the command given by [command] and its keywords. If you omit [command], the system displays all available commands. [keyword] Displays a summary of the keyword given by [keyword] belonging to the command given by [command]. If you omit [keyword], the system displays the available keywords for the specified command. all Displays a list of all available commands (including command variations).
Examples
Admin mode is required for this command. Usage: config edit [CONFIG_NAME]
59243-00 A
13-31
History
Displays a numbered list of the previously entered commands from which you can re-execute selected commands.
None history Use the History command to provide context for the ! command: Enter ![command_string] to re-execute the most recent command that matches [command_string]. Enter ![line number] to re-execute the corresponding command from the History display Enter ![partial command string] to re-execute a command that matches the command string. Enter !! to re-execute the most recent command.
Examples
13-32
59243-00 A
A
Hotreset
Resets the I/O module for the purpose of activating the pending firmware without disrupting traffic. This command terminates all management sessions, saves all configuration information, and clears the event log. After the pending firmware is activated, the configuration is recovered. This process may take a few minutes. To save the event log to a file before resetting, enter the Set Log Archive command.
Admin session hotreset You can load and activate version 6.5.x firmware on an operating I/O module without disrupting data traffic or having to re-initialize attached devices under the following conditions: The current firmware version permits the installation and non-disruptive activation of 6.5 firmware. Refer to the 6.5 Firmware Release Notes for previous compatible firmware versions. No changes are being made to switches in the fabric including installing firmware, powering up, powering down, disconnecting or connecting ISLs, and switch configuration changes. No port on the I/O module is in the diagnostic state. No zoning changes are being made on the I/O module. No changes are being made to attached devices including powering up, powering down, disconnecting, connecting, and HBA configuration changes. Ports that are stable when the non-disruptive activation begins, then change states, will be reset. When the non-disruptive activation is complete, QuickTools and Enterprise Fabric Suite 2007 sessions reconnect automatically. However, CLI and SSH sessions must be restarted manually. This command clears the event log and all counters.
59243-00 A
13-33
Image
Manages and installs I/O module firmware.
Authority Syntax
Admin session image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] install list tftp [ip_address] [file_source] [file_destination] unpack [file] cleanup Removes all firmware image files from the I/O module. All firmware image files are removed automatically each time the I/O module is reset. fetch [account_name] [ip_address] [file_source] [file_destination] Retrieves image file given by [file_source] using FTP and stores it on the I/O module with the file name given by [file_destination]. The image file is retrieved from the host IP address given by [Ip_address]. If an account name needs a password to access the FTP server, the system will prompt you for it. install Downloads firmware from a remote host to the I/O module, installs the firmware, then resets the I/O module to activate the firmware. This is disruptive. The command prompts you for the following: File transfer protocol (FTP or TFTP) IP address of the remote host An account name and password on the remote host (FTP only) Pathname for the firmware image file list Displays the list of image files that reside on the I/O module. tftp [ip_address] [file_source] [file_destination] Retrieves image file given by [file_source] using TFTP and stores it on the I/O module with the file name given by [file_destination]. The image file is retrieved from the host IP address given by [Ip_address].
Keywords
13-34
59243-00 A
A
unpack [file]
Installs the firmware file given by [file]. After unpacking the file, a message appears confirming successful unpacking. The I/O module must be reset for the new firmware to take effect.
Notes
To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware. To install firmware when the management workstation has an FTP server, use the Image Install command or the Firmware Install command.
Examples
Connected to 10.0.0.254 (10.0.0.254). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. 331 Password required for johndoe. Password: xxxxxxxxx 230 User johndoe logged in. bin 200 Type set to I. verbose Verbose mode off. This may take several seconds... The switch will now reset. Connection closed by foreign host.
59243-00 A
13-35
The following is an example of the Image Fetch and Image Unpack commands:
QLogic4GbT (admin) #> image fetch johndoe 10.0.0.254 6.5.00.11_ipc >ftp 10.0.0.254 user:johndoe password: ******** ftp>bin ftp>put 6.5.00.11_ipc ftp>quit SANbox (admin) $>image list SANbox (admin) $>image unpack 6.5.00.11_ipc Image unpack command result: Passed
13-36
59243-00 A
A
Lip
Reinitializes the specified loop port.
Admin session lip [port_number] [port_number] The number of the port to be reinitialized. Ports are numbered beginning with 0. The following is an example of the Lip command:
QLogic4GbT (admin) #> lip 2
59243-00 A
13-37
Logout
Closes the Telnet session.
None logout You can also enter Control-D to close the Telnet session.
13-38
59243-00 A
A
Passwd
Changes a user accounts password.
Admin account name and an Admin session to change another accounts password; You can change you own password without an Admin session. passwd [account_name] [account_name] The user account name. To change the password for an account name other than your own, you must open an Admin session with the account name USERID. If you omit [account_name], you will be prompted to change the password for the current account name.
Examples
please confirm account NEW password: ******** password has been changed.
59243-00 A
13-39
Ping
Initiates an attempt to communicate with another switch over an Ethernet network and reports the result.
None ping [ip_address] [ip_address] The IP address of the switch to query. Broadcast IP addresses, such as 255.255.255.255, are not valid.
Examples
13-40
59243-00 A
A
Ps
Displays current system process information.
13 Command Reference Ps
59243-00 A
13-41
Quit
Closes the Telnet session.
None quit You can also enter Control-D to close the Telnet session.
13-42
59243-00 A
A
Reset
Authority Syntax
Admin session reset config [config_name] factory port [port_list] radius security services snmp switch (default) system zoning config [config_name]
Resets the I/O module configuration parameters. If you omit the keyword, the default is Reset Switch.
Keywords
Resets the configuration given by [config_name] to the factory default values for switch, port, port threshold alarm, and zoning configuration as described in Table 13-5 through Table 13-23. If [config_name] does not exist on the I/O module, a configuration with that name will be created. If you omit [config_name], the active configuration is reset. You must activate the configuration for the changes to take effect. factory Resets I/O module configuration, port configuration, port threshold alarm configuration, zoning configuration, SNMP configuration, system configuration, security configuration, RADIUS configuration, I/O module services configuration, and zoning to the factory default values as described in Table 13-5 through Table 13-23. The I/O module configuration is activated automatically. NOTE: port [port_list] Reinitializes one or more ports given by [port_list]. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, [0 2 10-15] specifies ports 0, 2, 10, 11, 12, 13, 14, and 15. This keyword does not affect installed license keys.
59243-00 A
13-43
radius Resets the RADIUS configuration to the default values as described in Table 13-10. security Clears the security database and deactivates the active security set. The security configuration value, autosave, and fabric binding remain unchanged. services Resets the I/O module services configuration to the default values as described in Table 13-11. snmp Resets the SNMP configuration settings to the factory default values. Refer to Table 13-9 for SNMP configuration default values. switch Resets the I/O module without a power-on self test. This is the default. This reset disrupts traffic and does the following: Activates the pending firmware. Closes all management sessions. Clears the event log. To save the event log before resetting, refer to the Set Log command on page 13-76. To reset the I/O module with a power-on self test, refer to the Hardreset command on page 13-30. To reset the I/O module without disrupting traffic, refer to the Hotreset command on page 13-33. system Resets the system configuration settings to the factory default values as described in Table 13-12. NOTE: Because this keyword changes network parameters, the workstation could lose communication with the I/O module. This keyword does not affect installed license keys. zoning Clears the zoning database and deactivates the active zone set. The zoning configuration parameters (InteropAutoSave, DefaultZone, DiscardInactive) remain unchanged. Refer to Table 13-8 for information about the zoning configuration parameters.
13-44
59243-00 A
A
Notes
The following tables specify the various factory default settings: Enter the Show Config Switch command to display I/O module configuration values. Table 13-5. I/O Module Configuration Defaults
Parameter TransparentMode Admin State Broadcast Enabled InbandEnabled FDMIEnabled FDMIEntries DefaultDomain ID Domain ID Lock Symbolic Name R_A_TOV E_D_TOV Principal Priority Configuration Description InteropMode False Online True True True 1000 1 (0x Hex) False QLogic4GbT 10000 2000 254 Default Config Standard Default
59243-00 A
13-45
S
Table 13-6. Port Configuration Defaults
External Port Defaults (Ports 0, 15, 16, 17, 18, 19) Online Auto GL Portn, where n is the port number False True False False 0 0 True True False False True False Disabled False True Internal Port Defaults (Ports 114)1 Online 4-Gbps F Portn, where n is the port number False True False False 0 0 True True False False False False Disabled False True
Enter the Show Config Port command to display port configuration values.
Parameter Admin State Link Speed Port Type Symbolic Name ALFairness DeviceScanEnabled ForceOfflineRSCN ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable MSEnable NoClose IOStreamGuard VIEnable PDISCPingEnable
1 Ports 114 apply to BladeCenter unit Type 8677. Ports 18 apply to BladeCenter T unit Types 8720 and 8730; ports 914 are not used.
13-46
59243-00 A
A
Parameter ThresholdMonitoringEnabled CRCErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow ISLMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LoginMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LogoutMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LOSMonitoringEnabled RisingTrigger FallingTrigger SampleWindow False True 25 1 10 True 25 0 10 True 2 0 10 True 5 1 10 True 5 1 10 True 100 5 10
Enter Show Config Threshold command to display threshold alarm configuration values. Table 13-7. Port Threshold Alarm Configuration Defaults
Default
59243-00 A
13-47
S
Table 13-8. Zoning Configuration Defaults
Parameter Default True True False
Enter the Show Config Zoning command to display zoning configuration values.
Enter the Show Setup SNMP command to display SNMP configuration values. Table 13-9. SNMP Configuration Defaults
Parameter SNMPEnabled Contact Location Description Trap [1-5] Address Trap [1-5] Port Trap [1-5] Severity Trap [1-5] Version Trap [1-5] Enabled ObjectID AuthFailureTrap ProxyEnabled True <syscontact undefined> <sysLocation undefined> QLogic(R) 4Gb SAN Switch Module for IBM BladeCenter(R) Trap 1: 10.0.0.254; Traps 25: 0.0.0.0 162 Warning 2 False 1.3.6.1.4.1.3873.1.8 False True Default
13-48
59243-00 A
A
Parameter DeviceAuthOrder UserAuthOrder TotalServers DeviceAuthServer UserAuthServer AccountingServer ServerIPAddress ServerUDPPort Timeout Retries SignPackets Local Local 1 False False False 10.0.0.1 1812 2 seconds 0 False
Enter the Show Setup Radius command to display RADIUS configuration values. Table 13-10. RADIUS Configuration Defaults
Default
Enter the Show Setup Services command to display I/O module service configuration values. Table 13-11. Services Configuration Defaults
Parameter TelnetEnabled SSHEnabled GUIMgmtEnabled SSLMgmtEnabled EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled True False True False True True False True True. False Default
59243-00 A
13-49
S
Table 13-12. System Configuration Defaults
Parameter Default Static 30 minutes 0 True False 10.0.0.254 False 10.0.0.254 True
Enter the Show Setup System command to display system configuration values.
Ethernet Network Discovery Admin Timeout InactivityTimeout LocalLogEnabled RemotelogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled
Enter the Show Config Security command to display security configuration values. Table 13-13. Security Configuration Defaults
Parameter AutoSave FabricBindingEnabled PortBindingEnabled True False False Default
13-50
59243-00 A
A
Security
NOTE:
This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Opens a Security Edit session in which to manage the security database on an I/O module. Refer to the Group command on page 13-22 and the Securityset command on page 13-55.
Authority Syntax
Admin session. The keywords Active, History, Limits, and List are available without an Admin session. security active cancel clear edit history limits list restore save active Displays the active security set, its groups, and group members. This keyword does not require an Admin session. cancel Closes a Security Edit session without saving changes. Use the Edit keyword to open a Security Edit session. clear Clears all inactive security sets from the volatile edit copy of the security database. This keyword does not affect the non-volatile security database. However, if you enter the Security Clear command followed by the Security Save command, the non-volatile security database will be cleared from the I/O module. NOTE: The preferred method for clearing the security database from the I/O module is the Reset Security command.
Keywords
59243-00 A
13-51
edit Initiates a Security Edit session in which to make changes to the security database. A Security Edit session enables you to use the Group and Securityset commands to create, add, and delete security sets, groups, and group members. To close a Security Edit session and save changes, enter the Security Save command. To close a Security Edit session without saving changes, enter the Security Cancel command. history Displays history information about the security database and the active security set including the account name that made changes and when those changes were made. This keyword does not require an Admin session. limits Displays the current totals and the security database limits for the number of security sets, groups, members per group, and total members. This keyword does not require an Admin session. list Displays all security sets, groups, and group members in the security database. This keyword does not require an Admin session. restore Restores the volatile security database with the contents of the non-volatile security database. If the AutoSave parameter is False, you can use this keyword to revert changes to the volatile security database that were propagated from another switch in the fabric through security set activation or merging fabrics. Refer to Table 13-13 for information about the AutoSave parameter. save Saves the changes that have been made to the security database during a Security Edit session. Changes you make to any security set will not take effect until you activate that security set. Refer to the Securityset command on page 13-55 for information about activating a security set.
13-52
59243-00 A
A
Examples
QLogic4GbT #> security active Active Security Information SecuritySet ----------alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret Binding Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret Binding Chap MD5 ******** SHA-1 ******** 0 Chap MD5 ******** SHA-1 ******** 0 Group ----GroupMember -----------
10:00:00:00:00:10:21:17
00000000
59243-00 A
13-53
S
Maximum ------4 16 1000 1000 4 15 group1 group2 Current ------1 2 19 [Name] ------
No active securityset defined. Configured Security Information SecuritySet ----------alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret Binding Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret Binding Chap MD5 ******** SHA-1 ******** 0 Chap MD5 ******** SHA-1 ******** 0 Group ----GroupMember -----------
10:00:00:00:00:10:21:17
13-54
59243-00 A
A
Securityset
NOTE:
This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Authority
Admin session and a Security Edit session. Refer to the Security command on page 13-51 for information about starting a Security Edit session. The Active, Groups, and List keywords are available without an Admin session. You must close the Security Edit session before using the Activate and Deactivate keywords. securityset activate [security_set] active add [security_set] [group_list] copy [security_set_source] [security_set_destination] create [security_set] deactivate delete [security_set] groups [security_set] list remove [security_set] [group] rename [security_set_old] [security_set_new] activate [security_set] Activates the security set given by [security_set]. This keyword deactivates the active security set. Close the Security Edit session using the Security Save or Security Cancel command before using this keyword. active Displays the name of the active security set. This keyword is available to without an Admin session. add [security_set] [group_list] Adds one or more groups given by [group_list] to the security set given by [security_set]. Use a <space> to delimit multiple group names in [group_list]. A security set can have a maximum of three groups with no more than one group of each group type.
Syntax
Keywords
59243-00 A
13-55
copy [security_set_source] [security_set_destination] Creates a new security set named [security_set_destination] and copies into it the membership from the security set given by [security_set_source]. create [security_set] Creates the security set with the name given by [security_set]. A security set name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The security database supports a maximum of 4 security sets. deactivate Deactivates the active security set. Close the Security Edit session before using this keyword. delete [security_set] Deletes the security set given by [security_set]. If the specified security set is active, the command is suspended until the security set is deactivated. groups [security_set] Displays all groups that are members of the security set given by [security_set]. This keyword is available without an Admin session. list Displays a list of all security sets. This keyword is available without an Admin session. remove [security_set] [group] Removes a group given by [group] from the security set given by [security_set]. If [security_set] is the active security set, the group will not be removed until the security set has been deactivated. rename [security_set_old] [security_set_new] Renames the security set given by [security_set_old] to the name given by [security_set_new].
Notes
Refer to the Group command on page 13-22 for information about creating and managing groups.
13-56
59243-00 A
A
Examples
QLogic4GbT #> securityset active Active SecuritySet Information -----------------------------ActiveSecuritySet alpha LastActivatedBy LastActivatedOn Remote day month date time year
59243-00 A
13-57
Set Alarm
Controls the display of alarms in the session output stream or clears the alarm log.
Admin session for the Clear keyword. Otherwise, none. set alarm [option] [option] [option] can be one of the following: clear Clears the alarm log history. This value requires an Admin session. on Enables the display of alarms in the session output stream. off Disables the display of alarms in the session output stream. Disabling the display of alarms in the output stream allows command scripts to run without interruption.
Examples
13-58
59243-00 A
A
Set Beacon
Authority Syntax Keywords
None set beacon [state] [state] [state] can be one of the following: on Enables the flashing beacon. off Disables the flashing beacon.
Enables or disables the flashing of the Logged-In LEDs for the purpose of locating an I/O module.
Examples
59243-00 A
13-59
Authority Syntax
Admin session and a Config Edit session set config port [port_number] or set config ports internal external port [port_number] Initiates an edit session in which to change configuration parameters for the port number given by [port_number]. If you omit [port_number], the system begins with port 0 and proceeds in order through the last port. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Enter q to end the configuration for one port, or qq to end the configuration for all ports. Table 13-14 describes the port configuration parameters. NOTE: For external ports (0, 15, 16, 17, 18, 19), all port parameters apply. For internal ports (114), only the port state setting is configurable. Ports 114 apply to BladeCenter unit Type 8677. Ports 18 apply to BladeCenter T unit Types 8720 and 8730; ports 914 are not used. For information about port numbering and mapping, see Appendix A.
Keywords
ports [port_set] Initiates an editing session in which to change configuration parameters (except symbolic port name) for the set of all external ports based on external port 0, or the set of all internal ports based on internal port 1, depending on the value given by [port_set]. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Enter q to end the configuration. Table 13-14 describes the port configuration parameters. [port_set] can have the following values: external The configurations for all external ports (0, 15, 16, 17, 18, 19) are made based on the configuration of external port 0. internal The configuration for all internal ports (114) are made based on the configuration of internal port 1.
13-60
59243-00 A
A
Parameter AdminState Port administrative state:
Online Activates and prepares the port to send data. This is the default. Offline Prevents the port from receiving signal and accepting a device login. Diagnostics Prepares the port for testing and prevents the port from accepting a device login. Down Disables the port by removing power from the port lasers. LinkSpeed PortType Transmission speed: 1-Gbps, 2-Gbps, 4-Gbps, or Auto. The default is Auto. Port type: GL, G, F, FL, Donor. The default is GL. The Donor port type disables the port and makes the buffer credits available to other ports. Refer to the ExtCredit port configuration parameter. SymbolicPortName Descriptive name for the port. The name can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is Port n where n is the port number. This parameter can be changed only with the Set Config Port command. Arbitration loop fairness. Enables (True) or disables (False) the I/O modules priority to arbitrate on the loop. The default is False. Enables (True) or disables (False) the scanning of the connected device for FC-4 descriptor information during login. The default is True. Enables (False) or disables (True) the immediate transmission of RSCN messages when communication between a port and a device is interrupted. If enabled, the RSCN message is delayed for 200 ms for locally attached devices and 400 ms for devices connected through other switches. The default is False. This parameter is ignored if IOStreamGuard is enabled. Send ARB_FF (True) instead of IDLEs (False) on the loop. The default is False.
ALFairness
DeviceScanEnabled
ForceOfflineRSCN
ARB_FF
59243-00 A
13-61
S
Table 13-14. Port Configuration Parameters (Continued)
Description Interoperability credit. The number of buffer-to-buffer credits per port. 0 means the default is unchanged. Default buffer-to-buffer credits are 16 per port. Changing interoperability credits is necessary only for E_Ports that are connected to non-FC-SW-2-compliant switches. Contact your authorized maintenance provider for assistance in using this feature.
Parameter InteropCredit
ExtCredit
Extended credits. The number of port buffer credits that this port can acquire from donor ports. The default is 0. The Extended Credits license key is required to extend port credits. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
FANEnable
Fabric address notification. Enables (True) or disables (False) the communication of the FL_Port address, port name, and node name to the logged-in NL_Port. The default is True. Automatic performance tuning for FL_Ports only. The default is True. If AutoPerfTuning is enabled (True) and the port is an FL_Port, MFSEnable is automatically enabled. LCFEnable and VIEnable are overridden to False. If AutoPerfTuning is disabled (False), MFSEnable, LCFEnable, and VIEnable retain their original values.
AutoPerfTuning
LCFEnable
Link control frame preference routing. This parameter appears only if AutoPerfTuning is False. Enables (True) or disables (False) preferred routing of frames with R_CTL = 1100 (Class 2 responses). The default is False. Enabling LCFEnable will disable MFSEnable. Multi-Frame Sequence bundling. This parameter appears only if AutoPerfTuning is False. Prevents (True) or allows (False) the interleaving of frames in a sequence. The default is False. Enabling MFSEnable disables LCFEnable and VIEnable. Virtual Interface (VI) preference routing. This parameter appears only if AutoPerfTuning is False. Enables (True) or disables (False) VI preference routing. The default is False. Enabling VIEnable will disable MFSEnable. Management server enable. Enables (True) or disables (False) management server on this port. The default is True.
MFSEnable
VIEnable
MSEnable
13-62
59243-00 A
A
Parameter NoClose
IOStreamGuard
59243-00 A
13-63
Examples
The following is an example of the Set Config Port command for external port 0:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config port 0 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. Configuring Port Number: -----------------------AdminState LinkSpeed PortType SymPortName ALFairness (1=Online, 2=Offline, 3=Diagnostics, 4=Down) (1=1Gb/s, 2=2Gb/s, 4=4Gb/s, A=Auto) (GL / G / F / FL / Donor) (string, max=32 chars) (True / False) [Online] [Auto [GL ] ] 0
DeviceScanEnable (True / False) ForceOfflineRSCN (True / False) ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable VIEnable MSEnable NoClose IOStreamGuard PDISCPingEnable (True / False) (decimal value, 0-255) (dec value, increments of 7, non-loop only) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (Enable / Disable / Auto) (True / False)
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.
13-64
59243-00 A
A
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config port 1
The following is an example of the Set Config Port command for internal port 1:
A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. Configuring Port Number: -----------------------AdminState LinkSpeed PortType SymPortName ALFairness (1=Online, 2=Offline, 3=Diagnostics, 4=Down) (2=2Gb/s, 4=4Gb/s, A=Auto) (GL / G / F / FL / Donor) (string, max=32 chars) (True / False) [Online] offline [2Gb/s ] [GL ] [Port1 ] [False ] [True ] [False ] [False ] [0 [0 [True ] ] ] 1
DeviceScanEnable (True / False) ForceOfflineRSCN (True / False) ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable VIEnable MSEnable NoClose IOStreamGuard PDISCPingEnable (True / False) (decimal value, 0-255) (dec value, increments of 7, non-loop only) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (True / False) (Enable / Disable / Auto) (True / False)
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command. QLogic4GbT (admin-config) #> config save QLogic4GbT (admin-config) #> config activate
59243-00 A
13-65
S
This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Configures the security database for the automatic saving of changes to the active security set and fabric binding. The changes you make with this command are not retained when you reset or power cycle the I/O module unless you save them using the Config Save command.
Authority Syntax
Admin session and a Config Edit session set config security This command initiates an editing session in which to change the security database configuration. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Enter q or "Q" to end the editing session. Table 13-15 describes the security configuration parameters. Table 13-15. Security Configuration Parameters
Parameter AutoSave Description Enables (True) or disables (False) the saving of changes to active security set in the I/O modules permanent memory. The default is True. Enables (True) or disables (False) the configuration and enforcement of fabric binding on all switches in the fabric. Fabric binding associates switch worldwide names with a domain ID in the creation of ISL groups.
FabricBindingEnabled
13-66
59243-00 A
A
Examples
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config security
A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. FabricBindingEnabled AutoSave (True / False) (True / False) [False] [True ]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.
59243-00 A
13-67
Admin session and a Config Edit session set config security portbinding [port_number] [port_number] Initiates an editing session in which to change the port binding configuration for the port given by [port_number]. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Enter q or "Q" to end the editing session. Table 13-16 describes the Set Config Security Port parameters. Table 13-16. Port Binding Configuration Parameters
Parameter PortBindingEnabled WWN Description Enables (True) or disables (False) port binding for the port given by [port_number]. Worldwide port name for the port/device that is allowed to connect to the port given by [port_number].
Examples
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.
13-68
59243-00 A
A
Set Config Switch
Sets the I/O module configuration parameters. The changes you make with this command are not retained when you reset or power cycle the I/O module unless you save them using the Config Save command.
Authority Syntax
Admin session and a Config Edit session set config switch This command initiates an editing session in which to change I/O module configuration settings. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table 13-17 describes the I/O module configuration parameters. Table 13-17. I/O Module Configuration Parameters
Parameter TransparentMode Description Transparent mode control of the 20-Port Full Fabric License for IBM BladeCenter: Converts a properly licensed Pass-thru Module to a full-fabric 20-Port 4 Gb SAN Switch Module (False). Converts a 20-Port 4 Gb SAN Switch Module to a Pass-thru Module (True). AdminState I/O module administrative state. Online Activates and prepares the ports to send data. This is the default. Offline Prevents the ports from receiving signal and accepting a device login. Diagnostics Prepares the ports for testing and prevents the ports from accepting a device login. Down Disables the ports by removing power from the port lasers. BroadcastEnabled InbandEnabled Broadcast. Enables (True) or disables (False) forwarding of broadcast frames. The default is True. Inband management. Enables (True) or disables (False) the ability to manage the I/O module over an ISL. The default is True. Fabric Device Monitoring Interface. Enables (True) or disables (False) the monitoring of target and initiator device information. The default is True.
FDMIEnabled
59243-00 A
13-69
S
Description The number of device entries to maintain in the FDMI database. Enter a number from 01000. The default is 1000. Default domain ID. The default is 1. Prevents (True) or allows (False) dynamic reassignment of the domain ID. The default is False. Descriptive name for the I/O module. The name can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is QLogic4GbT. Resource Allocation Timeout Value. The number of milliseconds the I/O module waits to allow two ports to allocate enough resources to establish a link. The default is 10000. Error Detect Timeout Value. The number of milliseconds a port is to wait for errors to clear. The default is 2000. The priority used in the FC-SW-2 principal switch selection algorithm. 1 is high, 255 is low. The default is 254. I/O module configuration description. The configuration description can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is Default Config. Standard, FC-SW-2 compliant interoperability.
R_A_TOV
InteropMode
13-70
59243-00 A
A
Examples
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config switch
A list of attributes with formatting and default values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. TransparentMode AdminState BroadcastEnabled InbandEnabled FDMIEnabled FDMIEntries DefaultDomainID DomainIDLock SymbolicName R_A_TOV E_D_TOV PrincipalPriority ConfigDescription InteropMode (True / False) (1=Online, 2=Offline, 3=Diagnostics) (True / False) (True / False) (True / False) (decimal value, 0-1000) (decimal value, 1-239) (True / False) (string, max=32 chars) (decimal value, 100-100000 msec) (decimal value, 10-20000 msec) (decimal value, 1-255) (string, max=64 chars) (0=Standard) [False [Online [True [True [True [1000 [2 [False [SANbox [10000 [2000 [254 [Standard ] ] ] ] ] ] ] ] ] ] ] ] ]
[Default Config]
59243-00 A
13-71
Authority Syntax
Admin session and a Config Edit session set config threshold Initiates a configuration session by which to generate and log alarms for selected events. The system displays each event, its triggers, and sampling window one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table 13-18 describes the port alarm threshold parameters. Table 13-18. Port Alarm Threshold Parameters
Parameter Threshold Monitoring Enabled Description Master enable/disable parameter for all events. Enables (True) or disables (False) the generation of all enabled event alarms. The default is False. The event type enable/disable parameter. Enables (True) or disables (False) the generation of alarms for each of the following events: CRC errors Decode errors ISL connection count Device login errors Device logout errors Loss-of-signal errors Rising Trigger The event count above which a rising trigger alarm is logged. The I/O module will not generate another rising trigger alarm for that event until the count descends below the falling trigger and again exceeds the rising trigger. The event count below which a falling trigger alarm is logged. The I/O module will not generate another falling trigger alarm for that event until the count exceeds the rising trigger and descends again below the falling trigger. The time in seconds in which to count events.
Falling Trigger
Sample Window
13-72
59243-00 A
A
Notes Examples
The I/O module will down a port if an alarm condition is not cleared within three consecutive sampling windows (by default 30 seconds). Reset the port to bring it back online. An alarm is cleared when the threshold monitoring detects that the error rate has fallen below the falling trigger. The following is an example of the Set Config Threshold command:
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit QLogic4GbT (admin-config) #> set config threshold A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. ThresholdMonitoringEnabled CRCErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow ISLMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LoginMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LogoutMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LOSMonitoringEnabled RisingTrigger FallingTrigger SampleWindow (True / False) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) (True / False) (decimal value, 1-1000) (decimal value, 0-1000) [False [True [25 [1 [True [25 [0 [True [2 [0 [True [5 [1 [True [5 [1 [True [100 [5 ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ] ]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.
59243-00 A
13-73
Authority Syntax
Admin session and a Config Edit session set config zoning Initiates an editing session in which to change the zoning database configuration. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table 13-19. Zoning Configuration Parameters
Parameter InteropAutoSave Description Enables (True) or disables (False) the saving of changes to active zone set in the I/O modules non-volatile zoning database.The default is True. Disabling the Autosave parameter can be useful to prevent the propagation of zoning information when experimenting with different zoning schemes. However, leaving the InteropAutoSave parameter disabled can disrupt device configurations should an I/O module have to be reset. For this reason, the InteropAutoSave parameter should be enabled in a production environment. DefaultZone Enables (True) or disables (False) communication among ports/devices that are not defined in the active zone set. The default is True. Enables (True) or disables (False) the discarding of all inactive zone sets from that zoning database. Inactive zone sets are all zone sets except the active zone set. The default is False.
DiscardInactive
13-74
59243-00 A
A
Examples
QLogic4GbT #> admin start QLogic4GbT (admin) #> config edit The config named default is being edited. QLogic4GbT (admin-config) #> set config zoning
A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so. InteropAutoSave DefaultZone DiscardInactive (True / False) (True / False) (True / False) [True ] [True ] [False]
Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.
59243-00 A
13-75
Set Log
Specifies the events to record in the event log and display on the screen. You determine what events to record in the I/O module event log using the Component, Level, and Port keywords. You determine what events are automatically displayed on the screen using the Display keyword. Alarms are always displayed on the screen.
Authority Syntax
Admin session set log archive clear component [filter_list] display [filter] level [filter] port [port_list] restore save start (default) stop archive Collects all log entries and stores the result in new file named logfile that is maintained in I/O module memory where it can be downloaded using FTP. To download logfile, open an FTP session, log in with account name/password of images for both, and type get logfile. clear Clears all log entries. component [filter_list] Specifies one or more components given by [filter_list] to monitor for events. A component is a firmware module that is responsible for a particular portion of I/O module operation. Use a <space> to delimit values in the list. [filter_list] can be one or more of the following: All Monitors all components. To maintain optimal I/O module performance, do not use this setting with the Level keyword set to Info. Eport Monitors all E_Ports.
Keywords
13-76
59243-00 A
A
Mgmtserver Monitors management server status. Nameserver Monitors name server status. None Monitor none of the component events. Port Monitors all port events. SNMP Monitors all SNMP events. Switch Monitors I/O module management events. Zoning Monitors zoning conflict events. display [filter]
Specifies the log events to automatically display on the screen according to the event severity levels given by [filter]. [filter] can be one of the following values: Critical Critical severity level events. The critical level describes events that are generally disruptive to the administration or operation of the fabric, but require no action. Warn Warning severity level events. The warning level describes events that are generally not disruptive to the administration or operation of the fabric, but are more important than the informative level events. Info Informative severity level events. The informative level describes routine events associated with a normal fabric. None Specifies no severity levels for display on the screen.
59243-00 A
13-77
level [filter] Specifies the severity level given by [filter] to use in monitoring and logging events for the specified components or ports. [filter] can be one of the following values: Critical Monitors critical events. The critical level describes events that are generally disruptive to the administration or operation of the fabric, but require no action. This is the default severity level. Warn Monitors warning and critical events. The warning level describes events that are generally not disruptive to the administration or operation of the fabric, but are more important than the informative level events. Info Monitors informative, warning, and critical events. The informative level describes routine events associated with a normal fabric. NOTE: Logging events at the Info severity level can deplete I/O module resources because of the high volume of events.
None Monitors none of the severity levels. port [port_list] Specifies one or more ports to monitor for events. Choose one of the following values: [port_list] Specifies the port or ports to monitor. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, [0 2 10-15] specifies ports 0, 2, 10, 11, 12, 13, 14, and 15. All Specifies all ports. None Disables monitoring on all ports. restore Restores and saves the port, component, and level settings to the default values.
13-78
59243-00 A
A
save
Saves the log settings for the component, severity level, port, and display level. These settings remain in effect after an I/O module reset. The log settings can be viewed using the Show Log Settings command. To export log entries to a file, use the Set Log Archive command. start Starts the logging of events based on the Port, Component, and Level keywords assigned to the current configuration. The logging continues until you enter the Set Log Stop command. stop Stops logging of events.
Notes
In addition to critical, warn, and informative severity levels, the highest event severity level is alarm. The alarm level describes events that are disruptive to the administration or operation of a fabric and require administrator intervention. Alarms are always logged and always displayed on the screen. The following is an example of the Set Log Archive command:
QLogic4GbT: user1> admin start QLogic4GbT (admin): user1> set log archive
Examples
59243-00 A
13-79
Set Pagebreak
Specifies how much information is displayed on the screen at a time. This command is useful for disabling pagebreaks to allow command scripts to run without interruption.
None pagebreak [state] [state] [state] can be one of the following: on Limits the display of information to 20 lines at a time. The page break function affects the following commands: Alias (List, Members) Show (Alarm, Log) Zone (List, Members) Zoneset (List, Zones) Zoning (Active, List) off Allows continuous display of information without a break. This is the default.
13-80
59243-00 A
A
Examples
QLogic4GbT #> set pagebreak on QLogic4GbT #> help General Help -----------admin config create date exit feature firmware hardreset help history hotreset image logout passwd ping ps quit reset set show shutdown test TEST_OPTIONS RESET_OPTIONS SET_OPTIONS SHOW_OPTIONS [USER_ACCT_NAME] IP_ADDR IMAGE_OPTIONS HELP_OPTIONS FEATURE_OPTIONS install ADMIN_OPTIONS CONFIG_OPTIONS CREATE_OPTIONS [MMDDhhmmCCYY]
Press any key for more help or 'q' to end this list... uptime user whoami USER_OPTIONS
59243-00 A
13-81
Set Port
Sets port state and speed for the specified port temporarily until the next I/O module reset or new configuration activation. This command also clears port counters and moves port licenses from one port to another. NOTE: For external ports (0, 15, 16, 17, 18, 19), all port parameters apply. For internal ports (114), only the port state setting is configurable.
Authority Syntax
Admin session set port clear or set port [port_number] bypass [alpa] clear enable license [destination] speed [transmission_speed] state [state] [port_number] Specifies the port. Ports are numbered beginning with 0. For information about port numbering and mapping, see Appendix A. bypass [alpa] Sends a Loop Port Bypass (LPB) to a specific Arbitrated Loop Physical Address (ALPA) or to all ALPAs on the arbitrated loop. [alpa] can be a specific ALPA or the keyword ALL to choose all ALPAs. clear Clears the counters on all ports or the port given by [port_number]. enable Sends a Loop Port Enable (LPE) to all ALPAs on the arbitrated loop. license [destination] Moves the port license from the active port given by [port_number] to the inactive port number given by [destination]. This keyword applies only to the 10-Port 4 Gb SAN Switch Module.
Keywords
13-82
59243-00 A
A
speed [transmission_speed] 1Gb/s One gigabit per second. 2Gb/s Two gigabits per second. 4Gb/s Four gigabits per second. Auto The port speed is automatically detected. state [state]
Specifies the transmission speed for the specified port. Choose one of the following port speed values:
Specifies one of the following administrative states for the specified port: Online Activates and prepares the port to send data. Offline Prevents the port from receiving signal and accepting a device login. Diagnostics Prepares the port for testing and prevents the port from accepting a device login. Down Disables the port by removing power from the port lasers.
Examples
59243-00 A
13-83
S
This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Authority Syntax
Admin session set setup radius Prompts you in a line-by-line fashion to configure RADIUS servers for user account and device authentication. Table 13-20 describes the RADIUS server configuration fields. Table 13-20. RADIUS Service Settings
Entry DeviceAuthOrder Description Authenticator priority for devices: Local: Authenticate devices using only the local security database. This is the default. Radius: Authenticate devices using only the security database on the RADIUS server. RadiusLocal: Authenticate devices using the RADIUS server security database first. If the RADIUS server is unavailable, then use the local I/O module security database. UserAuthOrder Authenticator priority for user accounts: Local: Authenticate users using only the local security database. This is the default. Radius: Authenticate users using only the security database on the RADIUS server. RadiusLocal: Authenticate users using the RADIUS server security database first. If the RADIUS server is unavailable, then use the local I/O module security database. TotalServers Number of RADIUS servers to configure during this session. Setting TotalServers to 0 disables all RADIUS authentication. The default is 0. IP address of the RADIUS server. The default is 10.0.0.1. User Datagram Protocol (UDP) port number on the RADIUS server. The default is 1812.
ServerIPAddress ServerUDPPort
13-84
59243-00 A
A
Entry DeviceAuthServer UserAuthServer Description
Enable (True) or disable (False) this server for device authentication. The default is False. Enable (True) or disable (False) this server for user account authentication. A user authentication RADIUS server requires a secure management connection (SSL). The default is True. Enable (True) or disable (False) this server for auditing of activity during a user session. When enabled, user activity is audited whether UserAuthServer is enabled or not.The default is False. The accounting server UDP port number is the ServerUDPPort value plus 1 (default 1813). Number of seconds to wait to receive a response from the RADIUS server before timing out. The default is 2. Number of retries after the first attempt to establish communication with the RADIUS server fails. The default is 0. Enable (True) or disable (False) the use of sign packets to protect the RADIUS server packet integrity. The default is False. 32-byte hex string or 16-byte ASCII string used as a password for authentication purposes between the I/O module and the RADIUS server.
AccountingServer
59243-00 A
13-85
Examples
Do you want to save and activate this radius setup? (y/n): [y]
13-86
59243-00 A
A
Set Setup Services
Configures services on the I/O module.
Authority Syntax
Admin session set setup services Prompts you in a line-by-line fashion to enable or disable I/O module services. Table 13-21 describes the I/O module service parameters. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. NOTE: Use caution when disabling TelnetEnabled and GUIMgmtEnabled; it is possible to disable all Ethernet access to the I/O module. Table 13-21. I/O Module Services Settings
Entry TelnetEnabled Description Enables (True) or disables (False) the ability to manage the I/O module over a Telnet connection. Disabling this service is not recommended. The default is True. Enables (True) or disables (False) Secure Shell (SSH) connections to the I/O module. SSH secures the remote connection to the I/O module. To establish a secure remote connection, your workstation must use an SSH client. The default is False. The SSH service requires the Fabric Security license key To purchase a license key, contact your authorized maintenance provider or authorized reseller. GUIMgmtEnabled Enables (True) or disables (False) out-of-band management of the I/O module with Enterprise Fabric Suite 2007, the Application Programming Interface, SNMP, and SMI-S. The default is True.
SSHEnabled
59243-00 A
13-87
S
Table 13-21. I/O Module Services Settings (Continued)
Entry Description Enables (True) or disables (False) secure SSL connections for management applications including Enterprise Fabric Suite 2007, QuickTools, Application Programming Interface, and SMI-S. The default is False. The SSL service requires the Fabric Security license key. To enable secure SSL connections, you must first synchronize the date and time on the I/O module and workstation. This service must be enabled to authenticate users through a RADIUS server. Enabling SSL automatically creates a security certificate on the I/O module. To disable SSL when using a user authentication RADIUS server, the RADIUS server authentication order must be local. The SSL service requires the Fabric Security license key To purchase a license key, contact your authorized maintenance provider or authorized reseller.
SSLEnabled
EmbeddedGUIEnabled
Enables (True) or disables (False) the QuickTools embedded management application. QuickTools enables you to point at an I/O module with an internet browser and manage the I/O module. This parameter is the master control for the Set Setup System command parameter, EmbeddedGUIEnabled. The default is True. Enables (True) or disables (False) the management of the I/O module through third-party applications that use the Simple Network Management Protocol (SNMP). This parameter is the master control for the Set Setup SNMP command parameter, SNMPEnabled. The default is True. Enables (True) or disables (False) the Network Time Protocol (NTP) which allows the synchronizing of I/O module and workstation dates and times with an NTP server. This helps to prevent invalid SSL certificates and timestamp confusion in the event log. The default is False. This parameter is the master control for the Set Setup System command parameter, NTPClientEnabled. The default is False.
SNMPEnabled
NTPEnabled
CIMEnabled
Enables (True) or disables (False) the management of the I/O module through third-party applications that use SMI-S.
13-88
59243-00 A
A
Entry FTPEnabled
MgmtServerEnabled
59243-00 A
13-89
Examples
Do you want to save and activate this services setup? (y/n): [y]
SSHEnabled and SSLEnabled are available only with the Fabric Security license.
13-90
59243-00 A
A
Set Setup SNMP
Configures SNMP on the I/O module.
Authority Syntax
Admin session set setup snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table 13-22 describes the SNMP fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table 13-22. SNMP Configuration Settings
Entry SNMPEnabled Contact Description Enables (True) or disables (False) SNMP on the I/O module. The default is True. Specifies the name of the person to be contacted to respond to trap events. The name can be up to 64 characters excluding #, semicolon (;), and comma (,). The default is undefined. Specifies the name of the I/O module location. The name can be up to 64 characters excluding #, semicolon (;), and comma (,). The default is undefined. Specifies the workstation IP address to which SNMP traps are sent. The default address for trap 1 is 10.0.0.254. The default address for traps 25 is 0.0.0.0. Addresses, other than 0.0.0.0, for all traps must be unique. Specifies the workstation port to which SNMP traps are sent. Valid workstation port numbers are 165535. The default is 162. Specifies the severity level to use when monitoring trap events. The default is Warning. Specifies the SNMP version (1 or 2) to use in formatting traps. The default is 2. Specifies whether traps (event information) are enabled or disabled (default). Read community password that authorizes an SNMP agent to read information from the I/O module. This is a write-only field. The value on the I/O module and the SNMP management server must be the same. The read community password can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is public.
Location
Trap [1-5] Severity Trap [1-5] Version Trap [1-5] Enabled ReadCommunity
59243-00 A
13-91
S
Table 13-22. SNMP Configuration Settings (Continued)
Description Write community password that authorizes an SNMP agent to write information to the I/O module. This is a write-only field. The value on the I/O module and the SNMP management server must be the same. The write community password can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is private. Trap community password that authorizes an SNMP agent to receive traps. This is a write-only field. The value on the I/O module and the SNMP management server must be the same. The trap community password can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is public. Enables (True) or disables (False) the generation of traps in response to trap authentication failures. The default is False. Enables (True) or disables (False) SNMP communication with other switches in the fabric. The default is True.
Entry WriteCommunity
TrapCommunity
AuthFailureTrap ProxyEnabled
13-92
59243-00 A
A
Examples
QLogic4GbT (admin) #> set setup snmp
59243-00 A
13-93
Authority Syntax
Admin session set setup system Prompts you in a line-by-line fashion to change system configuration settings. Table 13-23 describes the system configuration fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table 13-23. System Configuration Settings
Entry FCNetworkDiscovery AdminTimeout Description Ethernet boot method: 1 - Static, 3 - DHCP. The default is 1 - Static. Amount of time in minutes the I/O module waits before terminating an idle Admin session. Zero (0) disables the time out threshold. The default is 30, the maximum is 1440. Amount of time in minutes the I/O module waits before terminating an idle Telnet command line interface session. Zero (0) disables the time out threshold. The default is 0, the maximum is 1440. Enables (True) or disables (False) the saving of log information on the I/O module. The default is True. Enables (True) or disables (False) the recording of the I/O module event log on a remote host that supports the syslog protocol. The default is False. The IP address of the host that will receive the I/O module event log information if remote logging is enabled. The default is 10.0.0.254. Enables (True) or disables (False) the Network Time Protocol (NTP) client on the I/O module. This client enables the I/O module to synchronize its time with an NTP server. This feature supports NTP version 4 and is compatible with version 3. An Ethernet connection to the server is required and you must first set an initial time and date on the I/O module. The synchronized time becomes effective immediately. The default is False. The IP address of the NTP server from which the NTP client acquires the time and date. The default is 10.0.0.254.
InactivityTimeout
LocalLogEnabled RemoteLogEnabled
RemoteLogHostAddress
NTPClientEnabled
NTPServerAddress
13-94
59243-00 A
A
Entry EmbeddedGUIEnabled
Examples
59243-00 A
13-95
Admin session set switch state [state] [state] [state] can be one of the following: online Activates and prepares the ports to send data. This is the default. offline Prevents the ports from receiving signal and accepting a device login. diagnostics Prepares the ports for testing and prevents each port from accepting a device login. When you leave the diagnostics state, the I/O module automatically resets.
Examples
13-96
59243-00 A
A
Set Timezone
Specifies the time zone for the I/O module and the workstation. The default is Universal Time (UTC) also known as Greenwich Mean Time (GMT). This keyword prompts you to choose a region, then a subregion to specify the time zone.
Admin session set timezone The following is an example of the Set Timezone command:
QLogic4GbT (admin) #> set timezone Africa Antarctica Atlantic Europe Pacific America Asia Australia Indian UTC Press ENTER for more options or 'q' to make a selection. America/Grenada America/Guatemala America/Guyana America/Havana America/Indiana America/Inuvik America/Jamaica America/Kentucky America/Lima America/Louisville America/Managua America/Martinique America/Menominee America/Mexico_City America/Monterrey America/Montreal America/Nassau America/Nipigon America/Noronha America/Panama America/Guadeloupe America/Guayaquil America/Halifax America/Hermosillo America/Indianapolis America/Iqaluit America/Juneau America/La_Paz America/Los_Angeles America/Maceio America/Manaus America/Mazatlan America/Merida America/Miquelon America/Montevideo America/Montserrat America/New_York America/Nome America/North_Dakota America/Pangnirtung
Press ENTER for more options or 'q' to make a selection. q Enter selection (or 'q' to quit): america/north_dakota America/North_Dakota/Center Enter selection (or 'q' to quit): america/north_dakota/center
59243-00 A
13-97
Show About
Displays an introductory set of information about operational attributes of the I/O module. This command is equivalent to the Show Version command.
None show about The following is an example of the Show About command:
QLogic4GbT #> show about ***************************************************** * * * Command Line Interface SHell (CLISH) * * *
***************************************************** SystemDescription EthNetworkAddress MACAddress WorldWideName ChassisSerialNumber SymbolicName ActiveSWVersion ActiveTimestamp DiagnosticsStatus QLogic(R)20-port 4Gb SAN Switch Module for IBM BladeCenter 10.20.11.192 (use 'set setup system' to update) 00:c0:dd:00:06:07 10:00:00:c0:dd:00:06:07 11S0632A00127 QLogic4GbT V6.5.x.x.xx.xx day month date time year Passed
13-98
59243-00 A
A
Show Alarm
Authority Syntax Keywords
None show alarm settings settings
Displays the alarm log and session output stream display setting.
Displays the status of the parameter that controls the display of alarms in the session output stream. This parameter is set using the Set Alarm command.
Notes Examples
The alarm log is cleared when the I/O module is reset or power cycled. The following is an example of the Show Alarm Settings command:
QLogic4GbT #> show alarm settings Current settings for alarm -------------------------display ON
59243-00 A
13-99
Show Broadcast
Displays the broadcast tree information and all ports that are currently transmitting and receiving broadcast frames.
None show broadcast The following is an example of the Show Broadcast command:
QLogic4GbT #> show broadcast Group Member Ports ISL Ports ----- ------------ --------0 3 15 16 16
13-100
59243-00 A
A
Show Chassis
Displays chassis component status, and temperature.
None show chassis The following is an example of the Show Chassis command.
QLogic4GbT #> show chassis Chassis Information ------------------BoardTemp (1) - Degrees Celsius PowerSupplyStatus (1) HeartBeatCode HeartBeatStatus 36 Good 1 Normal
59243-00 A
13-101
None show config port [port_number] [port_number] The number of the port. Ports are numbered beginning with 0. If you omit [port_number], all ports are specified.
Examples
The following is an example of the Show Config Port command for port 0:
QLogic4GbT #> show config port 0 Configuration Name: default ----------------------------Port Number: 0 -----------AdminState LinkSpeed PortType SymbolicName ALFairness DeviceScanEnabled ForceOfflineRSCN ARB_FF InteropCredit ExtCredit FANEnabled AutoPerfTuning LCFEnabled MSEnabled NoClose IOStreamGuard VIEnabled MFSEnabled PDISCPingEnable Online Auto GL Port0 False True False False 0 0 True False False True False Disabled False True True
13-102
59243-00 A
A
Show Config Security
NOTE:
This command requires the Fabric Security license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
None show config security The following is an example of the Show Config Security command:
QLogic4GbT #> show config security Configuration Name: default ------------------Switch Security Configuration Information ----------------------------------------FabricBindingEnabled AutoSave Port ---0 15 16 17 18 19 1 2 3 4 5 6 7 8 9 10 11 12 13 14 False True Binding Status -------------False False False False False False False False False False False False False False False False False False False False WWN --No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found. No port binding entries found.
59243-00 A
13-103
None show config security portbinding [port_number] [port_number] The number of the port. If you omit [port_number], the port binding configuration for all ports is displayed.
Examples
13-104
59243-00 A
A
Show Config Switch
Displays the I/O module configuration parameters.
None show config switch The following is an example of the Show Config Switch command:
QLogic4GbT #> show config switch Configuration Name: default ------------------Switch Configuration Information -------------------------------TransparentMode AdminState BroadcastEnabled InbandEnabled FDMIEnabled FDMIEntries DefaultDomainID DomainIDLock SymbolicName R_A_TOV E_D_TOV PrincipalPriority ConfigDescription ConfigLastSavedBy ConfigLastSavedOn InteropMode False Online False True False 10 19 (0x13) True QLogic4GbT 10000 2000 254 Default Config admin@OB-session5 day month date time year Standard
59243-00 A
13-105
None show config threshold The following is an example of the Show Config Threshold command:
QLogic4GbT #> show config threshold Configuration Name: default -----------Threshold Configuration Information ----------------------------------ThresholdMonitoringEnabled CRCErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow ISLMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LoginMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LogoutMonitoringEnabled RisingTrigger FallingTrigger SampleWindow LOSMonitoringEnabled RisingTrigger FallingTrigger SampleWindow False True 25 1 10 True 25 0 10 True 2 0 10 True 5 1 10 True 5 1 10 True 100 5 10
13-106
59243-00 A
A
Show Config Zoning
Authority Syntax Examples
None show config zoning
59243-00 A
13-107
Show Domains
Displays list of each domain and its worldwide name in the fabric.
None show domains The following is an example of the Show Domains command:
QLogic4GbT #> show domains Principal switch is (remote): 10:00:00:60:69:50:0b:6c Upstream Principal ISL is Domain ID List: Domain 97 Domain 98 Domain 99 (0x61) (0x62) (0x63) WWN = 10:00:00:c0:dd:00:71:ed WWN = 10:00:00:60:df:22:2e:0c WWN = 10:00:00:c0:dd:00:72:45 WWN = 10:00:00:c0:dd:00:ba:68 WWN = 10:00:00:60:df:22:2e:06 WWN = 10:00:00:c0:dd:00:90:ef WWN = 10:00:00:60:69:50:0b:6c WWN = 10:00:00:c0:dd:00:b8:b7 : 1
Domain 100 (0x64) Domain 101 (0x65) Domain 102 (0x66) Domain 103 (0x67) Domain 104 (0x68)
13-108
59243-00 A
A
Show Donor
NOTE:
Displays list of current donor and extended credit configuration for all ports. The Extended Credits license key is required to extend port credits. To purchase a license key, contact your authorized maintenance provider or authorized reseller.
None show donor The following is an example of the Show Donor command:
QLogic4GbT #> show donor Config Ext Credit Max Credit Donated Donor Valid Groups to Port ---Ext1:0 Type G Requested 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Credit Pool ----------0 Available 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 to Port Group Extend Credit None None None None None None None None None None None None None None None None None None None None 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 ------ ---------- ---------- ------- ----- ---------------
Ext2:15 GL Ext3:16 GL Ext4:17 GL Ext5:18 GL Ext6:19 GL Bay1 Bay2 Bay3 Bay4 Bay5 Bay6 Bay7 Bay8 Bay9 Bay10 Bay11 Bay12 Bay13 Bay14 F F F F F F F F F F F F F F
59243-00 A
13-109
Show Fabric
Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address.
None show fabric The following is an example of the Show Fabric command:
QLogic4GbT #> show fabric Domain -----1 (0x01) *99 (0x63) WWN --Enet IP Addr -----------FC IP Addr ---------0.0.0.0 0.0.0.0 SymbolicName -----------QLogic4GbT SANbox-90.54
13-110
59243-00 A
A
Show FDMI
Authority Syntax Keywords
None show fdmi [port_wwn] [port_wwn]
The device world wide port name for which to display information. If you omit [port_wwn], the command displays a summary of host bus adapter information for all attached devices in the fabric. Illegal characters in the display appear as question marks (?).
Examples
59243-00 A
13-111
S
QLogic Corporation [04202 QLA2342 QLogic QLA2342 PCI Fibre Channel Adapter 610000 20:00:00:e0:8b:07:aa:bc FC5010409-10 8.2.3.10 Beta 2 (W2K VI) 1.21 03.02.13. SunOS 5.8 2040 1
13-112
59243-00 A
A
Show Interface
Displays the status of the active network interfaces.
None show interface The following is an example of the Show Interface command:
QLogic4GbT #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD:00:BD:ED Bcast:10.20.68.255 MTU:1500 Mask:255.255.255.0 Metric:1 inet addr:10.20.68.107
RX packets:4712 errors:0 dropped:0 overruns:0 frame:0 TX packets:3000 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:100 RX bytes:415313 (405.5 Kb) RX bytes:20116 (19.6 Kb) TX bytes:716751 (699.9 Kb) TX bytes:20116 (19.6 Kb) Interrupt:11 Base address:0xfcc0
59243-00 A
13-113
Show Log
Displays the contents of the log or the parameters used to create and display entries in the log. The log contains a maximum of 1200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest.
Authority Syntax
None show log [number_of_events] component display [filter] level options port settings [number_of_events] Specifies the number of the most recent events to display from the event log. [number_of_events] must be a positive integer. component Displays the components currently being monitored for events. Table 13-24 describes the log monitoring components. Table 13-24. Log Monitoring Components
Component Chassis CLI Eport Mgmtserver Nameserver Other Port SNMP Switch Zoning Description Chassis hardware components such as fans and power supplies Command line interface events E_Port events Management server events Name server events Miscellaneous events Port events SNMP events I/O module management events Zoning conflict events
Keywords
13-114
59243-00 A
A
display [filter] Info Displays all informative events. Warning Displays all warning events. Critical Displays all critical events. Eport Displays all events related to E_Ports. Mgmtserver
Displays log events on the screen according to the component or severity level filter given by [filter]. [filter] can be one of the following:
Displays all events related to the management server. Nameserver Displays all events related to the name server. Port [port_number] Displays all events related to the port given by [port_number]. SNMP Displays all events related to SNMP. Switch Displays all events related to I/O module management. Zoning Displays all events related to zoning. level Displays the event severity level logging setting and the display level setting. options Displays the options that are available for configuring event logging and automatic display to the screen. Refer to the Set Log command on page 13-76 for information about how to configure event logging and display level.
59243-00 A
13-115
port Displays the ports being monitored for events. If an event occurs which is of the defined level and on a defined component, but not on a defined port, no entry is made in the log. settings Displays the current filter settings for component, severity level, port, and display level. This command is equivalent to executing the following commands separately: Show Log Component, Show Log Level, and Show Log Port.
Examples
13-116
59243-00 A
A
The following is an example of the Show Log command:
QLogic4GbT #> show log
[1][Fri Jan 07 02:07:56.068 UTC 2000][I][8400.0023][Switch][Successful login user (admin@OB-session8) with admin privilege from address 10.20.32.223-3852] [2][Fri Jan 07 02:07:56.069 UTC 2000][W][8400.0058][Switch][User (USERID) is using their initial/default password] [3][Fri Jan 07 02:08:38.179 UTC 2000][I][8400.0023][Switch][Successful login user (admin@OB-session9) with admin privilege from address 10.20.32.146] [4][Fri Jan 07 02:08:38.180 UTC 2000][W][8400.0058][Switch][User (USERID) is using their initial/default password] [5][Fri Jan 07 02:09:39.793 UTC 2000][I][8400.0023][Switch][Successful login user (admin@OB-session10) with admin privilege from address 10.20.32.223-3862] [6][Fri Jan 07 02:09:39.795 UTC 2000][W][8400.0058][Switch][User (USERID) is using their initial/default password] [7][Fri Jan 07 02:17:10.205 UTC 2000][C][8400.002A][Switch][User (USERID) attempted to log into switch with an incorrect password from 10.20.32.223]
59243-00 A
13-117
Show LSDB
Displays Link State database information.
None show lsdb The following is an example of the Show LSDB command:
QLogic4GbT #> show lsdb Link State Database Information ------------------------------LsID 34: Age=1176, Incarnation=0x800000e5 NeighborDomain=36, LocalPort=6, RemotePort=7, Cost=500 NeighborDomain=35, LocalPort=16, RemotePort=16, Cost=100 NeighborDomain=35, LocalPort=18, RemotePort=19, Cost=100 NeighborDomain=35, LocalPort=7, RemotePort=7, Cost=500 NeighborDomain=35, LocalPort=5, RemotePort=4, Cost=500 Local Domain LsID 35: Age=1166, Incarnation=0x800000cc
NeighborDomain=34, LocalPort=16, RemotePort=16, Cost=100 NeighborDomain=34, LocalPort=19, RemotePort=18, Cost=100 NeighborDomain=36, LocalPort=5, RemotePort=4, Cost=250 NeighborDomain=34, LocalPort=7, RemotePort=7, Cost=500 NeighborDomain=34, LocalPort=4, RemotePort=5, Cost=500 Route: OutPort=18, Hops=1, Cost=100 LsID 36: Age=1162, Incarnation=0x80000046
NeighborDomain=34, LocalPort=7, RemotePort=6, Cost=500 NeighborDomain=35, LocalPort=4, RemotePort=5, Cost=250 Route: OutPort=16, Hops=2, Cost=350
13-118
59243-00 A
A
Show Media
Displays transceiver operational and diagnostic information for one or more external ports. NOTE: This command requires the SANdoctor license key. To purchase a license key, contact your authorized maintenance provider or authorized reseller. Use the Feature command to install a license key.
Authority Syntax
None show media [port_list] all installed [port_list] The external port or ports for which to display transceiver information. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, [0 15-19] specifies ports 0, 15, 16, 17, 18, and 19. all Displays transceiver information for all ports. installed Displays transceiver information for all ports that have transceivers installed.
Keywords
Notes
Table 13-25 describes the transceiver information in the Show Media display. Table 13-25. Transceiver Information
Information Type MediaType Description Fibre Channel specification or one of the following: NotInstalledtransceiver is not installed. Unknowntransceiver does not have a serial ID. NotApplicabletransceiver is not needed. MediaVendor MediaPartNumber MediaRevision MediaSerialNumber Vendor name Vendor media part number Vender media revision level Vendor media serial number
59243-00 A
13-119
S
Table 13-25. Transceiver Information (Continued)
Description Transmission speed capabilities Temperature in degrees Celsius. Supply voltage in Volts. The range is 06.55. Transmitter laster bias current in milliamps. The range is 0655. Transmitter coupled output power in milliWatts. The range is 06.55. Received optical power in milliWatts. The range is 06.55. Measured value. State associated with the measured value: Normal: Value is in the normal operating range. HighAlarm: Value exceeds the high alarm threshold. HighWarning: Value exceeds the high warning threshold. LowWarning: Value is less than the low warning threshold. LowAlarm: Value is less than the low alarm threshold.
Information Type MediaSpeeds Temp Voltage Tx Bias Tx Power Rx Power Value Status
Vendor specified threshold above which an alarm is issued. Vendor specified threshold above which a warning is issued. Vendor specified threshold below which a warning is issued. Vendor specified threshold below which an alarm is issued.
13-120
59243-00 A
A
Examples
QLogic4GbT #> show media 19 Port Number: 19 -----------MediaType MediaVendor MediaPartNumber MediaRevision MediaSerialNumber MediaSpeeds AZ6P51300545 1Gb/s, 2Gb/s, 4Gb/s Temp (C) Value Status HighAlarm HighWarning LowWarning LowAlarm 34.62 Normal 95.00 90.00 -25.00 -32.00 Voltage (V) 3.33 Normal 3.63 3.56 3.04 2.97 Tx Bias (mA) 7.10 Normal 13.00 12.00 3.00 2.00 400-M5-SN-S Intel Corp. TXN31115D000000
The following is an example of the Show Media command for port 19:
59243-00 A
13-121
S
Temp Voltage (V) ------3.34 3.34 N/A N/A N/A 3.33 N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A Tx Bias (mA) ------6.45 6.60 N/A N/A N/A 7.08 N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A Tx Pwr (mW) -----0.314 0.342 N/A N/A N/A 0.348 N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A Rx Pwr (mW) -----0.366 0.377 N/A N/A N/A 0.211 N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
The following is an example of the Show Media command for all ports:
QLogic4GbT#> show media Note: -- LowAlarm; - LowWarning; + HighWarning; ++ HighAlarm
Port ---Ext1:0
(C) ------35.25 34.28 N/A N/A N/A 34.78 N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A
Ext2:15 Intel Corp. Ext3:16 NotInstalled Ext4:17 NotInstalled Ext5:18 NotInstalled Ext6:19 Intel Corp. Bay1 Bay2 Bay3 Bay4 Bay5 Bay6 Bay7 Bay8 Bay9 Bay10 Bay11 Bay12 Bay13 Bay14 NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable NotApplicable
13-122
59243-00 A
A
Show Mem
Displays information about memory activity.
None show mem [count] [count] The number of seconds for which to display memory information. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units. NOTE: This keyword will display memory activity updates until [count] is reachedit cannot be interrupted. Therefore, avoid using large values for [count].
Examples
59243-00 A
13-123
Show NS
Displays the WWNs for devices in the fabric.
None show ns [option] [option] The domain IDs or port IDs for which to display name server information. If you omit [option], name server information for the local domain ID is displayed. [option] can have the following values: all Displays WWNs for all switches and ports. [domain_id] Displays WWNs for all devices connected to the switch given by [domain_id]. [domain_id] is a switch domain ID. [port_id] Displays the WWNs for the devices connected to the port given by [port_id]. [port_id] is a port Fibre Channel address.
Examples
18 (0x12) 120700 N
21:00:00:e0:8b:07:a7:bc 20:00:00:e0:8b:07:a7:bc
13-124
59243-00 A
A
QLogic4GbT #> show ns 1301e1 Port ID: 1301e1 -------PortType PortWWN SymbolicPortName NodeWWN SymbolicNodeName NodeIPAddress ClassOfService PortIPAddress FabricPortName FC4Type FC4Desc 0.0.0.0 3 0.0.0.0 20:01:00:c0:dd:00:bc:56 FCP (NULL) 20:00:00:20:37:73:13:69 NL 21:00:00:20:37:73:13:69
59243-00 A
13-125
Show Pagebreak
Displays the current pagebreak setting.
None show pagebreak The pagebreak setting limits the display of information to 20 lines or allows the continuous display of information without a break. The following is an example of the Show Pagebreak command:
QLogic4GbT #> show pagebreak current setting: ON
13-126
59243-00 A
A
Show Perf
Displays port performance in frames/second and bytes/second. If you omit the keyword, the command displays data transmitted (out), data received (in), and total data transmitted and received in frames/second and bytes per second. Transmission rates are expressed in thousands (K) and millions (M).
Authority Syntax
None show perf or show perf byte inbyte outbyte frame inframe outframe errors byte Displays continuous performance data in total bytes/second transmitted and received for all ports. Type any character to stop the display. inbyte Displays continuous performance data in bytes/second received for all ports. Type any character to stop the display. outbyte Displays continuous performance data in bytes/second transmitted for all ports. Type any character to stop the display. frame Displays continuous performance data in total frames/second transmitted and received for all ports. Type any character to stop the display. inframe Displays continuous performance data in frames/second received for all ports. Type any character to stop the display. outframe Displays continuous performance data in frames/second transmitted for all ports. Type any character to stop the display.
Keywords
59243-00 A
13-127
errors Displays continuous error counts for all ports. Type any character to stop the display.
Examples
13-128
59243-00 A
A
QLogic4GbT#> show perf byte Displaying bytes/sec (total)... 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 q 15 63M 65M 60M 62M 58M 52M 61M 58M 54M 66M 64M 59M 56M 54M 50M 61M 16 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 17 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 18 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 19 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 31M 31M 29M 28M 26M 26M 34M 29M 28M 32M 35M 30M 26M 26M 24M 31M 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 31M 34M 30M 33M 31M 26M 26M 28M 26M 34M 29M 29M 29M 27M 25M 30M 4 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 5 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 6 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 7 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 8 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
----------------------------------------------------------------------------------
59243-00 A
13-129
Show Port
Displays operational information for one or more ports.
None show port [port_list] [port_list] The number of the port for which to display information. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, [0 15-19] specifies ports 0,15, 16, 17, 18, and 19.
Notes
Table 13-26 describes the port parameters. Table 13-26. Show Port Parameters
Entry AdminState AIinit AIinitError AsicNumber AsicPort Bad Frames BBCR_FrameFailures Administrative state Incremented each time the port begins AL initialization. Number of times the port entered initialization and the initialization failed. ASIC number ASIC port number Number of frames that have framing errors. Number of times more frames were lost during a credit recovery period than the recovery process could resolve. This causes a Link Reset to recover the credits. Number of times more R_RDYs were lost during a credit recovery period than the recovery process could resolve. This causes a Link Reset to recover the credits. Number of class x frames received by this port. Number of class x frames sent by this port. Number of class x words received by this port. Number of class x words sent by this port. Number of times an SOFi3 or SOFn3 frame is tossed from TBUF. Configured port type Description
BBCR_RRDYFailures
13-130
59243-00 A
A
Entry DecodeError DiagFaultCode DiagStatus EpConnects EpConnState EpIsoReason FBusy Number of decode errors detected
Fault code from the most recent Power-on self test Status from the most recent Power-on self test Number of times an E_Port connected through ISL negotiation. E_Port connection status E_Port isolation reason Number of times the I/O module sent a F_BSY because Class 2 frame could not be delivered within ED_TOV time. Number of class 2 and class 3 fabric busy (F_BSY) frames generated by this port in response to incoming frames. This usually indicates a busy condition on the fabric or N_Port that is preventing delivery of this frame. Number of frames received there were no available credits. Number of frames from devices that were rejected. Invalid CRC detected. Invalid destination address detected. I/O StreamGuard status Number of optical link failures detected by this port. A link failure is a loss of synchronization or a loss of signal while not in the offline state. A loss of signal causes the I/O module to attempt to re-establish the link. If the link is not re-established, a link failure is counted. A link reset is performed after a link failure. Port transmission speed Port activity status Number of F7, AL_PS LIPs, or AL_PD (vendor specific) resets, performed. This LIP is used to reinitialize the loop. An L_Port, identified by AL_PS, may have noticed a performance degradation and is trying to restore the loop. This LIP denotes a loop failure detected by the L_Port identified by AL_PS.
LIP_F8_AL_PS
59243-00 A
13-131
S
Table 13-26. Show Port Parameters (Continued)
Description A loop initialization primitive frame used to acquire a valid AL_PA. A loop initialization primitive frame used to indicate that a loop failure has been detected at the receiver. Number of device logins Login status Number of device logouts Number of incidents when one or more frames are received that are greater than the maximum size. A two (2) second timeout as specified by FC-AL-2. Number of synchronization losses (>100 ms) detected by this port. A loss of synchronization is detected by receipt of an invalid transmission word. Number of incidents of lost frames. Number of incidents of lost R_RDYs. Maximum number of port buffer credits Possible transmission speeds Transceiver vendor part number Transceiver revision Transceiver type Transceiver manufacturer Transceiver manufacturer identifier Operational state AutoPerfTuning status Fibre Channel port address World wide port name Primitive sequence errors detected. Operational port type Number of link reset primitives received from an attached device.
LostFrames Lost RRDYs MaxCredit MediaSpeeds MediaPartNumber MediaRevision MediaType MediaVendor MediaVendorID OperationalState PerfTuningMode PortID PortWWN PrimSeqErrors RunningType RxLinkResets
13-132
59243-00 A
A
Entry RxOfflineSeq
ShortFramesIn SymbolicName SyncStatus TestFaultCode TestStatus TotalErrors TotalLinkResets TotalLIPsRecvd TotalLIPsXmitd TotalOfflineSeq TotalRxFrames TotalRxWords TotalTxFrames TotalTxWords TxLinkResets TxOfflineSeq XmitterEnabled
59243-00 A
13-133
S
Online 0 18 GL Passed None NotApplicable True True 2Gb/s Active LoggedIn 8 1Gb/s,2Gb/s,4Gb/s 0 0 0 0 0 0 0 0 118 118 0 2268 2320 0 0 0 0 0 0 0 0 0 0 0 LIP_F8_F7 LinkFailures Login Logout LongFramesIn LoopTimeouts LossOfSync LostFrames LostRRDYs PrimSeqErrors RxLinkResets RxOfflineSeq ShortFramesIn TotalErrors TotalLinkResets TotalLIPsRecvd TotalLIPsXmitd TotalOfflineSeq TotalRxFrames TotalRxWords TotalTxFrames TotalTxWords TxLinkResets TxOfflineSeq 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 0 0 2 118 2268 118 2320 1 1 OperationalState Online PerfTuningMode PortID PortWWN RunningType MediaPartNumber MediaRevision MediaType MediaVendor MediaVendorID SymbolicName SyncStatus XmitterEnabled Normal 010000 20:01:00:c0:dd:00:06:07 E PL-XPL-VC-S23-11 1 400-M5-SN-I Intel Corp. 00000485 Port1 SyncAcquired True
Examples
The following is an example of the Show Port command for external port 0:
QLogic4GbT #> show port 0 Port Number: 0 -----------AdminState AsicNumber AsicPort ConfigType DiagStatus EpConnState EpIsoReason IOStreamGuard Licensed LinkSpeed LinkState LoginStatus MaxCredit MediaSpeeds ALInit ALInitError BadFrames BBCR_RRDYFailures Class2FramesIn Class2FramesOut Class2WordsIn Class2WordsOut Class3FramesIn Class3FramesOut Class3Toss Class3WordsIn Class3WordsOut DecodeErrors EpConnects FBusy FlowErrors FReject InvalidCRC InvalidDestAddr LIP_AL_PD_AL_PS LIP_F7_AL_PS LIP_F7_F7 LIP_F8_AL_PS
BBCR_FrameFailures 0
13-134
59243-00 A
A
Show Post Log
Authority Syntax Examples
None show post log
Displays the Power On Self Test (POST) log which contains results from the most recently failed POST.
59243-00 A
13-135
None show setup mfg The following is an example of the Show Setup Mfg command:
QLogic4GbT #> show setup mfg Manufacturing Information ------------------------BrandName BuildDate ChassisPartNumber ChassisSerialNumber CPUBoardSerialNumber LicensedExternalPorts LicensedInternalPorts MACAddress PlanarPartNumber SwitchSymbolicName SwitchWWN SystemDescription SystemObjectID QLogic Wednesday, January 31, 2007 10:13 BRT-4146-009 0703C00113 0703C00113 6 14 00:c0:dd:0d:2b:40 31716-02 QLogic4GbT 10:00:00:c0:dd:0d:2b:40 QLogic(R) 20 Port 4Gb SAN Switch for IBM BladeCenter(R) 1.3.6.1.4.1.3873.1.8 A A
13-136
59243-00 A
A
Show Setup Radius
Displays RADIUS server information.
None show setup radius The following is an example of the Show Setup RADIUS command:
QLogic4GbT #> show setup radius Radius Information -----------------DeviceAuthOrder UserAuthOrder TotalServers Server: 1 ServerIPAddress ServerUDPPort DeviceAuthServer UserAuthServer AccountingServer Timeout Retries SignPackets Secret 10.20.11.8 1812 False True False 2 0 False ******** RadiusLocal RadiusLocal 1
59243-00 A
13-137
None show setup services The following is an example of the Show Setup Services command:
QLogic4GbT #> show setup services System Services ----------------------------TelnetEnabled SSHEnabled GUIMgmtEnabled SSLEnabled EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled True False True False True True True True True True
13-138
59243-00 A
A
Show Setup SNMP
Displays the current SNMP settings.
Authority Syntax
None show setup snmp The following is an example of the Show Setup Snmp command:
QLogic4GbT #> show setup snmp SNMP Information ---------------SNMPEnabled Contact Location Description Trap1Address Trap1Port Trap1Severity Trap1Version Trap1Enabled Trap2Address Trap2Port Trap2Severity Trap2Version Trap2Enabled Trap3Address Trap3Port Trap3Severity Trap3Version Trap3Enabled Trap4Address Trap4Port Trap4Severity Trap4Version Trap4Enabled Trap5Address Trap5Port Trap5Severity Trap5Version Trap5Enabled ObjectID AuthFailureTrap ProxyEnabled True <sysContact undefined> N_107 System Test Lab QLogic 4 Gb 10.0.0.254 162 warning 2 False 0.0.0.0 162 warning 2 False 0.0.0.0 162 warning 2 False 0.0.0.0 162 warning 2 False 0.0.0.0 162 warning 2 False 1.3.6.1.4.1.1663.1.1.1.1.17 True True FC Switch
59243-00 A
13-139
None show setup system The following is an example of the Show Setup System command:
QLogic4GbT #> show setup system System Information -----------------Eth0NetworkDiscovery Eth0NetworkAddress Eth0NetworkMask Eth0GatewayAddress AdminTimeout InactivityTimeout LocalLogEnabled RemoteLogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled 0 True False 10.0.0.254 True 51.68.85.102 True Static 192.168.70.129 255.255.252.0 0.0.0.0 30
13-140
59243-00 A
A
Show Steering
Displays the routes that data takes in the fabric.
None show steering [domain_id] [domain_id] The domain ID for which to display route information. If you omit [domain_id], the system displays routes for all switches in the fabric.
Examples
59243-00 A
13-141
Show Switch
Displays I/O module operational information.
None show switch Table 13-27 describes the I/O module operational parameters. Table 13-27. I/O Module Operational Parameters
Parameter SymbolicName SwitchWWN BootVersion CreditPool DomainID FirstPortAddress FlashSize - MBytes LogFilterLevel MaxPorts NumberOfResets ReasonForLastReset ActiveImageVersion - build date PendingImageVersion - build date Description Descriptive name for the I/O module I/O module world wide name PROM boot version Number of port buffer credits available to recipient ports I/O module domain ID FC address of I/O module port 0 Size of the flash memory in megabytes Event severity level used to record events in the event log Number of ports available on the I/O module Number of times the I/O module has been reset over its service life Action that caused the last reset Active firmware image version and build date. Firmware image version and build date that is pending. This image will become active at the next reset or power cycle. Name of the I/O module configuration that is in use. I/O module administrative state Admin session status Beacon status as set by the Set Beacon command.
13-142
59243-00 A
A
Parameter OperationalState PrincipalSwitchRole BoardTemp (1) - Degrees Celsius SwitchDiagnosticsStatus SwitchTemperatureStatus
Examples
59243-00 A
13-143
Show Timezone
Displays the current time zone setting.
None show timezone The following is an example of the Show Timezone command:
QLogic4GbT #> show timezone America/Chicago
13-144
59243-00 A
A
Show Topology
Displays all connected devices.
None show topology The following is an example of the Show Topology command:
QLogic4GbT #> show topology Unique ID Key ------------A = ALPA, Loc Port ---Bay1 Bay2 Bay3 Bay9 Bay10 Bay11 Bay12 Type ---F F F F F F F D = Domain ID, Local PortWWN ------P = Port ID Rem Remote Unique ID -----P P P P P P P
20:00:00:09:6b:36:32:d7 010100 20:01:00:e0:8b:a5:a9:6e 010200 20:00:00:00:c9:56:49:cb 010300 20:01:00:e0:8b:a0:ff:35 010900 20:01:00:e0:8b:a5:16:6f 010a00 20:01:00:e0:8b:a5:f3:70 010b00 20:01:00:e0:8b:a5:31:6f 010c00
59243-00 A
13-145
S
#> show topology 1
Local Link Information ---------------------Port PortID PortWWN PortType Bay1 010100 20:01:00:c0:dd:0d:2b:58 F
Remote Link Information ----------------------Device 0 PortID PortWWN NodeWWN PortType IPAddress 010100 21:00:00:09:6b:36:32:d7 20:00:00:09:6b:36:32:d7 N 0.0.0.0
Description (NULL)
13-146
59243-00 A
A
Show Users
Authority Syntax Examples
None show users
Displays a list of logged-in users. This is equivalent to the User List command.
59243-00 A
13-147
Show Version
Displays an introductory set of information about operational attributes of the I/O module. This command is equivalent to the Show About command.
None show version The following is an example of the Show Version command.
QLogic4GbT #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * *
***************************************************** SystemDescription EthNetworkAddress MACAddress WorldWideName ChassisSerialNumber SymbolicName ActiveSWVersion ActiveTimestamp DiagnosticsStatus QLogic(R)20 Port 4Gb SAN Switch for IBM BladeCenter(R) 10.20.11.192 (use 'set setup system' to update) 00:c0:dd:00:06:07 10:00:00:c0:dd:00:06:07 11S0632A00127 QLogic4GbT V6.5.x.x.xx.xx day month date time year Passed
13-148
59243-00 A
A
Shutdown
Terminates all data transfers on the I/O module at convenient points and closes the Telnet session. Always power cycle the I/O module after entering this command.
Admin session shutdown When the shutdown is complete, the Heartbeat LED is extinguished.
59243-00 A
13-149
Test Cancel
Cancels a port test that is in progress.
Admin session test cancel port [port_number] port [port_number] Cancel the test for the port given by [port_number]. [port_number] can be 019. The following example cancels the test running on port 15:
QLogic4GbT (admin) #> test cancel port 15
13-150
59243-00 A
A
Test Port
Tests individual port performance.
Admin session test port [port_number] [loopback_type] [port_number] The port to be tested. [port_number] can be 019. [loopback_type] Performs a test of the type given by [loopback_type] on the port given by [port_number]. [loopback_type] can have the following values: internal Exercises the internal port connections. Use the Set Port command to place the port in the diagnostics state before running the test. external Exercises the port and its transceiver. Use the Set Port command to place the port in the diagnostics state before running the test. A transceiver with a loopback plug is required for the port. online Exercises the port, transceiver, and device connections while the port is online. This test does not disrupt communication on the port.
Notes
Table 13-28 describes the port test parameters. Table 13-28. Port Test Parameters
Parameter TestLength FrameSize DataPattern StopOnError Description Number of frames sent Number of bytes in each test frame Pattern in the payload Stops the test when an error occurs (True). Otherwise, the test continues to completion.
To cancel a port test that is in progress, enter the Test Cancel Port command. To display the status of the most recent port test or port test in progress, enter the Test Status Port command.
59243-00 A
13-151
Examples
Do you want to start the test? (y/n) [n] y The test has been started. A notification with the test result(s) will appear on the screen when the test has completed. QLogic4GbT (admin) #> Loopback test for port 1 Passed.
Do you want to start the test? (y/n) [n] y The test has been started. A notification with the test result(s) will appear on the screen when the test has completed. QLogic4GbT (admin) #> Test for port 0 Passed.
13-152
59243-00 A
A
Test Status
Authority Syntax Examples
None test status The following is an example of the Test Status command:
QLogic4GbT (admin) #> test status Port Number: -----------TestType Status FailureCount FrameCount Offline Running 0 91 of 100 1
Displays the status of a test in progress, or if there is no test in progress, the status of the test that was executed last.
59243-00 A
13-153
Uptime
Displays the elapsed up time since the I/O module was last reset and reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed up time reported by this command.
13-154
59243-00 A
A
User
Administers and displays user accounts.
Authority Syntax
USERID account name and an Admin session. The Accounts and List keywords are available to all account names without an Admin session. user accounts add delete [account_name] edit list accounts Displays all user accounts that exist on the I/O module. This keyword is available to all account names without an Admin session. add Add a user account to the I/O module. You will be prompted for an account name, a password, authority, and an expiration date. An I/O module can have a maximum of 15 user accounts. Account names are limited to 15 characters; passwords must be 820 characters. Admin authority grants permission to use the Admin command to open an Admin session, from which all commands can be entered. Without Admin authority, you are limited to view-only commands. The expiration date is expressed in the number of days until the account expires (2000 maximum). The I/O module will issue an expiration alarm every day for seven days prior to expiration. 0 (zero) specifies that the account has no expiration date. delete [account_name] Deletes the account name given by [account_name] from the I/O module. edit Initiates an edit session that prompts you for the account name for which to change the expiration date and authority. list Displays the list of users currently logged in and their session numbers. Provides the same function as the Show Users command. This keyword is available to all account names without an Admin session.
Keywords
59243-00 A
13-155
Notes Examples
Authority level or password changes that you make to an account that is currently logged in do not take effect until that account logs in again. The following is an example of the User Accounts command:
QLogic4GbT (admin) #> user accounts Current list of user accounts ----------------------------images USERID user1 user2 user3 (admin authority = False, never expires) (admin authority = True , never expires) (admin authority = True , never expires) (admin authority = False, expires in < 50 days) (admin authority = True , expires in < 100 days)
please confirm account password: ******* set account expiration in days (0-2000, 0=never): [0] 100 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
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]
13-156
59243-00 A
A
QLogic4GbT (admin) #> user del user3 The user account will be deleted.
59243-00 A
13-157
Whoami
Displays the account name, session number, and I/O module domain ID for the Telnet session.
13-158
59243-00 A
A
Zone
Authority
Manages zones and zone membership on an I/O module. Admin session and a Zoning Edit session. Refer to the Zoning command on page 13-166 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session. zone add [zone] [member_list] copy [zone_source] [zone_destination] create [zone] delete [zone] list members [zone] remove [zone] [member_list] rename [zone_old [zone_new] zonesets [zone] add [zone] [member_list] Specifies one or more ports/devices given by [members] to add to the zone named [zone]. Use a <space> to delimit aliases and ports/devices in [member_list]. A zone can have a maximum of 2000 members. [member_list] can have any of the following formats: Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1239; port numbers can be 0255. 6-character hexadecimal device Fibre Channel address (hex) 16-character hexadecimal worldwide port name (WWPN) with the format xx:xx:xx:xx:xx:xx:xx:xx. Alias name The application verifies that the [members] format is correct, but does not validate that such a member exists. copy [zone_source] [zone_destination] Creates a new zone named [zone_destination] and copies the membership into it from the zone given by [zone_source]. create [zone] Creates a zone with the name given by [zone]. An zone name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The zoning database supports a maximum of 2000 zones.
Syntax
Keywords
59243-00 A
13-159
delete [zone] Deletes the specified zone given by [zone] from the zoning database. If the zone is a component of the active zone set, the zone will not be removed from the active zone set until the active zone set is deactivated. list Displays a list of all zones and the zone sets of which they are components. This keyword does not require an Admin session. members [zone] Displays all members of the zone given by [zone]. This keyword does not require an Admin session. remove [zone] [member_list] Removes the ports/devices given by [member_list] from the zone given by [zone]. Use a <space> to delimit aliases and ports/devices in [member_list]. [member_list] can have any of the following formats: Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1239; port numbers can be 0255. 6-character hexadecimal device Fibre Channel address (hex) 16-character hexadecimal worldwide port name (WWPN) with the format xx:xx:xx:xx:xx:xx:xx:xx. Alias name rename [zone_old] [zone_new] Renames the zone given by [zone_old] to the zone given by [zone_new]. zonesets [zone] Displays all zone sets of which the zone given by [zone] is a component. This keyword does not require an Admin session.
13-160
59243-00 A
A
Examples
The following is an example of the Zone List command:
QLogic4GbT #> zone list Zone wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_set_1 wwn_22412f zone_set_1 ZoneSet -------------------
59243-00 A
13-161
13-162
59243-00 A
A
Zoneset
Authority
Manages zone sets and component zones across the fabric. Admin session and a Zoning Edit session. Refer to the Zoning command on page 13-166 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session. You must close the Zoning Edit session before using the Activate and Deactivate keywords. zoneset activate [zone_set] active add [zone_set] [zone_list] copy [zone_set_source] [zone_set_destination] create [zone_set] deactivate delete [zone_set] list remove [zone_set] [zone_list] rename [zone_set_old] [zone_set_new] zones [zone_set] activate [zone_set] Activates the zone set given by [zone_set]. This keyword deactivates the active zone set. Close the Zoning Edit session before using this keyword. active Displays the name of the active zone set. This keyword does not require Admin session. add [zone_set] [zone_list] Adds a list of zones and aliases given by [zone_list] to the zone set given by [zone_set]. Use a <space> to delimit zone and alias names in [zone_list]. copy [zone_set_source] [zone_set_destination] Creates a new zone set named [zone_set_destination] and copies into it the zones from the zone set given by [zone_set_source]. create [zone_set] Creates the zone set with the name given by [zone_set]. A zone set name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The zoning database supports a maximum of 256 zone sets.
Syntax
Keywords
59243-00 A
13-163
deactivate Deactivates the active zone set. Close the Zoning Edit session before using this keyword. delete [zone_set] Deletes the zone set given by [zone_set]. If the specified zone set is active, the command is suspended until the zone set is deactivated. list Displays a list of all zone sets. This keyword does not require an Admin session. remove [zone_set] [zone_list] Removes a list of zones given by [zone_list] from the zone set given by [zone_set]. Use a <space> to delimit zone names in [zone_list]. If [zone_set] is the active zone set, the zone will not be removed until the zone set has been deactivated. rename [zone_set_old] [zone_set_new] Renames the zone set given by [zone_set_old] to the name given by [zone_set_new]. You can rename the active zone set. zones [zone_set] Displays all zones that are components of the zone set given by [zone_set]. This keyword does not require an Admin session.
Notes
A zone set must be active for its definitions to be applied to the fabric. Only one zone set can be active at one time. A zone can be a component of more than one zone set.
13-164
59243-00 A
A
Examples
QLogic4GbT #> zoneset active ActiveZoneSet LastActivatedBy LastActivatedOn Bets admin@OB-session6 day month date time year
59243-00 A
13-165
Zoning
Opens a Zoning Edit session in which to create and manage zone sets and zones. Refer to the Zone command on page 13-159 and the Zoneset command on page 13-163.
Authority Syntax
Admin session except for the Active, History, Limits, and List keywords. The Clear keyword also requires a zoning edit session. zoning active cancel clear delete orphans edit history limits list restore save active Displays information for the active zone set including component zones and zone members. This keyword does not require an Admin session. cancel Closes the current Zoning Edit session. Any unsaved changes are lost. clear Clears all inactive zone sets from the volatile edit copy of the zoning database. This keyword requires a zoning edit session. This keyword does not affect the non-volatile zoning database. However, if you enter the Zoning Clear command followed by the Zoning Save command, the non-volatile zoning database will be cleared from the I/O module. NOTE: The preferred method for clearing the zoning database from the I/O module is the Reset Zoning command.
Keywords
delete orphans Deletes all objects that are not part of the active zone set including zone sets, zones, and aliases.
13-166
59243-00 A
A
edit Opens a Zoning Edit session. history
Displays a history of zoning modifications. This keyword does not require an Admin session. History information includes the following: Time of the most recent zone set activation or deactivation and the user who performed it Time of the most recent modifications to the zoning database and the user who made them. Checksum for the zoning database limits Displays the number of zone sets, zones, aliases, members per zone, members per alias, and total members in the zoning database. This keyword also displays the I/O module zoning database limits, excluding the active zone set, which are described in Table 13-29. This keyword does not require an Admin session. Table 13-29. Zoning Database Limits
Limit MaxZoneSets MaxZones MaxAliases MaxTotalMembers MaxZonesInZoneSets Description Maximum number of zone sets (256) Maximum number of zones (2000) Maximum number of aliases (2500) Maximum number of zone and alias members (10000) that can be stored in the I/O modules zoning database. Maximum number of zones that are components of zone sets (2000), excluding those in the orphan zone set, that can be stored in the I/O modules zoning database. Each instance of a zone in a zone set counts toward this maximum. Maximum number of members in a zone (2000) Maximum number of members in an alias (2000)
MaxMembersPerZone MaxMembersPerAlias
list Lists all zoning definitions. This keyword does not require an Admin session.
59243-00 A
13-167
restore Restores the volatile zoning database with the contents of the non-volatile zoning database. If the InteropAutoSave parameter is False (see Table 13-8), you can use this keyword to revert changes to the volatile zoning database that were propagated from another switch in the fabric through zone set activation or merging fabrics. save Saves changes made during the current Zoning Edit session. The system informs you that the zone set must be activated to implement any changes. This does not apply if you entered the Zoning Clear command during the Zoning Edit session.
Examples
13-168
59243-00 A
A
QLogic4GbT #> zoning limits Zoning Attribute ---------------MaxZoneSets MaxZones MaxAliases MaxTotalMembers MaxZonesInZoneSets MaxMembersPerZone Maximum ------256 2000 2500 10000 2000 2000 10 23 9 16 5 5 3 3 8 8 24 8 13 21 3 3 4 MaxMembersPerAlias 2000 2 AliasInAZone D_1_JBOD_1 D_1_Photons D_2_JBOD1 D_2_NewJBOD_2 E1JBOD1 E2JBOD2 LinkResetZone LinkResetZone2 NewJBOD1 NewJBOD2 Q_1Photon1 Q_1_NewJBOD1 Q_1_Photon_1 Q_2_NewJBOD2 ZoneAlias ZoneDomainPort ZoneFCAddr Current ------6 17 1 166 19 [Zoning Name] -------------
59243-00 A
13-169
S
Zone ZoneMember
13-170
59243-00 A
Appendix A
Port Mapping
Table A-1 shows the mapping of switch module port numbering for the BladeCenter and BladeCenter T configurations and whether these ports have the capability to be configured. Table A-1. Port Mapping For Server Units
Physical Port Connection External port 1 Server bay 1 Server bay 2 Server bay 3 Server bay 4 Server bay 5 Server bay 6 Server bay 7 Server bay 8 Server bay 9B Server bay 102 Server bay 112 Server bay 122 Server bay 132 QuickTools, CLI, and Enterprise Fabric Suite 2007 Logical Port Number 0 Ext(1:0A) 1 2 3 4 5 6 7 8 9 10 11 12 13 1 2 3 4 5 6 7 8 9 10 11 12 13 14 SNMP Port Numbering
Configurable
Yes No No No No No No No No No No No No No
59243-00 A
A-1
S
SNMP Port Numbering 15 16 17 18 19 20 Configurable
QuickTools, CLI, and Enterprise Fabric Suite 2007 Logical Port Number 14 15 Ext(2:151) 16 Ext(3:161) 17 Ext(4:171) 18 Ext(5:181) 19 Ext(6:191)
Indicates a symbolic port name if it is different from the logical port number. Bays 9 through 14 are not used for the BladeCenter T units.
NOTE:
The Fibre Channel ports that connect to each of the server bays (1 through 14) are fixed 4-Gbps TH_Ports (Pass-thru Modules) or F_Ports (SAN Switch Modules). Only the administrative state for these ports can be changed.
A-2
59243-00 A
Index
Numerics
10-Port Upgrade License 5-23, 13-18 alias add members 7-19, 13-5 copy 7-19, 13-5 create 7-18, 13-5 delete 7-18, 13-6 delete members 13-6 display list 13-6 display members 13-6 information 7-6 management 7-18 remove 7-12 remove ports/devices 7-19 rename 7-18, 13-6 Alias command 13-5 Add example 7-19 Copy example 7-19 Create example 7-18 Delete example 7-18 List example 7-6 Members example 7-6 Remove example 7-19 Rename example 7-18 ALPA - See Arbitrated Loop Physical Address Arbitrated Loop Physical Address 13-82 authentication 9-1, 10-1, 13-24 authority 3-1, 13-1 authorization 9-1 autosave security database 9-7 zoning database 7-9
A
account name display 13-155, 13-158 factory 3-1 USERID 2-2 activation firmware 5-19, 5-20 I/O module configuration 5-11, 5-12 security 9-9, 9-11 zoning 7-11 active zone set 7-1, 7-4 Admin authority 2-3 session 2-3 session timeout 13-94 Admin command 13-4 administrative state I/O module 13-96 port 13-83 alarm configuration 6-13, 13-72 configuration defaults 13-47 configuration display 6-5, 13-106 description 11-1, 13-79 log 13-58, 13-99
B
backup file 5-14 beacon 5-17, 13-59 binding fabric 13-23, 13-27 port 6-11, 13-68 broadcast 13-100
59243-00 A
Index-1
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
C
Central Processing Unit usage 5-3 certificate 8-1, 8-3, 13-10 Challenge Handshake Authentication Protocol 13-24 CHAP - See Challenge Handshake Authentication Protocol chassis status 13-100, 13-101 command entry 2-4 examples 13-2 listing 13-3 notes 13-2 reference 13-1 rules and conventions 13-2 syntax 13-2 command line interface (CLI) 2-1 command-line completion 2-4 Config command 13-7 Activate example 5-11 Backup example 5-14 Copy example 5-12 Delete example 5-12 Edit example 5-12, 7-9 List example 5-11 Restore example 5-15 configuration activate 5-11, 13-7 backup 5-14, 13-7 copy 5-12, 13-7 delete 5-12, 13-7 device security 9-1 display 5-11 edit 13-7 edit session 13-1 list 13-8 modify 5-12 reset 13-43 restore 5-14, 5-15, 13-8 save 13-8 configuration file download 2-8, 5-14 upload 2-9
connection security 8-1, 13-87, 13-88 SSL 13-10 CPU - See Central Processing Unit CRC - See Cyclic Redundancy Check Create command 13-10 Certificate example 8-3 Support example 2-6 credit 6-18, 13-109 critical event 11-1 Cyclic Redundancy Check errors 6-13
D
date 5-17 Date command 5-17, 13-13 decode errors 6-13 default zone 7-9 defaults alarm configuration 13-47 I/O module configuration 13-45 port configuration 13-46 RADIUS configuration 13-49 security configuration 13-50 services configuration 13-49 SNMP configuration system configuration 13-50 zoning configuration 13-48 device access 7-1 security configuration 9-1 discard inactive 7-9 discovery method 4-1 display control 2-5 domain ID binding 13-23, 13-27 display 13-108 donor port 6-18, 13-109 Dynamic Host Configuration Protocol 13-94
Index-2
59243-00 A
A
E
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
elapsed time 5-3 Enterprise Fabric Suite 2007 license key 5-23, 13-18 errors 6-13 Ethernet network information 4-3 event message format 11-2 output stream control 11-3 remote logging 11-6 severity level 11-1 event log clear 11-5 configuration 11-1, 11-4 configuration management 11-4 display 11-2 display configuration 11-5 filter 11-3 restore configuration 11-5 event logging by component 13-76, 13-114 by port 13-78, 13-116 by severity level 13-115 display 13-114 remote 11-6 restore defaults 13-78 save settings 13-79 settings 13-116 severity level 13-78 start and stop 11-1, 13-79 Exit command 13-14 expiration date 3-1 extended credit 6-18 donor 13-109 external test 6-15, 13-151
F
fabric binding 9-7 fabric configuration 4-1 Fabric Device Management Interface 13-111
Fabric Security license key 5-23, 13-18 factory defaults 13-43 Fcping command 13-15 example 4-5 Fctrace command 13-16 example 4-6 FDMI - See Fabric Device Management Interface Feature command 13-18 Add example 5-24 Log example 5-24 feature upgrade 5-23, 13-18 Fibre Channel connection 4-5 routing 4-6 file download and upload 2-8 File Transfer Protocol download files 2-8, 5-14 download firmware 5-21 restore configuration file 5-15 service 13-89 user account 3-1 firmware 5-20 custom installation 5-22 image file 13-34 information 5-8 install with CLI 13-20 installation 5-19 list image files 13-34 non-disruptive activation 13-33 one-step installation 5-21 remove image files 13-34 retrieve image file 13-34 unpack image 13-35 upload file 2-9 version 13-148 Firmware Install command 13-20 example 5-19 FTP - See File Transfer Protocol
G
gateway address 4-1
59243-00 A
Index-3
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
group add members 9-13, 13-23 add to security set 9-11 copy 9-13, 13-25 create 9-12, 13-25 delete 9-12 description 9-1 edit member attributes 13-26 ISL 9-12 list 13-27 list members 13-27 management 9-12 membership 9-5 modify member 9-14 MS 9-12, 13-25 port 9-12 remove from security set 9-11 remove members 9-14, 13-27 rename 9-12, 13-27 type 13-25, 13-27 Group command 13-22 Add example 9-13 Copy example 9-13 Create example 9-12 Delete example 9-12 Edit example 9-14 Members example 9-5 Remove example 9-14 Rename example 9-12 Securitysets example 9-5
I
I/O module administrative state 13-96 configuration 5-1, 5-11, 13-69 configuration defaults 13-45 configuration display 13-105 configuration parameters 5-5, 5-13 date and time 8-3 hard reset 13-30 information 5-1 log 13-94 login 2-2 management service 13-87 manufacturer information 13-136 operational information 5-2, 13-142 paging 5-17 reset 5-4, 5-19, 13-154 reset without POST 13-44 services 5-9, 13-44, 13-87, 13-138 user accounts 3-1 I/O Stream Guard 13-63 Image command 13-34 Install example 5-19 informative event 11-1 internal test 6-15, 13-151 Inter-Switch Link group 9-1, 9-12, 13-25 Inter-Switch Link connection count 6-13 IP address 4-1 IP addresses 2-2 ISL - See Inter-Switch Link
H
hard reset 5-19 Hardreset command 13-30 hardware information 5-7 Heartbeat LED 5-7 Help command 2-4, 13-31 History command 13-32 host bus adapter 13-111 hot reset 5-19 Hotreset command 13-33
K
keywords 13-2
Index-4
59243-00 A
A
L
license key description 5-23 display 5-24 install 5-24, 13-18 Link Control Frame 13-62 link state database 13-118 Lip command 13-37 log archive 13-76 clear 13-76 display 13-77, 13-115 event 13-76, 13-114 local 13-94 POST 13-135 remote 13-94 log file 11-7 download 2-8 upload 2-9 logged in users 13-147 login errors 6-13 limit 2-2 Logout command 13-38 logout errors 6-13 loop port bypass 13-82 enable 13-82 initialization 13-37 loss-of-signal errors 6-13
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
N
name server display 13-124 information 4-2 network configuration 4-1 configuration reset 13-44 discovery method 4-1, 13-94 interfaces 13-113 Network Time Protocol 4-4 client 13-94 description 5-17 interaction with Date command 13-13 server address 13-94 service 13-88 non-disruptive activation 5-20, 13-33 NTP - See Network Time Protocol
O
offline port test 6-16 online port test 6-15 operational information 5-2 orphan zone 13-166 output stream control 11-3
M
Management Server group 9-1, 9-12, 13-25 service 13-89 manufacturer information 13-136 mapping A-1 MD5 authentication 13-24 memory activity 13-123 modify 7-11 MS - See Management Server
P
page break 2-5 Pass-thru Module 5-15 Passwd command 3-4, 13-39 password change 13-39 default 2-2 File Transfer Protocol 2-8 I/O module 13-39 user account 3-4 performance tuning 13-62
59243-00 A
Index-5
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Ping command 13-40 port administrative state 13-83 binding 6-11, 13-68, 13-104 configuration 6-1, 13-60 configuration defaults 13-46 configuration display 13-102 configuration parameters 6-2 counters 13-82 external test 13-151 group 9-1, 9-12, 13-25 information 6-1 initialize 13-43 internal test 13-151 license 13-82 mapping A-1 modify operating characteristics 6-8 move license 6-17 offline test 6-16 online test 6-15, 13-151 operational information 6-4, 13-130 performance 6-6, 13-126, 13-127 performance tuning 13-62 reset 6-12 speed 13-83 testing 6-15 threshold alarms 6-5, 6-13 type 13-61 POST - See Power-On Self Test Power-On Self Test log 13-135 preference routing 13-62 process identifier 5-3 processing time 5-3 Ps command 5-3, 13-41
R
RADIUS - Remote Dial-In User Service RADIUS server configuration 8-1, 10-1, 10-3, 13-84 configuration defaults 13-49 configuration display 13-137 information 10-2 reset 13-44 Registered State Change Notification 13-63 Remote Dial-In User Service 10-1 remote host logging description 4-4, 11-6 enable 13-94 host address 13-94 Reset command 13-43 Config example 7-9 Factory example 7-9 Port example 6-12 Security example 9-9 SNMP example 12-5 Zoning example 7-11, 7-12 routing 13-62, 13-141 RSCN - See Registered State Change Notification
S
SANdoctor license key 5-23, 13-18 secret 13-24 Secure Shell description 8-1 service 8-1, 13-87 Secure Socket Layer certificate 8-3, 13-10 description 8-1 I/O module time 13-13 service 8-1, 13-88
Q
QuickTools 13-88, 13-95 Quit command 13-42
Index-6
59243-00 A
A
security certificate 8-1, 8-3 configuration 13-66 configuration defaults 13-50 configuration display 13-103 configuration parameters 5-6 connection 8-1 database 13-44 edit session 13-1 group 9-1 revert changes 9-7 Security command 13-51 Activate example 9-9 Active example 9-4 Clear example 9-9 Edit example 9-9 History example 9-6 Limits example 9-6 List example 9-3 Save example 9-9 security database autosave 9-7 clear 13-51 configuration 9-7 description 9-1 display 13-52 display history 13-52 information 9-2 limits 9-6, 13-52 modification history 9-6 modify 9-9 reset 9-9 restore 9-7 security edit session cancel 13-51 initiate 13-52 revert changes 13-52 save changes 13-52
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
security set activate 9-11, 13-55 active 9-4 add group 9-11 add member group 13-55 configured 9-2 copy 9-10, 13-56 create 9-10, 13-56 deactivate 9-11, 13-56 delete 9-10, 13-56 delete member group 13-56 description 9-1 display 13-56 display active 13-51, 13-55 display members 13-56 information 9-2 management 9-10 membership 9-5 remove groups 9-11 rename 9-10, 13-56 Securityset command 13-55 Activate example 9-11 Active example 9-4 Add example 9-11 Copy example 9-10 Create example 9-10 Deactivate example 9-11 Delete example 9-10 Group example 9-5 List example 9-2 Remove example 9-11 Rename example 9-10 services configuration defaults 13-49 display 5-9, 8-3 managing 5-9 SNMP 12-1 Set Beacon command 5-17 Set Config Port command 13-60 example 6-8 Set Config Security command 13-66 example 9-8 Set Config Security Port command 13-68 example 6-12
59243-00 A
Index-7
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Set Config Switch command 13-69 example 5-13 TransparentMode example 5-16 Set Config Threshold command 13-72 example 6-14 Set Config Zoning command 13-74 example 7-9 Set Log command 13-76 Archive example 11-7 Clear example 11-5 Display example 11-3 example 11-4 Restore example 11-5 Start example 11-1 Stop example 11-1 Set Pagebreak command 13-80 example 2-5 Set Port command 13-82 Set Setup command SNMP example 12-4 Set Setup Radius command 13-84 example 10-3 Set Setup Services command 13-87 example 5-10 NTP service 5-18 SNMP service 12-2 SSH and SSL services 8-2 Set Setup SNMP command 13-91 Set Setup System command 13-94 NTP configuration 5-18 remote logging 11-6 system configuration 4-4 Set Switch State command 13-96 Set Timezone command 13-97 severity level 11-1 SHA-1 authentication 13-24 Show About command 13-98 Show Alarm command 13-99 Show Broadcast command 13-100 Show Chassis command 13-101 example 5-7 Show Config Port command 13-102 example 6-2
Show Config Security command 13-103 example 5-6 port binding 6-11 Show Config Security Port command 13-104 Show Config Switch command 13-105 example 5-5 Show Config Threshold command 13-106 example 6-5 Show Config Zoning command 13-107 example 5-5 Show Domains command 13-108 Show Donor command 13-109 Show Fabric command 13-110 example 4-3 Show FDMI command 13-111 Show Interface command 13-113 Show Log command 13-114 display log 11-2 filter display 11-3 Settings example 11-5 Show LSDB command 13-118 Show Media command 13-119 example 6-7 Show Mem command 13-123 Show NS command 13-124 example 4-2 Show Pagebreak command 13-126 Show Perf command 13-127 example 6-6 Show Port command 13-130 example 6-4 Show Post Log command 13-135 Show Setup Mfg command 13-136 Show Setup Radius command 13-137 example 10-2 Show Setup Services command 13-138 example 5-9 SSL and SSH example 8-3 Show Setup SNMP command 13-139 example 12-3 Show Setup System command 13-140 example 4-3 Show Steering command 13-141 Show Switch command 13-142
59243-00 A
Index-8
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Show Timezone command 13-144 Show Topology command 13-145 Show Users command 13-147 Show Version command 13-148 example 5-8 Shutdown command 13-149 Simple Network Management Protocol configuration 12-1, 13-91 configuration display 13-139 defaults 13-48 information 12-3 modify configuration 12-4 reset 13-44 reset configuration 12-5 service 12-1, 13-88 SMI-S - See Storage Management Initiative-Specification SNMP - See Simple Network Management Protocol soft zone 7-1 soft reset 5-19 SSH - See Secure Shell SSL - See Secure Socket Layer Storage Management Initiative-Specification 13-88 subnet mask 4-1 support file 13-10 create 2-6 download 2-7, 2-8 upload 2-9 syntax 13-2 system configuration change 13-94 defaults 13-50 display 13-140 system process information 5-3
Telnet connection security 8-1 interface 2-1 login 2-2 service 13-87 session timeout 13-94 test cancel 6-17 offline 6-16 online 6-15 status 6-17 Test Cancel command 13-150 Test command example 6-15 Test Port command 13-151 example 6-15 Test Status command 13-153 TFTP - See Trivial File Transfer Protocol time between resets 5-4 set and display 5-17, 13-13 zone 13-97, 13-144 timeout Admin session 13-94 admin session 4-4 inactivity 4-4 Telnet session 13-94 topology 13-145 transceiver information 6-7 transparent mode 5-15, 13-69 Trivial File Transfer Protocol 5-21
U
upgrade 5-23, 13-18 Uptime command 13-154 example 5-4
T
technical support 2-6
59243-00 A
Index-9
A
user account add 13-155 configuration 3-1 create 3-3 delete 13-155 display 13-155 edit 13-155 information 3-2 list 13-155 logged in 13-147 modify 3-4 password 3-4 user administration 13-155 User command 13-155 Accounts example 3-2 Add example 3-3 Delete example 3-4 Edit example 3-4 List example 3-2
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
Z
zone add member port 13-159 add to zone set 7-14, 7-16 copy 7-16, 13-159 create 7-15, 13-159 definition 7-1 delete 7-16, 13-160 delete member port 13-160 list 13-160 list members 13-160 management 7-15 membership 7-5 remove 7-12 remove from zone set 7-14 remove ports/devices 7-17 rename 7-16, 13-160 Zone command 13-159 Add example 7-16 Copy example 7-16 Create example 7-15 Delete example 7-16 Members example 7-5 Remove example 7-17 Rename example 7-16 Zonesets example 7-5
V
Virtual Interface preference routing 13-62
W
warning 11-1 web applet enable 13-95 service 13-88 Whoami command 13-158 workstation date and time 8-3 settings 2-2
59243-00 A
Index-10
A
zone set activate 7-15, 13-163 active 7-1, 7-4, 13-166 add member zone 13-163 add zones 7-14 configured 7-2 copy 7-14, 13-163 create 7-13, 13-163 deactivate 7-15, 13-44, 13-164 definition 7-1 delete 7-13, 13-164 delete member zone 13-164 display 13-164 display active 13-163 display members 13-164 display zones 13-160 information 7-2 management 7-13 membership 7-5 remove 7-12 remove zones 7-14 rename 7-14, 13-164 Zoneset command 13-163 Activate example 7-15 Active example 7-4 Add example 7-14 Copy example 7-14 Create example 7-13 Deactivate example 7-15 Delete example 7-13 List example 7-2 Remove example 7-14 Rename example 7-14 Zones example 7-5
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
zoning configuration 7-1, 13-74 configuration defaults 13-48 configuration display 13-107 configuration parameters 5-5 database 13-44 edit 13-167 edit session 13-1 hardware enforced 7-1 history 13-167 information 7-2 limits 13-167 list definitions 13-167 modification history 7-7 modify 7-9 reset 7-11 restore 7-9 revert changes 7-9, 13-168 save edits 13-168 Zoning command 13-166 Active example 7-4 Clear example 7-12 Delete example 7-12 Edit example 7-11 History example 7-7 Limits example 7-8 List example 7-3 zoning database 7-11 configuration 7-9 limits 7-8 reset 7-12
59243-00 A
Index-11
A
Notes
QLogic 10/20-Port 4 Gb SAN Switch Module for IBM BladeCenter Command Line Interface Guide
59243-00 A
Index-12