Q-Logic ISR6142 User Manual

Loading...

iSR6142 Command Line Interface (CLI)

User’s Guide

SN0054659-00 A

iSR6142 Command Line Interface (CLI)

User’s Guide

S

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

© 2008 QLogic Corporation. All Rights Reserved Worldwide.

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

A

iSR6142 Command Line Interface (CLI)

User’s Guide

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

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

S

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

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

S

 

 

 

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

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

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

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

S

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

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

S

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

S

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

A

3 – Configuring CHAP

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

SN0054659-00 A

3-3

3 – Configuring CHAP

Normal Session—Bi-directional CHAP

S

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

A

3 – Configuring CHAP

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.

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

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

S

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

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

S

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

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

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

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

S

 

 

 

 

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

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

S

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

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

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

S

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 perf [ byte | init_rbyte | init_wbyte | tgt_rbyte | tgt_wbyte ] show presented_initiators [ fc | iscsi ]

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

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

S

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

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

S

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

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

S

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

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.

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

4-18

SN0054659-00 A

A

4 – Command Reference

Command Syntax

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 remove command example:

172.17.137.171 (admin) #> localmap rm

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)

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

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

S

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

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

S

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

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.

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

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

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

S

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

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

S

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

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

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

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)

 

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

(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

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