Qlogic SANsurfer iSCSI HBA CLI Guide de l'utilisateur

SN0054621-00 B Page iQSimplifySANsurfer iSCSI HBA CLI ApplicationUser’s GuideCommand Line Interface for SANbladeiSCSI Host Bus Adapters

1 – IntroductionTechnical Support1-2 SN0054621-00 BQNotes

SN0054621-00 B 2-1Section 2 Getting Started2.1IntroductionSANsurfer iSCSI HBA CLI operates in one of the following modes: Interactive mode. SAN

2 – Getting StartedInteractive Mode2-2 SN0054621-00 BQThe Main Menu (see figure 2-1) displays. For example:Figure 2-1. SANsurfer iSCSI HBA CLI Main M

2 – Getting StartedNon-interactive ModeSN0054621-00 B 2-3Q2.3Non-interactive ModeType the following in a command window to start SANsurfer iSCSI HBA

2 – Getting StartedNon-interactive Mode2-4 SN0054621-00 BQ-t-pb-pu, -pxN/A-pa-dspcap, -chapmap, -linkchap, -addchap, -defbidi, -edchap, -delchap, -l7

SN0054621-00 B 3-1Section 3 Initial InstallationThe following requirements must be met before you can run SANsurfer iSCSI HBA CLI: The HBAs mus

3 – Initial InstallationInstallation Instructions3-2 SN0054621-00 BQFor example, a package for the Linux operating system can be named:iscli-1.0.35-0

3 – Initial InstallationInstallation InstructionsSN0054621-00 B 3-3Q3. The Destination Folder dialog box displays (see figure 3-2).Figure 3-2. Destin

3 – Initial InstallationInstallation Instructions3-4 SN0054621-00 BQ4. The Start menu entries dialog box displays (see figure 3-3).Figure 3-3. Start

3 – Initial InstallationInstallation InstructionsSN0054621-00 B 3-5Q5. The Start copying files dialog box displays (see figure 3-4). Read the informa

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersQPage ii SN0054621-00 BInformation furnish

3 – Initial InstallationUninstall Instructions3-6 SN0054621-00 BQactivate this feature. The start menu and desktop shortcuts are ready and active now

3 – Initial InstallationUninstall InstructionsSN0054621-00 B 3-7Q3.2.1WindowsPerform the following steps to uninstall SANsurfer iSCSI HBA CLI:1. From

3 – Initial InstallationUninstall Instructions3-8 SN0054621-00 BQ

SN0054621-00 B 4-1Section 4 Interactive Mode CommandsThe following sections describe the interactive command line options listed in table 2-1. S

