Summary of the content on the page No. 1
R
Sim p lify
SANsurfer FC HBA CLI
User’s Guide
Command Line Interface for QLogic
Fibre Channel Host Bus Adapters
SN0054614-00 F Page i
Summary of the content on the page No. 2
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel 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
Summary of the content on the page No. 3
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A Changed HBA No. to HBA Instance.All Changed SFF DMI to HBA transceiver details.All Updated supported QLogic HBA list. Section 1.3 Updated supported operating system list. Section 1.4 All non-interactive information moved from Section 4, Section 5 Section 4 to Section 5. Command line options put in alphabetical order. Table 2-1, Section 4 Added Appendix B: XML Format 2. Appendix B Added port virt
Summary of the content on the page No. 4
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S Changed bullets describing interactive and Section 2.2, Section 2.3 non-interactive modes. Clarified the note about starting SANsurfer FC Section 2.2 HBA CLI on a Solaris console serial port. Added Macintosh column to Table 2-1. Section 2.3 Added support for Linux IOCTL module driver and Section 3, Section 4, Section 5 driver on the OS installation CD (inbox driver). Split Windows command line i
Summary of the content on the page No. 5
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A Expanded Save/Update Flash section to list which Section 4.10 OSs and HBAs save/update flash, BIOS, or the option ROM image. Added description and preparation instructions for Section 4.12.1.1, Section 4.12.2 loopback and read/write buffer tests. Added description of these test results. The following options and commands were added in Rev. E: Host Topology (command line option -tp) Section 4.1
Summary of the content on the page No. 6
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S Configure HBA Settings (-n): added option to 4.7.1, Section 5.3.22 restore the BIOS (QLA/QLE/QEM24xx HBAs). Selective LUNs (command line option -m): added 4.8.1.2, Section 5.3.21 ALL option to command line to view all selective LUNs for all HBA ports. Set Boot Device (-e): removed references to OSs 4.9.2.1.1 from the third paragraph; this command now applies to all OSs. Diagnostics (command li
Summary of the content on the page No. 7
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A Revision D Changes: Operating systems supported: All Windows 2003 Server™ and Enterprise Server: added x64; removed IEM64T and AMD64. Added ® Windows XP. ® Red Hat™ Linux AS: added x86_64; removed IEM64T and AMD64. ® SuSE Linux Enterprise Server (SLES) 8 and 9: added x86_64; removed IEM64T and AMD64. Removed Power PC (PPC) SLES 8 and 9. ® ® Solaris SPARC : removed v2.7; added version 7.
Summary of the content on the page No. 8
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S The following options and commands were changed in Rev. D: Interactive mode commands: Changed instructions and the example text to new port sorting and num- bering scheme. No change to command function. Non-interactive mode commands: Changed the HBA Port No. parameter to HBA No. parameter to support new port sorting and numbering scheme. No change to command function. Display HBA Settings (-
Summary of the content on the page No. 9
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A Display LUN List (-l): 4.6 In interactive mode, added target type to infor- mation displayed. Removed asset tag and end tag from list of VPD information. In example text, changed the first two option names of the Selective LUN(s) Display Configura- tion menu. In example text, changed the first two option names of the Selective LUN(s) Configuration - HBA/Device menu. Boot Device Selection (-e
Summary of the content on the page No. 10
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S Notes Page x SN0054614-00 F
Summary of the content on the page No. 11
Table of Contents Section 1 Introduction 1.1 Product Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2 Guide Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2.1 How this Guide is Organized. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2.2 Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1.3 Supported QLogic HBAs . .
Summary of the content on the page No. 12
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S 3.3 Uninstalling SANsurfer FC HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 3.3.1 Windows Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 3.3.1.1 Standard (GUI) Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 3.3.1.2 Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 13
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A 4.4 Target/LUN List Menu (Command Line Options -t and -l) . . . . . . . . . . . . . . 4-30 4.4.1 Target/LUN List (Per HBA Port). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 4.4.1.1 Per Target/LUN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 4.4.1.2 Per Target/All LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32 4.
Summary of the content on the page No. 14
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S 4.8 Boot Device Menu (Command Line Option -e) . . . . . . . . . . . . . . . . . . . . . . 4-51 4.8.1 HBA Port Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52 4.8.1.1 Boot Device(s) (Per HBA Port) . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52 4.8.1.2 Configure Boot Device(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53 4.
Summary of the content on the page No. 15
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A 4.13.2 Link Status (Command Line Option -ls). . . . . . . . . . . . . . . . . . . . . . . . 4-80 4.13.2.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-80 4.13.2.2 Show Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-82 4.14 Virtual Menu (Command Line Option -vp) . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 16
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S 5.3.16 -kl (Loopback Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17 5.3.16.1 DataPattern (DP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18 5.3.16.2 DataSize (DS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19 5.3.16.3 TestCount (TC) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 17
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A A.2.3 Display HBA Information (Command Line Option -i). . . . . . . . . . . . . . A-4 A.2.4 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . A-6 A.2.5 Display LUN List (Command Line Option -l) . . . . . . . . . . . . . . . . . . . . A-7 A.2.6 Target Persistent Binding (Command Line Option -p). . . . . . . . . . . . . A-7 A.2.7 Selective LUNs (Command Line Option -
Summary of the content on the page No. 18
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S B.8.7 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . B-16 B.8.8 Display All Information for One or All HBAs (Command Line Option -z). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-17 B.8.9 Link Statistics (Command Line Option -ls). . . . . . . . . . . . . . . . . . . . . . B-20 B.8.10 HBA Statistics (Command Line
Summary of the content on the page No. 19
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters A List of Figures Figure Page 3-1 Preparing to Install Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 3-2 Welcome Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3 3-3 Choose Destination Location Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3 3-4 Ready to I
Summary of the content on the page No. 20
SANsurfer FC HBA CLI User’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters S Notes Page xx SN0054614-00 F
