Q Simplify SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters SN0054621-00 B Page i
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters 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.
Q SN0054621-00 B SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters Page iii
SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters Q © 2005 QLogic Corporation. All rights reserved worldwide. First Published: September 2005 Printed in U.S.A.
Table of Contents Section 1 Introduction 1.1 Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 2 Getting Started 2.1 2.2 2.3 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters 4.4.2.3.3 4.4.2.3.4 4.4.2.3.5 4.4.2.3.6 4.4.2.4 4.4.2.5 4.4.2.6 4.4.2.7 4.4.3 4.4.3.1 4.4.3.2 4.4.3.3 4.4.3.4 4.4.3.5 4.4.3.6 4.4.3.7 4.4.3.8 4.4.4 4.5 4.6 4.7 4.7.1 4.7.2 4.7.3 4.7.4 4.7.5 4.7.6 4.7.6.1 4.7.6.2 4.7.6.3 4.7.6.4 4.7.6.5 4.7.6.6 4.7.6.7 4.7.7 Page vi Q Configure Firmware Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure Device Settings . . . . . . . . . . .
Q 4.8 4.8.1 4.8.2 4.8.3 4.8.4 4.9 SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters SANsurfer iSCSI HBA CLI 4.10 Diagnostic Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ping Target (Command Line Option -ping) . . . . . . . . . . . . . . . . . . . . . Perform Loopback Test (Command Line Option -lb) . . . . . . . . . . . . . . Perform Read/Write Buffer Test (Command Line Option -rwt) . . . . . .
SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters 5.31 5.32 5.33 5.34 5.35 5.36 5.37 5.38 Q -rdh (Restore HBA Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -stat (Display HBA Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -netconf (Display Network Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . -ipdhcp (Configure IP Settings). . . . . . . . . . . . . . . . . .
Section 1 Introduction The SANsurfer® command line interface (CLI) application is a simplified, condensed version of the SANsurfer iSCSI HBA Manager GUI. SANsurfer iSCSI HBA CLI does not provide any features that require a GUI. SANsurfer iSCSI HBA CLI is supported for QLA®4010, QLA4050/4052, and QMC4052 HBAs on the following operating systems: ■ Windows® 2000 Server, Advanced Server, Professional ■ Windows 2003 Server™ ■ Red Hat® Linux® AS v2.1 and 3.0 (2.4.
1 – Introduction Technical Support Q Notes 1-2 SN0054621-00 B
Section 2 Getting Started 2.1 Introduction SANsurfer iSCSI HBA CLI operates in one of the following modes: ■ Interactive mode. SANsurfer iSCSI HBA CLI starts, then waits for and executes input commands until terminated by the user. Use this mode to perform multiple operations. ■ Non-interactive (command line) mode. SANsurfer iSCSI HBA CLI starts, performs the functions defined by the list of parameters provided, then terminates.
Q 2 – Getting Started Interactive Mode The Main Menu (see figure 2-1) displays. For example: iscli Main Menu main Interactive Menu ------------------------------------------------------Current QLA4010 HBA/Port Information: HBA Serial Number: FS2046A08466 HBA Port: 0 IP Address: 192.168.8.18 Link: Up Port Name: iqn.200-04.com.qlogic:qla4010.fs20446a08466 Port Alias: ------------------------------------------------------1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11.
Q 2 – Getting Started Non-interactive Mode 2.3 Non-interactive Mode Type the following in a command window to start SANsurfer iSCSI HBA CLI in non-interactive mode: iscli SANsurfer iSCSI HBA CLI executes the command options, then terminates. To list all of the available command line parameters, type the following: iscli -h All command line options must be preceded by the dash (-) notation. Most options have a corresponding menu selection in interactive mode.
Q 2 – Getting Started Non-interactive Mode Table 2-1. Non-Interactive Mode Options (Continued) Non-interactive Option Interactive Menu Selection 7 Section list LUN information 4.7 4.7.1, 5.16 4.7.2, 5.12 4.7.3, 5.13, 5.14 4.7.4 4.7.5, 5.10 4.7.6, 5.20, 5.21, 5.22, 5.23, 5.24, 5.25, 5.26 4.7.7, 5.8 8 Diagnostics Menu: ping target perform a loopback test perform a read/write buffer test display HBA statistics 4.8 4.8.1, 5.17 4.8.2, 5.18 4.8.3, 5.19 4.8.4, 5.
Section 3 Initial Installation The following requirements must be met before you can run SANsurfer iSCSI HBA CLI: ■ The HBAs must be installed. ■ The HBA drivers must be installed. ■ You need approximately 1 MB on the PC hard disk to install the SANsurfer iSCSI HBA CLI application. NOTE: SANsurfer iSCSI HBA CLI is an application developed to configure QLogic HBAs. It can only configure HBAs on the local machine upon which the application is installed; it cannot configure HBAs on remote machines. 3.
Q 3 – Initial Installation Installation Instructions Subtype = One of the following: i386 ppc64 sparc_x86 There is no Subtype in the Windows package name. Install Type = One of the following: rpm (Linux) exe (Windows) Z (Solaris) For example, a package for the Linux operating system can be named: iscli-1.0.35-0_linux_i386.rpm 7.
Q 3 – Initial Installation Installation Instructions 3. The Destination Folder dialog box displays (see figure 3-2). Figure 3-2. Destination Folder Dialog Box Do one of the following: ❑ To select the destination location displayed in the dialog box, click Next (recommended). The default location for a Windows system is: Program Files\QLogic Corporation\SANsurferiCLI ❑ To select a different location: a. Click Browse. b. Select the desired location. c. The Destination Folder dialog box redisplays.
Q 3 – Initial Installation Installation Instructions 4. The Start menu entries dialog box displays (see figure 3-3). Figure 3-3. Start Menu Entries Dialog Box Do one of the following: ❑ To select the start menu group displayed in the dialog box, click Next (recommended). ❑ To select a different group, do one of the following: ❑ To select an existing group, select a group from the Start Menu Group drop-down box. ❑ To create a new group, type a name in the Start Menu Group drop-down box.
Q 3 – Initial Installation Installation Instructions 5. The Start copying files dialog box displays (see figure 3-4). Read the information, then click Next. Figure 3-4. Start Copying Files Dialog Box 6. After the program is installed, the Setup complete dialog box displays. Click Finish. Figure 3-5. Setup Complete Dialog Box 7.
Q 3 – Initial Installation Uninstall Instructions activate this feature. The start menu and desktop shortcuts are ready and active now. Click OK. 8. Restart your computer. 3.1.2 Red Hat/SuSE Linux/PPC To install SANsurfer iSCSI HBA CLI on a Red Hat/SuSE Linux/Power PC (PPC) operating system, type the following from the command prompt: rpm -i iscli-AA.BB.CC-DD_linux_.rpm In Red Hat, the files are automatically placed in the directory /opt/QLogic_Corporation/SANsurferiCLI.
Q 3 – Initial Installation Uninstall Instructions 3.2.1 Windows Perform the following steps to uninstall SANsurfer iSCSI HBA CLI: 1. From the Start menu, select Control Panel. 2. Click Add/Remove Programs. 3. Select SANsurferiCLI. 4. Click Change/Remove. 3.2.2 Red Hat/SuSE Linux/PPC To uninstall SANsurfer iSCSI HBA CLI on a Red Hat/SuSE Linux/PPC operating system, type the following from a command prompt: rpm -e iscli-AA.BB.CC-DD (be sure to omit the rest of the package name) 3.2.
3 – Initial Installation Uninstall Instructions 3-8 Q SN0054621-00 B
Section 4 Interactive Mode Commands The following sections describe the interactive command line options listed in table 2-1. See section 5 for a description of the commands available in non-interactive (command line) mode. Before making a selection from the Main Menu, specify the HBA whose settings you want to view or change by performing the following steps: 1. From the Main Menu, type 10 (Set Working Adapter), then press ENTER. 2. A list of iSCSI HBA ports is displayed.
Q 4 – Interactive Mode Commands HBA Options Menu ■ iSCSI name (HBA port iSCSI name. The QLogic manufacturing default name or a name that you assign.) ■ Alias (HBA port iSCSI alias name. Symbolic name you assign to the HBA for identification purposes.) ■ IP address (IP address of the HBA port) ■ Instance (driver ID number) For example: 1. HBA Model: QLA4052C HBA Serial Number: FS20525B03135 iSCSI name: iqn.1991-05.com.micorsfot:al-ibm Alias: MYHBA IP Address: 192.168.3.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.1 HBA Network Settings Menu Perform the following steps to make changes to the HBA network settings: 1. Specify the HBA port whose settings you want to view or change by typing the number for the Set Working Adapter option, then press ENTER. 2. A list of all iSCSI HBA ports is displayed. Type the number for the HBA port whose settings you want to change, then press ENTER. 3.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.1.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.1.2.2 Using SLP By default, the service locator protocol (SLP) is disabled. To enable SLP, press ENTER until the SLP: [off]: prompt displays. Type on, then press ENTER. 4.4.1.3 iSNS Settings (Command Line Option -isns) By default, iSNS is disabled. Use iSNS when extended discovery management capabilities (such as notifications, access management, and configuration) are required, such as in larger storage networks.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.2.1 Display Configured HBA Settings (Command Line Option -c) When this option is selected, all of the firmware parameters and their values are displayed for the HBA port. The firmware settings are described in table 4-1. Table 4-1.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description FW_Sense_Buffer_Desca on, off When this parameter is on, the HBA expects the last data segment descriptor of the data descriptor list associated with a Command Type 3 IOCB to be a descriptor of a sense buffer. When this parameter is off, the HBA passes any sense data returned by the target in a status IOCB.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Large_Framesa DevType Description on, off This parameter defines the maximum length of an Ethernet frame. When this parameter is on, the frame length is 9000. When this parameter is off, the frame length is 1500. This length determines when to fragment IP datagrams and the maximum size of a received frame. When this size is exceeded, the frame is discarded for being too long.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description iSCSI_Header_Digests on, off When this parameter is on, iSCSi headers with CRC protection can be transmitted. In addition, incoming iSCSI headers are validated and CRC protection is removed. iSCSI_Data_Digests on, off When this parameter is on, iSCSi data with CRC protection can be transmitted. In addition, incoming iSCSI data is validated and CRC protection is removed.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description iSCSI_Snack on, off When this parameter is on and the FW_Initiator_Mode parameter is on, the HBA firmware sends SNACK requests to the target when it detects missing PDUs. When this parameter is off and the FW_Initiator_Mode parameter is on, the firmware aborts the command and/or closes the connection when missing PDUs are detected.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description DefaultTime2Retaina 0–65535 seconds This parameter indicates the maximum logout time (in seconds) the HBA uses when negotiating with a device during the login phase. DefaultTime2Waita 0–65535 seconds This parameter indicates the minimum logout time (in seconds) the HBA uses when negotiating with a device during the login phase.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description TCP_SLP_SA on, off When this parameter is on, the HBA is enabled as an initiator to make SA SLP queries to discover iSCSI targets. TCP_DHCP on, off When this parameter is on, the HBA utilizes DHCP to obtain its IP address, gateway IP address, and subnet mask.
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description on, off When this parameter is on, a timestamp is placed in every transmitted TCP segment. When the receiver responds with an acknowledge (ACK), the timestamp is included. Consequently, the transmitter can calculate the round trip time (RTT) of the ACK. This value is used for calculating retransmissions (if necessary).
Q 4 – Interactive Mode Commands HBA Options Menu Table 4-1. HBA Firmware Settings (Continued) Parameter Value Description — This parameter specifies where to look for the SLP server. 08h This parameter indicates the number of completions the firmware posts to the completion queue before interrupting the host driver to indicate that there are items in the queue. This parameter is valid only when the FW_ZIO_Enable_Mode parameter is on. SLP_Address ZIO Table Notes a Read only 4.4.2.
Q 4 – Interactive Mode Commands HBA Options Menu a. For each submenu, save the changes by typing the number for the Save changes and reset HBA option, then press ENTER. b. To update the firmware with these changes, type the number for the Refresh option, then press ENTER. If you do not select this option, your changes will not be visible in SANsurfer iSCSI HBA CLI. 4.4.2.3.
4 – Interactive Mode Commands HBA Options Menu ■ ■ Q iSCSI_Strict_Login iSCSI_Alias Each setting is displayed with the current value in brackets, for example: iSCSI_Snack [off] : To change the value, type the new value after the prompt. To keep the current value, press ENTER at the prompt. The next iSCSI setting displays. The settings are displayed one-by-one, in the order shown in the above list. These settings are described in table 4-1. 4.4.2.3.
Q 4 – Interactive Mode Commands HBA Options Menu ■ ■ ■ ■ IP_Subnet_Mask IP_Gateway Primary_DNS SLP_Address Each setting is displayed with the current value in brackets, for example: Primany_DNS [0.0.0.0] : To change the value, type the new value after the prompt. To keep the current value, press ENTER at the prompt. The next device setting displays. The settings are displayed one-by-one, in the order shown in the above list. These settings are described in table 4-1. 4.4.2.3.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.2.3.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.2.5 Update Firmware Image (Command Line Option -f) This option updates the firmware image. At the prompt, enter the name of the file containing the firmware image to upload to the HBA. NOTE: ■ Before updating the firmware, be sure that no I/O processes are running. ■ Be sure to select the Save changes and reset HBA option afterwards; otherwise, the change will not take effect. 4.4.2.
Q 4 – Interactive Mode Commands HBA Options Menu 3. Make changes in the submenus, as described in the following sections: ■ ■ ■ ■ ■ ■ ■ ■ Display Bootcode Information (see section 4.4.3.1) Set Bootcode Mode (see section 4.4.3.2) Set Primary Boot Target Information (see section 4.4.3.3) Set Secondary Boot Target Information (see section 4.4.3.4) Clear Primary Boot Target Information (see section 4.4.3.5) Clear Secondary Boot Target Information (see section 4.4.3.
Q 4 – Interactive Mode Commands HBA Options Menu 4.4.3.3 Set Primary Boot Target Information (Command Line Option -pbootcode) This option allows you to select the primary target from which to boot. At the prompt, enter a target ID and associated LUN. 4.4.3.4 Set Secondary Boot Target Information (Command Line Option -sbootcode) This option allows you to select the secondary target from which to boot. At the prompt, enter a target ID and associated LUN. 4.4.3.
4 – Interactive Mode Commands HBA Information (Command Line Option -pinfo) Q 4.4.4 HBA Restore Factory Defaults (Command Line Option -rdh) NOTE: This option is not supported in the QLA4010 HBA.
Q 4 – Interactive Mode Commands Reset HBA (Command Line Option -b) For example: iscli Main Menu main Interactive Menu ------------------------------------------------------Current QLA4010 HBA/Port Information: HBA Serial Number: FS2046A08466 HBA Port: 0 IP Address: 192.168.8.18 Link: Up Port Name: iqn.200-04.com.qlogic:qla4010.fs20446a08466 Port Alias: ------------------------------------------------------1. Display General System Information 2. Display Program Version Information 3.
Q 4 – Interactive Mode Commands Target Menu 4.7 Target Menu Before making a selection from the HBA Target Menu, perform the following steps: 1. Specify the HBA port whose settings you want to view or change by typing the number for the Set Working Adapter option, then press ENTER. 2. A list of HBA ports is displayed. Type the number for the HBA port whose settings you want to change, then press ENTER. 3.
Q 4 – Interactive Mode Commands Target Menu 4.7.2 Bind Target (Command Line Option -pb) This option persistently binds a specific target to the HBA port by saving it in the HBA flash. Targets that are not persistently bound will not persist across firmware resets or HBA power cycles. After selecting the Bind Target option, a list of available targets is displayed. At the Enter a Target ID: prompt, type the target ID of the target you want to bind. 4.7.
Q 4 – Interactive Mode Commands Target Menu ■ ■ TGTCPO_Timestamp TGT_TargetIPAddress Each setting is displayed with the current value in brackets, for example: TGT_DefaultTimeout [120] : To change the value, type the new value after the prompt. To keep the current value, press ENTER at the prompt. The next device setting displays. The settings are displayed one-by-one, in the order shown in the above list. These settings are described in table 4-1. 4.7.
Q 4 – Interactive Mode Commands Target Menu ■ ■ ■ ■ Add a CHAP entry (see section 4.7.6.4) Add a default BIDI CHAP (see section 4.7.6.5) Edit a CHAP entry (see section 4.7.6.6) Delete a CHAP entry (see section 4.7.6.7) 4.7.6.1 Display a CHAP Table (Command Line Option -dspchap) This option displays the CHAP table, which is an array of records containing CHAP names and secrets used by the HBA during CHAP authentication.
Q 4 – Interactive Mode Commands Target Menu 3. The CHAP table is displayed. At the prompt CHAP Entry Number <0 for no CHAP>, do one of the following: ■ Type the entry number for one of the entries in the displayed CHAP table, then press ENTER. ■ Type 0 if you do not want to assign a CHAP entry to this target, then press ENTER. 4.7.6.4 Add a CHAP Entry (Command Line Option -addchap) Perform the following steps to add an entry to the CHAP table: 1.
Q 4 – Interactive Mode Commands Target Menu 4.7.6.6 Edit a CHAP Entry (Command Line Option -edchap) Perform the following steps to edit a CHAP entry: 1. From the HBA CHAP Menu, type 6 (Edit a CHAP entry), then press ENTER. 2. The CHAP table is displayed. Press ENTER. 3. At the prompt, type the number of the CHAP entry you want to change, then press ENTER. 4. At the CHAPName [default name] prompt, do one of the following: ■ ■ Type a new CHAP name, then press ENTER.
Q 4 – Interactive Mode Commands Diagnostic Menu 4.7.7 List LUN Information (Command Line Option -l) This option allows you to view the following information about LUNs attached to the selected target: ■ ■ ■ ■ ■ HBA/Target/LUN Number Vendor name Product ID Product revision LUN size You can view this information for a specific LUN or for all LUNs attached to the selected target. For example: iSCSI HBA Target Menu HBA Target Menu … enter selection: 7 Target ID: 64 IP: 192.166.1.
Q 4 – Interactive Mode Commands Diagnostic Menu Make changes in the submenus, as described in the following sections. After making changes, refresh the HBA to show these changes by typing 6 (Refresh), then press ENTER. If you do not select this option, your changes will not be visible in SANsurfer iSCSI HBA CLI. 4.8.1 Ping Target (Command Line Option -ping) Perform the following steps to ping a target: 1. From the HBA Diagnostic menu, type 1, then press ENTER. 2. The Enter an IP Address: prompt displays.
4 – Interactive Mode Commands Diagnostic Menu Q 4.8.3 Perform Read/Write Buffer Test (Command Line Option -rwt) CAUTION! Before performing a read/write buffer test, make sure that the HBA does not have any outstanding I/O operations. Perform the following steps to start a read/write buffer test: 1. From the HBA Diagnostic menu, type 3, then press ENTER. 2. At the prompt, enter the number of read/write tests to run. Valid values are in the range 1–2147483648 (2^31). By default, one test is performed. 3.
Q 4 – Interactive Mode Commands Diagnostic Menu ■ MACRxControlFrames. MAC received control frames MACRxDribble. MAC received dribble MACRxFrameLengthError. MAC received frame length errors MACRxJabber. MAC received jabber MACRxCarrierSenseError. MAC received carrier sense errors MACRxFramesDropped. MAC received dropped frames MACCRCErrorCount. MAC CRC error count MACEncodingErrorCount. MAC encoding error count MACRxLengthErrorCountLarge. MAC received large length error count MACRxLengthErrorCountSmall.
4 – Interactive Mode Commands Display Vital Product Data (VPD) Information (Command Line Option -vpd) ■ ■ Q iSCSIDataDigestErrorCount. iSCSI data digest error count SCSISeqErrorCount. iSCSI sequence error count 4.9 Display Vital Product Data (VPD) Information (Command Line Option -vpd) When this option is selected, the following information is displayed for the current working adapter (see section 4.
Section 5 Non-interactive Mode Commands 5.1 Introduction When operating in non-interactive mode, the command format is as follows: iscli [Command Variable] | [Command Variable] Where: <> = Parameters in angled brackets are required. [] = Parameters in square brackets are optional. | = OR operator Italic text = Placeholder describing the command variable (see table 5-1). Table 5-1 defines the command variables.
5 – Non-interactive Mode Commands -b (Reset HBA) Q The positional parameters vary, depending on the command option specified. For example, to display an HBA’s configured settings, use the command option -C, followed by the HBA number (positional parameter). In contrast, the command for providing general information, -g, has no positional parameters. In non-interactive mode, most changes made to the HBA become effective immediately.
Q 5 – Non-interactive Mode Commands -l (List LUN Information) 5.5 -g (Display General System Information) Type the following command to display general system information: -g The following information is displayed: ■ ■ ■ Host name Host version Host type 5.6 -h (Display Help File) Type the following command to display the SANsurfer iSCSi HBA CLI help file: -h 5.7 -i (List All QLogic iSCSI HBAs Detected) Type the following command to display general HBA information: -i [HBA No.] When the HBA No.
Q 5 – Non-interactive Mode Commands -n (Configure iSCSI Settings) 5.9 -n (Configure iSCSI Settings) Type the following command to set to HBA iSCSI parameters: -n [ …] The HBA will be reset after this command is issued. The parameter set can be repeated. These parameters are defined in table 5-2. Table 5-2.
Q 5 – Non-interactive Mode Commands -pb (Bind Target) Table 5-2. HBA Parameters (Continued) Configuration Name Configuration Alias TCP_DHCP TCP_DNS_Via_DHCP TCP_SLP_DA_Via_DHCP TCP_Nagle Value TCPDHCP on or off DNS_DHCP on or off DADHCP on or off TCPN on or off Miscellaneous Options KeepAliveTO KATO 0–65535 MaxBurstLen MBL 0–65535 MOR2T 0–65535 MaxOutstandingR2T 5.10 -pa (Add a Target) Type the following command to add persistent targets: -pa
Q 5 – Non-interactive Mode Commands -pu (Unbind Target) 5.13 -pu (Unbind Target) Type the following command to unbind a persistently bound target: -pu 5.14 -px (Unbind all Targets) Type the following command to unbind all persistently bound targets on the HBA: -px 5.15 -r (Update ROM Image) Type the following command to update the specified HBA’s ROM: -r The parameter indicates the HBA instance to update.
Q 5 – Non-interactive Mode Commands -rwt (Perform Read/Write Buffer Test) Where: HBA No. = The HBA port where the ping operation will be performed. IP Address = The IP address to ping. Ping Count = The number of times you want to ping the IP address (1–2147483648 (2^31)). 5.18 -lb (Perform Loopback Test) CAUTION! Before performing a loopback test, make sure that the HBA does not have any outstanding I/O operations. Type the following command to run a loopback test: -lb [-STOP] [-EXTLB]
Q 5 – Non-interactive Mode Commands -dspchap (Display a CHAP Table) Where: –STOP = The read/write buffer test is stopped if a failure occurs. –RWPAT n = Sets the pattern to write to the buffer. n can be one of the following: 1 (8 bytes of 55h) 2 (8 bytes of 5Ah) 3 (16 bytes of AAh) 4 (16 bytes of FFh) The default pattern is 1h (8 bytes) HBA No. = The HBA port where the read/write buffer test is to be performed.
Q 5 – Non-interactive Mode Commands -edchap (Edit a CHAP Entry) 5.22 -linkchap (Assign a CHAP Entry to a Target) Type the following command to link a CHAP entry to a target: -linkchap The HBA will not be reset after this command is issued. 5.23 -addchap (Add a CHAP Entry) Type the following command to add a CHAP entry to the persistent CHAP table: -addchap
5 – Non-interactive Mode Commands -delchap (Delete a CHAP Entry) Q The HBA will be reset after this command is issued. 5.26 -delchap (Delete a CHAP Entry) Type the following command to delete a CHAP entry: -delchap The HBA will be reset after this command is issued. 5.27 -pinfo (HBA Port Information) Type the following command to display the port information for the specified HBA: -pinfo 5.
Q 5 – Non-interactive Mode Commands -rdh (Restore HBA Settings) 5.31 -rdh (Restore HBA Settings) NOTE: This option is not supported in the QLA4010 HBA. Type the following command to restore the specified HBA port’s settings to their factory defaults: -rdh [A] [F N I T C V S] Where: HBA No. = HBA port whose factory settings you want to restore. A = Restores the factory settings for the entire HBA (firmware parameters, network parameters, iSCSI name, targets, CHAP table, NVARAM, and IPSec).
5 – Non-interactive Mode Commands -stat (Display HBA Statistics) Q 5.32 -stat (Display HBA Statistics) Type the following command to display the statistics for the specified HBA: -stat See section 4.8.4 for a list of statistics that are displayed. 5.33 -netconf (Display Network Settings) Type the following command to configure the network settings: -netconf
Q 5 – Non-interactive Mode Commands -bootcodemode (Set Bootcode Mode (QLA4050/4052 and QMC4052 HBAs)) 5.35 -dnsdhcp (Configure IP Settings) Type the following command to turn on DHCP address resolution to discover the DNS server address: -dnsdhcp This command is valid only if DCHP is on for the IP configuration. 5.36 -slp (Display Network Settings) Type the following command to configure SLP for the HBA port: -slp
Q 5 – Non-interactive Mode Commands -bootcode (Update Bootcode Code Image) Where: 1 = Disables bootcode mode 2 = Manual mode 3 = DHCP mode DCHP mode (3) is valid only when DHCP is enabled. 5.39 -bootcode (Update Bootcode Code Image) Type the following command to update the bootcode code image: -bootcode 5.40 -sbootcodecid (Set Alternative Client ID) Type the following command to set the alternative client ID: -sbootcodecid 5.
Q 5 – Non-interactive Mode Commands -vpd (Display VPD Information) 5.44 -csbootcode (Clear Secondary Primary Target Information) Type the following command to clear the secondary boot target and LUN: -csbootcode 5.45 -ver (Display Program Version Information) Type the following command to display the iSCSI HBA CLI program version information: -ver 5.46 -vpd (Display VPD Information) Type the following command to display VPD information: -vpd
5 – Non-interactive Mode Commands -vpd (Display VPD Information) 5-16 Q SN0054621-00 B
Index A Accept AEN 4-6 Access control, firmware 4-6 ACK, AFW_Delayed_Ack firmware parameter 4-7, 4-16, 4-18 -addchap 5-9 Address IP 4-13, 4-16, 4-17, 5-4 secondary IP 4-13 SLP 4-14, 4-17, 5-4 Advanced settings, configuring 4-18 AEN, accepting 4-6 AFW AutoConnect firmware parameter 4-7 Delayed _Ack firmware parameter 4-7 Device_Timeouts firmware parameter 4-7 see also Firmware parameters Alarm, protocol statistics 4-6 Alias 4-2 HBA, changing 4-14 iSCSI 4-13, 4-16, 4-17 Alternate client ID, bootcode 4-20 Alt
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters -binfo 5-13 -bootcode 5-14 -bootcodemode 5-13 -c 5-2 -chapmap 5-8 -cpbootcode 5-14 -csbootcode 5-15 -defbidi 5-9 -delchap 5-10 -dnsdhcp 5-13 -dspchap 5-8 -edchap 5-9 -f 5-2 -g 5-3 -gcr 5-10 -h 5-3 -i 5-3 -isns 5-10 -l 5-3 -lb 5-7 -linkchap 5-9 -n 5-4 -netconf 5-12 -pa 5-5 -pb 5-5 -pbootcode 5-14 -pinfo 5-10 -ping 5-6 -ps 5-5 -pu 5-6 -px 5-6 -r 5-6 -rdf 5-10 -rdh 5-11 -rwt 5-7 -sbootcode 5-14 -sbo
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters E -edchap 5-9 Error recovery level, iSCSI 4-10 Error recovery level, target iSCSI I/O 4-25 Execution throttle 4-8, 4-18, 4-25, 5-4 F -f 5-2 Fast posting 4-6 Firmware image, updating 4-19, 5-2 settings 4-5, 4-16 version 4-22 Firmware parameters AFW_AutoConnect 4-7, 4-16, 4-18, 5-4 AFW_Delayed_Ack 4-7, 4-16, 4-18 AFW_Device_Timeouts 4-7, 4-16, 4-18, 5-4 DefaultTime2Retain 4-11 DefaultTime2Wait 4-1
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters H -h 5-3 HBA alias 4-2 board type 4-22 bootcode version 4-22 chip version 4-22 connection type 4-22 default settings, restoring 4-18, 5-10 driver version 4-22 factory defaults, restoring 4-22, 5-11 firmware parameters 4-6, 5-2 Firmware Settings Menu 4-5 firmware version 4-22 Information Menu 4-22 information, displaying 5-10 iSCSI version 4-22 list all QLogic HBAs 4-1, 5-3 MAC address 4-22 model
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters L -l 5-3 Large frames 4-8 -lb 5-7 -linkchap 5-9 Login, iSCSI strict login 4-10, 4-16, 4-17, 5-4 Loopback test, performing 4-31, 5-7 LUN information, listing 4-30, 5-3 number 4-30 product ID 4-30 product revision 4-30 size 4-30 vendor name 4-30 M MAC address 4-22 Marker IOCB 4-6 Maximum burst length 4-11, 4-18, 4-25, 5-5 outstanding R2T 4-11, 4-18, 4-25, 5-5 receive data segment length 4-11 Menus
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters R -r 5-6 R2T, maximum outstanding 4-11, 4-18, 5-5 -rdf 5-10 -rdh 5-11 Read/write buffer test, performing 4-32, 5-7 Receive markers, iSCSI 4-8 Red Hat installing SANsurfer iSCSI HBA CLI 3-6 uninstalling SANsurfer iSCSI HBA CLI 3-7 Reset HBA 4-23, 5-2 ROM image, updating 4-19, 5-6 ROM version 4-22 -rwt 5-7 S SANsurfer iSCSI HBA CLI, operating systems supported 1-1 SANsurfer iSCSI HBA CLI, program
Q SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters TGT_MaxOutstandingR2T 4-25 TGT_Port 4-25 TGT_TargetIPAddress 4-26 TGTCPO_Nagle 4-25 TGTCPO_Timestamp 4-26 TGTISCISO_Data_Digests 4-25 TGTISCSIO_Header_Digests 4-25 TGTISCSIO_Immediate_Data 4-25 TGTISCSIO_Initial_R2T 4-25 TGTISCSIO_Snack 4-25 TGTSCSIO_Discovery_Logout 4-25 TGTSCSIO_Error_Recovery_Level 4-25 TGTSCSIO_Strict_Login 4-25 TCP auto discovery 4-11, 4-16, 4-17, 5-4 DHCP firmware parameter
SANsurfer iSCSI HBA CLI Application User’s Guide Command Line Interface for SANblade iSCSI Host Bus Adapters Index-8 Q SN0054621-00 B
