Q-Logic ISR6142 User Manual

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.

Document Revision History

Revision A

Changes

Sections Affected

New release

Published: September 2008

QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000

Page ii

SN0054659-00 A

iSR6142 Command Line Interface (CLI)

User’s Guide

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

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

Page iv

SN0054659-00 A

iSR6142 Command Line Interface (CLI)

User’s Guide


	. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .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
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

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

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

1 – Introduction

Technical Support

Training

QLogic offers certification training for the technical professional for QLogic HBAs, CNAs, switches, and routers. 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.

Contact Information

Support Headquarters	QLogic Corporation
	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



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

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

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

2 – Command Usage Working with SAN Router Configurations

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.

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.

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

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).

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.Click OK.

12.Click OK. The initiator completes the discovery.

3-2	SN0054659-00 A

3 – Configuring 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.Click OK. The initiator should complete discovery.

SN0054659-00 A

3-3

3 – Configuring 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:

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 Target Secret.

9.Select Mutual Authentication.

10.Click OK.

11.Click OK. The initiator completes the normal login.

3-4	SN0054659-00 A

3 – Configuring 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.

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

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

AAdmin

BBeacon

CClear

DDate

F	FcipRoute, FRU

H	Help, History

I	Image, Initiator

L	Localmap, Logout

P	Password, Ping

QQuit

RReboot, 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 Tar-
	gets, Show VLAN

T	Target, Traceroute

SN0054659-00 A

4-1

4 – Command Reference

Command Syntax

The CLI commands use the following syntax: command

keyword 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 Delete keyword using Del.

The command-line completion feature makes entering and repeating commands easier. Table 4-2 describes the command-line completion keystrokes.

Table 4-2. Command Line Completion

Keystroke	Effect

Tab	Completes the command line. Enter at least one character
	and press the Tab key to complete the command line. If
	more than one possibility exists, press the Tab key again to
	display all possibilities.

Up Arrow	Scrolls backward through the list of previously entered 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

4 – Command Reference

Command Syntax

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.
	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:
	QRouter #> beacon on

4-4	SN0054659-00 A

4 – Command Reference

Command Syntax

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:
	QRouter (admin) #> clear logs
	QRouter (admin) #> clear stats

SN0054659-00 A

4-5

4 – Command Reference

Command Syntax

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

4 – Command Reference

Command Syntax

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

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:

QRouter (admin) #> fciproute mod

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

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

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

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

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

4 – Command Reference

Command Syntax

Help

	Displays a list of the commands and their syntax.
Authority	None
Syntax	help
Examples	Help command example:
	QRouter #> help
	amin [ cancel \| start \| end ]
	beacon [ on \| off ]
	date [ <MMDDhhmmCCYY> ]
	clear [ logs \| stats ]
	fciproute [ add \| mod \| rm ]
	discover
	fru [ restore \| save ]
	history
	image [ cleanup \| list \| unpack ]
	image cleanup
	image list
	image unpack [ <filename> ]
	initiator [ add \| rm ]
	localmap [ add \| rm ]
	logout
	passwd
	ping
	quit
	reboot
	remotemap [ add \| mod \| rm ]
	remotepeer [ add \| rm ]
	reset factory
	save [ capture \| logs \| traces ]
	set [ chap \| fc \| features \| iscsi
	isns \| mgmt \| ntp \| properties
	snmp \| system ]
	set chap
	set fc [ <PORT_NUM> ]
	set features
	set iscsi [ <PORT_NUM> ]
	set isns [ <PORT_NUM> ]
	set mgmt
	set ntp
	set properties
	set snmp [trap_destinations [ <DEST_NUM> ]]
	set system
	show [ chap \| fc \| fciproutes
	features \| initiators \| iscsi
	isns \| localmaps \| logs

SN0054659-00 A

4-11

4 – Command Reference

Command Syntax

memory | mgmt | ntp

perf | presented_initiators | presented_targets properties | remotemaps | remotepeers

snmp | stats | system targets ]

show chap

show fc [ <PORT_NUM> ]

show fciproutes [ <LINK_ID> ] show features

show initiators [ fc | iscsi ] show iscsi [ <PORT_NUM> ] show isns [ <PORT_NUM> ]

show localmaps show logs show memory show mgmt show ntp

show presented_targets [ fc | iscsi ] show properties

show remotemaps show remotepeers show snmp

show stats show system

show targets [ fc | iscsi ] shutdown

target [ add | rm ]

4-12	SN0054659-00 A

