Summary of the content on the page No. 1
SANsurfer iSCSI HBA CLI
User’s Guide
Command Line Interface for
QLogic iSCSI Host Bus Adapters
SN0054621-00 E
Summary of the content on the page No. 2
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters 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 thes
Summary of the content on the page No. 3
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters S Updated (added and removed parameters) the list “Configure Device Settings” on page 4-25 of device settings. Updated (added and removed parameters) the list “Configure Basic Settings” on page 4-26 of basic settings. Updated (added and removed parameters) the list “Configure Advanced Settings” on page 4-26 of advanced settings. Changed Bootcode Settings Menu to new “BIOS/UEFI [or FCode] Settings Menu”
Summary of the content on the page No. 4
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters S Added missing descriptions for IPv4TOS and Appendix C Target Parameters IPv4TTL parameters. Deleted obsolete Primary_DNS and SLP_Address parameters. Moved trace information from 5 Non-Interactive Appendix F Using Trace Mode Commands to a new appendix. Page iv SN0054621-00 E
Summary of the content on the page No. 5
Table of Contents 1 Introduction Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 How This Guide is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Related Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Supported QLogic HBAs . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters S 3 Getting Started Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Starting Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Starting Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 4 Interactive Mode Commands Display Program Version Infor
Summary of the content on the page No. 7
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters A Configure Link Configuration (CLI Option -lc). . . . . . . . . . . . . . . 4-20 Save Changes and Reset HBA (if necessary) . . . . . . . . . . . . . . 4-20 Port Network Settings Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20 Display Network Settings (CLI Options -netconf) . . . . . . . . . . . . 4-20 Configure IP Settings (CLI Option -ipdhcp) . . . . . . . . . . . . . . . .
Summary of the content on the page No. 8
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters S Target Level Info & Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36 List Targets (CLI Option -t) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37 Display Target Information (CLI Option -t) . . . . . . . . . . . . . . . . . 4-37 Bind Target (CLI Option -pb). . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39 Delete Target . . . . . . . . . . . . . . .
Summary of the content on the page No. 9
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters A -dr (Display Default Router List [IPv6 only]) . . . . . . . . . . . . . . . . . . . . 5-8 -dspchap (Display a CHAP Table). . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 -dtdsp (Display Discovered Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 -dtdspa (List Targets). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9 -dtdupd (Duplicate a Discove
Summary of the content on the page No. 10
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters S -pb (Bind Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24 -pbootcode (Set Primary Boot Target Information) . . . . . . . . . . . . . . . 5-24 -pdt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24 -pet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 11
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters A D Error Codes Interactive Mode Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1 Non-interactive Mode Error Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5 E Downloadable File Names F Using Trace Trace Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2 Trace Level . . . . . . . . . . . . . . .
Summary of the content on the page No. 12
SANsurfer iSCSI HBA CLI User’s Guide Command Line Interface for QLogic iSCSI Host Bus Adapters S List of Figures Figure Page 2-1 Install Wizard: Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 2-2 Install Wizard: Select Which Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 2-3 Install Wizard: Destination Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 2-4 Install Wiza
Summary of the content on the page No. 13
1 Introduction The command line interface (CLI) application is a simplified, condensed version of the SANsurfer iSCSI HBA Manager graphical user interface (GUI). SANsurfer iSCSI HBA CLI does not provide any features that require a GUI. This introductory chapter covers the following: “Intended Audience” on page 1-1 “How This Guide is Organized” on page 1-1 “Supported QLogic HBAs” on page 1-4 “Supported Operating Systems” on page 1-4 “License Agreements” on page 1-5 “Technical Support” on
Summary of the content on the page No. 14
1 – Introduction How This Guide is Organized S Appendix A Port- and HBA-level Parameters provides an alphabetic list of the HBA port firmware parameters and their values. Appendix B HBA Statistics provides an alphabetic list of the HBA statistics shown when you select either the interactive mode Display HBA Statistics option or the non-interactive mode -stat command. Appendix C Target Parameters provides an alphabetic list of target parameters, both fixed and configurable. Appendix D Err
Summary of the content on the page No. 15
1 – Introduction How This Guide is Organized A Italicized text within angle brackets indicates user-defined variables. For example: -arp Text within square brackets indicates optional parameters. For example iscli [optional parameters] [Command Variable] Text shown in blue indicates a cross-reference hyperlink to a Web site or to another section of this guide. Click the hyperlink to jump to that site or section. For example: Visit the QLogic support Web site at support.qlog
Summary of the content on the page No. 16
1 – Introduction Supported QLogic HBAs S Supported QLogic HBAs SANsurfer iSCSI HBA CLI is supported on the following QLogic HBAs: Table 1-2. Supported HBAs HBA Ports Media QLA4010 1 Optical QLA4010C 1 Copper QLA4050 1 Optical QLA4050C 1 Copper QLA4052C 2 Copper QLE4060C 1 Copper QLE4062C 2 Copper QMC4052 (IBM) 2 Copper QMH4062 (HP) 2 Copper Supported Operating Systems SANsurfer iSCSI HBA CLI is supported on the following operating systems: ® Windows 2000 Server SP4+ (IA32, x64) ™ Windows Serve
Summary of the content on the page No. 17
1 – Introduction License Agreements A License Agreements Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product. Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. For the latest firmware and software updates
Summary of the content on the page No. 18
1 – Introduction Technical Support S The QLogic knowledge database contains troubleshooting information for the QLogic HBAs. Access the database from the QLogic Web site, www.qlogic.com. Click the Support tab, and then use the search engine at the top of the page to look for specific troubleshooting information. 1-6 SN0054621-00 E
Summary of the content on the page No. 19
2 Installation and Removal This section provides procedures for the following: “Installing SANsurfer iSCSI HBA CLI” on page 2-1 “Removing SANsurfer iSCSI HBA CLI” on page 2-12 Before you can run SANsurfer iSCSI HBA CLI, ensure that your system meets the following requirements: HBAs are installed. HBA drivers are installed. To install SANsurfer iSCSI HBA CLI, the PC hard disk must have about 1 MB free space. NOTE: SANsurfer iSCSI HBA CLI is designed to configure QLogic HBAs on the local
Summary of the content on the page No. 20
2 – Installation and Removal Installing SANsurfer iSCSI HBA CLI S 3. Under Drivers, Management Tools, and API Libraries: click the appropriate operating system. 4. In the SANsurfer iSCSI row of the Management Tools table, in the Download column, click Download. SANsurfer iSCSI HBA CLI shows the End User License Agreement box. 5. Scroll to the bottom, and then click Agree. SANsurfer iSCSI HBA CLI shows the File Download dialog box. 6. Click Save. Select a directory on your system and downloa