4 – Interactive Mode CommandsHBA Options Menu4-2 SN0054621-00 BQ iSCSI name (HBA port iSCSI name. The QLogic manufacturing default name or a name th

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-3Q4.4.1HBA Network Settings MenuPerform the following steps to make changes to the HBA

4 – Interactive Mode CommandsHBA Options Menu4-4 SN0054621-00 BQ4.4.1.2Configure IP Settings(Command Line Option -ipdhcp)This submenu allows you to e

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-5Q4.4.1.2.2Using SLPBy default, the service locator protocol (SLP) is disabled.To enabl

4 – Interactive Mode CommandsHBA Options Menu4-6 SN0054621-00 BQ4.4.2.1Display Configured HBA Settings(Command Line Option -c)When this option is sel

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-7QFW_Sense_Buffer_Descaon, off When this parameter is on, the HBA expects the last data

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersQSN0054621-00 B Page iii

4 – Interactive Mode CommandsHBA Options Menu4-8 SN0054621-00 BQLarge_Framesaon, off This parameter defines the maximum length of an Ethernet frame.

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-9QiSCSI_Header_Digests on, off When this parameter is on, iSCSi headers with CRC protec

4 – Interactive Mode CommandsHBA Options Menu4-10 SN0054621-00 BQiSCSI_Snack on, off When this parameter is on and the FW_Initiator_Mode parameter is

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-11QDefaultTime2Retaina0–65535 secondsThis parameter indicates the maximum logout time (

4 – Interactive Mode CommandsHBA Options Menu4-12 SN0054621-00 BQTCP_SLP_SA on, off When this parameter is on, the HBA is enabled as an initiator to

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-13QTCP_Time_Stamp on, off When this parameter is on, a timestamp is placed in every tra

4 – Interactive Mode CommandsHBA Options Menu4-14 SN0054621-00 BQ4.4.2.2Change HBA Alias NameNOTE: This option is not available in non-interactive mo

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-15Qa. For each submenu, save the changes by typing the number for the Save changes and

4 – Interactive Mode CommandsHBA Options Menu4-16 SN0054621-00 BQ iSCSI_Strict_Login iSCSI_AliasEach setting is displayed with the current value in

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-17Q IP_Subnet_Mask IP_Gateway Primary_DNS SLP_AddressEach setting is displayed with

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersQPage iv SN0054621-00 B© 2005 QLogic Corpo

4 – Interactive Mode CommandsHBA Options Menu4-18 SN0054621-00 BQ4.4.2.3.6Configure Advanced SettingsThis option allows you to modify the following s

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-19Q4.4.2.5Update Firmware Image(Command Line Option -f)This option updates the firmware

4 – Interactive Mode CommandsHBA Options Menu4-20 SN0054621-00 BQ3. Make changes in the submenus, as described in the following sections: Display Bo

4 – Interactive Mode CommandsHBA Options MenuSN0054621-00 B 4-21Q4.4.3.3Set Primary Boot Target Information(Command Line Option -pbootcode)This optio

4 – Interactive Mode CommandsHBA Information (Command Line Option -pinfo)4-22 SN0054621-00 BQ4.4.4HBA Restore Factory Defaults(Command Line Option -r

4 – Interactive Mode CommandsReset HBA (Command Line Option -b)SN0054621-00 B 4-23QFor example:iscli Main Menumain Interactive Menu------------------

4 – Interactive Mode CommandsTarget Menu4-24 SN0054621-00 BQ4.7Target MenuBefore making a selection from the HBA Target Menu, perform the following s

4 – Interactive Mode CommandsTarget MenuSN0054621-00 B 4-25Q4.7.2Bind Target(Command Line Option -pb)This option persistently binds a specific target

4 – Interactive Mode CommandsTarget Menu4-26 SN0054621-00 BQ TGTCPO_Timestamp TGT_TargetIPAddressEach setting is displayed with the current value i

4 – Interactive Mode CommandsTarget MenuSN0054621-00 B 4-27Q Add a CHAP entry (see section 4.7.6.4) Add a default BIDI CHAP (see section 4.7.6.5)

SN0054621-00 B Page vTable of ContentsSection 1 Introduction1.1 Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 – Interactive Mode CommandsTarget Menu4-28 SN0054621-00 BQ3. The CHAP table is displayed. At the prompt CHAP Entry Number <0 for no CHAP>, do

4 – Interactive Mode CommandsTarget MenuSN0054621-00 B 4-29Q4.7.6.6Edit a CHAP Entry(Command Line Option -edchap)Perform the following steps to edit

4 – Interactive Mode CommandsDiagnostic Menu4-30 SN0054621-00 BQ4.7.7List LUN Information(Command Line Option -l)This option allows you to view the f

4 – Interactive Mode CommandsDiagnostic MenuSN0054621-00 B 4-31QMake changes in the submenus, as described in the following sections.After making cha

4 – Interactive Mode CommandsDiagnostic Menu4-32 SN0054621-00 BQ4.8.3Perform Read/Write Buffer Test(Command Line Option -rwt)CAUTION! Before performi

4 – Interactive Mode CommandsDiagnostic MenuSN0054621-00 B 4-33Q MACRxControlFrames. MAC received control frames MACRxDribble. MAC received dribble

4 – Interactive Mode CommandsDisplay Vital Product Data (VPD) Information (Command Line Option -vpd)4-34 SN0054621-00 BQ iSCSIDataDigestErrorCount.

SN0054621-00 B 5-1Section 5 Non-interactive Mode Commands5.1IntroductionWhen operating in non-interactive mode, the command format is as follows

5 – Non-interactive Mode Commands-b (Reset HBA)5-2 SN0054621-00 BQThe positional parameters vary, depending on the command option specified. For exam

5 – Non-interactive Mode Commands-l (List LUN Information)SN0054621-00 B 5-3Q5.5-g(Display General System Information)Type the following command to d

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersPage vi SN0054621-00 BQ4.4.2.3.3 Configure

5 – Non-interactive Mode Commands-n (Configure iSCSI Settings)5-4 SN0054621-00 BQ5.9-n(Configure iSCSI Settings)Type the following command to set to

5 – Non-interactive Mode Commands-pb (Bind Target)SN0054621-00 B 5-5Q5.10-pa(Add a Target)Type the following command to add persistent targets:-pa &l

5 – Non-interactive Mode Commands-pu (Unbind Target)5-6 SN0054621-00 BQ5.13-pu(Unbind Target)Type the following command to unbind a persistently boun

5 – Non-interactive Mode Commands-rwt (Perform Read/Write Buffer Test)SN0054621-00 B 5-7QWhere:5.18-lb(Perform Loopback Test)CAUTION! Before performi

5 – Non-interactive Mode Commands-dspchap (Display a CHAP Table)5-8 SN0054621-00 BQWhere:This command runs a read/write buffer test that writes an 8-

5 – Non-interactive Mode Commands-edchap (Edit a CHAP Entry)SN0054621-00 B 5-9Q5.22-linkchap(Assign a CHAP Entry to a Target)Type the following comma

5 – Non-interactive Mode Commands-delchap (Delete a CHAP Entry)5-10 SN0054621-00 BQThe HBA will be reset after this command is issued.5.26-delchap(De

5 – Non-interactive Mode Commands-rdh (Restore HBA Settings)SN0054621-00 B 5-11Q5.31-rdh(Restore HBA Settings)NOTE: This option is not supported in t

5 – Non-interactive Mode Commands-stat (Display HBA Statistics)5-12 SN0054621-00 BQ5.32-stat(Display HBA Statistics)Type the following command to dis

5 – Non-interactive Mode Commands-bootcodemode (Set Bootcode Mode (QLA4050/4052 and QMC4052 HBAs))SN0054621-00 B 5-13Q5.35-dnsdhcp(Configure IP Setti

SANsurfer iSCSI HBA CLISN0054621-00 B Page viiQSANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus Ada

5 – Non-interactive Mode Commands-bootcode (Update Bootcode Code Image)5-14 SN0054621-00 BQWhere:DCHP mode (3) is valid only when DHCP is enabled.5.3

5 – Non-interactive Mode Commands-vpd (Display VPD Information)SN0054621-00 B 5-15Q5.44-csbootcode(Clear Secondary Primary Target Information)Type th

5 – Non-interactive Mode Commands-vpd (Display VPD Information)5-16 SN0054621-00 BQ

SN0054621-00 B Index-1IndexAAccept AEN 4-6Access control, firmware 4-6ACK, AFW_Delayed_Ack firmware parameter 4-7, 4-16, 4-18-addchap 5-9AddressIP 4-

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersIndex-2 SN0054621-00 BQ-binfo 5-13-bootcod

SANsurfer iSCSI HBA CLISN0054621-00 B Index-3QSANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus Adap

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersIndex-4 SN0054621-00 BQH-h 5-3HBAalias 4-2

SANsurfer iSCSI HBA CLISN0054621-00 B Index-5QSANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus Adap

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersIndex-6 SN0054621-00 BQR-r 5-6R2T, maximum

SANsurfer iSCSI HBA CLISN0054621-00 B Index-7QSANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus Adap

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersPage viii SN0054621-00 BQ5.31 -rdh (Restor

SANsurfer iSCSI HBA CLI Application User’s GuideCommand Line Interface for SANblade iSCSI Host Bus AdaptersIndex-8 SN0054621-00 BQ

SN0054621-00 B 1-1Section 1 IntroductionThe SANsurfer® command line interface (CLI) application is a simplified, condensed version of the SANsur