4 – Command Reference

Command Syntax

History

Displays a numbered list of the previously entered commands.

Authority None

Syntax History

Examples History command example:

QRouter (admin) #> history

1:admin start

2:help

3:history

SN0054659-00 A

4-13

4 – Command Reference

Command Syntax

Image

Updates the router’s firmware image and cleans up (removes) the image files in the router’s /var/ftp directory.

NOTE:

Use FTP to transfer an image file to the router’s /var/ftp directory.

Authority

Admin session

Syntax image cleanup list

unpack [file]

Keywords cleanup

Removes all firmware image files in the router’s /var/ftp directory. You can transfer these are files when updating the router’s firmware image.

list [file]

Displays a list of the firmware image files in the router’s /var/ftp directory. unpack [file]

Unpacks the firmware image file specified in the [file] parameter and installs the firmware image on the router. You must reboot the router to activate the new firmware image.

Image cleanup command example:

QRouter (admin) #> image cleanup

Image list command example:

QRouter (admin) #> image list isr-6142-2_1_1_0.bin

Image unpack command example:

QRouter (admin) #> image unpack isr-6142-2_1_1_0.bin

Unpack Completed. A reboot is required for the FW to take effect. Do you wish to reboot the System at the current time (y/n): n

4-14	SN0054659-00 A

4 – Command Reference

Command Syntax

Initiator

	Adds, modifies, and removes an initiator in the router’s database.
Authority	Admin session
Syntax	initiator
	add
	mod
	remove
Keywords	add
	Adds an initiator the router’s database.
	mod
	Modifies the settings of an initiator.
	remove
	Removes an initiator.
Examples	Initiator add command example:
	QRouter (admin) #> initiator 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.
	iSCSI Initiator Name (Max = 256 characters) [ ]
	iqn.1991-05.com.microsoft:qlogic-09sd5i4l
	All attribute values for that have been changed will now be saved.
	Initiator mod (modify) command example:
	QRouter (admin) #> initiator mod
	Index (WWNN/iSCSI Name)
	----- -----------------
	0 iqn.1991-05.com.microsoft:qlogic-09sd5i4l
	Please select an Initiator from the list above ('q' to quit): 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.
	All attribute values for that have been changed will now be saved.

SN0054659-00 A

4-15

4 – Command Reference

Command Syntax

Initiator remove command example:

QRouter (admin) #> initiator rm Index (WWNN/iSCSI Name)

----- -----------------

0 iqn.1991-05.com.microsoft:qlogic-09sd5i4l

Please select an Initiator from the list above ('q' to quit): 0 All attribute values for that have been changed will now be saved.

4-16	SN0054659-00 A

4 – Command Reference

Command Syntax

Localmap

Maps a locally-connected initiator device to a locally-connected target device. The initiator and target are not on the same FC port.

Authority	Admin session
Syntax	localmap
	add
	rm
Keywords	add
	Adds a local initiator to target mapping.
	rm
	Removes a local initiator from target mapping.
Examples	Localmap add command example with FC port query:
	QRouter (admin) #> localmap add
	The following wizard will query for attributes before persisting and
	activating the updated mapping in the system configuration. If you
	wish to terminate this wizard before reaching the end of the list
	press 'q' or 'Q' and the ENTER key to do so.

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

050:06:01:60:b0:22:0c:d1,50:06:01:68:30:22:0c:d1

1iqn.1991-05.com.microsoft:qlogic-09sd5i4l

Please select an Initiator from the list above ('q' to quit) : 1

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

020:00:00:20:37:fd:9c:f7,22:00:00:20:37:fd:9c:f7

150:06:01:60:b0:22:0c:d1,50:06:01:68:30:22:0c:d1

220:00:00:20:37:fd:8a:b0,22:00:00:20:37:fd:8a:b0

320:00:00:20:37:fd:8b:ab,22:00:00:20:37:fd:8b:ab

Please select a Target from the list above ('q' to quit) : 3 iSCSI port used to access the Initiator (1=GE1, 2=GE2, ...) : 2 FC port used to access the Target (1=FC1, 2=FC2, ...) : 1

The selected initiator has not been presented on the port that was selected to access the target. The following steps in the wizard will now setup the initiator so that it is presented on the port that will be used to access the target. A default name for the presented initiator is assigned below. To accept the default assigned name simply press the ENTER key or enter a new name.

SN0054659-00 A

4-17

4 – Command Reference

Command Syntax

FC presented initiator WWPN [21:01:00:c0:dd:0c:8b:e2 ] :

