iSR6142
Command Line Interface (CLI)
User’s Guide
SN0054659-00 A
iSR6142 Command Line Interface (CLI)
User’s 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.
QLogic is a registered trademark and SmartWrite is a trademark of QLogic Corporation.
AMCC is a registered trademark of Applied Micro Circuits Corporation
Brocade is a registered trademark of Brocade Communications Systems, Inc.
Cisco is a registered trademark of Cisco Technology, Inc.
Gnome is a trademark of the GNOME Foundation Corporation.
Java and Solaris are registered trademarks of Sun Microsystems, Inc.
Pentium is a registered trademark of Intel Corporation.
IBM and PowerPC are registered trademarks of the International Business Machines Corporation.
Linux is a registered trademark of Linus Torvalds.
MacOS X and Safari are registered trademarks of Apple Computer, Inc.
McDATA is a registered trademark of McDATA Corporation.
Microsoft, Windows XP, Windows 2003, and Internet Explorer are registered trademarks of Microsoft
Corporation.
Netscape Navigator and Mozilla are trademarks or registered trademarks of Netscape Communications
Corporation.
Red Hat is a registered trademark of Red Hat Software Inc.
SANmark is a trademark of the Fibre Channel Industry Association.
SUSE is a trademark of Novell, Inc.
All other brand and product names are trademarks or registered trademarks of their respective owners.
S
Revision A
New release
QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000
Document Revision History
Changes Sections Affected
© 2008 QLogic Corporation. All Rights Reserved Worldwide.
Published: September 2008
Page ii SN0054659-00 A
A
Table of Contents
1 Introduction
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
2 Command Usage
Logging On to a SAN Router . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Guest Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Working with SAN Router Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Modifying a Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Saving and Restoring Router Configurations . . . . . . . . . . . . . . . . . . . 2-2
Save Router Configuration and Persistence . . . . . . . . . . . . . . . 2-3
Restore Router Configuration and Persistence . . . . . . . . . . . . . 2-4
iSR6142 Command Line Interface (CLI)
User’s Guide
3 Configuring CHAP
CHAP Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Discovery Session—Bi-directional CHAP . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Discovery Session—Uni-directional CHAP . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Normal Session—Bi-directional CHAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Normal Session—Uni-directional CHAP . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
4 Command Reference
Command Listing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Command Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Beacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Clear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
FcipRoute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7
FRU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
SN0054659-00 A Page iii
iSR6142 Command Line Interface (CLI)
User’s Guide
Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
Initiator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Localmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
Logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
Ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
Quit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
Reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
Remote Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-25
Remote Peer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
Reset Factory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
Set CHAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36
Set FC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
Set Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-38
Set iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
Set iSNS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-41
Set Mgmt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42
Set NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
Set Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
Set SNMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45
Set System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47
Show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48
Show CHAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-51
Show FC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52
Show FcipRoutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53
Show Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54
Show Initiators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-55
Show iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56
Show iSNS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-58
Show Localmaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
Show Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60
Show Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
Show Mgmt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62
Show NTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63
Show Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64
Show Presented Initiators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-66
Show Presented Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-67
S
Page iv SN0054659-00 A
A
Show Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-69
Show Remotemaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-70
Show Remotepeers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-71
Show SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
Show Stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-73
Show System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
Show Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-77
Show VLAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-79
Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-80
Traceroute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-81
A Log Messages
Log Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Informational Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Application Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
iSCSI Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4
Fibre Channel Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5
User Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6
FCIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8
TOE Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
Error Log Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
Application Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
iSCSI Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
Fibre Channel Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
User Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22
System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
Fatal Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
iSCSI Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
FC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-28
TOE Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-30
System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-31
iSR6142 Command Line Interface (CLI)
User’s Guide
B Simple Network Management Protocol (SNMP)
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
SNMP Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
SNMP Trap Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Management Information Base (MIB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
System Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
SN0054659-00 A Page v
iSR6142 Command Line Interface (CLI)
User’s Guide
Network Port Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4
Fibre Channel Port Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6
Sensor Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-8
Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11
Notification Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11
Agent Start Up Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12
Agent Shut Down Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12
Network Port Down Notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12
Fibre Channel Port Down Notification . . . . . . . . . . . . . . . . . . . . . . . . . B-12
Sensor Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12
Generic Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13
S
Index
List of Tables
Table Page
4-1 CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4-2 Command Line Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
A-1 Application Modules — Informational Log Messages . . . . . . . . . . . . . . . . . . . . . . . . A-2
A-2 iSCSI Driver — Informational Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4
A-3 Fibre Channel Driver — Informational Log Messages. . . . . . . . . . . . . . . . . . . . . . . . A-5
A-4 User Modules— Informational Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6
A-5 FCIP —Informational Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8
A-6 TOE—Informational Log Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
A-7 System —Informational Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
A-8 Application Module— Error Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
A-9 iSCSI Driver —Error Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
A-10 Fibre Channel Driver — Error Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
A-11 User Modules— Error Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22
A-12 System —Error Log Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
A-13 iSCSI Driver —Fatal Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
A-14 Fibre Channel Driver — Fatal Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-28
A-15 TOE—Fatal Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-30
A-16 System —Fatal Log Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-31
B-1 SNMP Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
B-2 SNMP Trap Configuration Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Page vi SN0054659-00 A
1 Introduction
This manual describes how to use the command line interface (CLI) to configure
and manage the iSR6142 Intelligent Storage Router (iSR-6142).
Intended Audience
This guide is for users who are responsible for installing, managing, and servicing
the iSR6142 router and the storage area network (SAN) equipment to which it is
attached.
Related Materials
iSR6142 Router Installation Guide, part number SN0051102-00
iSR6142 Router Manager User's Guide, part number SN0054660-00
Internet Protocol, Version 6 (IPv6) Specification, RFC2460
Neighbor Discovery for IP Version 6 (IPv6), RFC2461
IPv6 Stateless Address Autoconfiguration, RFC2462
Internet Control Message Protocol (ICMPv6) for the Internet Protocol
Version 6 (IPv6) Specification, RFC2463
Transmission of IPv6 Packets over Ethernet Networks, RFC2464
iSCSI draft standard draft-ietf-ips-iSCSI-20
Internet engineering task force (IETF) – iSCSI Requirements and Design
Considerations, iSCSI Naming and Discovery, Internet Protocol
Specification (IPv4), RFC793
Transmission Control Protocol (TCP) Specification, RFC1122, Requirements
for Internet Hosts-Communication Layers
TCP Extensions for High Performance, RFC1323
TCP Congestion Control, RFC2581
NewReno Modification to TCP’s Fast Recovery Algorithm, RFC2582
SN0054659-00 A 1-1
1 – Introduction
Technical Support
S
ANSI SCSI – SCSI-3 Architecture Model (SAM), X3T10/994D/Rev 18,
SCSI-3 Controller Command Set, X3T10/Project 1047D/Rev 6c. IEEE –
802.1Q Virtual LAN (VLAN), 802.1p Priority of Service, 802.3x Flow Control,
802.3ad Link Aggregation
SCSI-3 Fibre Channel Protocol (SCSI-FCP), X3.269:1996
Fibre Channel Physical and Signaling Interface (FC-PH), X3.230:199
Fibre Channel 2nd Generation (FC-PH-2), X3.297:1997
Third Generation Fibre Channel Physical and Signaling Interface (FC-PH-3),
X3.303:1998, Fibre Channel-Arbitrated Loop (FC-AL-2), working draft,
revision 6.4, August 28, 1998
Fibre Channel Fabric Loop Attachment Technical Report (FC-FLA)
NCITS/TR-20:1998, Fibre Channel-Private Loop Direct Attach Technical
Report (FC-PLDA)
SCSI Fibre Channel Protocol-2 (FCP-2) working draft, revision 3, October1,
1999
Fibre Channel over TCP/IP (FCIP), RFC3821
ANSI Information Technology-SCSI 3 Architecture Model, revision 18,
November 27, 1995
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic products. QLogic-direct customers may contact QLogic
Technical Support; others will be redirected to their authorized maintenance
provider.
Visit the QLogic support Web site listed in Contact Information for the latest
firmware and software updates.
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours excluding QLogic Observed Holidays.
1-2 SN0054659-00 A
A
Training
QLogic offers certification training for the technical professional for QLogic HBAs,
CNAs, switches, and routers. From the training link at www.qlogic.com
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
Contact Information
Support Headquarters QLogic Corporation
1 – Introduction
Technical Support
, you may
.
4601 Dean Lakes Blvd
Shakopee, MN 55379
USA
QLogic Web Site www.qlogic.com
Technical Support Web Site support.qlogic.com
Technical Support Email support@qlogic.com
Technical Training Email tech.training@qlogic.com
North American Region
Email support@qlogic.com
Phone +1-952-952-4040
Fax +1-952-687-2504
Europe, Middle East, and Africa Region
Email emeasupport@qlogic.com
Phone Numbers by Language +353 1 6924960 - English
+353 1 6924961 - Français
+353 1 6924962 - Deutsch
+353 1 6924963 - Español
+353 1 6924964 - Português
+353 1 6924965 - Italiano
Asia Pacific Region
Email apacsupport@qlogic.com
SN0054659-00 A 1-3
1 – Introduction
Technical Support
S
Phone Numbers by Language +63-2-885-6712 - English
+63-2-885-6713 - (Mandarin)
+63-2-885-6714 - (Japanese)
+63-2-885-6715 - (Korean)
Latin and South America Region
Email calasupport@qlogic.com
Phone Numbers by Language +52 55 5278 7016 - English
+52 55 5278 7017 - Español
+52 55 5278 7015 - Português
1-4 SN0054659-00 A
2 Command Usage
The command line interface (CLI) enables you to perform a variety of router
management tasks through an Ethernet or serial port connection. This section
describes the following:
Logging On to a SAN Router
Guest Account
Working with SAN Router Configurations
Logging On to a SAN Router
To log on to a router using Telnet, open a command line window on the
workstation and enter the Telnet command followed by the router IP address:
# telnet <ip_address>
A Telnet window opens prompting you for a login. Enter an account name and
password.
To log on to a switch through the serial port, configure the workstation port with the
following settings:
115200 baud
8-bit character
1 stop bit
No parity
Enter an account name and password when prompted.
SN0054659-00 A 2-1
2 – Command Usage
Guest Account
Guest Account
Routers come from the factory with the following account already defined:
Account name: guest
Password: password
This guest account provides access to the router and its configuration. After
planning your router management needs, consider changing the password for this
account.
The guest account is automatically closed after 15 minutes of inactivity.
See the password command (page 4-21) for information about changing
passwords.
Working with SAN Router Configurations
S
Successful management of routers with the command line interface depends on
the effective use of router configurations. Modifying configurations, backing up
configurations, and restoring configurations are key router management tasks.
Modifying a Configuration
The router has three major areas of configuration:
Management port configuration, which uses the following commands:
set mgmt (see page 4-42)
show mgmt (see page 4-62)
ISCSI port configuration, which uses the following commands:
set iscsi (see page 4-39)
show iscsi (see page 4-56)
Saving and Restoring Router Configurations
Saving and restoring a configuration can help protect your work or for use as a
template in configuring other routers.
2-2 SN0054659-00 A
A
Save Router Configuration and Persistence
Perform the following steps to save the router’s configuration and persistent data.
Persistent data consists of LUN mappings, discovered FC targets, and discovered
iSCSI initiators.
To save the router’s configuration and persistence:
1. Execute the fru save CLI command (see “FRU” on page 4-10) to generate
a file (iSR-6142_FRU.bin) containing the saved data. This file is stored
locally on the router in an FTP directory.
2. Transfer the saved data from the router to a workstation by executing an
FTP utility on a workstation. The following text is an example of an FTP
transfer to get the saved router configuration data:
c:\>ftp 172.17.137.102
Connected to 172.17.137.102.
220 (none) FTP server (GNU inetutils 1.4.2) ready.
User (172.17.137.102:(none)): ftp
331 Guest login ok, type your name as password.
Password: ftp
230 Guest login ok, access restrictions apply.
ftp> bin
200 Type set to I.
ftp> get iSR-6142_FRU.bin
200 PORT command successful.
150 Opening BINARY mode data connection for
'iSR-6142_FRU.bin' (6168 bytes).
226 Transfer complete.
ftp: 6168 bytes received in 0.00Seconds
6168000.00Kbytes/sec.
ftp> quit
221 Goodbye.
2 – Command Usage
Working with SAN Router Configurations
SN0054659-00 A 2-3
2 – Command Usage
Working with SAN Router Configurations
Restore Router Configuration and Persistence
To restore the router’s configuration and persistent data:
1. Transfer the saved data from a workstation to the router by executing an
FTP utility on the workstation. The following text is an example of an FTP
transfer to put previously saved router configuration data on the router:
c:\>ftp 172.17.137.102
Connected to 172.17.137.102.
220 (none) FTP server (GNU inetutils 1.4.2) ready.
User (172.17.137.102:(none)): ftp
331 Guest login ok, type your name as password.
Password: ftp
230 Guest login ok, access restrictions apply.
ftp> bin
200 Type set to I.
ftp> put iSR-6142_FRU.bin
200 PORT command successful.
150 Opening BINARY mode data connection for
'iSR-6142_FRU.bin'.
226 Transfer complete.
ftp: 6168 bytes sent in 0.00Seconds
6168000.00Kbytes/sec.
ftp> quit
221 Goodbye.
S
2. Execute the fru restore CLI command (see “FRU” on page 4-10) to
update the router with the saved configuration data. The fru restore
command has the following two options:
Full restore – Restores all router configuration parameters, including IP
addresses, subnet masks, gateways, local/remote mappings, and all
other persistent data.
Partial restore – Restores only the local/remote mappings and
persistent data, such as discovered FC targets and iSCSI initiators.
2-4 SN0054659-00 A
3 Configuring CHAP
This chapter describes CHAP and provides the procedures for configuring CHAP
from the command line interface (CLI).
For procedures, see the following sections:
“Discovery Session— Bi-directional CHAP” on page 3-2
“Discovery Session—Uni-directional CHAP” on page 3-3
“Normal Session — Bi-directional CHAP” on page 3-4
“Normal Session — Uni-directional CHAP” on page 3-5
CHAP Definition
In challenge handshake authentication protocol (CHAP), the authentication agent
sends the client program a random value that is used only once and an ID value.
Both the sender and peer share a predefined secret. The peer concatenates the
random value, the ID, and the secret, and calculates a one-way hash using MD5
(Message-Digest algorithm 5). It sends the hash value to the authenticator, which
in turn builds that same string on its side, calculates the MD5 checksum, and
compares the result with the value received from the peer. If the values match, the
peer is authenticated.
By transmitting only the hash, the secret cannot be reverse-engineered. The ID
value is increased with each CHAP dialogue to protect against replay attacks.
SN0054659-00 A 3-1
3 – Configuring CHAP
Discovery Session—Bi-directional CHAP
Discovery Session—Bi-directional CHAP
To configure a bi-directional CHAP used during a discovery session:
1. On the router:
a. Enable CHAP on the port.
b. Create a secret (for example, secret_port).
c. Using the set chap command, choose the iSCSI node that
represents the GE port.
d. Use the show iscsi command to find the iSCSI node name of the
GE port.
2. Use the initiator add command to add the initiator that is about to do
discovery:
a. Enable the CHAP for this initiator.
b. Create a secret (for example, secret_initiator).
S
c. Use the set chap command to update the CHAP settings of the
initiator.
3. Go to the Microsoft iSCSI (MS) Initiator and perform the following steps:
a. Click General.
b. Click Secret (in the middle of the screen). If this is the first time you are
setting secrets, reset all secrets.
c. Type the secret (secret_port) that you created in Step 1.
4. Click Discovery.
5. Click Add.
6. Type the address of the iSCSI port of the router.
7. Click Advanced.
8. Select Chap Login Information.
9. Type the secret (secret_initiator) you created in Step 2 into Target Secret.
10. Select Mutual Authentication.
11. C li ck OK.
12. Click OK. The initiator completes the discovery.
3-2 SN0054659-00 A
3 – Configuring CHAP
A
Discovery Session—Uni-directional CHAP
Discovery Session—Uni-directional CHAP
To configure a single-direction CHAP used during a discovery session:
1. Do not enable CHAP on the ISCSI port.
2. Use the initiator add command:
a. Add the initiator that is about to perform the discovery.
b. Enable the CHAP for this initiator.
c. Create a secret (for example, secret_initiator).
d. Use the set chap command to update the initiator’s CHAP settings.
3. Go to the MS Initiator.
4. Click Discovery.
5. Click Add.
6. Type the address of the iSCSI port of the router.
7. Click Advanced.
8. Select Chap Login Information.
9. In Target Secret, type the secret (secret_initiator) you created in Step 2.
10. Click OK.
11. C li ck OK. The initiator should complete discovery.
SN0054659-00 A 3-3
3 – Configuring CHAP
Normal Session—Bi-directional CHAP
Normal Session—Bi-directional CHAP
To configure a bi-directional CHAP used during a normal session:
1. On the router:
a. Enable CHAP on the presented target to which the initiator will login.
b. Create a secret (for example, secret_target).
c. Use the set chap command.
2. Use the initiator add command to add the initiator that is about to do a
normal login:
a. Enable the CHAP for this initiator.
b. Create a secret (for example, secret_initiator).
c. Use the set chap command to update the CHAP settings of the
initiator.
3. Go to the MS Initiator and perform the following steps:
S
a. Click General.
b. Click Secret (in the middle of the screen).
c. If this is the first time you are setting secrets, reset all the secrets.
d. Type the secret (secret_target) that you created in Step 1.
4. Click Targets.
5. Select the target you want to login to.
6. Click Advanced.
7. Select Chap Login Information.
8. Type the secret (secret_initiator) that you created in Step 2 into Targ et
Secret.
9. Select Mutual Authentication.
10. Click OK.
11. C li ck OK. The initiator completes the normal login.
3-4 SN0054659-00 A
A
Normal Session—Uni-directional CHAP
Normal Session—Uni-directional CHAP
To configure single-direction CHAP to be used during a normal session:
1. Do not enable CHAP on the presented target.
2. Use the initiator add command:
a. Add the initiator that is about to do a normal login.
b. Enable the CHAP for this initiator.
c. Create a secret (for example, secret_initiator).
d. Use the set chap command to update the CHAP settings of the
initiator.
3. Go to the MS Initiator.
4. Click Targets.
5. Select the target you want to login to.
6. Click Advanced.
3 – Configuring CHAP
7. Select Chap Login Information.
8. Type the secret (secret_initiator) that you created in into Target Secret.
9. Click OK.
10. Click OK. The initiator completes the normal login.
SN0054659-00 A 3-5
3 – Configuring CHAP
Normal Session—Uni-directional CHAP
Notes
S
3-6 SN0054659-00 A
4 Command Reference
This chapter lists and describes the CLI commands in alphabetical order. Each
command description includes its syntax, keywords, notes, and examples.
Command Listing
Table 4-1. CLI Commands
A Admin
B Beacon
C Clear
D Date
F FcipRoute, FRU
H Help, History
I Image, Initiator
L Localmap, Logout
P Password, Ping
Q Quit
R Reboot, Remote Map, Remote Peer, Reset Factory
S Save, Shutdown
Set Set, Set CHAP, Set FC, Set Features, Set iSCSI, Set iSNS, Set Mgmt, Set
NTP, Set Properties, Set SNMP, Set System
Show Show, Show CHAP, Show FC, Show FcipRoutes, Show Features, Show
Initiators, Show iSCSI, Show iSNS, Show Localmaps, Show Logs, Show
Memory, Show Mgmt, Show NTP, Show Performance, Show Presented
Initiators, Show Presented Targets, Show Properties, Show Remotemaps,
Show Remotepeers, Show SNMP, Show Stats, Show System, Show Targets, Show VLAN
T Ta r ge t , Traceroute
SN0054659-00 A 4-1
4 – Command Reference
Command Syntax
Command Syntax
The CLI commands use the following syntax:
command
key
word
keyword [value]
keyword [value1] [value2]
The command is followed by one or more keywords. Consider the following rules
and conventions:
Commands and keywords are case insensitive.
Required keyword values appear in standard font: [value]. Optional values
are shown in italics: [value].
Underlined portions of the keyword in the command format indicate the
abbreviated form. For example, you can abbreviate the Del
using Del.
S
ete keyword
The command-line completion feature makes entering and repeating commands
easier. Tab le 4 -2 describes the command-line completion keystrokes.
Table 4-2. Command Line Completion
Keystroke Effect
Ta b Completes the command line. Enter at least one character
and press the Tab key to complete the command line. If
more than one possibility exists, press the Tab key again to
display all possibilities.
Up Arrow Scrolls backward through the list of previously entered com-
mands.
Down Arrow Scrolls forward through the list of previously entered com-
mands.
Control-A Moves cursor to the beginning of the command line.
Control-E Moves cursor to the end of the command line.
The command set performs monitoring and configuration tasks. Commands
related to monitoring tasks are available to all account names. Commands related
to 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. Refer to the “Admin” on page 4-3.
4-2 SN0054659-00 A
A
Admin
Opens and closes an administrator session. You can run any command that
changes the router configuration within an Admin session. Only one Admin
session can be open on the router at any time. An inactive Admin session will time
out after 15 minutes.
When you start an Admin session, the system prompts you to enter a password.
The default password is config.
Authority None
Syntax admin
start (or begin)
end (or stop)
cancel
Keywords start (or begin)
Opens the Admin session.
4 – Command Reference
Command Syntax
end (or stop)
Closes the Admin session. The logout, shutdown, and reset 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.
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.
Examples Opening and closing an Admin session example:
QRouter #> admin start
Password : ******
QRouter(admin) #>
...
QRouter(admin) #> admin end
QRouter #>
SN0054659-00 A 4-3
4 – Command Reference
Command Syntax
Beacon
Enables or disables the Heartbeat and System Fault LEDs flashing. The
heartbeat and system fault LEDs flash synchronously (on and off, together). No
other LEDs are affected.
Authority Admin session
Syntax beacon
on
off
Keywords on
Turns on the router beacon.
off
Turns off the router beacon.
Examples Beacon command example:
S
QRouter #> beacon on
4-4 SN0054659-00 A
A
Clear
Provides two operations: it removes all entries from the router’s log file, or it resets
the Fibre Channel and iSCSI statistic counters.
Authority Admin session
Syntax clear
logs
stats
Keywords logs
Clears all entries from router’s log file.
stats
Resets the statistic counters.
Examples Clear command example:
4 – Command Reference
Command Syntax
QRouter (admin) #> clear logs
QRouter (admin) #> clear stats
SN0054659-00 A 4-5
4 – Command Reference
Command Syntax
S
Date
Displays or sets the 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.
The date and time should be set to UTC "Coordinated Universal Time", also
known as GMT "Greenwich Mean Time." This is required for the router
management application to correctly display the router’s time. The router
management GUI also sets the router time to UTC.
Authority Admin session to set the date and time. No authority required to display the
current date and time.
Syntax date
[MMDDhhmmCCYY]
Keywords [MMDDhhmmCCYY]
Specifies the date—this requires an Admin session. If you omit
[MMDDhhmmCCYY], the command uses the current date, which does not require
an admin session.
Notes Network time protocol (NTP) must be disabled to set the time with the Date
command. Refer to the “Set NTP” on page 4-43 for information about NTP.
Examples Date command example:
QRouter (admin) #> date 010314282007
Tue Jan 1 14:28:00 2008
QRouter (admin) #> date
Tue Jan 1 14:28:14 2008
4-6 SN0054659-00 A
A
FcipRoute
Configures a new FCIP route and lets you modify or delete an existing FCIP route.
Each FCIP route requires a dedicated FC and Gigabit Ethernet port. Configuring
an FCIP route and specifying an FC and GE port pair take precedence over any
previous configuration for the port pair (FC/GE). This removes the previous
configuration of the port pair.
Authority Admin session.
Syntax fciproute
add
mod
rm
Keywords add
Configures a new FCIP route.
modify
4 – Command Reference
Command Syntax
Modifies command modifies an existing FCIP route.
remove
Removes an existing FCIP route.
Examples FCIP route add command example:
QRouter (admin) #> fciproute add
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.
WARNING:
The following command might cause a loss of connections to both GE
ports.
Configuring FCIP Route: 1
---------------------------
FCIP Interfaces FC & GE (0=Enable, 1=Disable) [Enabled ]
FC Port (1=FC1, 2=FC2, ...) [FC1 ]
GE Port (1=GE1, 2=GE2, ...) [GE1 ]
IP Address (IPv4 or IPv6; 0=IPv6 Link Local) [0.0.0.0 ] 0
Selected IPv6 Link Local Address: fe80::2c0:ddff:fe0c:8be2
SN0054659-00 A 4-7
4 – Command Reference
Command Syntax
Remote IPv6 Address [:: ]
fe80::21b:21ff:fe06:d517
MTU Size (0=Normal, 1=Jumbo, 2=Other) [Normal ]
TCP Window Size (0=8KB, 1=16KB, 2=32KB) [32768 ]
Window Scaling (0=Enable, 1=Disable) [Disabled ]
TCP Port No. (Min=1024, Max=65535) [3225 ]
GE Port Speed (0=Auto, 1=100Mb, 2=1Gb) [Auto ]
FCIP Time Stamp (0=Enable, 1=Disable) [Enabled ]
Resource Allocate TimeOut (Min=1sec, Max=5sec)[1 ]
Bandwidth, Mbit/sec (Min=1, Max=1000) [1000 ]
VLAN (0=Enable, 1=Disable) [Disabled ]
FCIP SW Compression (0=Enable, 1=Disable) [Disabled ]
All attribute values for FCIP Route 1 will now be saved.
FCIP route modify command example:
S
QRouter (admin) #> fciproute mod
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.
WARNING:
The following command might cause a loss of connections to both GE
ports.
Route FC Port ID GE Port ID
----- ---------- ----------
1 FC1 GE1
Please select a FCIP route from the list above ('q' to quit): 1
Configuring FCIP Route: 1
---------------------------
FCIP Interfaces FC & GE (0=Enable, 1=Disable) [Enabled ]
IP Address (IPv4 or IPv6; 0=IPv6 Link Local) [:: ]
Selected IPv6 Link Local Address: fe80::2c0:ddff:fe0c:8be2
Remote IPv6 Address [fe80::21b:21ff:fe06:d517]
fe80::21b:21ff:fe06:d514
MTU Size (0=Normal, 1=Jumbo, 2=Other) [Normal ]
4-8 SN0054659-00 A
A
4 – Command Reference
Command Syntax
TCP Window Size (0=8KB, 1=16KB, 2=32KB) [32768 ]
Window Scaling (0=Enable, 1=Disable) [Disabled ]
TCP Port No. (Min=1024, Max=65535) [3225 ]
GE Port Speed (0=Auto, 1=100Mb, 2=1Gb) [Auto ]
FCIP Time Stamp (0=Enable, 1=Disable) [Enabled ]
Resource Allocate TimeOut (Min=1sec, Max=5sec)[1 ]
Bandwidth, Mbit/sec (Min=1, Max=1000) [1000 ]
VLAN (0=Enable, 1=Disable) [Disabled ]
FCIP SW Compression (0=Enable, 1=Disable) [Disabled ]
All attribute values for FCIP Route 1 will now be saved.
FCIP route remove command example:
QRouter (admin) #> fciproute rm
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.
WARNING:
The following command might cause a loss of connections to both GE
ports.
Route FC Port ID GE Port ID
----- ---------- ----------
1 FC1 GE1
Please select a FCIP route from the list above ('q' to quit): 1
FCIP Route 1 has been removed from the system.
SN0054659-00 A 4-9
4 – Command Reference
Command Syntax
FRU
Saves and restores the router’s configuration.
Authority Admin session to restore.
Syntax fru
restore
save
Keywords restore
Requires that you first ftp the tar file containing the desired configuration to the
router. After you enter this command, it prompts you to enter the restore level. You
can fully restore the router’s configuration (all configuration parameters and LUN
mappings) or restore only the LUN mappings. The restored configuration will not
take effect until you reboot the router.
save
S
Creates a tar file containing the router’s persistent data, configuration, and LUN
mappings. It stores the file in the router’s /var/ftp directory. You must then
ftp the tar file from the router.
Examples FRU restore command example:
QRouter (admin) #> fru restore
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.
Type of restore (0=full, 1=mappings only) [full]
FRU restore completed.
Please reboot the system for configuration to take effect.
FRU save command example:
QRouter (admin) #> fru save
FRU save completed. Configuration File is QLogic_Router_FRU.bin
Please use FTP to extract the file out from the System.
4-10 SN0054659-00 A
Loading...