The selected target has not been presented on the port that was selected to be accessed the initiator. The following steps in the wizard will now setup the target so that it is presented on the port that will be used by the initiator. A default name for the presented target is assigned below. To accept the default assigned name simply press the ENTER key or enter a new name.

iSCSI presented target name [iqn.2004-08.com.qlogic:isr-6142.0608a00471.1.220000 2037fd8bab.2000002037fd8bab] :

All attribute values for that have been changed will now be saved.

Localmap add command example without FC port query:

QRouter (admin) #> localmap add

The following wizard will query for attributes before persisting and activating the updated mapping in the system configuration. If you wish to terminate this wizard before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

050:06:01:60:b0:22:0c:d1,50:06:01:68:30:22:0c:d1

1iqn.1991-05.com.microsoft:qlogic-09sd5i4l

Please select an Initiator from the list above ('q' to quit) : 1

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

020:00:00:20:37:fd:9c:f7,22:00:00:20:37:fd:9c:f7

150:06:01:60:b0:22:0c:d1,50:06:01:68:30:22:0c:d1

220:00:00:20:37:fd:8a:b0,22:00:00:20:37:fd:8a:b0

320:00:00:20:37:fd:8b:ab,22:00:00:20:37:fd:8b:ab

Please select a Target from the list above ('q' to quit) : 3 iSCSI port used to access the Initiator (1=GE1, 2=GE2, ...) : 2

FC presented initiator WWPN [21:01:00:c0:dd:0c:8b:e2 ] :

4-18	SN0054659-00 A

4 – Command Reference

Command Syntax

iSCSI presented target name [iqn.2004-08.com.qlogic:isr-6142.0608a00471.1.220000 2037fd8bab.2000002037fd8bab] :

All attribute values for that have been changed will now be saved.

Localmap remove command example:

172.17.137.171 (admin) #> localmap rm

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

020:00:00:14:c3:44:9a:fa,22:00:00:14:c3:44:9a:fa

120:00:00:20:37:fd:9c:f7,22:00:00:20:37:fd:9c:f7

220:00:00:20:37:fd:8a:b0,22:00:00:20:37:fd:8a:b0

320:00:00:14:c3:44:9b:9d,22:00:00:14:c3:44:9b:9d

420:00:00:14:c3:3d:d2:bf,22:00:00:14:c3:3d:d2:bf

520:00:00:14:c3:44:9b:86,22:00:00:14:c3:44:9b:86

620:00:00:14:c3:3d:cf:80,22:00:00:14:c3:3d:cf:80

720:00:00:14:c3:44:9a:f1,22:00:00:14:c3:44:9a:f1

820:00:00:14:c3:44:9b:0b,22:00:00:14:c3:44:9b:0b

920:00:00:14:c3:44:9b:7c,22:00:00:14:c3:44:9b:7c

Please select a Target from the list above ('q' to quit): 0 The following is a list of the initiators that have been mapped to the selected target and the port that was configured for the initiator to be presented on in order to access the target.

Target

Index Port Initiator (WWNN,WWPN/iSCSI Name)

----- ------ --------------------------------

0 FC1 iqn.1991-05.com.microsoft:qlogic-09sd5i4l Please select an Initiator to remove ('q' to quit) : 0

All attribute values for that have been changed will now be saved.

SN0054659-00 A

4-19

4 – Command Reference

Command Syntax

Logout

Exits the command line interface and returns you to the login prompt.

Authority None

Keywords logout

Examples Logout command example:

QRouter (admin) #> logout (none) login:

4-20	SN0054659-00 A

4 – Command Reference

Command Syntax

Password

	Changes the guest and administrator passwords.
Authority	Admin session
Syntax	password
Examples	Password command example:
	QRouter (admin) #> passwd
	Press 'q' and the ENTER key to abort this command.
	Select password to change (0=guest, 1=admin) : 1
	account OLD password : ******
	account NEW password (6-128 chars) : ******
	please confirm account NEW password : ******
	Password has been changed.

SN0054659-00 A

4-21

4 – Command Reference

Command Syntax

Ping

Verifies the connectivity of each Ethernet port, management, GE1 (iSCSI 1), and

GE2 (iSCSI 2).

Authority

Admin session

Syntax ping

Examples Ping command example:

QRouter (admin) #> ping

IP Address (IPv4 or IPv6)		[0.0.0.0]
fe80::217:a4ff:fe99:c279
Iteration Count (0=Continuously)		[0	] 10
Outbound Port (0=Mgmt,	1=GE1, 2=GE2, ...) [Mgmt		]
Size Of Packet (Min=1,	Max=65486 Bytes)	[56	]

Pinging fe80::217:a4ff:fe99:c279 with 56 bytes of data:

Request timed out.

Reply from fe80::217:a4ff:fe99:c279: bytes=64 time=0.4ms

Reply from fe80::217:a4ff:fe99:c279: bytes=64 time=0.3ms

Reply from fe80::217:a4ff:fe99:c279: bytes=64 time=0.2ms

Reply from fe80::217:a4ff:fe99:c279: bytes=64 time=0.3ms

Reply from fe80::217:a4ff:fe99:c279: bytes=64 time=0.7ms

Reply from fe80::217:a4ff:fe99:c279: bytes=64 time=0.2ms

Ping Statistics for fe80::217:a4ff:fe99:c279:

Packets: Sent = 10, Received = 9, Lost = 1

Approximate round trip times in milli-seconds:

Minimum = 0.2ms, Maximum = 0.7ms, Average = 0.3ms

4-22	SN0054659-00 A

4 – Command Reference

Command Syntax

Quit

Exits the command line interface and returns you to the login prompt.

Authority None

Syntax quit

Examples Quit command example:

QRouter (admin) #> quit (none) login:

SN0054659-00 A

4-23

4 – Command Reference

Command Syntax

Reboot

	Restarts the router firmware.
Authority	Admin session
Syntax	reboot
Examples	Reboot command example:
	QRouter (admin) #> reboot
	Are you sure you want to reboot the System (y/n): y
	System will now be rebooted...

4-24	SN0054659-00 A

4 – Command Reference

Command Syntax

Remote Map

Maps an initiator and target, one of which is located on a remote system (router). After you enter this command, it prompts you to enter the remote system (router), then lists the devices (initiators and targets) located on the remote system. You can select a device from the remote system and then the local system.

Authority	Admin session
Syntax	remotemap
	add
	mod
	rm
Keywords	add
	Adds a device mapping, initiator to target, one of which is remote.
	mod
	Modifies an existing remote device mapping.
	rm
	Removes a remote device mapping.
Examples	Remotemap add command example:
	QRouter (admin) #> remotemap add
	The following wizard will create a mapping a device connected to the
	local system and a device connected to the selected remote peer
	system. If you wish to terminate this wizard before reaching the end
	of the list press 'q' or 'Q' and the ENTER key to do so.
	Index (System Info, Mgmt IP Address)
	----- ------------------------------
	0 iSR-6142.0608A00487(172.17.137.215)
	Please select a REMOTE system from the list above ('q' to quit) : 0
	Index (WWNN,WWPN/iSCSI Name)
	----- ----------------------
	0 20:20:00:d0:b2:02:86:d0,21:20:00:d0:b2:02:86:d0 (Init/Tgt)
	1 20:21:00:d0:b2:02:86:d0,21:21:00:d0:b2:02:86:d0 (Init/Tgt)
	2 20:20:00:d0:b2:02:86:d1,21:20:00:d0:b2:02:86:d1 (Init/Tgt)
	3 20:21:00:d0:b2:02:86:d1,21:21:00:d0:b2:02:86:d1 (Init/Tgt)
	Please select a LOCAL device from the list above ('q' to quit) : 0
	Index (WWNN,WWPN/iSCSI Name)

SN0054659-00 A

4-25

4 – Command Reference

Command Syntax

----- ----------------------

0 20:00:00:e0:8b:08:5f:3d,21:00:00:e0:8b:08:5f:3d (Initiator)

1 20:00:00:d0:b2:00:19:f0,21:00:00:d0:b2:00:19:f0 (Init/Tgt)

Please select a REMOTE device from the list above ('q' to quit) : 0

NOTE: Both the LOCAL and REMOTE systems do not have the SMART-WRITE feature, therefore the querying of the SMART-WRITE settings are not applicable and will be skipped for this mapping. All attribute values for that have been changed will now be saved.

Remotemap add command example with SMART-WRITE licenses:

QRouter (admin) #> remotemap add

The following wizard will create a mapping a device connected to the local system and a device connected to the selected remote peer system. If you wish to terminate this wizard before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.

Index (System Info, Mgmt IP Address)

----- ------------------------------

0 iSR-6142.0608A00471(172.17.137.143)

Please select a REMOTE system from the list above ('q' to quit) : 0

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

0 20:01:00:e0:8b:28:5f:3d,21:01:00:e0:8b:28:5f:3d (Initiator)

1 20:00:00:e0:8b:08:5f:3d,21:00:00:e0:8b:08:5f:3d (Initiator)

Please select a LOCAL device from the list above ('q' to quit) : 0

Index (WWNN,WWPN/iSCSI Name)

----- ----------------------

0 20:00:00:14:c3:3d:d2:bf,22:00:00:14:c3:3d:d2:bf (Target)

1 20:00:00:14:c3:44:9b:86,22:00:00:14:c3:44:9b:86 (Target)

2 20:00:00:14:c3:44:9b:9d,22:00:00:14:c3:44:9b:9d (Target)

3 20:00:00:14:c3:44:9a:fa,22:00:00:14:c3:44:9a:fa (Target)

4 20:00:00:20:37:fd:9c:f7,22:00:00:20:37:fd:9c:f7 (Target)

5 20:00:00:20:37:fd:8a:b0,22:00:00:20:37:fd:8a:b0 (Target)

6 20:00:00:14:c3:3d:cf:80,22:00:00:14:c3:3d:cf:80 (Target)

7 20:00:00:14:c3:44:9a:f1,22:00:00:14:c3:44:9a:f1 (Target)

8 20:00:00:14:c3:44:9b:0b,22:00:00:14:c3:44:9b:0b (Target)

9 20:00:00:14:c3:44:9b:7c,22:00:00:14:c3:44:9b:7c (Target)

10 20:00:00:20:37:fd:8b:ab,22:00:00:20:37:fd:8b:ab (Target)

Please select a REMOTE device from the list above ('q' to quit) : 0

4-26	SN0054659-00 A

4 – Command Reference

Command Syntax

Smart-Write (0=Enable, 1=Disable) [Enabled ]

Smart-Write Compression (0=Enable, 1=Disable) [Disabled ] Smart-Write Load Balance (0=Enable, 1=Disable) [Disabled ]

All attribute values for that have been changed will now be saved.

Remotemap add command example without SMART-WRITE licenses:

QRouter (admin) #> remotemap add

Index (System Info, Mgmt IP Address)

-----------------------------------

0 iSR-6142.0608A00487(172.17.137.215)

Please select a REMOTE system from the list above ('q' to quit) : 0 Index (WWNN,WWPN/iSCSI Name)

---------------------------

0 20:20:00:d0:b2:02:86:d0,21:20:00:d0:b2:02:86:d0 (Init/Tgt)

1 20:21:00:d0:b2:02:86:d0,21:21:00:d0:b2:02:86:d0 (Init/Tgt)

2 20:20:00:d0:b2:02:86:d1,21:20:00:d0:b2:02:86:d1 (Init/Tgt)

3 20:21:00:d0:b2:02:86:d1,21:21:00:d0:b2:02:86:d1 (Init/Tgt)

Please select a LOCAL device from the list above ('q' to quit) : 0


Index (WWNN,WWPN/iSCSI		Name)
----- ----------------------			(Initiator)
0	20:00:00:e0:8b:08:5f:3d,21:00:00:e0:8b:08:5f:3d
1	20:00:00:d0:b2:00:19:f0,21:00:00:d0:b2:00:19:f0		(Init/Tgt)
Please select a REMOTE		device from the list above	('q' to quit) : 0

Remotemap modify command example with SMART-WRITE licenses:

QRouter (admin) #> remotemap mod

The following wizard will be used to modify various settings of a remote mapping. If you wish to terminate this wizard before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.

Index Local Device (WWPN)	Remote Device (WWPN)
----- -------------------	--------------------
0 21:00:00:e0:8b:08:5f:3d	22:00:00:20:37:fd:8a:b0

SN0054659-00 A

4-27

+ 107 hidden pages

Q-Logic ISR6142 User Manual

Table of Contents

1 Introduction

Intended Audience

Related Materials

Technical Support

Availability

Training

Contact Information

2 Command Usage

Logging On to a SAN Router

Guest Account

Working with SAN Router Configurations

Modifying a Configuration

Saving and Restoring Router Configurations

Save Router Configuration and Persistence

Restore Router Configuration and Persistence

3 Configuring CHAP

CHAP Definition

Discovery Session—Uni-directional CHAP

4 Command Reference

Command Listing

Command Syntax

Admin

Beacon

Clear

Date

FcipRoute

Help

History

Image

Initiator

Localmap

Logout

Password

Ping

Quit

Reboot

Remote Map