Home

Q-Logic 2310F Network Card User Manual

1. Product Vendor SEAGATE Product ID ST318203FC Product Revision 0006 LUN s 00 Size 34 18 GB Type SBC 2 Direct access block device e g magnetic disk WWULN 20 00 00 20 37 38 73 BC Press Enter to continue Target information repeats for each target Here is an example of the All LUNs information for Linux Product Vendor HITACHI Product ID HUS103073FLF210 Product Revision FA16 SN0054614 00 F 4 37 4 Interactive Commands XX Target Link Speed or iiDMA Settings Menu Command Line Option q QLOGIC Ces A LUN 20 Size 68 37 GB Type SBC 2 Direct access block device e g magnetic disk WWULN 20 00 00 00 87 72 85 B2 OS LUN Name dev sda Here is an example of the All LUNs information on Solaris with a QLA driver Product Vendor SUN Product ID StorEdge 3510 Product Revision 415F LUN i35 Size 4 88 GB Type SBC 2 Direct access block device e g magnetic disk WWULN 60 0C 0F F0 00 00 00 00 09 8B 68 37 E0 B1 9B 04 OS LUN Name dev rdsk cit0d0s15 4 5 Target Link Speed or iiDMA Settings Menu Command Line Option q 5 Target Link Speed or 5 iiDMA Settings NOTE Depending on your system the SANsurfer FC HBA CLI Main Menu may show either the Target Link Speed option or the iiDMA Settings option This option shows the Target Link Speed Menu or iiDMA Menu that includes a list of all HBAs and port instances detected including
2. Vendor SEAGATE Product ID ST318453FC Product Rev 00006 Serial Number 3JA9AYSGOO0072496FBJ Port Name 22 00 00 0C 50 68 1E 9A Port ID 11 0A E2 Max Target Link Rate 4 Gbps m Disk 2 on QLA2462 HBA Instance 1 Vendor SEAGATE Product ID ST318453FC Product Rev 00006 Serial Number 3AJA9ALAGO000724966ZK Port Name 22 00 00 11 C6 2D 5A 3F Port ID 11 0A E2 Max Target Link Rate 4 Gbps n Disk Vendor SEAGATE Product ID ST318453FC Product Rev 0006 Serial Number 3JA9TQE0O0007249662ZK Port Name 22 00 00 11 C6 2D 5A 3F Port ID 02 0A EA Max Target Link Rate 4 Gbps p Apply Changes to Selected Target s 4 5 4 2 1 Target Link Speed All HBAs Advanced Configuration 5 Target Link Speed gt 2 AIL HBAs gt 1 Advanced Configuration 1 n Link speed 4 44 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target Persistent Bindings Menu Command Line Option p a When you select an HBA to set its link speed the Target Link Speed Menu Advanced menu for a particular HBA instance appears It shows the link speed options you can choose from The options vary according to the HBA in use For example a 1 Gbps B 2Gbps BH 4Gbps B 8Gbps When you set a Link Speed option for a particular target device the Target Link Speed Menu Advanced for All HBAs reappears allowing you to set the link speed for another HBA In
3. Windows Server 2003 with STORport miniport driver 9 0 0 12 Solaris SPARC 4 12 Table Notes All subsequent versions also apply To do a loopback test using the current parameters type SN0054614 00 F 5 21 5 Non interactive Commands XX Command Summary QLOGIC ee scli kl HBA Instance lt HBA WWPN To do a loopback test with custom parameters type scli kl HBA Instance lt HBA WWPN gt Parameter Name Parameter Alias Parameter Value gt Section 5 3 16 describes the parameters and their default values The following examples do 500 loopback tests with a test increment of 10 a data pattern of FFh and a data size of 8 bytes The test stops if an error occurs scli kl HBA WWPN gt DP FF DS 8 TC 500 TI 10 OE 1 scli kl HBA Instance DP FF DS 8 TC 500 TI 10 OE 1 You do not have to set each parameter for the loopback test If you do not specify a parameter in the command line the current parameter value is used For example the following command sets the data pattern to FFh and uses the current values for the other parameters scli kl HBA Instance DP FF The following example sets the data size to 16 bytes and has the test loop if an error occurs The other parameters use the current values scli kl HBA WWPN gt DS 16 OE 2 An example of a successful loopback test follows Test Configuration Data Pattern Random Data Size
4. Failed to open file Failed to read file Failed to write to a file Failed to close a file Selected file is incorrect File size is incorrect HBA is unsupported Unable to open the HBA handle HBA is unknown to SANsurfer FC HBA CLI HBA has invalid SSDID SSVID The specified flash NVRAM file does not have the SSDID SSVID that match with the HBA SN0054614 00 F C 1 C Interactive Exit Codes XX QLOGIC BL L 1 vY O Table C 1 Exit Code Descriptions Interactive Mode Continued uum Name Description 12 ERROR MISMATCH CHECKSUM File checksum does not match 13 ERROR CORRUPTED FILE File appears to be corrupted 14 ERROR FILE CHKSUM ERROR File checksum returns error 15 ERROR FILE INVALID DATA File has invalid data 16 ERROR FLASH UPDATE IGNORE HBA does not need to be updated 17 Reserved Not used 18 Reserved Not used 19 ERROR FLASH UPDATE UNSUPPORTED Flash update is not supported with this HBA 20 ERROR FLASH OPTION DISABLED HBA Flash update is disabled with this HBA 21 ERROR FLASH OPTION DISABLED OS Flash update is disabled with this OS 22 ERROR FLASH HEADER SIGNATURE Flash file has invalid header signature 23 ERROR FLASH DATA SIGNATURE Flash file has invalid data signature 24 Reserved Internal used 25 ERROR FLASH CSUM ERROR Flash file checksum test failed 26 ERROR FLASH NO FW REGION VALID HBA does not have valid firmware region 27 ERROR FLASH INVALID FW FILE Firmware file do
5. scli vp lt HBA Instance gt lt HBA WWPN gt list all 5 40 SN0054614 00 F XX 5 Non interactive Commands QLOGIC Command Summary ls Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA vport WWPN World wide port name of the virtual port vport hex World wide port name of the virtual port with the two hex digits in byte three supplied by the user To list a specific virtual port on a physical HBA port type scli vp lt HBA Instance lt HBA WWPN gt list vport wwpn gt To create a virtual port with an automatic WWPN type scli vp HBA Instance lt HBA WWPN gt create auto To create a virtual port with a specific WWPN type scli vp HBA Instance HBA WWPN gt create vport hex When prompted enter two hexadecimal digits The system checks these digits to be sure they are unique and if they are puts them into byte 3 of the WWPN To delete all virtual ports on a physical HBA port type scli vp HBA Instance HBA WWPN gt delete all To delete a particular virtual port on a physical HBA port type scli vp HBA Instance lt HBA WWPN gt delete vport wwpn gt 5 3 34 X Output in XML Format 1 NOTE This option is valid only in non interactive mode You can use this option with all non interactive mode options that have a corresponding interactive mode option see Table 5 1 This o
6. General Information Menu Command Line Option g ls OUOCOUOUD Primary Boot Port Address Alternate 1 Boot Port Name Alternate 1 Boot Port Address Alternate 2 Boot Port Name Alternate 2 Boot Port Address Alternate 3 Boot Port Name Alternate 3 Boot Port Address An example follows SANsurfer FC HBA CLI vl 7 1 Build 9 Copyright C 2003 2007 QLogic Corp All rights reserved Command Line QLogic FC Host Bus Adapters Build Type Release Build Date 10 25 2007 5 18 58 PM Host Name OS Type OS Version SDM API Version BRAGI Microsoft Windows Server 2003 Enterprise Edition x86 Service Pack 1 1 28 0 50 QLSDM DLL Build 3790 HBA Model 2200 SN C28437 Port 1 WWPN 21 00 00 E0 8B 03 55 7C HBA instance 0 Online Port 2 WWPN 21 01 00 E0 8B 23 55 7C HBA instance 1 Online HBA Model QLA2300 SN D83179 Port 1 WWPN 21 00 00 E0 8B 05 CB D8 HBA instance 2 Online Port 2 WWPN 21 01 00 E0 8B 25 CB D8 HBA instance 3 Online HBA Model QLA2462 SN FFC0551D59564 Port 1 WWPN 21 00 00 E0 8B 85 8C 7C HBA instance 4 Loop down Port 2 WWPN 21 01 00 E0 8B A5 8C 7C HBA instance 5 Online Total QLogic HBA s 3 Time and date Tue Nov 20 16 11 43 2007 HBA General Information Host Name BRAGI HBA Instance 1 HBA Model 2200 HBA Description QLA2200 02 12 04 QLA2202FS QCP2202 HBA ID 1 2200 HBA Alias HBA Port 2 Port Alias ode Name
7. Initial Installation XX Installing SANsurfer FC HBA CLI QLOGIC E ee 3 2 Installing SANsurfer FC HBA CLI Follow the installation instructions in the section that corresponds to your operating system OS m Windows See section 3 2 1 m q Llinux See section 3 2 2 W Solaris See section 3 2 3 B Macintosh See section 3 2 4 3 2 1 Windows Installation To install SANsurfer FC HBA CL on Windows follow either the GUI or command line installation steps B Standard GUI installation See section 3 2 1 1 B Command line installation See section 3 2 1 2 3 2 1 1 Standard GUI Installation To install SANsurfer FC HBA CLI on a Windows operating system follow these steps 1 Locate and double click the installer package The Preparing to Install dialog box appears as shown in Figure 3 1 The status bar indicates that the installation package is loading InstallShield Wizard Preparing to Install SANsurfer FC CLI Setup is preparing the InstallShield Wizard which will guide you through the program setup process Please wait Preparing to Install SSS Figure 3 1 Preparing to Install Dialog Box After the install package is loaded the Welcome dialog box appears as shown in Figure 3 2 3 2 SN0054614 00 F XKX 3 Initial Installation QLOGIC Installing SANsurfer FC HBA CLI SANsurfer FC CLI InstallShield Wizard x Welcome to the InstallShield Wizard for SA
8. lt param lt param alias gt value gt Parameter Name Description lt param name gt Persistently bound target s only PersistentOnly SN0054614 00 F 5 13 5 Non interactive Commands XX Command Summary QLOGIC EN Table 5 3 Driver Settings Parameters Continued Alias Value Parameter Name Description param param lt param name alias gt value gt Present persistently bound tar PersistentPlusNew PN 0 1 get s plus any new target s with driver default Present targets with driver default NewOnly NO 0 1 Bind devices by WWPN BindWWPN BW 0 1 Bind devices by port ID BindPortID BP 0 1 Table Notes a 0 Disabled 1 Enabled Driver parameter NewOnly NO is supported only with the failover driver If you select a QLA22xx HBA all QLA22xx HBAs on the host will use the same settings If you select a 23xx HBA all 2G 4G HBAs on the host will also use the same settings The following restrictions apply W UnderSolaris the driver configuration feature is disabled if you are using the driver from the OS installation CDs QLC driver m Under Linux this feature is disabled if you are using the ioctl or sysfs inbox driver a Under Macintosh the BindWWPN and BindPort ID parameters are not changeable Mac supports only the Bi ndWWPN parameter 5 3 11 Display System Information To view system information type scli g For details of this com
9. t all targets speed link speed To set the link speed of selected Target s attached to one HBA to the designated speed type the following command scli q lt HBA Instance gt lt HBA WWPN gt lt all gt lt Target WWPN gt lt speed gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA all Reports link speed for all targets on all HBAs in the system Target WWPN World wide port name of the Target speed link speed SN0054614 00 F 5 37 5 Non interactive Commands XX Command Summary QLOGIC EN UT O V Ol 5 3 27 r Update HBA Parameters To update the HBA Parameters type scli r HBA Instance HBA WWPN gt all File Name Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA all All HBA ports in the system are updated with the new HBA parameters HBA Parameters File File name or a path to a file that contains the updated HBA Name parameters To save the HBA parameters to a file type scli r HBA Instance lt HBA WWPN gt save File Name Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA HBA Parameters File File name or a path to a file to save the HBA parameters Name 5 3 28 S Silent Mode NOTES W The s option is valid only in non interactive mode W You can use this option with all non
10. 142 ERROR INIT SECURITY DESCRIPTOR Failed to init security descriptor during driver update 143 ERROR SET SECURITY DESCRIPTOR Failed to set security descriptor during driver update 144 ERROR FAIL UPDATE DRIVER Failed to update driver 145 ERROR HARDWARE ID NO MATCH HBA hardware ID does not match with the driver config file 146 ERROR DRIVER UPDATE UNSUPPORTED Driver update is not allowed with this HBA 147 ERROR NO DRV INF FILE Driver inf file is missing in the driver package 148 ERROR CREATE TEMP DIR Failed to create temporary directory 149 ERROR OPEN ZIP FILE Failed to open zip file SN0054614 00 F C 7 C Interactive Exit Codes XX QLOGIC VC L O A Table C 1 Exit Code Descriptions Interactive Mode Continued um Name Description 150 ERROR CLOSE ZIP FILE Failed to close zip file 151 ERROR READ ZIP FILE Failed to read zip file 152 ERROR EXTRACT ZIP FILE Failed to extract zip file 153 ERROR CORRUPTED ZIP FILE The zip file appears to be corrupted 154 ERROR CREATE ZIP FILE Failed to create zip file 155 ERROR MISSING DRV FILE Driver sys file is missing in the driver package 156 ERROR EMPTY FOLDER Driver folder is empty 157 ERROR GET REGISTRY KEY Failed to get a registry key 158 ERROR SET REGISTRY KEY Failed to set a registry key 159 ERROR STORPORT NOT SUPPORTED Operation failed with Stor miniport driver 160 ERROR INVALID VPD DATA HBA has invalid VPD data 161 Reserved Not used 162
11. 4 49 4 6 2 3 Target Persistent Binding Unbind Targets 4 49 4 7 Selective LUNs Menu Command Line Option m 4 49 4 7 1 Selective LUNs Per HBA Port 00 0c 4 49 4 7 2 selective LUNs All HBAs 2r RR EHE RERIG 4 50 4 7 2 1 Display LUN Configuration sels 4 50 4 7 2 2 Manual Configure LUNS lisse 4 51 4 7 2 3 Auto Configure LUNS i esce Re iue PF ERE Sapa 4 51 SN0054614 00 F Page xiii SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC AE S 4 8 Boot Device Menu Command Line Option e n sanaan anaana 4 8 1 HBA Port Instance ums dede ERRARE US ed db ves 4 8 1 1 Boot Device s Per HBA Port 2 22200008 4 8 1 2 Configure Boot Device S 20 0 eee eee eee 4 8 2 Boot Device s All HBAS 0002s 4 9 Driver Settings Menu Command Line Option fg 5 4 10 Utilities MENU ia os pes REDE UR ee Seay Phd EL RE RE 4 10 1 Flash Update Per HBA Port or All HBAs Command Line NOMS sur EMT oan nas E CD MU 4 10 2 Flash Save Per HBA Port Command Line Option b and Reserved Word Save s vetas es ex DOR OT HE ER ERIT DR 4 10 3 HBA Parameters Update Per HBA Port or All HBAs Command lie OPO Mh is ier ie ate ORE p I Eau P tops Pac bes eed 4 10 4 HBA Parameters Save Per HBA Port Command Line Option r and Reserved Word save 000 0c eee
12. Enter 1 to proceed the installation 6 Type the number that corresponds to your operating system and then press ENTER The pkgadd program does a series of checks posts a script warning and asks whether to continue the installation For example Processing package instance lt QLSclix gt from space chuynh scli qlogic Solaris pkgs x SANsurfer FC HBA CLI HBA Configuration Utility sparc 1 xx xx Build xx Solaris 8 10 QLogic Corporation Executing checkinstall script Processing package information Processing system information 3 package pathnames are already properly installed Verifying disk space requirements Checking for conflicts with packages already installed Checking for setuid setgid programs 3 10 SN0054614 00 F XKX 3 Initial Installation QLOGIC Installing SANsurfer FC HBA CLI o IEEE verifying class lt none gt Executing postinatall script Installation of lt QLSclix gt was successful 3 2 4 Macintosh Installation To install SANsurfer FC HBA CLI follow either the standard GUI or command line installation method W Standard GUI installation See section 3 2 4 1 B Command line installation See section 3 2 4 2 3 2 4 1 Standard GUI Installation Follow these steps to install SANsurfer FC HBA CLI on a Macintosh 1 You must have Admin privileges to install SANsurfer FC HBA CLI To verify enable Admin
13. FF type scli kl HBA Instance lt HBA WWPN gt DP Parameter Value In addition to a hex pattern you can enter a compliant random data pattern CRPAT jitter tolerance pattern CJTPAT or supply noise test sequence CSPAT for a loopback test For example scli kl HBA Instance HBA WWPN gt DP CJTPAT Table 5 5 lists all valid data patterns SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary ls Table 5 5 Data Pattern Values Hex Binary 00h 00000000 55h 01010101 5Ah 01011010 A5h 10100101 AAh 10101010 FFh 11111111 Random Customized 00 FF CRPAT loopback test only CJTPAT loopback test only CSPAT loopback test only Table Notes Complaint random data pattern in a valid FC frame as defined by the ANSI doc ument Methodologies for Jitter and Signal Quality Specification MJSQ Annex A Test bit sequences Complaint jitter tolerance pattern in an FC frame as defined by the ASIC docu ment listed above Supply noise test sequence in a valid FC frame as defined by the ASIC docu ment listed above 5 3 16 2 DataSize DS For the loopback test the data size is either DS Parameter Value DataSize Parameter Value The valid data sizes are as follows B Read write buffer test The data size can be 8 16 32 64 or 128 bytes The default value is 128 bytes a Echo test The data size can be 8 16 3
14. SN0054614 00 F 3 7 3 Initial Installation XX Installing SANsurfer FC HBA CLI QLOGIC _z o oa B To query for the installed SANsurfer FC HBA CLI package name enter the following text from the command line rpm q scli 3 2 3 Solaris Installation To install SANsurfer FC HBA CLI on Solaris follow the steps in one of these sections E Solaris SPARC 8 9 10 See section 3 2 3 1 Solaris x86 9 and 10 See section 3 2 3 2 3 2 3 1 Solaris SPARC 8 9 10 Installation Follow these steps to install SANsurfer FC HBA CLI on a Solaris SPARC 8 9 or 10 operating system 1 Download the scli x xx xx xx sparc Solaris pkg file from the QLogic Web site or the FC HBA Manager CD ROM to a temporary directory on your machine For example tmp NOTE In the file name x xx xx xx stands for the current version of SANsurfer FC HBA CLI The xx stands for the build version 2 Tosee the available package file type the following 1s The available packages appear For example scli x xx xx xx sparc Solaris pkg 3 To install SANsurfer FC HBA CLI type the following pkgadd d scli x xx xx xx sparc Solaris pkg 4 You are prompted to select a package For example The following packages are available 1 QLScli QLogic SANsurfer FC HBA CLI HBA Configuration Utility sparc x xx xx Build xx Select package s you wish to process or all to process all packages default all q Enter 1
15. target an HBA port Disable wwnn target wwpn gt m lt hba instance gt hba wwpn Configures all LUNs of all devices attached to unselect all an HBA port Disable m hba instance hba wwpn gt Configures individual LUN of a device attached target wwnn target wwpn gt to an HBA port lun id 0 1 enable select unselect n lt hba instance hba wwpn Modifies the HBA Parameters of an HBA port param name gt lt param alias gt lt param value gt n lt hba instance gt hba wwpn Sets the HBA Parameters of an HBA port with all OEM name a pre defined OEM default templates n lt hba instance hba wwpn gt Restores the HBA Parameters of an HBA port all default to factory default settings 4Gb HBAs or lat est o file name Writes the output to a named file This option can be combined with other options However this option must be at the beginning or at the end of the command line E 5 E Help Commands XX QLOGIC E V 1 A A L Pm Table E 1 Help Commands Continued Command Line Arguments Function Action p lt hba instance hba wwpn gt Binds the selected device s attached to an target wwnn target wwpn gt HBA port target portid gt target id p lt hba instance gt hba wwpn gt Unbinds a spe
16. 1 Basic Configuration When you select this option the Target Link Speed Menu Basic for All HBAs appears It offers the link speed options The options vary according to the HBA in use For example 1 Gbps B 2Gbps B 4Gbps B 8Gbps Respond Yes to the Proceed prompt to apply the change to all Port Instances on all HBAs 4 5 4 2 Target Link Speed All HBAs Advanced Configuration 5 Target Link Speed gt 2 All HBAs gt 1 Advanced Configuration This option displays the Target Link Speed Menu Advanced for All HBAs This menu lists all targets on all HBAs and shows information about each target WB X Target Type Target number HBA model and Instance Product vendor Product ID Product revision Serial Number Port Name Port ID Max Target Link Rate OUOOUOUD W Next Target Type Target number HBA model and Instance SN0054614 00 F 4 43 4 Interactive Commands XX Target Link Speed or iiDMA Settings Menu Command Line Option q QLOGIC E XV AO 9 8 wA W Apply Changes to Selected Targets Here is an example of the Target Link Speed Menu Advanced for All HBAs Target Link Speed Menu Advanced All HBAs 1 Disk 0 on QLA2462 HBA Instance 0 Vendor SEAGATE Product ID ST318453FC Product Rev DF12 Serial Number S3EVONYSGO00072496DYD Port Name 22 00 00 04 CF 9C 24 CA Port ID 02 00 E1 Max Target Link Rate 4 Gbps 2 Disk 1 on QLA2462 HBA Instance 0
17. A 10 B 10 fs 5 13 g 4 2 5 1 A 3 B 10 gs 4 76 5 14 A 13 B 21 h 4 87 5 15 ha 4 18 5 16 A 14 B 21 i 4 17 4 18 5 17 A 4 B 11 kl 4 62 4 63 5 17 5 21 A 9 B 13 kr 4 62 4 66 5 23 5 24 A 9 B 13 4 18 4 30 5 28 A 7 B 14 ls 4 76 4 80 5 28 A 13 B 20 m 4 49 5 29 A 8 B 15 n 4 23 4 57 0 5 33 p 4 45 4 46 4 47 4 48 5 34 A 7 B 15 pa 4 19 5 36 A 14 B 22 q 4 38 5 36 r 4 57 5 38 rs 4 60 s 5 38 save 4 56 4 57 t 4 30 5 39 A 6 B 16 tb 4 61 5 39 topology 4 3 tp 4 3 5 3 5 40 A 20 B 24 v 5 40 vp 4 83 5 40 x 4 8 5 41 x2 4 9 5 42 Z 4 9 4 17 5 2 5 4 5 42 A 10 B 17 configuration saving 4 54 Index 2 configuring boot device 4 53 5 4 driver settings 5 13 HBA statistics 4 76 iiDMA settings 4 39 link status 4 80 LUNs automatically 4 51 LUNs manually 4 51 selective LUNs 5 5 target persistent binding 5 5 connection loop only 4 25 loop preferred otherwise point to point 4 25 point to point only 4 25 ConnectionOption parameter 5 32 connector loopback 4 65 contents of Help 4 88 copyright information ii count login retry 4 23 port down retry 4 23 Courier New font meaning of 1 2 CRC errors 5 23 creating virtual port 4 86 CRPAT parameter 5 18 5 19 5 26 CSPAT parameter 5 18 5 19 5 26 CSV file definition of Glossary 1 current settings HBA statistics 4 78 link status 4 81 Custom Device Module CDM defi
18. B Bind status Yes Device type Disk for example Target information model name and number for example Port Name Port ID Target ID 4 6 2 2 Target Persistent Binding Bind Targets 6 Target Persistent Binding gt p All HBAs 2 Bind Targets See 4 6 1 2 Target Persistent Bindings Bind Target s Command Line Option p 4 6 2 3 Target Persistent Binding Unbind Targets 6 Target Persistent Binding gt p All HBAs gt 3 Unbind Targets See 4 6 1 3 Target Persistent Binding Unbind Targets Command Line Option p 4 7 Selective LUNs Menu Command Line Option m 7 Selective LUNs When you select this option SANsurfer FC HBA CLI shows the Selective LUNs Menu see 4 5 2 allowing you to select an individual HBA port or All HBAs 4 7 1 Selective LUNs Per HBA Port 7 Selective LUNs gt 1 m HBA Port Instance When you select this option SANsurfer FC HBA CLI shows the following options for the HBA W X Display LUN Configuration m Manual Configure LUNs SN0054614 00 F 4 49 4 Interactive Commands XX Selective LUNs Menu Command Line Option m QLOGIC A S W Auto Configure LUNs If this option is not available for the selected LUN the following message appears Configuration not permitted Device s either not present or not persistently bound HBA n 4 7 2 Selective LUNs All HBAs 7 Selective LUNs 1 All HBAs When you select this option SANsurfer FC H
19. B QLogic HBAs see section 1 3 B Single or multiprocessor server or workstation QO Pentium III with 450 MHz or greater for Windows 2000 Windows Server 2003 Windows XP Professional Linux and Solaris QJ Windows Vista and Windows Server 2008 Use the minimum requirements from Microsoft Q Power Mac G5 1 8 MHz or greater with 512 MB of memory Q FC devices such as disks and RAID subsystems OY QLogic FC HBAs SANsurfer FC HBA CLI supports most FC devices For a complete list of devices that support failover see the QLogic SAN Interoperability Guide which you can download from the QLogic Web site www qlogic com interopquide info asp inter SN0054614 00 F PRELIMINARY 1 5 1 Introduction XX System Requirements QLOGIC NENNEN NOTE Tape devices are shown as part of the configuration but are not fully supported by SANsurfer FC HBA CLI Only persistent binding and LUN masking are available m 256 MB physical RAM are required to run SANsurfer FC HBA CLI running with less memory can cause disk swapping paging or paging out which severely affects performance Video card capable of 256 colors and a screen resolution of 800x600 pixels About 7 MB of disk space 1 5 2 Software Requirements The minimum software requirements are as follows W QLogic drivers for your OS platform B Administrative privileges to do management functions B Oneofthe operating systems listed in section 1 4 1 5
20. Interactive Commands XX Statistics Menu Command Line Options gs and Is QLOGIC OO c 3 From the HBA Statistics Menu type the number for the Show HBA Statistics option and then press ENTER 4 The Statistics Menu appears and prompts you to select an HBA port Type the number for the port and then press ENTER The HBA statistics for that port are shown For example HBA Instance 0 2200 Port 1 WWPN 21 00 00 E0 8B 03 55 7C PortID 00 00 EF HBA Port Statistics The following keys are in use during test XR lt r gt Reset All Counters RETURN Abort Test HBA Port Errors Device Errors Reset I O Count IOPS BPS Time 0 0 0 30568 0 0 0 09 43 43 AM 4 13 2 Link Status Command Line Option Is 13 Statistics 2 Link Status The following sections describe how to view and change the HBAs link status NOTE Under Solaris link status is disabled if you are using drivers from the OS installation CDs QLC driver From the Main Menu select Statistics and then select Link Status When you select the Link Status option SANsurfer FC HBA CLI shows the following options B Configuration B Show Link Status 4 13 2 1 Configuration 13 Statistics 2 Link Status 1 Configuration When you select the Configuration option the Link Status Settings Menu appears and allows you to view and configure the following W Current Settings W Restore Default 4 80 SN0054614 00
21. Library Receipts directory For example rm rf Library Receipts scli x x x x pkg NOTE You must be in the root directory or have root admin privileges to do this operation SN0054614 00 F 3 15 3 Initial Installation XX Uninstalling SANsurfer FC HBA CLI QLOGIC E Ct3 Notes 3 16 SN0054614 00 F Section 4 Interactive Commands This section describes the interactive mode command line options for specific QLogic FC HBAs The interactive mode uses a series of menus from which you select the option you want and enter the number for that option See Section 5 for non interactive mode operation in which you simply enter a one or two letter code to perform operations on the HBA To start the interactive mode type one of the following scli scli int on some Solaris installations When you start SANsurfer FC HBA CLI in interactive mode the Main Menu appears as follows Main Menu 1 General Information 2 HBA Information 3 HBA Parameters 4 Target LUN List 5 Target Link Speed Or 5 iiDMA Settings 6 Target Persistent Bindings 7 Selective LUNs 8 Boot Device 9 Driver Settings 10 Utilities 11 Beacon 12 Diagnostics 13 Statistics 14 Help Or 14 Virtual if available 15 Exit Ol 15 Help Or 16 Exit NOTE Selections on the Main Menu may differ depending on your system W Selection 5 may be either Target Link Speed or iiDMA Settings B The Virtual menu selec
22. Reserved Not used 163 Reserved Not used 164 Reserved Not used 165 Reserved Not used 166 Reserved Not used 167 Reserved Not used 168 Reserved Not used 169 Reserved Not used 170 Reserved Not used 171 IBM Reserved Blocked 172 IBM Reserved Blocked 173 IBM Reserved Blocked 174 IBM Reserved Blocked 175 IBM Reserved Blocked 176 IBM Reserved Blocked C 8 SN0054614 00 F XX C Interactive Exit Codes QLOGIC Lk Table C 1 Exit Code Descriptions Interactive Mode Continued m Name Description 177 IBM Reserved Blocked 178 IBM Reserved Blocked 179 IBM Reserved Blocked 180 IBM Reserved Blocked 181 IBM Reserved Blocked 182 IBM Reserved Blocked 183 IBM Reserved Blocked 184 IBM Reserved Blocked 185 IBM Reserved Blocked 186 IBM Reserved Blocked 187 IBM Reserved Blocked 188 IBM Reserved Blocked 189 IBM Reserved Blocked 190 IBM Reserved Blocked 191 IBM Reserved Blocked 192 IBM Reserved Blocked 193 Reserved Not used 194 Reserved Not used 195 Reserved Not used 196 Reserved Not used 197 Reserved Not used 198 Reserved Not used 199 Reserved Not used 200 ERROR_SAVE_SEL_LUN_CONFIG Failed to save selective LUN configuration 201 Reserved Not used 202 Reserved Not used 203 Reserved Not used SN0054614 00 F C 9 C Interactive Exit Codes XX QLOGIC VPCPVWV Ww A w A Table C 1 Exit Code Descriptions Interactive Mod
23. Symbolic HBA name 100 characters maximum To set an alias for the selected HBA scli ha HBA Instance HBA WWPN Alias To delete the current alias of the selected HBA scli ha HBA Instance HBA WWPN gt delete To view the current alias of the selected HBA scli ha HBA Instance lt HBA WWPN gt view 5 16 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary ls 5 3 15 i Display HBA General Information or VPD Information for One or All HBAs To show general HBA information or VPD information for all HBA ports in the system type the following command scli i lt all gt lt VPD gt Where all All HBAs in the system VPD Vital Product Data To show general or VPD information for a specific HBA type scli I HBA Instance HBA WWPN gt VPD To show VPD QLA QLE24xx only for all HBA ports in the system type scli i VPD scli i all VPD Where all VPD information for all HBAs in the system 5 3 16 kl Loopback Test Use the k1 command to perform the loopback test Use the kr command to perform the read write buffer test see section 5 3 18 1 To do a loopback test with the default parameters type scli kl lt HBA Instance gt lt HBA WWPN gt To do a loopback test with customized parameters type scli kl lt HBA Instance gt lt HBA WWPN gt lt Parameter N
24. Table 5 9 Changed value of ResetDelay ExecutionThrottle and LinkDownTimeOut parameters Added QLA QLE23xx HBAs quantifier to EnableEx tended Logging and EnableLIPFullLogin parame ters Added a list of valid data patterns for the DataPat 4 17 1 2 1 Table 5 6 tern diagnostic parameter Table 4 4 Table 5 6 SN0054614 00 F Page vii SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC N 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 c DisplayHBA Information i Display Device List t Display LUN List l Configure HBA Settings n Target Persistent Binding p Selective LUNs m Boot Device Selection e Driver Settings fs View Driver Settings fg Save Update Flash b Save Update NVRAM r Flash HBA Beacon a and tb Diagnostics kl and kr Statistics gs and Is Host Information g Quantified that the direct driver version is only displayed in Windows No longer shows firm ware version Shows new HBA number HBA 0 n Display HBA Information l
25. The XML Format 2 for all adapter information is as follows lt xml version value encoding value gt SN0054614 00 F B 17 B XML Format 2 XX Display System Information Command Line Option g QLOGIC EN Ph 4 V b 1 m QLogic lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt Host gt lt Name gt Host Name lt Name gt lt OSType gt OS Type lt OSType gt lt OSVersion gt OS Version BUILD patches lt OSVersion gt lt SDMAPIVersion gt SDMAPI version lt SDMAPIVersion gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt NumOfHBA Number of HBA s detected lt NumOfHBA gt Host HBA lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt GeneraliInfo Instance value HBAModel value HBATD value HBAAlias value HBAPort value PortAlias value WWNN value WWPN value Port ID value SerialNumber value DriverVersion value BIOSVersion value FirmwareVersion value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value TargetCount value PortType value Status value gt lt Param ConnectionOption value lt VPD gt lt VPD ProductIdentifier gt lt VPD gt lt Param ConnectionOption value DataRate v
26. This Port Alias refers to only that port and none other Thus an HBA can only have one HBA Alias but each port on that HBA must have a unique Port Alias PRELIMINARY SN0054614 00 F Section 3 Initial Installation Before you run SANsurfer FC HBA CLI ensure that the following requirements are met a The HBAs must be installed The HBA drivers must be installed NOTES Some SANsurfer FC HBA CLI features are not available when W You have a Solaris system that is running with the driver distributed with the OS installation CDs QLC driver W You have a Linux system that is running with the ioctl or sysfs inbox driver W You have a Linux system that is running with a VMware driver 3 1 Downloading the Installation Package To download the SANsurfer FC HBA CLI installation package from the QLogic Web site follow these steps 1 From the QLogic home page www glogic com click Downloads on the left 2 Onthe Drivers Downloads Manuals page click your HBA model The Resources page for the selected model appears 3 Under Drivers Management Tools and API Libraries click the appropriate operating system 4 Inthe Management Tools table go to the SANsurfer CLI row and in the Download column click Download 5 The system shows the End User License Agreement box Scroll to the bottom and click Agree 6 Click Save Select a directory on your system and download the file SN0054614 00 F 3 1 3
27. Value options Table 5 8 Diagnostics Parameters Name Alias Value Description DataPattern DP Test pattern in hex format 00 55 5A A5 AA FF Customized 00 FF see Table 5 9 Random pattern gt CRPAT 0 CJTPAT Loopback test Loopback test on CSPAT P y Loopback test only DataSize DS 8 16 32 64 128 256 Actual data transferred 512 1024 2048 during any given pass of the test TestCount TC 0 65535 Loopback test only 0 10 000 Read write buffer test only TestIncre TI 1 65535 Loopback test only ment 1 10 000 Read write buffer test only OnError OE 0 2 0 ignore 1 stop 2 loop on error Table Notes a Valid two character case insensitive hexadecimal patterns 5 26 SN0054614 00 F XX QLOGIC 5 Non interactive Commands Command Summary ls Complaint random data pattern in a valid FC frame as defined by the ANSI document Methodologies for Jitter and Signal Quality Specification MJSQ Annex A Test bit sequences Complaint jitter tolerance pattern in a FC frame as defined by the ASIC document listed above Supply noise test sequence in a valid FC frame as defined by the ASIC document listed above For read write buffer test the maximum size is 128 this is also the default For an echo test the maximum size is 2048 the default size is 512 For a loopback test on Windows Solaris and Macintosh systems the maximum size is 2048 the default s
28. WWPN value WWNN value gt Statistics LoopID 2 value PortError value DeviceError value Reset value TOCount value IOPS value BPS value TimeStamp value gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt A 2 15 HBA Alias Command Line Option ha The XML Format 1 for the HBA alias option is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt HBAAlias gt lt Alias Name value gt lt HBAAlias gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt A 2 16 HBA Port Alias Command Line Option pa The XML Format 1 for the HBA port alias option is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt A 14 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option ls lt HBA Port value WWNN value WWPN value gt PortAlias Alias Name value PortAlias HBA Status 0 lt Status gt Reboot 0 lt Reboot gt QLogic 4 2 17 SFF DMI Command Line Option dm The XML Format 1 f
29. do the following steps 1 From the Control Panel click Add or Remove Programs 2 Highlight SANsurfer FC HBA CLI 3 Click Remove No re boot is required Alternately invoke scli 1 x x xx windows exe and select the option to Remove all installed features 3 3 1 2 Command Line Uninstall To uninstall SANsurfer FC HBA CLI using the command line type the following scli 1 x x x windows exe uninst s If you created an uninstall script in section 3 2 1 2 2 you can uninstall SANsurfer FC HBA CLI in silent mode by type the following scli 1 x x x windows exe s f 1 C Temp uninstall iss 3 3 2 Linux Uninstall To uninstall SANsurfer FC HBA CLI go to the command line and type one of the following commands where x xx xx is the current version of CLI rpm e scli x xx xx xx rpm e scli To query for the installed SANsurfer FC HBA CLI package name type the following text from the command line rpm q scli 3 3 3 Solaris Uninstall To uninstall SANsurfer FC HBA CLI follow one of these procedures SN0054614 00 F 3 13 3 Initial Installation XX Uninstalling SANsurfer FC HBA CLI QLOGIC E SeSe x m Solaris SPARC 8 9 10 See section 3 3 3 1 E Solaris x86 8 9 10 See section 3 3 3 2 3 3 3 1 Solaris SPARC 8 9 and 10 Uninstall Follow these steps to uninstall SANsurfer FC HBA CLI 1 Type the following to remove SANsurfer FC HBA CLI pkgrm QLScli 2 The program shows the package name and a script wa
30. lt OpticalTransceiverDigit alDiagnosticData gt Address A0 Identifier value Identifier Ext Identifier value Ext Identifier lt Connector gt value lt Connector gt lt TransceiverData gt lt Compliance gt value lt Compliance gt FCLinkLength value lt FCLinkLength gt A 16 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option ls lt FCTransmitterTech gt value lt FCTransmitterTech gt lt FCTransmissionMedia gt value lt FCTransmissionMedia gt lt FCSpeed gt value lt FCSpeed gt lt TransceiverData gt Encoding gt value lt Encoding gt BR Nominal gt value lt BR Nominal gt Length 9um km value Length 9um km Length 9um value Length 9um Length 50um value Length 50um Length 62 5um value Length 62 5um Length Copper value lt Length Copper gt lt VendorName gt value lt VendorName gt VendorOUI value lt VendorOUI gt VendorPN value lt VendorPN gt lt VendorRev gt value lt VendorRev gt lt WaveLength gt value lt WaveLength gt lt CC_BASE gt value lt CC_BASE gt lt Options gt lt SignalLossAsDefinedInSFPMSA gt value lt SignalLossAsDefinedInSFPMSA gt lt SignalLossInvertedFromSFPMSA gt value lt SignalLossInvertedFromSFPMSA gt lt TX_Fault_SignalImplemented gt value lt TX_Fault_SignalImplemented gt lt TX_DisableImplementedAndDisable
31. value B 14 SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g I Vendor value Product value Revision value Size value Type value gt lt Target gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The lt Target gt sequence repeats for each LUN attached to the target The LUN list is listed under the target not under the adapter B 8 5 Selective LUNs Command Line Option m The command format is scli m all view x2 The XML Format 2 for the selective LUNs information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt EnabledLUN ID value LUNWWNN value LUNWWPN value gt lt Target gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The Target Target sequence repeats for each enabled LUN on the target B 8 6 Target Persistent Binding Command Line Option p The command format is SN0054614 00 F B 15 B XML Format 2 XX Display System In
32. 0x0 Temp High Warning 0x0 Reserved Warning 0x0 Reserved Warning 0x0 SN0054614 00 F 4 75 4 Interactive Commands XX Statistics Menu Command Line Options gs and Is QLOGIC E XV V 1 q Reserved Warning 0x0 Reserved Warning 0x0 Reserved Warning 0x0 Reserved Warning 0x0 RX Power Low Warning 0x0 RX Power High Warning 0x0 Vendor Specific 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 4 13 Statistics Menu Command Line Options gs and Is 13 Statistics The Statistics option allows you to view and change HBA and link statistics When you select this option SANsurfer FC HBA CLI shows the Statistics Menu containing B HBA Statistics W Link Status NOTE M Under Solaris HBA statistics are disabled if you are using the driver from the OS installation CDs QLC driver Under Linux this feature is disabled if you are using the ioctl or sysfs inbox driver W Under Solaris link statistics are disabled if you are using the driver from the OS installation CDs QLC driver 4 13 1 HBA Statistics Monitoring Command Line Option gs 13 Statistics 1 HBA Statistics When you select this option SANsurfer FC HBA CLI shows the HBA Statistics Menu including the following options B Configuration E Show HBA Statistics 4 13 1 1 Configuration 13 Statistics gt 1 HBA Statistics 1 Configuration 4 76 SN0054614 00 F XX 4 Interactive Com
33. 2 1 Unsupported Features Depending on your system not all SANsurfer FC HBA features are available 1 5 2 1 1 Features Not Available When Running Windows Driver with NPIV Enabled When running the driver with NPIV enabled on Windows the following features are not available with virtual port HBA parameters settings HBA parameters restore default Flash update from file Flash save to file HBA parameters update from file HBA parameters save to file HBA parameters update from templates Target link speed Boot device settings Driver settings HBA beacon Target LUN list 1 6 PRELIMINARY SN0054614 00 F XX 1 Introduction QLOGIC Technical Support O o 3 A aAO9a EHE 1 5 2 1 2 Features Not Available When Running ioctl Module Driver When running the input output control ioctl module driver on a Linux OS the following features are not available m Persistent binding Selective LUN HBA port statistics Driver settings Host topology 1 5 2 1 3 Features Not Available When Running Sysfs Inbox Driver When running the Sysfs Inbox driver on a Linux OS the following features are not available Persistent binding Selective LUN HBA port statistics Driver settings Host topology Link status Loopback test 1 5 2 1 4 Features Not Available When Running VMware Driver When running the VMware driver on a Linux OS the following features are not available with virtual ports HBA parameters settings HBA parameter
34. 20 00 00 E0 8B 03 55 7C SN0054614 00 F 4 13 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC e Port Name 21 01 00 E0 8B 23 55 77C Port ID 11 06 00 Serial Number C28437 Driver Version SCSI Miniport 8 1 5 15 W2K IP BIOS Version Lo1 5293 Firmware Version 22 202 2 03 Actual Connection Mode Point to Point Actual Data Rate 1 Gbps PortType Topology NPort Target Count 22 PCI Bus Number BOX PCI Device Number Ee HBA Status Online HBA VPD Information Feature is not supported with selected HBA Instance 1 2200 HBA Parameters Settings HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Connection Options 3 Point to Point Otherwise Loop Frame Size 1024 Hard Loop ID 00 Loop Reset Delay seconds 09 Enable Host HBA BIOS Disabled Enable Hard Loop ID Disabled Enable FC Tape Support Enabled Execution Throttle 16 Login Retry Count i8 Enable LIP Reset Disabled Port Down Retry Count 30 Enable LIP Full Login Enabled Link Down Timeout seconds 0 Enable Target Reset Enabled LUNs Per Target 8 Driver Settings Information HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Driver Settings Group Persistent Present targets that are persistently bound plus any new target s Enable 4
35. 3 10 10 10 10 HBA Utilities g 1 1 1 Show system information 5 3 11 gs 13 13 13 HBA Statistics 5 3 12 h 14 14 14 Show usage 5 3 13 3 14 14 14 Show usage ha 2 2 2 HBA alias 5 3 14 i 2 2 2 Show HBA information 53 18 k1 12 12 12 Loopback test 5 3 16 kr 12 12 12 Read write buffer test 5 3 18 1 4 4 4 Show LUN list 5 3 19 1s 13 13 13 Show Link Status 5 3 20 m T 7 7 Selective LUNs 5 3 21 n 3 3 3 Configure HBA settings Bowe 0 1 1 1 Output to a file 5 3 26 P 6 6 6 Target persistent binding 5 3 241 pa 2 2 2 HBA port alias 5 3 25 2 4 PRELIMINARY SN0054614 00 F XKX 2 Getting Started QLOGIC Starting Non interactive Mode A Table 2 1 Non interactive Mode Options Continued CLI a Hed Hat SuSE Interactive Option window 3 Linux Solaris Macintosh Description Section q 5 5 5 Target link speed 5 3 26 r Save update NVRAM 1 1 1 Refresh 15 16 15 16 15 16 Quit s Silent mode 5 328 t 4 4 4 Show device list 5 3 29 tb 11 11 11 Flash target beacon 5 3 30 tp 1 1 1 Show host topology 5 3 31 v Show version 5 3 32 x 1 1 1 Output in XML format 5 3 34 z 2 2 2 Show all information for one 5 3 36 or all HBAs a Windows Linux Solaris x86 Solaris SPARC Options that have a corresponding menu selection cannot be combined That is only one option is allowed in a single command If multiple options are spec
36. 3 30 5 3 31 5 3 32 5 3 33 5 3 34 5 3 35 5 3 36 kl Loopback Test vtro ecd cod ELM te Locate s 5 17 DataPatiern DP 4i eu ei pese e eb ober ed 5 18 Datasize DS ue expos os deb UV mei EN ER Rd 5 19 TestCount EOS 2 vr Una tus eR e oo Senate INI Ed 5 20 Test Increment TI er re REREX RE 5 20 ONE Or QE ood rad st fuae son D eO ES X oe aren ee 5 20 Run a Loopback Test 5524 er E RR EE e 5 21 kl Run HBA Diagnostics Loopback Test 000 5 23 kr Run Read Write Buffer Test 2 22000 eee eee 5 23 Run a Read Write Buffer Test 2 200005 5 24 Run HBA Diagnostics Read write Buffer Test 5 26 Display LUN Info vs site ce 2 aed ehe sid duo tie at temi ser 5 28 Is Display Link Status nike LR RE ERRERRR RES EXAE 5 28 m View Enable or Disable LUNs isses 5 29 n Set Selected HBA Parameter 200 0c ee eee 5 31 O QUIPUTTO a File obere ey Sis PEER a Ree Cetus 5 33 p Display Persistent Target Binding Info 5 34 pa Define Port Allas s dace G ve RR ERR nee aoe 5 36 q View or Set Target Link Speed 00 2c eee 5 36 r Update HBA Parameters 000 02 eee eee 5 38 S SIE ModB s te crete ete Bie tuna eg eRe P ara ela 5 38 t Display Target Information 2 2c c eee 5 39 tb Target Beacon On Off 0 0 2 2 ee ee 5 39 tp Display Host Topology 2 222 ce
37. 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 from the third paragraph this command now applies to all OSs Diagnostics command line options kl and dr 417 A121 5 3 17 DataPattern DP parameter added CRPAT CSPAT and CJTPAT DataSize DS parameter added 128 byte value 4 17 1 2 2 Table 5 5 for read write buffer test Added 128 256 512 1024 2048 4096 8192 16384 32768 65535 byte values for loopback test Added default val ues TestCount TC parameter changed the number of 4 17 1 2 3 Table 5 5 loopback tests that can be run from 0 10000 to 0 65535 Testlncrement TI parameter increased test incre 4 17 1 2 4 Table 5 5 ment for the loopback test from 1 10000 to 1 65535 Output in XML Format command line option x Section 5 3 34 Added XML format for HBA alias command line Section 5 3 14 option ha Added XML format for HBA port alias command Section 5 3 25 line option pa Added XML format for SFF DMI command line Section 5 3 5 option dm Added XML format for host topology command Section 5 3 31 line option tp Target Persistent Binding command line option Section 5 3 24 p added ALL parameter to show target persistent binding information for all HBA ports Page vi
38. 61 locating selected target 4 62 locating target 4 61 toggling 5 6 link down timeout 4 23 4 28 rate setting 4 82 status log to file 4 82 status viewing 4 81 4 82 5 28 status viewing and setting 4 80 A 13 B 20 LinkDownTimeOut parameter 5 32 Linux host topology 4 4 installing on 3 7 ioctl driver 4 4 operating systems supported by SANsurfer FC HBACLI 1 4 sysfs driver 4 4 uninstalling from 3 13 LIP enable reset 5 32 enabling LIP full login 5 32 full login enable 4 23 4 28 5 32 reset enable 4 23 LIP Loop Initialization Process definition of Glossary 4 listing error codes 5 12 target LUN 4 30 virtual ports 4 85 load balancing definition of Glossary 4 locating HBA beacon LED 4 61 selected target beacon LED 4 62 target beacon LED 4 61 log to file parameter 5 15 log to file link status 4 82 logging enabling extended 5 32 Logical Unit Number LUN definition of Glossary 4 login retry count 4 23 4 27 5 32 login LIP full 4 23 SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls loop preferred connection 4 25 reset delay 4 23 4 26 loop abitrated definition of Glossary 1 loop ID definition of Glossary 4 Loop Initialization Process LIP definition of Glossary 4 Loop Port L Port definition of Glossary 4 loopback definition of Glossary 4 loopback connector att
39. B 2 B 7 2 SFF DMI Command Line Option dm 02000 a B 3 B 7 3 Boot Device Command Line Option e 0 02 00s B 8 B 7 4 View Driver Settings Command Line Option fg B 10 B 8 Display System Information Command Line Option 9 B 10 B 8 1 Display HBA Information Command Line Option l B 11 B 8 2 Diagnostics Results Loopback Test Command Line Option Kyu ed terni Rt ERE ELE EB S B 13 B 8 3 Diagnostics Results Read Write Buffer Test Command Line ivi SKN P B 13 B 8 4 Display LUN List Command Line Option l B 14 B 8 5 Selective LUNs Command Line Option m B 15 B 8 6 Target Persistent Binding Command Line Option p B 15 SN0054614 00 F Page xvii SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC R B 8 7 B 8 8 B 8 9 B 8 10 B 8 11 B 8 12 B 8 13 Display Device List Command Line Option t B 16 Display All Information for One or All HBAs Command Line Option az aod cis grades oa amp ada ed neues babes E TAE P EE fu B 17 Link Statistics Command Line Option Is 0000 B 20 HBA Statistics Command Line Option gs 2000 B 21 View HBA Alias Command Line Option ha B 21 HBA Port Alias Command Line Option pa issues B 22 Host Topology Command Line Option
40. Bytes 512 Number of test s 0 65535 N A Test Increment 1 65535 125 On Error Ignore Test Continuous ON Diagnostics Loopback Test Result Note Press Enter to stop the test any time HBA Test Data Pattern Status CRC Disparity FrameLength Active 0 B1 3B 6A A5 11 28 C1 8C Success 0 0 0 The test results are described in the following paragraphs WB Status Test result The possible values are CL Success The test passed 5 22 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary eT QJ Error CRC disparity or frame length errors occurred Q Failed An error occurred when attempting to issue a command CQ Loop down The loop is down CRC Number of CRC errors Disparity Number of disparity errors Frame Length Number of frame length errors kl HBA Instance HBA WWPN gt lt Parameter Name Parameter Alias Parameter Value gt 5 3 17 kl Run HBA Diagnostics Loopback Test NOTE Under Solaris this feature is disabled if you are using the driver from the OS installation CDs QLC driver The Parameter Name Parameter Alias and Parameter Value options are described in Table 5 8 The system shows the following information after a loopback test completes B Teststatus m CRC error W Disparity error B q Frame length error 5 3 18 kr Run Read Write Buffer Test Use the kr
41. C6 2D 5A 3F Port ID 02 0A EA Bind No Target ID p All Target s 4 6 1 2 1 Target Persistent Binding FC Port Configuration Command Line Option p 6 Target Persistent Binding gt 1 n Target Persistent Binding 2 Bind Target s 1 n Port configuration When you select this menu you are prompted to enter a Target ID The Target Persistent Binding FC Port configuration Menu appears and lists these options Select More B Commit Changes a Cancel Type the number for the option you want and press ENTER 4 6 1 3 Target Persistent Binding Unbind Targets Command Line Option p 6 Target Persistent Binding gt 1 n Target Persistent Binding HBA Instance n 3 Unbind Target s The Unbind Targets option is like the Bind Targets option see section 4 6 1 2 4 6 2 Target Persistent Binding All HBAs 6 Target Persistent Binding p All HBAs When you select this option SANsurfer FC HBA CLI shows the following options W X Display Configuration B Bind Target s W Unbind Target s 4 48 SN0054614 00 F XX 4 Interactive Commands QLOGIC Selective LUNs Menu Command Line Option m ls 4 6 2 1 Display Target Persistent Binding 6 Target Persistent Binding gt p All HBAs gt 1 Display Configuration When you select the Display Configuration option the following information appears Or the message No target persistent binding configuration on HBA instance n appears instead
42. Down timeout to a value from 0 to 240 4 3 1 2 17 Enable Target Reset 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters n Enable Target Reset This choice gives you the option to Enable or Disable Target Reset 4 3 1 2 18 LUNs per Target 3 HBA Parameters gt N PortNumber 2 Configure HBA Parameters n LUNs per Target This option shows the LUNs per Target menu From it you can select 0 LUN per Target 8 LUNS per Target 16 LUNs per Target 32 LUNS per Target 64 LUNS per Target 128 LUNS per Target 256 LUNS per Target 4 3 1 2 19 Commit Changes 3 HBA Parameters gt N PortNumber gt 2 Configure HBA Parameters gt n Commit changes Choose this option to make the changes permanent CAUTION There is undo after you commit to making changes to the HBA parameters 4 28 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Parameters Menu ls 4 3 1 2 20 Abort Changes 3 HBA Parameters gt N Port Number gt 2 Configure HBA Parameters n Abort changes Choose this option to stop without making any changes 4 3 1 3 Restore Defaults 3 HBA Parameters gt n PortNumber gt 3 Restore Defaults This option is for 4Gb and 8Gb HBAs only Selecting the Restore Defaults option causes the following warning to appear Warning Please update the HBA parameters with extreme care Incorrectly updating the HBA parameters may render the HBA inoperable If you currently have boot d
43. E0 8B 21 43 9B Online HBA Model QLA2300 3 Port 1 WWPN 21 00 00 E0 8B 05 CB D8 Loop down 4 Port 2 WWPN 21 01 00 E0 8B 25 CB D8 Online HBA Model QLA2462 Port 1 WWPN 21 00 00 E0 8B 1P 9D PO0 Online 6 Port 2 WWPN 21 01 00 E0 8B 3P 9D PO Loop down HBA Model QLA210 7 Port 1 WiIPN 21 00 00 E0 8B 1A 3F E0 Online 8 All HBAs 9 Return to Previous Menu Enter the number to select the HBA you want to configure or All HBAs 4 3 1 HBA Parameters Per HBA Port 3 HBA Parameters gt n Port instance The HBA Instance menu has the following options W Display HBA Parameters B Configure HBA Parameters W X Restore Defaults 4Gb and 8Gb HBAs only W Return to Previous Menu 4 3 1 1 Display HBA Parameters Command Line Option c 3 HBA Parameters gt n PortInstance 1 Display HBA Parameters When you select this option the following parameters appear Connection Options Data Rate QLA23xx QLA24xx QLE23xx and QLE24xx HBAs Frame Size Hard Loop ID Loop Reset Delay seconds Enable Host HBA BIOS Enable Hard Loop ID Enable FC Tape Support Operation Mode Interrupt Delay Timer 100 ms 4 22 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Parameters Menu C 7 7 IHEEENENEENNMZZZZGQNM Execution Throttle Login Retry Count Enable LIP Reset Port Down Retry Count Enable LIP Full Login Link Down Timeout seconds Enable Target Reset LUNs Per Target Enable Receive Out Of Orde
44. Flashing is OFF In Solaris SPARC include double quotes around the question mark if the system is running with a csh or tsch shell For example scli a HBA To start or stop flashing the HBA s LED beacon type scli a HBA Instance lt HBA WWPN gt SANsurfer FC HBA CLI toggles the LED s state If the LED is flashing the flashing stops If the LED is not flashing the flashing begins If SANsurfer FC HBA CLI is not in silent mode see section 5 3 28 one of the following messages appears to indicate the LED s current state he LED Flashing for HBA Instance HBA WWPN gt has been turned ON he LED Flashing for HBA Instance HBA WWPN gt has been turned OFF The HBA Instance or HBA WWPN gt must match the command input parameter Save or Update the Flash BIOS or Fcode Use the b command to W Update the BIOS or Fcode from a file 1 W Save the BIOS or Fcode to a file 2 To update one or all HBA s Flash with new BIOS or FCode type scli b all HBA Instance HBA WWPN gt rg fw boot gt all BIOS FCode File Name Where all All HBAs of the same type in the system are updated with the new BIOS FCode SN0054614 00 F 5 7 5 Non interactive Commands XX Command Summary QLOGIC E Se HBA Instance HBA number use g command to find HBA WWPN World wide port name rg Flash region update mode 4GB HBAs o
45. HBAs Command Line Option b 10 Utilities gt 1 Flash Update When you select Flash Update you are prompted to select either one of your HBA port instances or All HBAs to update SANsurfer FC HBA CLI then provides the following update options and prompts you to enter a file name for the flash update file W Update Entire Image Update Boot Code Only Update FW Only Flash Update 4 10 2 Flash Save Per HBA Port Command Line Option b and Reserved Word save 10 Utilities 2 Flash Save When you select this option SANsurfer FC HBA CLI opens the Flash Save Menu where you select an HBA port and then enter a file name to save 4 56 SN0054614 00 F XX 4 Interactive Commands QLOGIC Utilities Menu UU EN 4 10 3 HBA Parameters Update Per HBA Port or All HBAs Command Line Option r 10 Utilities 3 HBA Parameters Update When you select HBA Parameters Update you are prompted to select either one of your HBA port instances or All HBAs to update SANsurfer FC HBA CLI then displays the following warning message Warning Please update the HBA parameters with extreme care Incorrectly updating the HBA parameters may render the HBA inoperable If you currently have boot device information set up in the HBA parameters updating the HBA parameters from a file may result in changing that information If you wish to preserve the boot device information please either update the file with the correct boot devi
46. Line Option p ls Target information model name and number for example Port Name Port ID Target ID 4 6 1 2 Target Persistent Bindings Bind Target s Command Line Option p 6 Target Persistent Bindings 1 n Target Persistent Bindings HBA Instance n 2 Bind Target s When you select the Bind Targets option the Target Persistent Binding Menu for HBA Instance n appears This menu lists all targets on the selected HBA Instance and shows information about each target m Target Type Product Vendor Product ID Port Name Port ID Bind Target ID OOOCUOU WB Next Target repeats m All Targets Here is an example of the Target Persistent Binding Menu for HBA Instance n Target Persistent binding Menu HBA Instance 0 1 Disk Vendor SEAGATE Product ID ST318453FC Port Name 22 00 00 04 CF 9C 24 CA Port cb 02 00 E1 Bind No Target ID 2 Disk Vendor SEAGATE Product ID ST318453FC Port Name 22 00 00 0C 50 68 1E 9A Port ID 11 0A E2 Bind g No Target ID m Disk 2 on QLA2462 HBA Instance 1 Vendor SEAGATE SN0054614 00 F 4 47 4 Interactive Commands XX Target Persistent Bindings Menu Command Line Option p QLOGIC EN V 9 p amp Product ID ST318453FC Port Name 22 00 00 11 C6 2D 5A 3F Port ID 11 0A E2 Bind No Target ID n Disk Vendor SEAGATE Product ID ST318453FC Port Name 22 00 00 11
47. Mode Continued Code Name Description 205 Reserved Not used 206 Reserved Not used 207 Reserved Not used 208 Reserved Not used 209 Reserved Not used 210 ERROR MISSING IP ADDRESS IP address is required 211 ERROR MISSING NETMASK ADDRESS Netmask address is required 212 ERROR MISSING GATEWAY ADDRESS Gateway address is required 213 ERROR INVALID IP ADDRESS Invalid IP address 214 ERROR INVALID NET MASK Invalid netmask address 215 ERROR GET SWITCH INFO Failed to get switch information 216 ERROR SET SWITCH IP ADDRESS Failed to set switch IP address 217 ERROR INVALID SWITCH INPUT Invalid switch parameters settings 218 ERROR INVALID ADMIN ACCOUNT Admin account is required 219 ERROR INVALID ADMIN PASSWORD Admin password is incorrect 220 ERROR INVALID OPTION Switch input is invalid 221 Reserved Not used 222 Reserved Not used 223 Reserved Not used 224 Reserved Not used 225 Reserved Not used 226 Reserved Not used 227 Reserved Not used 228 Reserved Not used 229 Reserved Not used 230 ERROR GET TARGET IIDMA SETTINGS Failed to read target link speed 231 ERROR SAVE TARGET IIDMA SETTINGS Failed to set target link speed D 10 SN0054614 00 F XX D Non interactive Error Codes QLOGIC TT ke Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 232 ERROR SET TARGET IIDMA UNSUPPORTED Target link speed operation is un
48. Order Frame DOCODDCODDOCODCODUULCO W Driver Settings Information Header Command Line Options fg HBA Instance HBA Part Number Port Number WWPN Port ID W X Driver Settings repeats for each HBA Instance DCOCDULD Driver Settings Group Persistent Q Persistently bound Plus New targets QO Persistently bound targets only Driver Settings Group Binding CQ Bind by WWPN Q Bind by Port ID W Device LUNs Information Header Repeats for each HBA Instance Q HBA Instance SN0054614 00 F 4 11 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC ee HBA Part Number Port Number WWPN PORT ID W Device LUNs Information Repeats for each LUN Path Target Device ID Product Vendor Product ID Product Revision Serial number Node name Port Name Port ID Product Type LUN count s Status UN N Repeats for each LUN Product Vendor Product ID Product revision LUN Size Type WWULN B Selective LUN Information Header repeats for each selective LUN M a d d DOCCODDCOCODDUCDOLD a r DOCODCDDUCCO HBA Instance HBA Part Number Port Number WWPN Port ID a Selective LUN Information DOCOCDULD Device Vendor ID Device Product ID Serial Number Device Port Name Device Port ID LDOCOCDULD W Boot Device Settings L Selectable Boot Q Primary Boot Port Name 4 12 SN0054614 00 F XX QLOGIC 4 Interactive Commands
49. P bet Port Name LUN 00 00 00 00 00 00 00 00 0 ned MNA Port Name LUN 00 00 00 00 00 00 00 00 0 Alternate a eae Port Name g LUN 00 00 00 00 00 00 00 00 0 Finish in 1 second s Hit RETURN to continue 4 1 3 2 Generate Report All HBAs Command Line Option z 1 General Information 3 Report 4 N All HBAs The system shows the report information for all HBAs See section 4 1 3 1 above in which data repeats for every HBA 4 1 4 Refresh 1 General Information 4 Refresh This selection returns the option to refresh the configuration for the current host 4 2 HBA Information Menu Command Line Option i 2 HBA Information This command shows the HBA Information Menu that includes list of all detected HBAs and their ports as well as the options to view all HBAs and to return to the previous menu a HBA Model QLxnnnn NI 1 Port information L Port number Oh WWPN Status SN0054614 00 F 4 17 4 Interactive Commands XX HBA Information Menu Command Line Option i QLOGIC ee Q additional port s as appropriate M Additional HBAs as appropriate m All HBAs Here is an example of a typical HBA Information Menu screen In this example the host includes three HBAs with two ports each HBA Model 2200 1 Port 1 WWPN 21 00 00 E0 8B 03 55 7C Online 2 Port 2 WWPN 21 01 00 E0 8B 23 55 7C Online HBA Model QLA2300 3 Port 1 WWPN 21 00 00 E0 8B 05 CB D8 Online 4 Po
50. Port Expansion Port F Port FL Port Fabric Loop Port G Port Generic Port N Port Node Port NIC Network Interface Controller NVRAM Non Volatile Random Access Memory A type of memory that retains data even when power is removed Holds configura tion settings You can configure NVRAM settings manually or restore them from a file These settings are retained when SN0054614 00 F called HBA Parameters in this guide network adapter A chip that provides network capabilities A computer may include a network adapter on its system board or on an adapter card Also a NIC network interface card or controller ONC Open Network Computing A remote procedure call developed by Sun Microsystems path A path to a device is a combination of a HBA port instance and a target port as distinct from internal paths in the fabric network A fabric network appears to the operating system as an opaque network between the HBA initiator and the target Since a path is a combination of an HBA and a target port it is distinct from another path if it is accessed through a different HBA and or it is accessing a different target port Consequently when switching from one path to another the driver might be selecting a different HBA initiator a different target port or both This is important to the driver when selecting the proper method of failover notification It can make a difference to the target device
51. QLOGIC E 3 AN A A A Length 9um value Length 9um Length 50um value lt Length 50um gt Length 62 5um value Length 62 5um Length Copper value Length Copper lt VendorName gt value lt VendorName gt lt VendorOUI gt value VendorOUI VendorPN value lt VendorPN gt lt VendorRev gt value lt VendorRev gt lt WaveLength gt value lt WaveLength gt lt CC_BASE gt value lt CC_BASE gt lt Options gt lt SignalLossAsDefinedInSFPMSA gt value lt Signa ossAsDefinedInSFPMSA gt SignalLossInvertedFromSFPMSA value Signa iossinvertedFromSFPMSA gt lt TX_Fault_SignalImplemented gt value TX Fault Signallmplemented TX DisablelmplementedAndDisablesSerialOP value TX DisablelImplementedAndDisablesSerialOP RATE SelectImplemented value lt RATE_SelectImplemented gt Options lt BR Max gt value lt BR Max gt lt BR Min gt value lt BR Min gt lt VendorSN gt value lt VendorSN gt lt DateCode gt value lt DateCode gt lt DiagMonitoringType gt lt AddressChangeRequired gt value lt AddressChangeRequired gt lt PowerMeasurement gt value lt PowerMeasurement gt lt ExternallyCalibrated gt value lt ExternallyCalibrated gt lt InternallyCalibrated gt value lt InternallyCalibrated gt lt lt Digi
52. SN0054614 00 F XX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters I S Revision D Changes Operating systems supported 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 Solaris removed 9 x86 and 10 x86 added x86 v2 9 10 Removed the sentence SANsurfer FC HBA CLI Section 1 does not provide any features that require a GUI Added QEM2462 and QLA QLE2xx to list of sup Section 1 ported HBAs Changed standard GUI install instructions for 3 1 1 1 Windows operating systems Changed package name version to xx which indi 3 1 1 2 3 1 3 1 3 12 3 3 cates the current version of SANsurfer FC HBA CLI Changed step 1 of the Mac OX installation proce dure Removed the steps to create the root user log out of the current user account and log into the root user previously steps 2 3 4 Changed WWPN in example text to generic xx for Section 4 consistency Changed name of Show System Information sub 4 2 1 4 2 2 4 2 4 4 2 5 menus Changed name of Boot Device to Boot Device 4 10 Selection in interactive mode HBA Parameters Table 4 2 Table 6 12 4 6 1 2
53. Selective LUNs 4 7 E Boot device 4 8 The XML Format 1 for all adapter information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt Host gt lt Name gt Host Name lt Name gt lt OSType gt OS Type lt OSType gt lt OSVersion gt OS Version and patches where applicable lt OSVersion gt lt HBA Port value WWNN value WWPN value gt lt NumOfHBA gt Number of QLogic Fibre Channel HBA s detected lt NumOfHBA gt lt Host gt lt HBA gt lt HBA PortNumber value WWNN value WWPN value gt lt GeneralInfo Port value odel value HBAID value HBAAlias value HBAPort value PortAlias value WWNN value WWPN value PortID value SerialNumber value DriverVersion valu BIOSVersion value FirmwareVersion valu TargetCount value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value PortType value Status value gt lt VPD gt lt VPD Product Identifier gt lt VPD gt SN0054614 00 F A 11 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E S lt Param ConnectionOption value DataRate value FrameSize value HardLoopID value LoopResetDelay value EnableHostAdapterBIOS value EnableHardLoopId value ibreChannelTapeSupport
54. SyncLoss value SignalLoss value InvalidCRC value TimeStamp value gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The lt HBA gt lt HBA gt sequence repeats for each HBA SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g ls The LinkStatus parameter repeats for each link B 8 10 HBA Statistics Command Line Option gs The command format is scli gs lt HBA Instance gt lt HBA WWPN gt lt Parameter Name gt Parameter Alias Parameter Value gt x2 The XML Format 2 for the HBA statistics option is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt Statistics LoopID 2 value PortError value DeviceError value Reset value TOCount value IOPS value BPS value TimeStamp value gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The lt Statistics gt sequence repeats for each HBA B 8 11 View HBA Alias Command Line Option ha The command format is scli ha HBA Instance lt HBA WWPN gt view x2 The XML F
55. The following new general information shows HBA instance HBA ID OptionROM BIOS version OptionROM FCode version OptionROM EFI ver sion OptionROM firmware version total number of devices The following general information has been removed Device target count The following VPD information has been removed Assettag End tag Page viii 4 3 5 3 3 4 4 5 3 1 5 4 5 5 4 6 5 4 7 5 4 8 5 4 9 5 4 10 5 4 11 5 4 12 5 4 12 5 4 11 5 4 16 5 4 17 5 4 18 5 4 2 1 4 2 4 4 4 5 4 8 SN0054614 00 F XX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters I 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 eE In interactive mode 4 10 5 3 6 added new HBA Boot Device menu to example text Target Persistent Binding p 4 8 5 9 In interactive mode changed first two option names of Target Persistent Binding menu in the example text Driver Settings fs Changed from bind By 4 11 WWPN to bind by Port ID Save Update Flash b 4 12 5 3 2 In interactive mode removed secondary subti tles o
56. Unable to run R W buffer test because the TARGET excluded device is not available 47 ERROR DIAGNOSTICS MAX FRAME Unable to run diagnostics because of the SETTING HBA current frame size setting 48 ERROR INVALID DIAGNOSTICS Invalid diagnostics test parameter settings SETTINGS 49 Reserved Not used 50 ERROR FC LINK UNKNOWN STATUS Error getting FC link status 51 ERROR RESET LINK STATUS Unable to reset HBA link status 52 ERROR INVALIDE STATISTICS PARAMS Invalid link status statistics parameter set tings 53 Reserved Not used 54 Reserved Not used 55 Reserved Not used 56 Reserved Not used 57 Reserved Not used SN0054614 00 F C 3 C Interactive Exit Codes XX QLOGIC EN w OO E 9 Table C 1 Exit Code Descriptions Interactive Mode Continued m Name Description 58 Reserved Not used 59 Reserved Not used 60 ERROR INVALID PARAM SETTINGS Invalid HBA parameter value key 61 ERROR PARAM UNSUPPORTED HBA Specified HBA parameters is not supported 62 ERROR PARAM UNSUPPORTED DRIVER Unable to update HBA parameters Driver unsupported 63 ERROR RESTORE NVRAM DEFAULT Failed to restore HBA parameters to default settings 64 Reserved Not used 65 Reserved Not used 66 Reserved Not used 67 Reserved Not used 68 Reserved Not used 69 Reserved Not used 70 ERROR SAVE HBA FLASH TO FILE Failed to save HBA flash image to a file 71 ERROR_READ_HBA_FLASH_HBA Failed to read HBA flash 72 ERROR_NO_SPACE_LEFT Co
57. Variables Variable Definition Format HBA Instance or HBA number lt Instance number gt lt HBA WWPN gt HBA world wide port name XX XX XX XX XX XX XX XX Or XXXXXXXXXXXXXX lt Alias gt HBA Alias Symbolic HBA name lt Target WWNN gt Target world wide node XX XX XX XX XX XX XX XX OF name XXXXXXXXXXXXXX lt Target WWPN gt Target world wide port XX XX XX XX XX XX XX XX Or name XXXXXXXXXXXXXX lt Target Port ID gt Target port ID XX XX XX Of XXXXXX lt Target ID gt Target ID lt LUN ID gt Logical unit number 0 255 Address IP Address XXX XXX XXX XXX speed Target link speed 1 2 or 4 GHz a You can use the g command to find HBA numbers You assign the symbolic name It is limited to 100 characters in length 5 3 1 a View or Toggle Beacon Status Use the a command to either view 1 or change 2 the status of a beacon NOTES B HBA must not be in silent mode See section 5 3 28 to issue a response to this command W The a feature is not supported on QLA22xx HBAs 5 6 SN0054614 00 F XX QLOGIC 5 Non interactive Commands Command Summary A T 5 3 2 b To view the HBA port s LED Beacon state type t scli a HBA Instance HBA WWPN gt view When the HBA s LED is flashing the following message appears HBA Port x LED Flashing is ON When the HBA s LED is not flashing the following message appears HBA Port x LED
58. address on the FC loop arbitrated loop A circular ring topology versus point to point where two or more ports can be interconnected but only two ports can communicate at a time All communi cation passes through all ports connected to the loop BIOS Basic Input Output System typically in Flash PROM The program or utility that serves as an interface between the hardware and the operating system and allows booting from the HBA at startup boot code The program that initializes a system or an HBA Boot code is the first program to run when a system or a devices within a system such as an HBAs FCode BIOS and EFI enhanced firmware interface are all forms of boot code for specific hardware operating system environments Boot code for QLogic FC HBAs is required if the computer system is booting from a storage device disk drive attached to the HBA The primary function of the boot code is communication with the external boot device before the operating system is up and running There are also secondary functions that can be performed by the boot code including managing the setup SN0054614 00 F for the HBA and initializing and testing the HBA s ISP boot device The device usually a the hard disk that contains the operating system the BIOS uses to boot from when the computer is started cache A temporary high speed storage memory area where recently used or frequently accessed data is stored
59. and applied to the HBA instance n 4 10 5 1 Using HBA Parameter Templates Use templates to set OEM specific storage qualified HBA parameters to a pre determined value without using a specific DAT DEF file for each HBA type that you might be using NOTE Settings that are effected by the template apply only to the ISP 2300 2310 23x2 2Gb HBAs and the ISP2422 2432 4Gb HBAs The following ISP2422 2432 parameters are subject to the template feature WB Execution Throttle specifies the maximum number of commands executing on any one port When a port s execution throttle is reached no new commands are executed until the current command finishes executing B Descending Loop ID Search specifies in what order the firmware assigns the AL PA ArbitratedLoop PhysicalAddress The firmware searches all the nodes in a loop topology and assigns the AL PA in a descending order if you select 0 ascending order if you select 1 Maximum LUNs Per Target specifies the maximum number of LUNs per target Multiple LUN support is typically for RAID boxes that use LUNs to map drives B Port Down Retry Count specifies the number of times SANsurfer FC HBA CLI retries a command to a port returning port down status 4 58 SN0054614 00 F XX QLOGIC 4 Interactive Commands Utilities Menu ls WB Link Down Timeout specifies the time the driver waits for the link to come up after link down before returning the I Os This is analogo
60. and Windows Vista operating system are registered trademarks of Microsoft Corporation in the United States and other countries Novell and NetWare are registered trademarks of Novell Inc IBM and PowerPC are registered trademarks of International Business Machines Corporation in the United States other countries or both QLogic the QLogic logo QLA and SANsurfer are registered trademarks of QLogic Corporation Red Hat and all Red Hat based are trademarks or registered trademarks of Red Hat Inc Solaris is a registered trademark of Sun Microsystems Inc in the United States and other countries SPARC is a registered trademark of SPARC International Inc Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems Inc Stufflt is a registered trademark of Smith Micro Software Inc SuSE is a registered trademark of SuSE Linux AG VMware is a registered trademark of VMware Inc in the United States and or other jurisdictions All other brand and product names are trademarks or registered trademarks of their respective owners Document Revision History Revision A August 20 2004 Revision B September 28 2005 Revision C June 7 2006 Revision D October 1 2006 Revision E February 1 2007 Revision F February 2008 Changes Sections Affected Revision F Changes Changed NVRAM to HBA Parameters Changed Option ROM to Flash 2004 2008 QLogic
61. and checks for the frame CRC disparity and length errors NOTE Under Solaris this feature is disabled if you are using the driver from the OS installation CDs QLC driver To prepare for a loopback test follow these steps 1 In interactive mode type the number for the Configure HBA Settings option and then press ENTER 2 From the Connections Options menu interactive mode or the n command non interactive mode do one of the following B Ifthe HBA port is not connected to the fabric through a point to point connection F port and is not connected to a switch change the setting to oop only if not currently set to this option QOr L If the HBA port is connected to the fabric through a point to point connection F port and is connected to a switch change the setting to point to point only if not currently set to this option After completing the loopback test change the connection option back to its original value 3 Attach a loopback connector to the FC connector on the HBA port unless your system meets the criteria in section 4 17 1 2 6 in this case an echo test is done The loopback connector must be appropriate for the type of FC HBA connector Be sure to select the appropriate HBA connector for testing To install a loopback connector do the following a Disconnect the cable from the appropriate HBA connector b Install the loopback connector on the HBA connector 4 Follow the step
62. bindings 4 45 4 46 4 47 Target Persistent Bindings Menu 4 45 tb 4 61 5 39 TC parameter 5 20 5 26 technical support 1 7 availability 1 8 training 1 8 template HBA parameters 4 57 supported parameters 4 59 template supported parameter settings QLA23xx HBAs ISP2300 2310 4 60 QLA23xx HBAs ISP2312 4 59 QLA23xx HBAs ISP2322 4 60 QLA246x QLE246x HBAs 4 59 QLE256x HBA 4 59 terminology used in guide 2 6 terms definitions of Glossary 1 SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters lls test count parameter 5 20 diagnostics loopback 4 63 increment parameter 5 20 loopback 4 64 loopback preparing for 4 65 number of tests parameter 5 20 5 26 pattern 5 26 read write buffer 4 66 5 23 results loopback and read write buffer 4 64 TestCount parameter 5 26 TestIncrement parameter 5 26 txt 4 8 text file 4 8 throttle execution 4 23 Tl parameter 5 20 5 26 timeout parameter 5 32 timeout link down 4 23 timer interrupt delay 4 23 toggle beacon status 5 6 topology 4 3 topology host 4 3 host viewing 4 3 Linux 4 4 saving as text file 4 8 viewing 5 40 tp 4 3 5 3 5 40 A 20 B 24 trademark information ii training certification 1 8 transceiver details viewing 4 72 type OS 4 2 U unbind targets 4 49 uninstall Linux 3 13 Macintosh 3 15 Solaris SPARC 8 9 and 10 3 14 Solaris x86 8 9 and 10 3 14 Windows 3 13 unsupported
63. command installs the product in the default Applications directory var root Applications QLogic Corporation SANsurferCLI If this is the first time you are installing SANsurfer FC HBA CLI the system shows the following messages qlogic root installer pkg scli x x x x pkg target installer Package name is SANsurfer FC HBA CLI x x x Build x installer Installing onto volume mounted at installer The install was successful If there is a previous version of SANsurfer FC HBA CLI on the system the installer automatically runs an update operation For example qlogic root installer pkg scli x x x x pkg target installer Package name is SANsurfer FC HBA CLI x x x Build x installer Upgrading volume mounted at installer The upgrade was successful 3 3 Uninstalling SANsurfer FC HBA CLI Refer to the following sections for the appropriate procedure to uninstall SANsurfer FC HBA CLI from your system E 3 3 1 Windows Uninstall 3 3 2 Linux Uninstall 3 3 3 Solaris Uninstall 3 3 4 Macintosh Uninstall 3 12 SN0054614 00 F XKX 3 Initial Installation QLOGIC Uninstalling SANsurfer FC HBA CLI A 3 3 1 Windows Uninstall To uninstall SANsurfer FC HBA CLI use either the standard GUI or command line method B Standard GUI uninstall See section 3 3 1 1 Command line uninstall See section 3 3 1 2 3 3 1 1 Standard GUI Uninstall To uninstall SANsurfer FC HBA CLI using the GUI
64. command to do read write buffer test To run the loopback test use the k1 command see section 5 3 16 To do a read write test using the default parameters type scli kr HBA Instance HBA WWPN gt To do a read write test with customized parameters type t scli kr HBA Instance HBA WWPN gt EX EXCLUDE Target WWPN gt Parameter Name Parameter Alias Parameter Value SN0054614 00 F 5 23 5 Non interactive Commands XX Command Summary QLOGIC Ez i i Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA EX or EXCLUDE World wide port name of the target device that is Target WWPN excluded from the read write test Parameter Name One of the following W DataPattern see section 5 3 16 1 DataSize see section 5 3 16 2 TestCount see section 5 3 16 3 Testlncrement see section 5 3 16 4 OnError see section 5 3 16 5 Parameter Alias ne of the following DP see section 5 3 16 1 DS see section 5 3 16 2 TC see section 5 3 16 3 TI see section 5 3 16 4 OE see section 5 3 16 5 ll BH EH CH HO NH BH BH NH Parameter Value Value for selected parameter Sections 5 3 16 1 through 5 3 16 5 describe how to change the default parameters for both of these tests Section 5 3 16 6 contains command line examples and test results for a loopback test Section 5 3 18 1 contains command line examples and test results fo
65. current HBA parameters of an HBA save lt file name gt port to a file E lt hba instance hba wwpn gt Updates the HBA parameters of an HBA port lt all gt lt file name gt or all HBAs from a file E 6 SN0054614 00 F XX E Help Commands QLOGIC o aaa Table E 1 Help Commands Continued Command Line Arguments Function Action s Suppresses the output This option can be combined with other options However this option must be at the beginning or at the end of the command line lt hba instance gt lt hba wwpn gt Displays the information about devices disks or tapes attached to an HBA port t lt hba instance gt lt hba wwpn gt Displays the information about a device disk lt target wwpn gt lt target or tape attached to an HBA port portid gt t all Displays the information about devices disks or tapes attached to all HBAs tb hba instance hba wwpn Locates a specific device or multiple devices in target wwpn beacon a JBOD This feature is supported only by mode devices within a JBOD tp Displays the current topology Host view topol ogy v Shows the current version vp lt hba instance gt hba wwpn gt Creates a virtual port with your own WWPN create lt vport hex gt vp lt hba instance hba wwpn gt Creates a virtual port with default WWPN auto creat
66. device Also called HBA adapter host adapter and adapter board HBA alias A user defined name for an HBA HBA port A port on the HBA board HBA port alias A user defined name for an HBA port HBA port beacon An LED on the HBA Flashing it enables you to locate the HBA Glossary 3 SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC EN V OO 6 IOCB I O control block An IOCB is a command structure in QLogic ISP architecture ioctl input output control A system call in Unix Linux systems Allows an application to control or commu nicate with a device driver outside usual read write operations JBOD Just a Bunch of Disks As opposed to a SAN See SAN Storage Area Network L Port Loop Port Does arbitrated loop functions and proto cols NL Ports and FL Ports are examples of loop capable ports See E Port Expansion Port F Port FL Port Fabric Loop Port G Port Generic Port N Port Node Port NL Port Node Loop Port LIP Loop Initialization Process The initialization process in an arbitrated loop that occurs when the loop is powered up or a new device is added One function of a LIP is to assign addresses All data transmission on the loop is suspended during a LIP load balancing A software feature that improves system performance by balancing device access between multiple HBAs for maximum reso
67. eee 4 10 5 HBA Parameters Template Per HBA or All HBAs Command Line Option n and OEM Name ssssesesee nnn 4 10 5 1 Using HBA Parameter Templates 00 4 10 6 Driver Update Command Line Option d 2000 4 10 7 Driver Rescan Command Line Option rS llle 4 11 Beacon MON cs oae onde eats Sonne She ftans Sx Phe a 4 11 1 Locate HBA HBA Beacon Command Line Option a 4 11 2 Locate Target s Target Beacon Command Line Option tb 4 11 2 1 Beacon Selected Target S 00 cece eee eee eee 4 12 Diagnostics Menu Command Line Options kl kr and dm 4 12 1 Diagnostics Loopback Test Command Line Option kl 4 12 1 1 Configure Loopback Test Parameters Lue 4 12 1 2 Run Loopback Test 22 6 i as eesuaet IRR ERE ERRARE 4 12 2 Diagnostics Read Write Buffer Test 000 00 e eee 4 12 2 1 Configure Read Write Test Parameters 0 4 12 2 2 Run Read Write Buffer Test 2 20000000 4 12 3 Diagnostics Transceiver Details DMI Command Line Option dmi arsa e ed Gane i aaie ea aa a E a 4 12 3 1 Transceiver Details General 2 0 0 000 eeeee 4 12 3 2 Transceiver Details Details 2 000000ee 4 13 Statistics Menu Command Line Options gs and ls 4 13 1 HBA Statistics Monitoring Command Line Option gs 4 13 1 1 Configuration x
68. features 1 6 SN0054614 00 F updating device driver 5 8 driver 4 60 Fcode 5 7 Flash 4 56 Flash BIOS 5 7 HBA parameter templates 4 58 HBA parameters 4 57 5 38 user generated virtual port 4 87 Utilities Menu 4 56 utility header XML 1 Format A 1 XML 2 Format B 1 V v 5 40 version OS 4 2 SDM API 4 3 viewing for product 4 88 5 40 viewing beacon status 5 6 boot device 5 9 driver settings 5 4 link status 4 82 LUNs 5 29 target link speed 5 36 virtual machines VMs 4 84 Virtual Menu 4 83 for HBA instance 4 85 virtual ports 4 83 5 40 auto generating 4 87 creating 4 86 deleting 4 86 listing 4 85 user generated 4 87 viewing creating deleting 4 83 Vital Product Data 4 20 VMs virtual machines 4 84 vp 4 83 5 40 VPD information 4 20 5 5 VPorts 4 83 Index 11 SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC E V b VV 48 W Windows driver level structure Glossary 2 installing on 3 2 operating systems supported by SANsurfer FC HBA CLI 1 4 uninstalling from 3 13 Windows Virtual Server environment 4 84 WWPN bind by WWPN parameter 5 14 X X 4 8 5 5 5 41 x1 A 1 X2 4 9 5 42 XML file saving as 4 8 Format 1 4 8 5 41 A 1 Format 2 4 9 5 42 B 1 xml file 4 8 Z Z HBA reporting interactive mode 4 9 4 17 HBA reporting non interactive mode 5 2 5 4 5 42 HBA reporting XML Format 1 A 10
69. for rapid access thus increasing the efficiency of processor operations Cache contents duplicate recently used values stored on disk or elsewhere Cache is quick to access relative to the original data which either takes more time due to slow disc access time or is slow to compute Once data is stored in the cache future use can be made by accessing the cached copy rather than re finding or recomputing the original data so that the average access time is lower B L1cache Primary smallest cache on the same chip as the processor W L2 cache Secondary larger cache Either on the processor chip or external to the processor CSV file A comma separated values CSV file device A target typically a disk drive Hardware such as a disk drive tape drive printer or keyboard that is installed in or connected to a system In FC a target device Glossary 1 SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC E k O L driver The software that interfaces between the file system and a physical data storage device or network media The level structure for Windows XP Professional 2000 Windows Server 2003 drivers is as follows M Class Driver The highest driver level There is a separate class for disk Ethernet and so forth This level handles all generic aspects of opera tions for that class E Port Driver The middle driver level whi
70. gt XBiasLowWarning gt value lt TXBiasLowWarning gt XBiasHighWarning gt value lt TXBiasHighWarning gt VccLowWarning value lt VccLowWarning gt VccHighWarning value lt VccHighWarning gt TempLowWarning value lt TempLowWarning gt TempHighWarning gt value lt TempHighWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt RXPowerLowWarning gt value lt RXPowerLowWarning gt NAA AKA AA KA AKA KA KAKA AKA KA AKA KA AKA AKA AAA A A RXPowerLowWarning gt value lt RXPowerLowWarning gt lt VendorSpecific gt value lt VendorSpecific gt lt Address_A2 gt lt HBA gt lt Status gt n lt Status gt lt ErrorMsg gt message lt ErrorMsg gt lt Reboot gt n Reboot gt lt QLogic gt B 7 3 Boot Device Command Line Option e The command format for all HBAs is e view x2 The command format for a single HBAs is B 8 SN0054614 00 F XX B XML Format 2 QLOGIC XML2 Tags for Each Option ls e HBA Instance HBA WWPN gt view x2 The XML Format 2 for the boot device information is as follows lt xml version value encoding value gt lt
71. gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt Host gt lt Name gt Host Name lt Name gt OSType OS Type lt OSType gt OSVersion OS Version and patches lt OSVersion gt XHBA Port value WWNN value WWPN value NumOfHBA Number of QLogic FC HBA s lt NumOfHBA gt Host Status 0 lt Status gt Reboot 0 Reboot QLogic The parameter lt HBA gt repeats for each HBA in the system A 2 2 Display Adapter Settings Command Line Option c The XML Format 1 for adapter settings information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt Param ConnectionOption value DataRate value FrameSize value HardLoopID value LoopResetDelay value EnableHostAdapterBIOS value EnableHardLoopId value FibreChannelTapeSupport value OperationMode value I ntDelayTimer value ExecutionThrottle value EnableExtendedLogging value LoginRetryCount value E inab sipReset value SN0054614 00 F A 3 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC ee PortDownRetryCount value EnableLipFulllogin value LinkDownTimeout value EnableTar
72. into a file type o followed by the file name For example to save LUN information to a file named systemLUNinfo scli 1 o systemLUNinfo Where the file name is systemLUNinfo all messages are located in the directory indicated for the system platform Windows syslog log in the current directory Linux var log messages Macintosh var log system log Solaris var adm messages SN0054614 00 F 5 33 5 Non interactive Commands XX Command Summary QLOGIC E ee 5 3 24 Display Persistent Target Binding Info With this command you can W Show binding information for one or on all HBAs 1 B Binda specific target to a selected HBA 2 W Bind all targets on a specific HBA or on all HBAs 3 B Unbind a specific target 4 W Unbind all targets on a specific HBA or on all HBAs 5 NOTES M Under Solaris if you use the driver from the OS installation CDs QLC driver these features are disabled B Under Linux if you use the ioctl or sysfs inbox driver these features are disabled To show target persistent binding information for a specific HBA port type scli p HBA Instance HBA WWPN gt view To show persistent binding information for all HBAs type scli p all view Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA NOTE In Solaris SPARC using a csh or tsch shell include double quotes around the
73. libqlsdm so opt QLogic Corporation SANsurferCLI menu properties opt QLogic Corporation SANsurferCLI nvramdefs default nvram2 2 dat opt QLogic Corporation SANsurferCLI nvramdefs default nvram2 3 dat EET of QLScli was successful 3 2 3 2 Solaris x86 9 and 10 Installation To install SANsurfer FC HBA CLI on a Solaris x86 9 or 10 operating system follow these steps 1 Download the scli x xx xx xx x86 Solaris pkg file from the QLogic Web site or the FC HBA Manager CD ROM to a temporary directory on your machine For example tmp SN0054614 00 F 3 9 3 Initial Installation XX Installing SANsurfer FC HBA CLI QLOGIC E SeSe e NOTE In the file name x xx xx xx stands for the current version of SANsurfer FC HBA CLI The xx stands for the build version 2 To uncompress the file type the following uncompress scli x xx xx xx x86 Solaris pkg 3 Tosee the available package file type the following ls The available packages appear For example scli x xx xx xx SPARC X86 Solaris pkg 4 To install SANsurfer FC HBA CLI type the following pkgadd d scli x xx xx xx SPARC X86 Solaris pkg 5 You are prompted to select a package For example The following packages are available 1 QLSclix QLogic SANsurfer FC HBA CLI HBA Configuration Utility 1386 x xx xx Build xx Select package s you wish to process or all to process all packages default all q q
74. list see the QLogic SAN Interoperability Guide B Italicized text within angle brackets indicates user defined variables For example scli k HBA Instance HBA WWPN gt B Textshown 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 glogic com for the latest firmware and product updates For information on Vital Product Data VPD see section 4 2 1 4 W In Section 4 Interactive Commands a breadcrumbs line follows most command headings to show you how to access that option that is it shows the hierarchical path from the top level to the command under discussion For example to reach the Save to Text File options from the main SANsurfer FC HBA CLI menu you would select option 1 to open the General Information menu 2 to open the Host Topology menu and 2 again to see the Save to Text File options The following shows a breadcrumbs example 1 General Information 2 Host Topology 2 Save to Text File SN0054614 00 F PRELIMINARY 1 3 1 Introduction Supported QLogic HBAs OO XX QLOGIC 1 3 Supported QLogic HBAs SANsurfer FC HBA CLI is supported for the following QLogic HBAs QLA234x QLA2xx QLE2xx QLE246x QLA246x 1 4 QLE256x Supported Operating Systems SANsurfer FC HBA CLI is supported on the follo
75. lt Reboot gt lt QLogic gt A 2 4 Display Device List Command Line Option t The XML Format 1 for adapter device information is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBAPort value WWNN value WWPN value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt Info Path value ID value Vendor value ProductID value Revision value SerialNumber value DeviceID value PortID value LunCount value Type valu DeviceStatus value gt lt Target gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt n The lt Target gt lt Target gt sequence is repeated for each HBA target A 6 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option ls A 2 5 Display LUN List Command Line Option l The XML Format 1 for the adapter LUN list information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBAPort value WWNN value WWPN value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt LUN ID value WWULN val
76. means a QLogic HBA a tape or disk target device or GBIC connected to a physical port on a switch If the interconnect element is a switch W Interconnect Element switch Type Switch or HBA World wide name Domain ID Management ID IP address Model Symbolic name Serial number MAC address Firmware version Port count Beacon status DOCDDCOCDDCODOLD If the interconnect element is an HBA 4 4 SN0054614 00 F XX QLOGIC 4 Interactive Commands General Information Menu Command Line Option g ls SN0054614 00 F Interconnect element HBA DOCODDOCODDCDODOCUO Type World wide node name World wide port name Vendor ID HBA Model HBA Serial Number HBA Alias Port Alias Driver Version Firmware Version Total Number of Devices Host Number of Port Beacon Status Port Type Port State Port Information repeats for each port Every port may not use all items m Physical Port Number Switch or HBA port number including Port Name WWPN Port State Online or Loop Down Port Type TX Port Type Port Module Type DOCOLD Attached Port Repeats for every Target Initiator that functions as an Attached Port Not all items may appear for every port Target Initiator Node Name Port Name Vendor ID Product ID if applicable Product Revision if applicable Product Serial Number if applicable HBA Model if applicable HBA Serial Number if applicable HBA Alias if appl
77. number when the system The process in which the HBA driver binds boots up So Port 0 on an HBA might have a target ID using a target s world wide port a port instance number of for example 8 if name WWPN or port ID This enables it is the eighth port discovered by the the target ID to always connect to the system WWPN or port ID across reboots regard less of SAN reconfigurations SAN Storage Area Network Multiple storage units disk drives and servers connected by networking topology SCSI Small Computer System Interface A high speed interface used to connect devices such as hard drives CD drives printers and scanners to a computer The SCSI can connect many devices using a single controller Each device is accessed by an individual identification number on the SCSI controller bus Glossary 6 SN0054614 00 F Index A a 4 61 5 6 abort changes to HBA parameters 4 29 about the product 4 88 adapter definition of Glossary 1 Adjunct driver level definition of Glossary 2 AL PA definition of Glossary 1 alias HBA 5 6 A 14 HBA information 4 18 HBA port 4 19 arbitrated loop definition of Glossary 1 Arbitrated Loop Physical Address definition of Glossary 1 attached port definition of 4 4 viewing details 4 5 attaching loopback connector 4 65 auto poll See automatic polling auto generating a virtual port 4 87 automatic polling 4 78 4 81 5 15 AutoPoll parameter 5 15 B b 4 8 4 56 5 7 beacon H
78. press ENTER 4 The Port Alias Menu appears Here is an example Port Alias Menu 1 HBA Model QLA2462 WWNN XX XX XX XX XX XX XX XX Serial Number FFC0519U93213 Port Alias 4G Port 1 2 Cancel Enter 0 to return to the Main Menu Enter Selection If you select a port number from the Port Alias Menu the screen prompts you to enter a Port Alias as follows Port Alias W To keep the current port alias enter the number for Cancel and press ENTER To change the port alias type a new name and press ENTER To delete an existing port alias leave the field blank and press ENTER 4 2 1 4 HBA VPD Information Command Line Option I and Reserved Word vpd 2 HBA Information gt n Port Number gt 4 VPD With QLA QLE24xx HBAs only if you select option 4 the Vital Product Data VPD information appears B HBAinstance number model port number HBA port name WWPN and port ID Product Identifier VPD R tag VPD ReadOnly field if available Part Number HBA model Serial Number Misc Information for example PCI and PCI X speeds Manufacturing ID 4 20 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Parameters Menu ls EFI Driver Version Firmware Version BIOS Version Windows and Linux FCode Version Solaris DOCU If the HBA does not support VPD the following message appears VPD not supported on current HBA 6 4 2 2 HBA Information All HBAs 2 HBA Informatio
79. question mark For example f scli p HBA The following example is a typical SANsurfer FC HBA CLI screen showing all targets currently bound to an HBA HBA 0 QLA2462 Port 1 WWPN xx xXx Xx XxXx Xx xXx xx xx Port ID 11 06 EF Bind Typ Device Node Nam Device Port Name Port ID ID No Disk XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX 10 02 E1 Yes Disk XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX 10 02 E2 0 5 34 SN0054614 00 F XX QLOGIC I Yes Yes Disk Disk Press lt 5 Non interactive Commands Command Summary XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX xX 10 02 E4 il XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX xXxX 10 02 E8 2 Enter to continue To bind a selected target to a specific HBA type scli p HBA Instance HBA WWPN gt Target WWNN Target WWPN gt Target Port ID Target ID Where HBA Instance HBA number use g command to find HBA WWNN Word wide node name of the HBA HBA WWPN World wide port name of the HBA Target WWNN World wide node name of the target Target WWPN World wide port name of the target Target Port ID Port ID of the target Target ID ID to which the target is bound To bind multiple targets with a single command repeat the following group lt Target WWNN gt Target WWPN gt Target Port ID Target ID To bind all targets on a specific H
80. show HBA information 5 5 HBA settings 5 4 link status 4 82 LUN list 5 5 parameter settings 5 8 system information 5 4 target list 5 5 silent mode 5 5 5 38 size frame 4 25 Small Computer System Interface SCSI definition of Glossary 6 software requirements 1 6 Solaris installing on 3 8 operating systems supported by SANsurfer FC HBA CLI 1 4 SPARC driver structure Glossary 2 target ID 5 11 uninstalling from 3 14 starting interactive mode 4 1 statistics HBA port 4 79 link status 4 80 Statistics Menu 4 76 statistics HBA viewing and changing 4 76 A 13 B 21 status message XML Format 1 A 2 XML Format 2 B 2 status link 4 80 status of beacon viewing 5 6 Storage Area Network SAN definition of Glossary 6 Sun Microsystems ONC Glossary 5 support technical 1 7 sysfs driver 4 4 system information display 5 14 information viewing 5 1 5 2 5 3 A 3 B 10 requirements hardware 1 5 software 1 6 Index 10 T t 4 30 5 5 5 39 A 6 B 16 tape support enable 4 23 target beacon starting and stopping 5 39 binding 4 49 binding info viewing 5 34 binding definition of Glossary 6 definition of Glossary 6 ID 5 6 ID Solaris 5 11 link speed setting and viewing 5 36 list 4 31 locating beacon LED 4 61 locating selected beacon LED 4 62 LUN list 4 30 LUNs 4 23 persistent binding A 7 B 15 port ID 5 6 reset enabling 4 23 4 28 5 32 unbinding 4 49 WWNN 5 6 WWPN 5 6 Target Link Speed Menu 4 38 target persistent
81. the loopback test results is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt Loop ID value CRCError value DisparityError value FrameLengthError value Result value gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt A 2 10 Diagnostics Results Read Write Buffer Test Command Line Option kr The XML Format 1 for the read write buffer test results is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt Loop ID value DataMiscompare value LinkFailure value LossOfSync value LossOfSignal value InvalidCRC value Result value gt lt Target gt lt HBA gt Status 0 lt Status gt Reboot 0 Reboot SN0054614 00 F A 9 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC EN PPP VV A 2 11 lt QLogic gt The lt Target gt sequence is repeated for each device attached to the adapter View Driver Settings Comman
82. the options to select W Fach HBA port instance individually B AI HBAs Here is an example of the Target Link Speed Menu or iiDMA Settings Menu HBA Model QLA2342 1 Port 1 WWPN 21 00 00 EO 8B 01 43 9B Online 2 Port 2 WWPN 21 01 00 E0 8B 21 43 9B Online HBA Model QLA2300 3 Port 1 WWPN 21 00 00 E0 8B 05 CB D8 Loop down 4 Port 2 WWPN 21 01 00 E0 8B 25 CB D8 Online HBA Model QLA2462 5 Port 1 WWPN 21 00 00 E0 8B 1P 9D P0 Online 6 Port 2 WWPN 21 01 00 E0 8B 3P 9D PO0 Loop down HBA Model QLA210 7 Port 1 WilPN 21 00 00 E0 8B 1A 3F E0 Online 4 38 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target Link Speed or iiDMA Settings Menu Command Line Option q I 8 All HBAs 9 Return to Previous Menu Table 4 3 lists the target link speed settings and descriptions Table 4 3 Target Link Speed Settings Target Link Speed Settings Description lt address gt IP Address lt hba instance gt HBA number HBA instance number lt hba wwnn gt HBA World Wide Port Name format XX XX XX XX XX XX XX XX OL XXXXXXXX lun id Logical Unit Number 0 255 speed Target Link Speed iiDMA 1 2 or 4 Gbs target id Target ID target portid Target World Wide Port Name format xx xx xx OF XXXXXX target wwnn gt Target World Wide Node Name format XX XX XX XX XX XX XX XX OL XXXXXXXX target wwpn gt Targ
83. this option from the Main Menu SANsurfer FC HBA CLI shows Diagnostics Menu with the standard list of HBA ports Select the port you want to run diagnostic tests on type its number and then press ENTER NOTE exclude ex ignores this device in a read write buffer test Table 4 9 shows the diagnostics configuration settings Table 4 9 HBA Diagnostics Configuration Settings Parameter Name Alias lt param param name aas Value param value Description DataPattern DP 00 FF See table note 1 CRPAT See table note 1 CSPAT See table note 1 4 62 SN0054614 00 F XX 4 Interactive Commands QLOGIC Diagnostics Menu Command Line Options kl kr and dm I E Table 4 9 HBA Diagnostics Configuration Settings Continued Parameter Name Alias lt param lt param name gt aliass Value param value Description CJTPAT See table note 1 DataSize DS 8 16 32 64 128 256 See table note 2 512 1024 2048 TestCount TC 0 65535 Loopback See table note 3 0 10000 R W Buffer See table note 3 TestIncrement TI 1 65535 Loopback See table note 4 TI 1 10000 R W Buffer See table note 4 OnError OE 0 Ignore 1 Stop 2 Loop on error See table note 5 Table Notes 1 DataPattern is the test pattern in hexadecimal format Hex Binary 00 00000000 55 01010101 5A 01011010 A5 10100101 AA 10101010 FF 11111111 User Defined Pattern Hex Random Pattern CRP
84. to proceed with the installation 3 8 SN0054614 00 F XX 3 Initial Installation QLOGIC Installing SANsurfer FC HBA CLI o L L L C TU U aasEEEEEEEEEESNSSNAEARAEN 5 The pkgadd program does a series of checks and then posts a script warning and asks whether to continue the installation For example Processing package instance QLScli from space chuynh scli qlogic Solaris pkgs x QLogic SANsurfer FC CLI HBA Configuration Utility sparc X XX XX Build xx QLogic Corporation Executing checkinstall script Using lt gt as the package base directory Processing package information Processing system information 39 package pathnames are already properly installed Verifying disk space requirements Checking for conflicts with packages already installed Checking for setuid setgid programs This package contains scripts which will be executed with super user permission during the process of installing this package Do you want to continue with the installation of lt QLScli gt y n To continue type y then press ENTER 6 Messages appear showing what files have been installed The system shows a final message when installation is complete For example Installing OLogic SANsurfer FC CLI HBA Configuration Utility as QLScli Installing part 1 of 1 opt QLogic Corporation SANsurferCLI adapters properties opt QLogic Corporation SANsurferCLI libs
85. to the main menu and type the indicated number to quit SANsurfer FC HBA CLI 5 Close the terminal window The Main Menu appears as shown in the following SANsurfer FC HBA CLI vl x x Build xx Main Menu 1 General Information 2 HBA Information 3 HBA Parameters 4 Target LUN List 5 Target Link Speed Or 5 iiDMA Settings 6 Target Persistent Bindings 7 Selective LUNs 8 Boot Device 9 Driver Settings 10 Utilities 11 Beacon 12 Diagnostics 13 Statistics 14 Help Or 14 Virtual if available 15 Exit Ol 15 Help Or 16 Exit NOTE The Virtual menu is available only on Windows systems running with a driver that supports NPIV N Port ID Virtualization Depending on which menu you select may prompt you for more input For example if you select HBA Parameters SANsurfer FC HBA CLI prompts you for the port number that corresponds to the HBA model you want to view NOTES B The Driver Update option under Utilities option 10 is only available on Windows W n Solaris SPARC the option to Save Update BIOS is Save Update FCode 2 2 PRELIMINARY SN0054614 00 F XKX 2 Getting Started QLOGIC Starting Non interactive Mode A 2 3 Starting Non interactive Mode To start SANsurfer FC HBA CLI in non interactive mode type the following in a command window scli lt Parameters gt SANsurfer FC HBA CLI executes the command options then terminates To list all of the available command
86. tp 06 B 24 Appendix C Interactive Exit Codes Appendix D Non interactive Error Codes Appendix E Help Commands Glossary Index Page xviii SN0054614 00 F XX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters TO aa Figure 3 1 3 2 3 3 3 4 3 5 3 6 Table 2 1 3 2 4 1 4 3 List of Figures Page Preparing to Install Dialog BOX cere RR RR ERR 3 2 Welcome Dialog BOX s d oats tia reos Ice i RU MENU RE ea oe Tam ede 3 3 Choose Destination Location Dialog Box 0000 ee 3 3 Ready to Install the Program Dialog Box 0 00 cee ee 3 4 Setup Status Dialog BOX iio e ERRARE e RS Ee eee heated 3 4 InstallShield Wizard Complete Dlalog Box 0 0 cece eee 3 5 List of Tables Page Non interactive Mode Options 0 0002 e eee eee 2 4 Windows Command Line Installation Parameters 0000 eee eee 3 6 HBA Parameters Settings NVRAM 20 e eee eee eee 4 24 Target LUN Information 4 seek x RR RRPERR IR X Y RARG whee a tenes y eGo eyes 4 30 Target Link Speed Settings nannan EH RERUM RE UU X DERE De 4 39 Driver Settings sei xe be eu ne eae ee yr eux ae aua Pedes e Rd 4 55 Template Supported Parameter Settings for QLA246x QLE246x and OLEPbDOCEIBAS o oeb cesse pito th tes tina Pim ed Gone ate oe de a OK 4 59 Template Supported Parameter Settings for QLA23xx
87. value PartNumber value SerialNumber value iscInformation value anufacturingID value EFIDriverVersion valu FirmwareVersion valu BIOSVersion value FCodeVersion valu lt VPD gt lt HBA gt Status 0 lt Status gt Reboot 0 lt Reboot gt QLogic B 8 2 Diagnostics Results Loopback Test Command Line Option kl The command format is scli kl HBA Instance HBA WWPN gt Parameter Name Parameter Alias Parameter Value x2 The XML Format 2 for the loopback test results is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value Loop ID value CRCError value DisparityError value FrameLengthError value Result Success gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt B 8 3 Diagnostics Results Read Write Buffer Test Command Line Option kr The command format is SN0054614 00 F B 13 B XML Format 2 XX Display System Information Command Line Option g QLOGIC Ca scli kr lt HBA Instance gt lt HBA WWPN gt EX EXCLUDE lt Target WWPN gt lt Parameter Name gt lt Parameter Alias
88. value perationMode value ntDelayTimer value xecutionThrottle value inableExtendedLogging value oginRetryCount value nableLipReset value PortDownRetryCount value jnableLipFulllogin 2 value inkDownTimeout value nableTargetReset value UNsPerTarget value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt Info Path value FH O hj I D E zj D E p Vendor value ProductID value Revision value SerialNumber value DeviceID value PortID value LunCount value Type value DeviceStatus value LUN ID 2 value WWULN value Vendor value Product value Revision value Size value Type value gt lt EnabledLUN ID value LUNWWNN value LUNWWPN value gt lt Target gt lt TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value gt lt BootDevice TargetWWNN value TargetWWPN value LUNID value gt lt DriverSettings gt lt Info PersistentPlusNew value PersistentOnly value BindbyWWPN value A 12 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option ls BindbyPortID value gt lt DriverSettings gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt NOTES W The l
89. x Configure Loopback Test Parameters Show Test Configuration Restore Test Configuration to Default Customize Test Configuration Run Diagnostic Test Return to Diagnostics Test Menu OP WBN EF Note 0 to return to Main Menu Enter Selection 1 HBA 1 QEM2462 Port 1 WWPN xx xx xx Xxx xx xx xx xx Port ID 02 0E 00 Gl Test Configuration Data Pattern Random Data Size Bytes 512 Number of test s 1 65535 500 Test Increment 1 65535 sow On Error Ignore SN0054614 00 F 4 69 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC ee Test Continuous OFF Press lt Enter gt to continue SANsurfer FC HBA CLI vl x x Build x Configure Loopback Test Parameters Show Test Configuration Restore Test Configuration to Default Customize Test Configuration Run Diagnostic Test Return to Diagnostics Test Menu OP WBN Ha Note 0 to return to Main Menu Enter Selection 3 SANsurfer FC HBA CLI vl x x Build x Diagnostic Test Configuration Menu Data Pattern Data Size Number of Test s 1 65535 Test Increment s 1 65535 On Error Policy Enable Disable Test Continuously Return to Previous Menu 1o01 0 P5 rm Note 0 to return to Main Menu Enter Selection 7 SANsurfer FC HBA CLI vl x x Build x Configure Loopback Test Parameters Show Test Configuration Restore Test Configuration to Default Customi
90. 14 SN0054614 00 F XX 4 nteractive Commands QLOGIC General Information Menu Command Line Option g Present targets that are persistently bound Only Disable Driver Settings Group Binding Bind by World Wide Port Name Enable Bind by Port ID Disable Devices LUNs Information HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Path 0 Target 0 Device ID 0x82 Product Vendor SEAGATE Product ID ST136403FC Product Revision FF5F Serial Number Node Name Port Name LT06464600001011HGGH 20 00 00 20 37 1A 6B CF 21 00 00 20 37 1A 6B CF Port ID 11 01 E4 Product Type Disk LUN Count s rit Status Online LUN 0 Product Vendor SEAGATE Product ID ST136403FC Product Revision FF5F LUN 0 Size 33 92 GB Type SBC 2 Direct access block device e g magnetic disk WWULN 20 00 00 20 37 1A 6B CF HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Path Target Device ID Product Vendor Product ID Product Revision Serial Number Node Name Port Name Port ID Product Type 0 1 0x83 SEAGATE T118273 CLAR18 SGID LP60266900001919HQ1K 20 00 00 20 37 11 FF 21 00 00 20 37 11 FF 11 01 E8 Disk SN0054614 00 F 4 15 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC ee LUN C
91. 2 64 128 256 512 1024 or 2048 The default size is 512 E Loopback test Windows Solaris and Macintosh systems The data size can be 8 16 32 64 128 256 512 1024 or 2048 The default value is 512 bytes SN0054614 00 F 5 19 5 Non interactive Commands XX Command Summary QLOGIC ee a Loopback test Linux systems The data size can be 8 16 32 64 128 256 512 1024 2048 4096 8192 16384 32768 or 65535 The default value is 512 bytes 5 3 16 3 TestCount TC The number of loopback tests is either TC Parameter Value TestCount Parameter Value For a read write buffer test the number of tests run must be in the range of 0 10000 For a loopback test the number of tests run must be in the range of 0 65535 For both tests a value of 0 indicates that the test runs continuously it stops when you press ENTER The default number of tests run is 500 5 3 16 4 Test Increment TI 5 3 16 5 The Test Increment for the loopback test is either of the following TI Parameter Value Test Increment Parameter Value For a read write buffer test the test increment must be in the range of 1 10000 For a loopback test the test increment must be in the range of 1 65535 If the number of tests is continuous see section 5 3 16 3 the test increment is automatically set to one of the following B 12 Windows m 25 Solaris m 2 Linux and Macintosh The default test increment is 1 Th
92. A 15 B 3 documentation conventions used in guide 1 2 revision history ii DP parameter 5 18 5 26 driver definition of Glossary 2 ioctl 4 4 rescanning 4 60 settings viewing 5 13 A 10 B 10 sysfs 4 4 updating 4 60 updating for device 5 8 driver settings 4 54 4 55 configure 5 13 DS parameter 5 19 5 26 E e 4 51 5 4 5 9 A 8 B 8 E Port Expansion Port definition of Glossary 2 echo diagnostic test definition of Glossary 2 ei 5 12 D 1 enable FC tape support 4 23 Fibre Channel tape support 4 26 HBA hard loop ID 4 23 4 26 HBA port BIOS 4 23 4 26 LIP full login 4 23 4 28 LIP reset 4 23 4 27 receive out of order frame 4 23 target reset 4 23 4 28 EnableBIOS parameter 5 32 EnableExtendedLogging parameter 5 32 EnableHardLooplD parameter 5 32 EnableLIPFullLogin parameter 5 32 EnableLIPReset parameter 5 32 EnableTargetReset parameter 5 32 Index 3 SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC E VXl JVV 3 enabling LUNs 5 29 error codes interactive mode C 1 listing 5 12 non interactive mode D 1 error message XML Format 1 A 2 XML Format 2 B 2 execution throttle 4 23 4 27 ExecutionTrottle parameter 5 32 exit codes interactive mode 4 88 C 1 extended logging enabling 5 32 F f 5 5 5 12 F Port definition of Glossary 3 fabric port F Port definition of Glossary 3 fabric switch definition of Glossary 3 fabric
93. A 8 A 2 8 Boot Device Command Line Option e 2 0000 0 ee A 8 A 2 9 Diagnostics Results Loopback Test Command Line Option kl A 9 A 2 10 Diagnostics Results Read Write Buffer Test Command Line Option k siemen de uet epi vede petes aimi aut as A 9 A 2 11 View Driver Settings Command Line Option fg A 10 A 2 12 Display All Information for One or All HBAs Command Line Sip rME A 10 A 2 13 Link Statistics Command Line Option Is 0000 A 13 A 2 14 HBA Statistics Command Line Option gs 2005 A 13 A 2 15 HBA Alias Command Line Option ha 0002 00 ee A 14 A 2 16 HBA Port Alias Command Line Option pa issus A 14 A 2 17 SFF DMI Command Line Option dm lssllesslssssss A 15 A 2 18 Host Topology Command Line Option tp 000 A 20 Appendix B XML Format 2 B 1 Iftrodi GOLES A3 i51 ctetu td beo ed t oi oo Ira eit eod M ed B 1 B 2 Malt Tata a4 bd pancu edad rds phage Papx edd ee P oca weed ad B 1 B 3 Utility Header nc sis be ran mec ERROR EROR e Sc bo HE tte sete vid au B 1 B 4 Status Message uo dese ttn tari o Rd B am qe SD RR UN RE SO ees d B 2 B 5 Error Messag eoe exco e c a EN Roa RUP RE SES PE We RRS B 2 B 6 Reboot Message s utet neve y erie Es OTRO ERO REIR Oe B 2 B 7 XML2 Tags for Each Optlon vss is RARE RE SES B 2 B 7 1 Display Adapter Settings Command Line Option c
94. A BIOS utility FCode A type of boot code for Sun s SPARC platforms See boot code and Flash F Port Fabric Port A port in a fabric where an N Port can attach FL Port Fabric Loop Port In an FC the fabric switch is capable of FC Arbitrated Loop operations and is connected to one or more NL Ports by an FC Arbitrated Loop An FL Port becomes a shared entry point for public NL Port devices to an FC fabric FL Ports are intermediate ports in virtual point to point links between end ports that do not reside on the same loop for example NL Port to FL Portto F Portto N Port through a single FC fabric switch SN0054614 00 F Flash Nonvolatile memory holding the boot code At times Flash and boot code are used interchangeably See boot code Flash BIOS A flash PROM contains the BIOS code for the HBA G Port Generic Port A port that can operate as either an E Port or an F Port AG Port can determine operating mode at switch port initialization F Port when an N Port attachment is determined E Port when an E Port attachment is determined See E Port Expansion Port F Port FL Port Fabric Loop Port L Port Loop Port N Port Node Port NL Port Node Loop Port HBA host bus adapter The board that interfaces between the host system and the target devices HBA is synonymous with adapter host adapter and adapter board host bus adapter HBA The board that interfaces between the host system and
95. A PortInstance When you select this option SANsurfer FC HBA CLI shows the Boot Device Settings menu for HBA Instance m You can choose to W X Display Boot Device s W Configure Boot Device s 4 8 1 1 Boot Device s Per HBA Port 8 Boot Device gt n Port Number gt 1 Display Boot Device s When you select this option SANsurfer FC HBA CLI shows the following information about the boot devices for this HBA Instance HBA Instance Number HBA Model Number QLAxxxx Port Number on that HBA WWPN Port ID Boot Device Settings Selectable Boot Enabled Disabled Primary Boot Port Name WWPN and LUN Alternate 1 Boot Port Name and LUN Alternate 2 Boot Port Name and LUN Alternate 3 Boot Port Name and LUN For example HBA Instance 0 2200 Port 1 WWPN 21 00 00 E0 8B 03 55 7C PortID 00 00 EF Boot Device Settings Selectable Boot Disabled Primary Boot Port Name LUN 00 00 00 00 00 00 00 00 0 Alternate 1 Boot Port Name LUN 00 00 00 00 00 00 00 00 0 Alternate 2 Boot Port Name LUN 4 52 SN0054614 00 F XX 4 Interactive Commands QLOGIC Boot Device Menu Command Line Option e ls 00 00 00 00 00 00 00 00 0 Alternate 3 Boot Port Name LUN 00 00 00 00 00 00 00 00 0 4 8 1 2 Configure Boot Device s 8 Boot Device gt n Port Number gt 2 Configure Boot Device s When you select this option SANsurfer FC HBA CLI shows the Boot Device Settings men
96. A WWPN gt lt Target WWPN gt lt Target Port ID gt iiDMA Intelligent Interleave Factor settings include B targets t applies to all targets B speec indicates the supported intelligent interleave factor 1 2 4 or 8 Gbps 5 3 30 tb Target Beacon On Off To start or stop flashing a target s LED type scli tb HBA Instance HBA WWPN gt Target WWPN gt 0 ON 1 PRESET gt SN0054614 00 F 5 39 5 Non interactive Commands XX Command Summary QLOGIC E ee NOTES WB The lt 0 ON option flashes the LED until interrupted The lt 1 PRESET option flashes the LED 12 times W This feature is supported only on JBOD devices 5 3 31 tp Display Host Topology Use the tp option to show the topology configuration of the host scli tp topology Under Linux this feature is disabled if you are using the ioctl or sysfs inbox driver Section 5 2 3 covers this command 5 3 32 V Display Version NOTE This option is valid only in non interactive mode To show the version number of the SANsurfer FC HBA CLI tool type scli v The system shows the following information SANsurfer FC HBA CLI vl x x Build x Copyright 2003 2007 QLogic Corp All rights reserved Command Line QLogic FC Host Bus Adapters Build Type Release Build Date xx xx Xxxxx Xxx xx xx AM 5 3 33 vp Virtual Port To list all virtual ports on a physical HBA port type
97. A boot code to a file save file name e lt hba instance gt lt hba wwpn gt Views the HBA Parameters settings of an HBA port e all Views the HBA Parameters settings of all HBAs d file name Performs a driver update to the HBAs lt file name is the full path of the driver file in inf zip Or exe format dm lt hba instance hba wwpn Runs a transceiver SFF SFP diagnostics on all general gen details an HBA port and displays the result in general det or detail view This feature is supported only with 4Gb HBA or latest This feature is not available with inbox driver SLES 10 0 RHEL 5 0 or latest e lt hba instance gt hba wwpn Selectable Boot Configure the operating sys enable 00 0 tem to boot from the first target the BIOS finds e lt hba instance hba wwpn Selectable Boot Configure the operating sys enable 00 0 tem to boot from the first target the BIOS finds E 2 SN0054614 00 F XX QLOGIC E Help Commands ls Table E 1 Help Commands Continued SN0054614 00 F Command Line Arguments Function Action e lt hba instance gt lt hba wwpn gt Shows the current boot device information on view an HBA port e hba instance gt hba wwpn gt Shows the current boot device information on view an HBA port e lt hba instance gt lt hba wwpn gt C
98. AT Loopback test only CSPAT Loopback test only CJTPAT Loopback test only 2 DataSize specifies the data frame payload size in bytes Actual data that is transferred during any given pass of the test For R W buffer test the maximum data size is 128 bytes 3 TestCount 0 Test continuously 1 Max Total number of tests that will be executed 4 TestIncrement must be less than the number of test count specified 5 OnError specifies the action if an error occurs during any given pass 4 12 1 Diagnostics Loopback Test Command Line Option kl 12 Diagnostics n Port Number When you select an HBA port from the Diagnostics menu SANsurfer FC HBA CLI shows the list of diagnostic tests you can run for that port including SN0054614 00 F 4 63 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC e S W loopback Test m Read Write Buffer Test m Transceiver Details available on 4Gb and 8Gb only Test results for loopback and read write buffer tests may include these test results B Loopback test results Test Status CRC Error CL Disparity Error Q Frame Length Error i Read Write buffer test results Loop ID Status Data Miscompare Link Failure Loss of Sync Loss of Signal Invalid CRC DOCDULDULC 4 12 1 1 Configure Loopback Test Parameters 12 Diagnostics gt n Port Number 1 Loopback Test When you select the Loopback Test optio
99. Alarm gt value lt LowAlarm gt lt Temperature gt lt Voltage gt MeasuredVoltage V lt MeasuredVoltage gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt lt A NS BO BA HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt Voltage gt lt TxBias gt lt MeasuredTxBiasUnit gt mA lt MeasuredTxBiasUnit gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt lt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt TxBias gt lt TxPower gt B 4 SN0054614 00 F XX B XML Format 2 QLOGIC XML2 Tags for Each Option I a lt MeasuredTxPowerUnit gt mW lt MeasuredTxPowerUnit gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt HighWarning gt value lt HighWarning gt lt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt TxPower gt lt RxPower gt easuredRxPowerUnit gt mW lt MeasuredRxPowerUnit gt Value gt value lt Value gt Status gt value lt Status gt HighAlarm gt value lt HighAlarm gt HighWarning gt value lt HighWarning gt LowWarning gt v
100. BA locating 4 61 selected target locating 4 62 status toggling 5 6 status viewing 5 6 target locating 4 61 target starting and stopping 5 39 Beacon Menu 4 61 bind by port ID parameter 5 14 by WWPN parameter 5 14 targets 4 49 SN0054614 00 F binding information viewing persistent target 5 34 BIOS definition of Glossary 1 enabling 5 32 HBA port enabling 4 23 blue text meaning of 1 3 bold text meaning of 1 2 boot code definition of Glossary 1 boot device A 8 configuring 4 53 definition of Glossary 1 disable 5 9 displaying 4 52 HBA port instance 4 52 select 5 9 selectable 5 9 settings 4 53 view 5 9 viewing B 8 Boot Device Menu 4 51 breadcrumbs list explanation of 4 2 C c 4 18 4 22 5 4 5 8 A 3 B 2 cache definition of Glossary 1 changed terms 2 6 CJTPAT parameter 5 18 5 19 5 26 class driver definition of Glossary 2 codes error list of 5 12 interactive exit C 1 non interactive errors D 1 comma separated values CSV file definition of Glossary 1 command line format non interactive mode 5 5 options non interactive 5 1 Index 1 SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC E e commands interactive mode 4 1 non interactive mode 2 3 5 1 5 5 a 4 61 5 6 b 4 8 4 56 5 7 c 4 18 4 22 5 8 A 3 B 2 d 4 60 5 8 dm 4 62 4 72 5 9 A 15 B 3 e 4 51 5 9 A 8 B 8 ei 5 12 D 1 f 5 12 fg 4 54 5 13
101. BA CLI lists the disks on the selected HBA port and shows the current configuration of each Select the number for the disk you want to configure and press ENTER to continue You can then select either an individual LUN to configure or All LUNs Select option 1 Enable to enable the LUN s or option 2 Disable to disable the LUN s You are prompted to choose either 1 Select More to configure additional LUNs or 2 Commit Changes to confirm your configuration changes 4 7 2 3 Auto Configure LUNs 7 Selective LUNs gt 1 m PortNumber 3 Auto Configure LUNs When you select this option SANsurfer FC HBA CLI provides the options 1 Enable to enable all targets and all LUN s or 2 Disable to disable all targets and all LUN s When you select either option the changes are saved immediately and you are prompted to reboot Configuration saved on HBA instance 5 WWPN 21 01 00 E0 8B 25 CB D8 LUN persistent data saved successfully Please reboot the system for the saved configuration to become effective 4 8 Boot Device Menu Command Line Option e 8 Boot Device When you select this option SANsurfer FC HBA CLI shows the standard HBA Port Instance menu see section 4 5 2 allowing you to select an individual HBA port or All HBAs SN0054614 00 F 4 51 4 Interactive Commands XX Boot Device Menu Command Line Option e QLOGIC E R9 I CO T4 1A q V 4 8 1 HBA Port Instance 8 Boot Device gt 1 m HB
102. BA CLI shows the following options for all HBAs W X Display LUN Configuration m Manual Configure LUNs W Auto Configure LUNs 4 7 2 1 Display LUN Configuration 7 Selective LUNs gt 1 m Port Number 1 Display LUN Configuration When you select the Display LUN Configuration menu you can choose to show either Bl Details View E General View The detailed view shows Selective LUN Menu Display HBA Instance 5 QLA2300 Port 2 Online WWPN 21 01 00 E0 8B 25 CB D8 Desc QLA2302 VA CPQ PCI to FC dual channel HP Appliance 1 Disk Vendor SEAGATE Product ID ST136403FC Port Name 21 00 00 20 37 1A 6B CF Port ID 11 01 EA Bind Yes Target ID 0 2 Disk Vendor SEAGATE Product ID ST118273 CLAR18 Port Name 21 00 00 20 37 11 FF EF Port ID 11 01 E8 Bind Yes Target ID ver 4 50 SN0054614 00 F XX 4 Interactive Commands QLOGIC Boot Device Menu Command Line Option e ls 3 Return to Previous Menu The general view shows HBA Instance 5 QLA2300 Port 2 WWPN 21 01 00 E0 8B 25 CB D8 PortID 11 05 EF Enable Type Target LUN Info Port Name LUN ID Yes Disk SEAGATE ST136403FC 21 00 00 20 37 1A 6B CF 0 Yes Disk SEAGATE ST118273 CLAR18 21 00 00 20 37 11 FF EF 0 4 7 2 2 Manual Configure LUNs 7 Selective LUNs gt 1 m PortNumber 2 Manual Configure LUNs When you select this option SANsurfer FC H
103. BA Model QLA2300 SN D825408 F 1 WWPN 21 00 00 E0 8B 05 CB D8 SN D83179 HBA Instance 2 Loop down Port 2 WWPN 21 01 00 E0 8B 25 CB D8 SN D83179 HBA Instance 3 Online 1 QLA2462 SN FFC0551C34679 Port 1 WWPN 21 00 00 E0 8B 1F 9D F0 SN FFC0519U93213 HBA Instance 4 Online F WWPN 21 01 00 E0 8B 3F 9D PO0 SN FFC0519U93213 HBA Instance 5 Loop down HBA Model QLA210 SN C655417 Port 1 WWPN 21 00 00 E0 8B 1A 3F E0 SN R61343 HBA Instance 6 Online Total QLogic HBA s 4 4 1 2 Host Topology Command Line Option tp topology 1 General Information 2 Host Topology SN0054614 00 F 4 3 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC EN RB CG 7 This option shows you the HBA Host Topology menu NOTE Under Linux host topology tp is disabled if you are using the ioctl or sysfs inbox driver From the General Information Menu type the number for Host Topology and then press ENTER When you select this option the following options appear B Display a Save As Txt file B Save As XML File 4 1 2 1 Display Host Topology Command Line Option tp topology 1 General Information gt 2 Host Topology 1 Display The host topology option shows information about interconnect elements switches or HBAs and switch ports NOTE Attached Port
104. BA already has that device selected as boot device To use selectable boot the OS boots from the first target the BIOS finds set the Target WWPN gt Target WWNN gt and LUN ID inputs to all zeroes For example type scli e HBA Instance HBA WWPN gt enable 0 O 0 To disable delete the boot device for a specific HBA type scli e HBA Instance HBA WWPN gt disable SN0054614 00 F 5 11 5 Non interactive Commands XX Command Summary QLOGIC E e 5 3 7 ei List SANsurfer FC HBA CLI Error Codes This command lists the SANsurfer FC HBA CLI error codes as shown in Appendix D 5 3 8 f Input Parameter Options from a Text File NOTE The option is valid only in non interactive mode and cannot be combined with any other options Only one command line parameter per file is valid This option is used when it is run as a script file To input parameter options to SANsurfer FC HBA CLI through a text file type f followed by the file name For example scli f command txt The text file must be formatted as follows B X Thefile must contain a single line B The file must contain only parameters B The file cannot contain another option The following example shows how to set the connection option of a HBA to default loop preferred otherwise point to point and the data rate to auto through a command file that is invoked by the option 1 Create a text fi
105. BA or to bind all targets on all HBAs type scli p HBA Instance HBA WWPN gt all bind all Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA To unbind a specific target type scli p lt HBA Instance lt HBA WWPN gt remove target WWNN gt unbind target WWNN gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Target WWNN World wide node name of the target To unbind all targets on a specific HBA port or on all HBA ports type scli p HBA Instance HBA WWPN gt all remove all unbind all SN0054614 00 F 5 35 5 Non interactive Commands XX Command Summary QLOGIC E S 5 3 25 pa Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Define Port Alias 5 3 26 With this command you can B Define the port alias for a specific HBA port 1 W Delete the port alias from a specific HBA port 2 B View the port alias for a specific HBA port 3 To define a port alias for the specified HBA type scli pa HBA Instance HBA WWPN gt alias Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Alias Symbolic name you assign to the HBA port To delete a port alias for the specified HBA port type scli pa HBA Instan
106. Command Line Option I and Reserved Word VDd issu see edad acetbemedee aes 4 20 4 2 2 HBA Information All HBAS llle 4 21 4 2 2 1 Informatio cere we denis ex tego eee alte ES deas 4 21 4 3 HBA Parameters Men 2 0 5 ace Re RS hb Sea RES Bees os 4 21 4 3 1 HBA Parameters Per HBA Port 0 0000 ee eee eee 4 22 4 3 1 1 Display HBA Parameters Command Line Option c 4 22 4 3 1 2 Configure HBA Parameters Command Line Option n 4 23 4 3 1 3 Restore Defaults 15 cid cee tiwevere e ais ee bee aoe 4 29 4 3 2 HBA Parameters All HBAS 020 00 e eee eee ee 4 29 Page xii SN0054614 00 F XX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls 4 4 Target LUN List Menu Command Line Options t and l 4 30 4 4 1 Target LUN List Per HBA Port 00 002 e eee eee 4 31 4 4 1 1 Per Target ED N d ino ios ect ts de Recibe ES ENS a ae 4 31 4 4 1 2 Per Target All LUNS Ss e 5 dee e eres Sha ee eS 4 32 4 4 1 3 All Targets 5d eoe es REX eae ek aay PE eR RAS 4 33 4 4 2 TargeU LUN List All HBAs epe erue De ERE ERI 8s 4 33 4 4 2 1 Individual Target ses xe Rx oe ewe 4 33 4 4 2 2 Iridividilal EN 22 2o ho Dh hoe e Ree ee ores 4 34 4 4 2 3 All RAN QONS cc ct Se et d edens ameet uus S NOR Sella Pet Re reta 4 35 4 4 2 4 All Target s xk RRRREEev pv ER RE ERE MS 4 36 4 4 2 5 PA ERIS a edu so phate Meet Qu dt du ie t ee o
107. Corporation All Rights Reserved Worldwide First Published March 2004 QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo CA 92656 800 662 4471 or 949 389 6000 Page ii SN0054614 00 F XX QLOGIC ls Changed HBA No to HBA Instance Changed SFF DMI to HBA transceiver details Updated supported QLogic HBA list Updated supported operating system list All non interactive information moved from Section 4 to Section 5 Command line options put in alphabetical order Added Appendix B XML Format 2 Added port virtualization NPIV information Added support for Red Hat Linux REL 5 1 Removed installation uninstallation instructions for Solaris SPARC 6 and 7 Added NPIV information Added OS LUN Name Solaris and Linux Added guide overview section including a descrip tion of what s in the guide and documentation con ventions used Added interactive mode exit codes listing Moved tables other than help commands from Help Commands appendix to appropriate interac tive commands sections Expanded iiDMA settings information Added Virtual Menu information Expanded HBA parameter templates information Expanded diagnostic testing information Revision E Changes Expanded product description Split supported HBAs and operating systems into two sections Updated list of supported operating systems Added system requirements section SN0054614 00 F SANsurfer FC HBA CLI User s Guide Comm
108. Delay timer to 0 to 255 seconds You cannot set the Interrupt Delay timer when the Operation Mode blue is set to Interrupt for Every I O Completion 4 3 1 2 11 Execution Throttle 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters n Execution throttle This choice gives you the option to set the Execution Throttle to a value from1 to 65535 4 3 1 2 12 Login Retry Count 3 HBA Parameters gt N PortNumber 2 Configure HBA Parameters n Login Retry Count This choice gives you the option to set the Login Retry Count to a value from 0 to 255 4 3 1 2 13 Enable LIP Reset 3 HBA Parameters gt N PortNumber gt 2 Configure HBA Parameters n Enable LIP Reset This choice gives you the option to Enable or Disable LIP Reset 4 3 1 2 14 Port Down Retry Count 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters n Port Down Retry Count SN0054614 00 F 4 27 4 Interactive Commands XX HBA Parameters Menu QLOGIC EN This choice gives you the option to set the Port Down Retry Count to a value from 0 to 255 4 3 1 2 15 Enable LIP Full Login 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters n Enable LIP Full Login This choice gives you the option to enable or disable LIP Full Login 4 3 1 2 16 Link Down Timeout 3 HBA Parameters gt N PortNumber 2 Configure HBA Parameters n Link Down Timeout This choice gives you the option to set the Link
109. E24xx 5 3 15 only 1 Show LUN list 5 3 19 m Configure selective LUNs 5 3 21 p Configure target persistent binding 5 3 24 t Show target list 5 3 29 5 3 Command Summary The command format for non interactive mode is scli Cmd HBA Instance HBA WWPN gt view Where HBA Instance HBA port instance use g command to find HBA WWPN HBA World wide port name You can combine the commands o s and x with other options However they must be at the beginning or at the end of the command line Use these commands as follows W o Output the results to a file see section 5 3 23 For example scli 1 o WB s Silent mode see section 5 3 28 For example scli i all s o output txt B x Outputs the results in XML format see 5 3 34 For example scli i all x o output xml You cannot combine the command with any other options m f Input Parameter Options from a Text File see section 5 3 8 For example scli f command txt In addition the following general rules for commands apply Only one command line option per input file is valid SN0054614 00 F 5 5 5 Non interactive Commands XX Command Summary QLOGIC EN PpLL B You can use either the hyphen character or the forward slash character For example both of these commands are valid scli g scli g Table 5 2 defines the command variables Table 5 2 Command
110. ER PARAM Failed to read current driver settings of the HBA 102 ERROR DRIVER PARAM NOT FOUND Unknown driver parameter settings 103 Reserved Not used 104 Reserved Not used 105 Reserved Not used 106 Reserved Not used 107 Reserved Not used 108 Reserved Not used D 5 D Non interactive Error Codes XX QLOGIC E e Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 109 Reserved Not used 110 ERROR DUPLICATE TARGET ID Target has duplicate ID 111 ERROR INVALID TARGET ID Target has invalid ID 112 ERROR MISMATCH TARGET ID Target has mismatch ID 113 ERROR READ FROM DRIVER Failed to read persistent binding data from driver database 114 ERROR READ FROM PERSISTENT STORAGE Failed to read persistent binding data from persistent database 115 ERROR MEMORY ALLOC FAILURE Unable to allocate memory 116 ERROR TARGET ENTRY NOT FOUND Unable to find the binding entry of the specified target 117 ERROR DELETE TARGET PERSISTENT ENTRY Failed to delete target persistent bind ing 118 ERROR LUN NOT FOUND The specified LUN ID not available 119 ERROR NO DEVICE FOUND HBA does not have attached devices 120 ERROR OPTION UNSUPPORTED DRV Option is not available with running driver 121 ERROR OPTION UNSUPPORTED HBA Option is not available with HBA 122 ERROR OPTION UNSUPPORTED OS Option is not available on this OS plat form 123 ERROR OPTION DISABLED GU
111. F XX 4 Interactive Commands QLOGIC Statistics Menu Command Line Options gs and Is ls m Auto Poll m Set Rate B Log to file Table 4 11 shows the statistics and link status options Table 4 11 Statistics Link Status Options Parameter Name Alias Value Description AutoPoll AP 0 Update the link statistics automati cally 1 256 Update the link statistics up to a speci fied interval SetRate SR 5 30 Set the Statistics Sampling Rate sec onds LogToFile LF Log File Name Export the link statistics to a file CSV format 4 13 2 1 1 Current Settings 13 Statistics 2 Link Status 1 Configuration 1 Current Settings Select the Current Settings option to have the system display the current link status settings for W X AutoPoll AP WB SetRate SR B LogToFile LF 4 13 2 1 2 Restore Default 13 Statistics 2 Link Status 1 Configuration 2 Restore Default The Restore Default option causes the system to restore the default settings and return the following message Resetting to default settings done 4 13 2 1 3 Auto Poll Menu 13 Statistics 2 Link Status 1 Configuration 3 Auto Poll SANsurfer FC HBA CLI displays two polling options SN0054614 00 F 4 81 4 Interactive Commands XX Statistics Menu Command Line Options gs and Is QLOGIC E S m Auto Poll ul Manual Poll If you select the Auto Poll option the system enables Auto
112. F DMI command line option dm The following options and com Host Information command line option g removed QLogic direct driver version from the list of displayed information For Host Configuration command line option z made the following changes to the list of displayed information Added VPD information to display HBA information command line option l Added view driver settings command line option fg Removed run loopback test command line option kl Removed run read write test command line option kr Removed display and change HBA statistics com mand line option gs Removed display and change link status com mand line option Is Also changed the list order to reflect the order in which the commands are displayed Show HBA Information command line option i Added HBA Alias and Port Alias to list of shown information Changed PCI bus number to PCI device number Show Device List command line option t added Serial Number to the list of displayed information Section 4 1 2 Section 5 3 31 Section 4 2 1 2 Section 5 3 14 Section 4 2 1 3 Section 5 3 25 Section 4 12 Section 5 3 5 mands were changed in Rev E Section 4 2 1 Section 4 2 Section 4 2 Section 4 3 1 4 5 4 4 1 SN0054614 00 F Page v SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC A Configure HBA Settings n added option to
113. GIC E S Type HBA World Wide Node Name 20 00 00 E0 8B 85 8C 7C World Wide Port Name 21 00 00 E0 8B 85 8C 7C Vendor Id QLogic Corporation HBA Model QLA2462 HBA Serial Number FFC0551D59564 HBA Alias Port Alias Driver Version STOR Miniport 9 1 0 18 w32 Firmware Version 4 00 12 Total Number of Devices 0 Host BRAGI Number of Port TU Beacon status c OFE Port Type Unknown Port State LinkDown Hit lt RETURN gt to continue 4 1 2 2 Save As Txt File Command Line Option b 1 General Information gt 2 Host Topology 2 Save As Txt File When you save the host topology to a text file the system responds with the file name For example Topology has been successfully saved to file BRAGI topology 06152007 093855 txt 4 1 2 3 Save As XML File 1 General Information 2 Host Topology 3 Save As XML File When you choose to save the host topology to an XML file the system responds with the Host Topology Menu with options to E Save as XML Format 1 E Save as XML Format 2 4 1 2 3 1 Save As XML File Format 1 Command Line Option x 1 General Information 2 Host Topology 3 Save As XML File 1 Save As XML File format 1 The system responds with the name of the XML Format 1 file for example 4 8 SN0054614 00 F XX 4 Interactive Commands QLOGIC General Information Menu Command Line Option g ls Topology has been successfully s
114. HBA Alias menu appears N HBA Model QLnnnn Port n WWPN nn nn nn nn nn nn nn nn Serial Number XXXXnnnnnnnnn Port Alias lf the HBA already has an alias it appears otherwise blank Type the number for the HBA model and press ENTER Create modify or delete the HBA alias as follows a Tocreate or modify an the HBA alias type a symbolic name maximum 100 characters at the HBA Alias prompt and then press ENTER b Todelete an existing HBA alias leave the HBA Alias field empty and press ENTER Here is an example of the HBA Alias option HBA Alias Menu 1 HBA Model QLA2462 WWNN XX XX XX XX XX XX XX XX Serial Number FFC0519U93213 HBA Alias 4G Dual Port HBA 2 Cancel Note 0 to return to the Main Menu Enter Selection 1 HBA Alias 4 2 1 3 HBA Port Alias Command Line Option pa 2 HBA Information gt n Port Number gt 3 HBA Port Alias SN0054614 00 F 4 19 4 Interactive Commands XX HBA Information Menu Command Line Option i QLOGIC EE S The HBA Port Alias option allows you to create modify or delete a symbolic name Alias for the specified HBA port Follow these steps to create modify or delete an HBA port alias 1 From the Main Menu type the number for the HBA Information option and then press ENTER 2 Type the number for the HBA Port for which you want to change the Port Alias and then press ENTER Type the number for the HBA Port Alias option and then
115. HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt An Ne A A AA KA AKA KA AKA AKA KA A KAEN R N AAA A A SN0054614 00 F A 19 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E ee A 2 18 Host Topology Command Line Option tp The XML Format 1 for an HBA type interconnect element is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt InterConnectElement Type HBA gt lt HBA WWNN value WWPN value VendoriId value odel value SerialNumber value Alias value PortAlias value DriverVersion value FirmwareVersion value Host value TotalNumberOfDevices value NumberofPort value BeaconStatus value PortType value PortState value gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt The XML Format 1 for a switch type interconnect element is as follows lt InterConnectElement Type Switch gt Switch WWPN value DomainID value Management ID value IPAddress value Model value SymbolicName value SerialNumber value MACAddress value FirmwareVersion value PortCount value BeaconStatus value lt PhysicalPortInformation gt lt PhysicalPort Number val
116. HBA port statistics options SN0054614 00 F 4 77 4 Interactive Commands XX Statistics Menu Command Line Options gs and Is QLOGIC ee Table 4 10 HBA Port Statistics Options Parameter Name Alias Value Description AutoPoll AP 0 Turn on automatic updates of the HBA port statistics 1 256 Turn on automatic updates of the HBA port statistics at a specified interval SetRate SR 5 30 Set the polling interval during automatic update seconds LogToFile LF Log File Export the statistics to a file CSV format Name 4 13 1 1 1 Current Settings 13 Statistics gt 1 HBA Statistics 1 Configuration 1 Current Settings The system displays the current settings for W AutoPoll AP WB SetRate SR B LogToFile LF 4 13 1 1 2 Restore Defaults 13 Statistics 1 HBA Statistics 1 Configuration 2 Restore Default The system restores the default settings and returns a message Resetting to default settings done 4 13 1 1 3 Auto Poll 13 Statistics 1 HBA Statistics 1 Configuration 3 Auto Poll SANsurfer FC HBA CLI displays two polling options B AutoPoll m Manual Poll If you select the Auto Poll option the system enables Auto Poll and returns a message Auto Poll enabled 4 78 SN0054614 00 F XX 4 Interactive Commands QLOGIC Statistics Menu Command Line Options gs and Is ls If you select the Manual Poll option the system prompts you
117. HBA reporting XML Format 2 B 17 Index 12 SN0054614 00 F
118. HBAs ISP2312 4 59 Template Supported Parameter Settings for QLA23xx HBAs ISP2300 2310 4 60 Template Supported Parameter Settings for QLA23xx HBAs ISP2322 4 60 HBA Diagnostics Configuration Settings liliis 4 62 HBA Port Statistics Options 55 0 aoi d atte P Re EE dpt Be 4 78 slatistics Link Status OplIODS uirga retro wea D FREE RETRO EA 4 81 Options Shown By Z tcs e x ex nde Ge lew ARIES E See ae aed Ke 5 4 Command Variables s shox doa cele ss DDR ERE S e bMS ENSE ER 5 6 Driver Settings Parameters 2o pu yet Rex EE req ERG a 5 13 FIBA Sialisucs Parameters uu dux E Sheth ERES EXE SA CENE RIDE 5 15 Data Pattern Values sd Lek ane eom AL d Mr eM M oo dU dra d ced 5 19 OnError Nale S i usate a oe batte OE aot OL Oe Ry S ence let Bae tended tool Deck A Boag 5 21 Driver Versions Not Requiring a Loopback Connector 0 000 eee 5 21 Diagnostics Par meters c iesclme ve ed Pee eae eK bee ER UY bed Be 5 26 Data Pattern DP Test Patterns 0 0 0 0 eee 5 27 Link Status Parameters scope RDLESRRRIEAG ARES e e Rad hep eetag tases 5 29 HBA Parameters 2 Dale Ios Hv Sere ards te sds se Ree ee aE ee Vo VER 5 32 Options Displayed by z cec ye oy RIDE ES Ree EDERE ERR TP RS A 10 Options Displayed Dy zz suos repu 4 ascia etu e e aU cis Siete C Re Ke oU ERR B 17 Exit Code Descriptions Interactive Mode 00 0c eee eee eee C 1 Error Code Descriptions Non intera
119. I CONFIG Target persistent binding is not allowed because of existing configura tion saved by the SANsurfer manager 124 ERROR OPTION DISABLED DRV Target persistent binding is disabled because of current driver 125 ERROR UPDATE LUN DATA PERSIST BINDING Failed to update LUN data during per sistent binding configuration 126 ERROR FAILOVER DRIVER LOADED Feature is not supported with failover driver 127 Reserved Not used 128 Reserved Not used 129 Reserved Not used D 6 SN0054614 00 F XX QLOGIC o 9 9 97 a D Non interactive Error Codes Table D 1 Error Code Descriptions Non interactive Mode Continued 151 ERROR READ ZIP FILE SN0054614 00 F Code Name Description 130 ERROR INUALID HBA WWID HBA WWPN WWNN specified is invalid 131 ERROR INVALID HBA PID HBA instance specified is invalid 132 ERROR INUALID TARGET WWID Target WWPN WWNN specified is invalid 133 ERROR INUALID LUN ID LUN ID specified is invalid 134 ERROR MISSING INPUT Incomplete command line option 135 ERROR INVALID INPUT Invalid command line option 136 ERROR CMD UNSUPPORTED Specified command line option is unsupported 137 Reserved Not used 138 Reserved Not used 139 Reserved Not used 140 ERROR UNKNOWN FILE FORMAT Unable to determine file format 141 ERROR READ DRV VER SYS FILE Failed to read driver version from sys file 142 ERROR INIT SECURITY DESCRIPTOR Failed to init sec
120. ID SSVID 11 ERROR MISMATCH SSID The specified flash NVRAM file does not have the SSDID SSVID that match HBA 12 ERROR MISMATCH CHECKSUM File checksum does not match 13 ERROR CORRUPTED FILE File appears to be corrupted 14 ERROR FILE CHKSUM ERROR File checksum returns error 15 ERROR FILE INVALID DATA File has invalid data 16 ERROR FLASH UPDATE IGNORE HBA does not need to be updated 17 Reserved Not used SN0054614 00 F D 1 D Non interactive Error Codes XX QLOGIC E e Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 18 Reserved Not used 19 ERROR FLASH UPDATE UNSUPPORTED Flash update is not supported with this HBA 20 ERROR FLASH OPTION DISABLED HBA Flash update is disabled with this HBA 21 ERROR FLASH OPTION DISABLED OS Flash update is disabled with this OS 22 ERROR FLASH HEADER SIGNATURE Flash file has invalid header signature 23 ERROR FLASH DATA SIGNATURE Flash file has invalid data signature 24 Reserved Internal used 25 ERROR FLASH CSUM ERROR Flash file checksum test failed 26 ERROR FLASH NO FW REGION VALID HBA does not have valid firmware region 27 ERROR FLASH INVALID FW FILE Firmware file does not match with HBA 28 Reserved Internal used 29 ERROR FLASH CSUM MISMATCH Flash file has checksum mismatched 30 ERROR INCORRECT RISC CODE FILE Incorrect RISC image 31 ERROR INCORRECT BOOT CODE FILE Incorrect BIOS FCo
121. MAPIVersion gt B 10 SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g ls lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt NumOfHBA n NumOfHBA Host Status n lt Status gt ErrorMsg message ErrorMsg Reboot n Reboot gt QLogic The parameter lt HBA gt repeats for each HBA in the system B 8 1 Display HBA Information Command Line Option l The command format is scli i HBA Instance HBA WWPN gt all x2 Another version of the command displays all information or VPD information scli i all vpd x2 The XML Format 2 for adapter general information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt Generallnfo Instance value HBAModel value HBAID value HBAAlias value HBAPort value PortAlias value WWNN value WWPN value Port ID value SerialNumber value DriverVersion valu BIOSVersion value FirmwareVersion valu PCI bus value PCIDevice value ActualConnectionMode value ActualDataRate value TargetCount value PortType value Status value SN0054614 00 F B 11 B XML Format 2 XX Display Syste
122. NSUPPORTED current HBA 233 ERROR INVALID IIDMA SETTINGS Selected target link speed rate not supported with current HBA 234 Reserved Not used 235 Reserved Not used 236 Reserved Not used 237 Reserved Not used 238 Reserved Not used 239 Reserved Not used 240 ERROR NO TARGET SELECTED Unable to run target beacon because no device is selected 241 ERROR GET BEACON STATE Unable to get the beacon status 242 ERROR SET BEACON STATE Unable to set the beacon status 243 ERROR BEACON UNSUPPORTED Beacon operation is unsupported 244 ERROR INVALID BEACON PARAMETERS Beacon settings is invalid 245 Reserved Not used 246 Reserved Not used 247 Reserved Not used 248 Reserved Not used 249 Reserved Not used 250 ERROR GET HBA ALIAS Failed to retrieve HBA alias of the HBA 251 ERROR UPDATE HBA ALIAS Failed to update HBA alias of the HBA 252 ERROR GET PORT ALIAS Failed to retried port alias of the HBA 253 ERROR UPDATE PORT ALIAS Failed to update port alias of the HBA 254 Reserved Not used 255 Reserved Not used SN0054614 00 F C 11 C Interactive Exit Codes XX QLOGIC E ee Table C 1 Exit Code Descriptions Interactive Mode Continued uum Name Description 256 Reserved Not used 257 Reserved Not used 258 Reserved Not used 259 Reserved Not used 260 ERROR DRIVER RESCAN Driver rescan operation failed Solaris 261 Reserved Not used 262 Reserved Not used 263 Reserved Not used 264 Res
123. Not used 165 Reserved Not used 166 Reserved Not used 167 Reserved Not used 168 Reserved Not used 169 Reserved Not used 170 Reserved Not used 171 IBM Reserved Blocked 172 IBM Reserved Blocked 173 IBM Reserved Blocked 174 IBM Reserved Blocked 175 IBM Reserved Blocked 176 IBM Reserved Blocked 177 IBM Reserved Blocked D 8 SN0054614 00 F XX D Non interactive Error Codes QLOGIC TT ke Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 178 IBM Reserved Blocked 179 IBM Reserved Blocked 180 IBM Reserved Blocked 181 IBM Reserved Blocked 182 IBM Reserved Blocked 183 IBM Reserved Blocked 184 IBM Reserved Blocked 185 IBM Reserved Blocked 186 IBM Reserved Blocked 187 IBM Reserved Blocked 188 IBM Reserved Blocked 189 IBM Reserved Blocked 190 IBM Reserved Blocked 191 IBM Reserved Blocked 192 IBM Reserved Blocked 193 Reserved Not used 194 Reserved Not used 195 Reserved Not used 196 Reserved Not used 197 Reserved Not used 198 Reserved Not used 199 Reserved Not used 200 ERROR SAVE SEL LUN CONFIG Failed to save selective LUN configu ration 201 Reserved Not used 202 Reserved Not used 203 Reserved Not used 204 Reserved Not used SN0054614 00 F D 9 D Non interactive Error Codes XX QLOGIC OO O X Table D 1 Error Code Descriptions Non interactive
124. Nsurfer FC CLI The InstallShield Wizard will install S amp Nsurfer FC CLI 1 06 16 Build 57 on your computer To continue click Nest lt Back Cancel Figure 3 2 Welcome Dialog Box 2 Read the information and then click Next The Choose Destination Location dialog box appears as shown in Figure 3 3 SANsurfer FC CLI InstallShield Wizard E XI Choose Destination Location Select folder where setup will install files Setup will install S amp Nsurfer FC CLI 1 06 18 Build 57 in the following folder To install to this folder click Next To install to a different folder click Browse and select another folder Destination Folder C Program Files QLogic CorporationNSANsurferCLIN Browse InstallShield Figure 3 3 Choose Destination Location Dialog Box 3 In the Choose Destination Location dialog box do one of the following Q To select the destination location in the dialog box click Next recommended The default location for a Windows system is Program Files QLogic CorporationNSANsurferCLI SN0054614 00 F 3 3 3 Initial Installation XX Installing SANsurfer FC HBA CLI QLOGIC To select a different location a Click Browse b Select an installation location c The Choose Destination Location dialog box reappears Click Next The Ready to Install the Program dialog box appears as shown in Figure 3 4 SANsurfer FC CLI InstallShield Wizard 3 i x R
125. O 0 1 See table notes 3 5 EnableTargetReset TR 0 1 See table note 3 ExecutionThrottle ET 1 565535 FrameSize FR 512 1024 2048 HardLoopID HD 0 125 InterruptDelayTimer ID 0 255 LinkDownTimeOut LT 0 240 LoginReTryCount LR 0 255 MaximumLUNsPerTarget ML 0 8 16 32 64 128 256 OperationMode OM 0 5 6 See table note 6 PortDownRetryCount PD 0 255 ResetDelay RD 0 255 Table Notes 1 Connection Options 0 Loop Only 1 Point to point Only 2 Loop preferred otherwise Point to Point 3 Point to Point otherwise Loop QLA22xx Only 2 Data Rate 0 2 1 Gbs 122 Gbs 2 Auto 3 4 Gbs 4 8 Gbs 4 24 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Parameters Menu I lM 3 Others 0 Disable 1 Enable 4 Option is not available on 4Gb or latest HBAs 5 Option is available on 4Gb or latest HBAs 6 Operation Modes 0 Interrupt for every I O completion 5 Interrupt when Interrupt Delay Timer expires 6 Interrupt when Interrupt Delay Timer expires or no active I O 4 3 1 2 1 Connection Options 3 HBA Parameters gt 1 PortNumber gt 2 Configure HBA Parameters n Connection Options From this menu you can configure the connection options W O0 Loop Only 1 Point to Point Only 2 Loop Preferred Otherwise Point to Point 3 Point to Point Otherwise Loop QLA22xx HBA only Type the number for the connection type you want and press ENTER 4 3 1 2 2 Data Rate 3 HBA Parameter
126. Poll and returns a message Auto Poll enabled If you select the Manual Poll option the system prompts you to enter a value for Manual Poll iteration Manual Poll iteration 1 256 Enter a value from 1 to 256 and press ENTER The system updates the Manual Poll iteration value and returns the following message Manual Poll updated 4 13 2 1 4 Set Rate 13 Statistics 2 Link Status 1 Configuration gt 4 Set Rate The system prompts you to enter a value for the sampling rate the current rate is shown in parentheses Sampling Rate Seconds 5 30 n Enter a value from 5 to 30 and press ENTER The system updates the sampling rate and returns a message Sampling rate updated 4 13 2 1 5 Log to File 13 Statistics 2 Link Status 1 Configuration 5 Log to File When you select the Log to File option the system prompts you to enter a file name or press RETURN to cancel If you press the ENTER key the Link Status Settings Menu reappears If you enter a file name for example MyFile the system saves the log to that file and returns a message Save to file option enabled MyFile csv The file name extension csv indicates a Comma Separated Value file type 4 13 2 2 Show Link Status 13 Statistics 2 Link Status 2 Show Link Status 4 82 SN0054614 00 F XX 4 Interactive Commands QLOGIC Virtual Menu Command Line Option vp aaa The Show Link Status option shows a menu of p
127. QLA210 All HBAs wo 0 N 1 Port 1 WWPN 21 2 Port 2 WWPN 21 3 Port 1 WWPN 21 4 Port 2 WWPN 21 5 Port 1 WWPN 21 6 Port 2 WWPN 21 00 00 EO 8B 01 43 9B Online 01 00 E0 8B 21 43 9B Online 00 00 E0 8B 05 CB D8 Loop down 01 00 E0 8B 25 CB D8 Online 00 00 E0 8B 1P 9D P0 Online 01 00 E0 8B 3P 9D PO0 Loop down Port 1 WilPN 21 00 00 E0 8B 1A 3F E0 Online Return to Previous Menu Table 4 2 lists the variables and their descriptions for target LUN information Table 4 2 Target LUN Information Variable Description address lt hba instance gt lt hba wwnn gt lt lun id gt lt target id gt lt target portid gt lt target wwnn gt lt target wwpn gt IP Address Show Version Show usage help text Silent mode Specifies the output in XML format 2 Specifies the output in XML format 1 Specifies the output to a log file Specifies command line input from file 4 30 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target LUN List Menu Command Line Options t and l A I Q emm 4 4 1 Target LUN List Per HBA Port 4 Target LUN List gt 1 n Target List Menu Port n When you select an HBA Port instance from the Target LUN List a list of LUNs disks attached to that port instance appears Technical information for each LUN appears including a Vendor Product ID Product Revision Serial Number Node Name P
128. QLOGIC General Information Menu Command Line Option g ls Port Name 20 01 00 C0 DD 00 6A 9F Port state Offline Port Type Vendor Specific Reserved Port Type TX Port Type jo El ctrical EL Port Module Type GBIC Attached Port Target Initiator Target Node Name 20 00 00 20 37 1A 6B CF Port Name 21 00 00 20 37 1A 6B CF Vendor Id SEAGATE Product Id ST136403FC Product Revision gt FESE Product Serial Number LT06464600001011HGGH Target Initiator Target Node Name 20 00 00 20 37 11 FF EF Port Name 21 00 00 20 37 11 FF EF Vendor Id SEAGATE Product Id T118273 CLAR18 Product Revision SGID Product Serial Number LP60266900001919HO1K Physical Port Number 8 Port Name 20 07 00 C0 DD 00 6A 9F Port state Offline Port Type Vendor Specific Reserved Port Type TX Port Type Short wave laser SN 850nm Port Module Type GBIC Attached Port Target Initiator ISL Node Name 20 00 00 E0 8B 03 55 7C Port Name 21 00 00 E0 8B 03 55 7C Vendor Id QLogic Corporation HBA Model 2200 HBA Serial Number C28437 HBA Alias Port Alias Driver Version SCSI Miniport 8 1 5 15 W2K IP Firmware Version 2 202503 Total Number of Devices 0 Host BRAGI InterConnect Element SN0054614 00 F 4 7 4 Interactive Commands XX General Information Menu Command Line Option g QLO
129. QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt BootDeviceInfo BootParam EnableSelectableBoot value BootDevice TargetWWPN value LUNID value gt BootDeviceInfo HBA lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt BootDeviceInfo BootParam EnableSelectableBoot 0 BootDevice TargetWWPN value LUNID value EnableSelectableBoot 0 gt BootDeviceInfo HBA Status n lt Status gt ErrorMsg message ErrorMsg Reboot n Reboot gt QLogic The lt HBA gt lt HBA gt sequence repeats for each HBA NOTE If Enable Selectable Boot is set to 1 in the Boot Param Enable Selectable Boot tag it does not appear in the Boot Device Target WWPN tag BootParam EnableSelectableBoot 1 BootDevice TargetWWPN value LUNID value However if Enable Selectable Boot is set to 0 in the Boot Param Enable Selectable Boot tag it appears in the Boot Device Target WWPN tag BootParam EnableSelectableBoot 0 lt BootDevice TargetWWPN value LUNID value EnableSelectableBoot 0 gt SN0054614 00 F B 9 B XML Forma
130. RR oe da bis 5 40 v Display Version o o o ede S ovni e OW S Sandee 5 40 Vp Virtual POM seus siege ore eee Ae EE pem Rx esa RT 5 40 x Output in XML Format 1 vex RR EU XEeERD D RE R3 5 41 X2 Output in XML Format 2 lllseleseleseeessene 5 42 z Display All HBA information for One or All HBAS 5 42 Appendix A XML Format 1 A 1 Ito OE rs cpg SI Aid Meca Penal t tu ido Ia at Kira MM E cr A 1 A 1 1 Main Tag x4 Shera Re pr e ed te Pee eS ea etu qd qd A 1 A 1 2 Utility Header ou chive cal erie eee eee Ro bs BERG ples ORE A 1 A 1 3 Status Message 4v fos eee tha WAR Wee oom Ce ee at A 2 A 1 4 Reboot Message every ek e yc yu EO Weg A 2 A 1 5 Error Message ne cac hie Ose hum PN Se a Ee M epe A 2 A 2 XML Format 1 Tags for Each Option 0 000 e ee eee A 2 A 2 1 Display System Information Command Line Option g A 3 A 2 2 Display Adapter Settings Command Line Option c A 3 Page xvi SN0054614 00 F XX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls 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 m
131. Serial Number Node Name Port Name Port ID Product Type LUN Count s Status Here is an example of the All Targets option Note 0 to return to Main Menu Enter Selection 3 HBA Instance 5 QLA2300 Port 2 WWPN 21 01 00 E0 8B 25 CB D8 PortID 11 05 EF Node Name Port Name Port ID Product Type LUN Count s Status Path 0 Target 0 Device ID 0x85 Product Vendor SEAGATE Product ID ST136403FC Product Revision FF5F Serial Number LT06464600001011HGGH 20 00 00 20 37 1A 6B CF 21 00 00 20 37 1A 6B CF 11 01 E4 Disk 1 Online And so forth 4 36 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target LUN List Menu Command Line Options t and l ls 4 4 2 5 All LUN s 4 Target LUN List gt n Port Number 3 All LUN s When you select this option SANsurfer FC HBA CLI shows the following information about all LUNs for all HBA Port Instances m Product Vendor Product ID Product Revision LUN Size in GB or MB Type for example magnetic disk WWULN world wide unique LUN name OS LUN Name on Solaris and Linux NOTE W Inthe Solaris OS the QLA HBA driver supports a maximum of 256 LUNs E Inthe Solaris OS the QLC HBA driver supports a maximum of 16K LUNs Here is an example of the All LUNs information HBA Instance 0 QLA2462 Port 1 WWPN 21 00 00 E0 8B 1F 9D FO0 Port ID 02 00 00 Target WWPN 22 00 00 04 CF 9C 24 CA
132. T11 standard that describes how multiple unique fabric addresses N_Port IDs can share a single FC HBA physical port N Port in SAN fabric topology NPIV allows a physical HBA port to obtain N Port IDs The SANsurfer FC HBA CLI refers to these N Port IDs as virtual ports VPorts QLogic 4Gb FC HBAs QLx24xx support the NPIV standard Using NPIV requires software tools or applications to create delete manage deploy and migrate virtual ports Microsoft s Windows Virtual Server 2005 R2 along with Windows Server 2003 provides a virtualization platform that can run guest operating systems in an x86 environment Use the QLogic NPIV capable Windows driver with QLogic s SANsurfer FC HBA CLI to create delete and manage virtual ports You can deploy and migrate virtual ports in conjunction with virtual machines VMs in your Windows Virtual Server environment using Microsoft System Center Virtual Machine CLI 2007 For more information about QLogic and Microsoft solutions see the following documents Wm HBA Virtualization Technologies for Windows Environments m Microsoft System Center Virtual Machine Manager The Virtual Menu options allow you to view create and delete virtual HBA ports To see a complete list of NPIV options add the flag h to the vp command For example scli vp h When you select the Virtual Menu option from the main menu the Virtual Menu appears E HBA Model L Port Number u WWPN LC Status Online Lo
133. TE You can repeat the sequence Target WWNN gt Target WWPN gt LUN ID 1 to select multiple LUNs in the same command To disable deselect a LUN on a specific target on a specific HBA type 5 30 SN0054614 00 F XX 5 Non interactive Commands QLOGIC Command Summary ls scli m HBA Instance HBA WWPN gt Target WWNN gt Target WWPN gt LUN ID 0 disable deselect NOTE To select multiple LUNs in the same command repeat the following sequence Target WWNN gt Target WWPN LUN ID 0 To enable select all LUNs for a specific target on a specific HBA type scli m HBA Instance HBA WWPN gt select enable Target WWNN gt Target WWPN gt To disable deselect all LUNs for a specific target on a specific HBA type scli m HBA Instance HBA WWPN gt deselect disable Target WWNN gt Target WWPN gt To enable select all LUNs of all targets on a specific HBA scli m HBA Instance HBA WWPN gt select all To disable deselect all LUNs of all targets on a specific HBA scli m lt HBA Instance gt lt HBA WWPN gt deselect all 5 3 22 n Set Selected HBA Parameter To set a specific parameter on a specific HBA type scli n HBA Instance lt HBA WWPN gt Parameter Name Parameter Alias Parameter Value To restore the default BIOS 4G HBAs only type scli n HBA Insta
134. TE Product ID ST118273 CLAR18 Product Rev SGID Serial Number LP60266900001919HQ1K Port Name 21 00 00 20 37 11 FF EF Port ID 11 01 E8 Intelligent Interleave Factor 4 Gbps 3 Apply Changes to selected Target s 4 Return to Previous Menu Note 0 to return to Main Menu Enter Selection 4 5 3 1 Advanced Configuration 5 Target Link Speed gt n Port Number 2 Advanced Configuration When you select a Port Instance from the Target Link Menu the Target Link Speed Menu Advanced appears It includes the link speed options The options vary according to the HBA in use For example m 1 Gbps B 2Gbps B 4Gbps B 8Gbps Type the number for the link speed you want for the HBA Port Instance selected and then press ENTER The same menu reappears allowing you to set the link speed for every port instance you want 4 42 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target Link Speed or iiDMA Settings Menu Command Line Option q ls When you have set the speed for all the links you want type the number for Apply changes to Selected Target s and then press ENTER 4 5 4 Target Link Speed All HBAs 5 Target Link Speed gt 2 All HBAs When you select this option the Target Link Speed Menu for All HBAs appears It offers two options W Basic configuration W Advanced Configuration 4 5 4 1 Target Link Speed All HBAs Basic Configuration 5 Target Link Speed gt 2 All HBAs gt
135. Target gt lt Target NodeName value PortName value VendorId value ProductId value ProductRevision value ProductSerialNumber value gt lt AttachedPort gt ue lt PhysicalPort gt lt Phy sicalPortInformation gt SN0054614 00 F A 21 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E 1TOCA1A1A V 9 V CV b InterConnectElement Status 0 Status Reboot 0 Reboot lt QLogic gt A 22 SN0054614 00 F Appendix B XML Format 2 B 1 Introduction NOTE XML files created using the x2 command line option match standard output They do not match the X1 files which are designed for backward compatibility with customized legacy scripts If you are developing new scripts we strongly recommend using the x2 command line option which generates standard output XML files see Appendix A The x2 command line option see section 5 3 35 displays all output in XML Format 2 This section defines the XML2 output format which consists of the following parts B Maintag W Utility header W Status message m XML2 message one for each option B 2 Main Tag When SANsurfer FC HBA CLI is in XML2 mode all outputs are between the main tags lt QLogic gt elonogio B 3 Utility Header The following header information is displayed after the main tag lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt X YY ZZ Buil
136. To view the current boot device selection on all HBAs scli e view To view the current boot device selection for a specific HBA scli e HBA Instance HBA WWPN gt view In Solaris SPARC if the system is running with a csh or tsch shell include double quotes around the question mark For example scli e HBA In Windows and Linux each HBAs currently selected boot device is shown in the following format HBA Number HBA WWPN Target WWNN Target WWPN LUN ID Solaris shows each HBA s currently selected boot device in the following format HBA Number HBA WWPN Target WWNN Target WWPN Target ID LUN ID If the system does not have an HBA with a boot device selected the following message appears There is no boot device selected for any HBA in the system Following is an example of the Boot Device option when viewing the boot device for a single HBA In this example no boot device is configured selectable boot is disabled the boot port name is all zeroes HBA 1 QLA2340 WWPN xx xx Xxx xXx Xxx xx xx xx Port ID 00 00 00 Boot Device Settings Selectable Boot Disabled Primary Boot Port Name LUN 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0 Press Enter to continue SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary ls To cause the OS to boot from the first ta
137. UCTION ERES ae dee sale a ROLLE 2 1 2 2 Starting Interactive Mode sog Rte Chee ERE a peda 2 1 2 3 Starting Non interactive Mode 000 e eee eee ee eee 2 3 2 4 Termiri logy 5225s cado o A ech RRA lon ete Le DED ees 2 6 Section 3 Initial Installation 3 1 Downloading the Installation Package 0 0 cee eee 3 1 3 2 Installing SANsurfer FC HBA CLI nna anana aana 3 2 3 2 1 Windows Installation 0 0 0 ccc ee es 3 2 3 2 1 1 Standard GUI Installation 2 0 2 0 00 0 cee eee 3 2 3 2 1 2 Command Line Installation 0 0 0 0 cee eee 3 5 3 2 2 Linux Install tlon us bre ee ate RR wale 3 7 3 2 3 Solaris Installation llle 3 8 3 2 3 1 Solaris SPARC 8 9 10 Installation 3 8 3 2 3 2 Solaris x86 9 and 10 Installation llle 3 9 3 2 4 Macintosh Installation llle 3 11 3 2 4 1 Standard GUI Installation 2 0 0 0 0 0 0 cee eee 3 11 3 2 4 2 Command Line Installation 0 0 0 0 0 ce eee 3 11 SN0054614 00 F Page xi SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC EE S 3 3 Uninstalling SANsurfer FC HBA CLI 0 00 ee 3 12 3 3 1 Windows Uninstall 44 Ere Re Rer Rcs e 3 13 3 3 1 1 Standard GUI Uninstall 5h rm ERR IER RE 3 13 3 3 1 2 Command Line Uninstall 2 0000 00 3 13 3 3 2 linux Uninstall es 2 acte e OREN rn e ex pg aie re EX cn
138. UN on a specific target To show the LUN information for all target devices for a specific HBA Instance type scli 1 HBA Instance lt HBA WWPN gt To show the LUN information for a specific device for a specific HBA port type scli 1 HBA Instance HBA WWPN gt Target Port ID Target WWPN gt To show the LUN information for a specific LUN on a specific target device for a specific HBA port instance type scli 1 HBA Instance HBA WWPN gt Target Port ID Target WWPN gt LUN ID Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Target Port ID Port ID of the target Target WWPN World wide port name of the target LUN ID ID of the LUN 5 3 20 Is Display Link Status To view the link status type scli ls HBA Instance lt HBA WWPN gt Parameter Name Parameter Alias Parameter Value gt 5 28 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary I l Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Parameter Name Name of the parameter see Table 5 10 Parameter Alias Alias of the parameter see Table 5 10 Parameter Value New value of the parameter see Table 5 10 Table 5 10 defines the link status parameter names aliases and values Table 5 10 Link Status Parameters Descr
139. UNSUPPORTED HBA Option is not available with HBA 122 ERROR OPTION UNSUPPORTED OS Option is not available on this OS platform 123 ERROR OPTION DISABLED GUI CONFIG Target persistent binding is not allowed because of existing configuration saved by the SANsurfer manager 124 ERROR OPTION DISABLED DRV Target persistent binding is disabled because of current driver 125 ERROR UPDATE LUN DATA PERSIST Failed to update LUN data during persistent BINDING binding configuration C 6 SN0054614 00 F XX QLOGIC ls C Interactive Exit Codes Table C 1 Exit Code Descriptions Interactive Mode Continued m Name Description 126 ERROR FAILOVER DRIVER LOADED Feature is not support with failover driver 127 Reserved Not used 128 Reserved Not used 129 Reserved Not used 130 ERROR INVALID HBA WWID HBA WWPN WWNN specified is invalid 131 ERROR INVALID HBA PID HBA instance specified is invalid 132 ERROR INVALID TARGET WWID Target WWPN WWNN specified is invalid 133 ERROR INVALID LUN ID LUN ID specified is invalid 134 ERROR MISSING INPUT Incomplete command line option 135 ERROR INVALID INPUT Invalid command line option 136 ERROR CMD UNSUPPORTED Specified command line option is unsup ported 137 Reserved Not used 138 Reserved Not used 139 Reserved Not used 140 ERROR UNKNOWN FILE FORMAT Unable to determine file format 141 ERROR READ DRV VER SYS FILE Failed to read driver version from sys file
140. XX QLOGIC Simplify SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters SN0054614 00 F Pagei SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC R 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 Apple Finder Mac OS Macintosh and Power Mac registered trademarks and Safari is a trademark of Apple Inc registered in the U S and other countries EMC is a registered trademark of EMC Corporation Intel and Pentium are trademarks of Intel Corporation in the U S and other countries Linux is a registered trademark of Linus Torvalds Microsoft Windows Windows NT operating system Windows 2000 operating system Windows Server 2003 operating system Windows XP Professional operating system
141. aching 4 65 loopback test 4 64 5 17 after completing 4 66 example of 5 22 preparing for 4 65 results A 9 B 13 running 4 63 4 67 5 21 loop only connection 4 25 ls 4 76 4 80 5 28 A 13 B 20 LUN masking definition of Glossary 4 LUNs configuration displaying 4 50 configure automatically 4 51 configure manually 4 51 definition of Glossary 4 enabling and disabling 5 29 ID 5 6 information viewing 5 28 list viewing A 7 B 14 maximum per target 5 32 per target 4 23 4 28 selective 4 49 viewing 5 29 viewing selective A 8 B 15 m 4 49 5 5 5 29 A 8 B 15 Macintosh installation on 3 11 operating systems supported by SANsurfer FC HBA CLI 1 5 uninstalling from 3 15 Main Menu interactive mode 4 1 SN0054614 00 F main tag XML Format 1 A 1 XML Format 2 B 1 manual polling 4 78 4 81 MaximumLUNsPerTarget parameter 5 32 media definition of Glossary 4 messages output to XML Format 1 5 41 Microsoft System Center Virtual Machine CLI 2007 4 84 Microsoft s Windows Virtual Server 2005 4 84 Miniport driver level definition of Glossary 2 mode interactive definition of 2 1 interactive starting 2 1 non interactive definition of 2 1 non interactive starting 2 3 operation 4 23 silent 5 38 Monolithic driver definition of Glossary 2 N n 4 23 4 57 N Port Node Port definition of Glossary 4 N Port ID Virtualization 4 83 definition of Glossary 5 N Port IDs 4 83 N Port IO Virtualization defi
142. all HBAs in the system type scli z lt HBA Instance gt lt HBA WWPN gt lt all gt Section 5 2 2 covers this command SN0054614 00 F Appendix A XML Format 1 A 1 Introduction NOTE XML files created using the x1 command line option do not match standard output They are designed for backward compatibility with customized legacy scripts For new scripts we strongly recommend using the x2 command line option which generates standard output XML files see Appendix B The x1 command line option see section 5 3 34 displays all output in XML format 1 This section defines the XML format 1 output which consists of the following parts B Main tag Utility header Status message Error message Reboot message A 1 1 Main Tag When SANsurfer FC HBA CLI is in XML mode all outputs are within the main tag lt QLogic gt elonogio A 1 2 Utility Header The following header information is displayed after the main tag lt AppName gt SANsurfer Command Line Utility lt AppName gt lt AppVersion gt X YY ZZ Build XX lt AppVersion gt SN0054614 00 F A 1 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E ee A 1 3 Status Message Before the closing main tag lt QLogic gt SANsurfer FC HBA CLI displays returning status from the execution of the command line parameters and the error messages Successful execution of the command line parameters returns the following status Statu
143. all LUNs on a specific target on a specific HBA 6 Disable deselect all LUNs on a specific target on a specific HBA 7 Enable select all LUNs of all targets on a specific HBA 8 Disable deselect all LUNs of all targets on a specific HBA 9 For these commands HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Target WWNN World wide node name of the target Target WWPN World wide port name of the target LUN ID ID of the LUN To view all selective LUNs for all HBA ports type t scli m all view To view an HBAs selective LUN list type t scli m HBA Instance HBA WWPN gt all view In Solaris SPARC include double quotes around the question mark if the system is running with a csh or tsch shell For example scli m HBA SANsurfer FC HBA CLI shows the HBA s enabled LUN list in the following format Target WWNN Target WWPN gt LUN ID To view the current select state of a specific LUN type scli m HBA Instance HBA WWPN gt Target WWNN gt Target WWPN gt LUN ID view If the input represents a valid LUN SANsurfer FC HBA CLI shows that LUN s current state as selected or deselected for that HBA To enable select a LUN on a specific target on a specific HBA type scli m HBA Instance HBA WWPN gt Target WWNN Target WWPN gt LUN ID 1 enable select NO
144. alue BindbyPortID value DriverSettings HBA Status n Status Reboot n Reboot QLogic SN0054614 00 F B 19 B XML Format 2 XX Display System Information Command Line Option g QLOGIC B 8 9 W The HBA HBA sequence repeats for each HBA B The lt DriverSettings gt sequence repeats for each HBA B The VPD Product Identifier sequence repeats for each HBA The lt Target gt lt Target gt sequence repeats for each target The LUN sequence repeats for each LUN The EnabledLUN ID sequence repeats for each enabled LUN The TargetBinding sequence repeats for each target persistent binding entry The BootDevice sequence repeats for each boot device selection entry Link Statistics Command Line Option Is B 20 The command format is scli ls HBA Instance HBA WWPN gt Parameter Name Parameter Alias Parameter Value x2 The XML Format 2 for the link statistics option is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt LinkStatus PortName value LinkFailure value
145. alue FrameSize value HardLoopID value LoopResetDelay value EnableHostAdapterBIOS value EnableHardLoopId value FibreChannelTapeSupport value B 18 SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g aaa OperationMode value IntDelayTimer value ExecutionThrottle value LoginRetryCount value EnableLipReset value PortDownRetryCount value nableLipFulllogin value inkDownTimeout value nableTargetReset value UNsPerTarget value Target lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt Info Path value ID value Vendor value ProductID value Revision value SerialNumber value DeviceID value Port ID value LunCount value A D E ing Type value DeviceStatus value gt lt LUN ID value WWULN value Vendor value Product value Revision value Size value Type value gt lt EnabledLUN ID value LUNWWNN value LUNWWPN value gt lt Target gt lt TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value gt gt BootDeviceInfo lt BootParam EnableSelectableBoot value gt BootDevice TargetWWPN value LUNID value gt BootDeviceInfo lt DriverSettings gt lt Info PersistentPlusNew value PersistentOnly value BindbyWWPN v
146. alue lt LowWarning gt LowAlarm gt value lt LowAlarm gt lt RxPower gt lt Diagnostics gt lt HBA gt AA AA AAA The XML Format 2 for SFF DMI general information is as follows scli dm lt HBA Instance gt lt HBA WWPN gt all details det x2 The XML Format 2 for SFF DMI detailed information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value lt OpticalTransceiverDigitalDiagnosticData gt lt OpticalTransceiverDigit alDiagnosticData gt Address A0 lt Identifier gt value lt Identifier gt lt Ext Identifier gt value lt Ext Identifier gt lt Connector gt value lt Connector gt lt TransceiverData gt lt Compliance gt value lt Compliance gt FCLinkLength value lt FCLinkLength gt lt FCTransmitterTech gt value lt FCTransmitterTech gt lt FCTransmissionMedia gt value lt FCTransmissionMedia gt lt FCSpeed gt value lt FCSpeed gt lt TransceiverData gt lt Encoding gt value lt Encoding gt lt BR Nominal gt value lt BR Nominal gt Length 9um km value lt Length 9um km gt SN0054614 00 F B 5 B XML Format 2 XX XML2 Tags for Each Option
147. ame gt lt Parameter Alias gt lt Parameter Value gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA ex or exclude Target World wide port name of the target device to be WWPN excluded from the read write test SN0054614 00 F 5 17 5 Non interactive Commands XX Command Summary QLOGIC EN PV S M w 5 3 16 1 Parameter Name One of the following W DataPattern see 5 3 16 1 DataSize see 5 3 16 2 TestCount see 5 3 16 3 Testlncrement see 5 3 16 4 OnError see 5 3 16 5 Parameter Alias One of the following DP see 5 3 16 1 DS see 5 3 16 2 TC see 5 3 16 3 TI see 5 3 16 4 W OE see 5 3 16 5 Parameter Value Value for selected parameter Sections 5 3 16 1 through 5 3 16 5 describe how to change the default parameters for both of these tests Section 5 3 16 6 contains command line examples and test results for a loopback test Section 5 3 18 1 contains command line examples and test results for a read write buffer test DataPattern DP For the loopback test the data pattern is either DP Parameter Value DataPattern Parameter Value The data pattern must be in a two character hexadecimal pattern in the range of 00 FF The hexadecimal letters can be uppercase or lowercase The default pattern is random for example scli kl HBA Instance HBA WWPN gt DP Random To enter a customized value in the range of 00
148. ame size 4 23 Index 8 hard loop ID 4 23 HBA 4 21 configuring 4 23 HBA template 4 57 HBA displaying 4 22 loop reset delay 4 23 restoring defaults 4 29 saving HBA 4 57 template supported 4 58 4 59 updating 4 58 5 38 updating HBA 4 57 viewing settings of HBAs 5 8 patent information ii path definition of Glossary 5 persistent only parameter 5 13 persistent plus new parameter 5 14 persistent target binding info display 5 34 persistently bound targets 4 54 point to point only connection 4 25 point to point connection 5 21 definition of Glossary 5 poll rate parameter 5 15 polling auto and manual 4 78 4 81 port attached definition of 4 4 BIOS enabling 4 26 definition of Glossary 5 ID bind by port ID parameter 5 14 instance definition of Glossary 6 LED 5 6 report for one 4 9 transceiver details viewing 4 72 virtual 5 40 auto generating 4 87 creating 4 86 deleting 4 86 listing 4 85 user generated 4 87 port alias creating editing deleting 4 19 5 36 XML Format 1 A 14 port down retry count 4 23 4 27 SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls port driver definition of Glossary 2 PortDownRetryCount parameter 5 32 Q q 4 38 5 36 QLA QLE QEM HBAs supported by 1 4 QLA QLE24xx 5 5 QLA23xx 4 23 5 21 QLA24xx 5 21 QLA24xx HBA VPD 4 20 QLE23xx 4 23 5 21 QLE24xx 5 21 QLE24xx HBA VPD 4 20 QLogic technical
149. ame size FrameSize FR 512 1024 2048 Hard loop ID HardLoopID HD 0 125 Interrupt delay timer InterruptDelay ID 0 255 Timer Login retry count LoginRetryCount LR 0 255 Link down timeout LinkDownTimeOut LT 0 240 Maximum LUNS per tar MaximumLUNsPerTar ML 0 8 16 32 64 128 get get 256 Operation mode OperationMode OM See table note below Port down retry count PortDownRetryCount PD 0 255 Reset Delay ResetDelay RD 0 255 Table Notes SN0054614 00 F XX 5 Non interactive Commands QLOGIC Command Summary o 9 97 S EN Data Rate QLA23xx QLA24xx QLE23xx QLE24 xx HBAs 0 1 Gbs 1 2Gbs 2 Auto 3 4 Gbs EnableBlOS option not available on 4Gb HBA EnableExtendedLogging option not available on PPC64 or SPARC Operation mode QLA QLE23xx and QLA QLE24 xx HBAs 0 interrupt for every I O completion 5 interrupt when interrupt delay timer expires 6 interrupt when interrupt delay timer expires or no active I O NOTE See the HBA Manager Index Adapter setting for QLA200 210 parameters 5 3 23 0O Output to a File NOTES W The o option is valid only in non interactive mode W This option can be used with all non interactive mode options that have a corresponding interactive mode option see Table 5 1 The option must be the first or last command in the command line W Ifthe file already exists new data are appended to the current file To output result and status messages
150. and Line Interface for QLogic Fibre Channel Host Bus Adapters All All Section 1 3 Section 1 4 Section 4 Section 5 Table 2 1 Section 4 Appendix B Section 4 14 Section 5 3 33 Section 3 2 2 Section 3 2 3 Section 4 14 1 Section 4 4 Section 1 2 Appendix C Section 4 Section 4 5 Section 4 14 Section 4 10 5 Section 4 12 Section 1 1 Section 1 3 Section 1 4 Section 1 5 SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC Changed bullets describing interactive and non interactive modes Clarified the note about starting SANsurfer FC HBA CLI on a Solaris console serial port Added Macintosh column to Table 2 1 Added support for Linux IOCTL module driver and driver on the OS installation CD inbox driver Split Windows command line installation into two sections standard and silent Changed installa tion instructions Added new parameters to com mand line for silent installation Split Solaris installation and uninstallation into three sections Solaris SPARC 6 and 7 Solaris SPARC 8 9 10 Solaris x86 8 9 10 Added Mac OS X command line installation instructions In Windows uninstall standard added how to invoke the exe package and remove the installed features In Windows uninstall command line changed the uninstall directions Added Mac OS X instructions to manually uninstall the package Replaced no
151. and line option In these sections the term number refers to the adapter number displayed with the HBA general information command line option 1 B 7 1 Display Adapter Settings Command Line Option c The command format is B 2 SN0054614 00 F XX QLOGIC B XML Format 2 XML2 Tags for Each Option ls B 7 2 SFF DMI scli c 0 x2 The XML Format 2 for adapter settings information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value lt Param ConnectionOption value DataRate value FrameSize value HardLoopId value LoopResetDelay value EnableHostAdapterBIOS value nableHardLoopId value ibreChannelTapeSupport value perationMode value ntDelayTimer value xecutionThrottle value inRetryCount value leLipReset value DownRet ryCount value leLipFulllogin value DownTimeout value EnableTargetReset value UNsPerTarget value gt Lr E E E H4 On e te H U Oy 2 2 K D t o p B Qo o 5 n p Jg E31 HBA Status n lt Status gt Reboot n Reboot gt QLogic The lt HBA gt HBA se
152. ands XX Display System Information Command Line Options g z and tp QLOGIC EN V BZ O IC L Port State W Port Information Q Physical Port Number switch port number including QO Port state QO Port type Oh TX port type Q Port module type C Attached Port QLogic HBA tape device or disk device connected to the switch physical port including Target initiator Node name Port name Vendor ID Product ID if applicable Product revision if applicable Product serial number if applicable HBA model if applicable HBA serial number if applicable HBA alias if applicable Port alias if applicable Driver version Firmware version Total number of devices if applicable Host if applicable DOCOCODOCDIDOCDDUCCUO 5 2 4 Host Configuration Use these options to show the information for one or all of the HBA ports in the system The z option shows the combination of the commands listed in Table 5 1 The commands are listed in alphabetical order Table 5 1 Options Shown by z CLI Description See Section c Show HBA settings 543 e Configure boot device 5 3 6 fg View driver settings 5 3 9 g Show system information 5 3 11 5 4 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary ls Table 5 1 Options Shown by z Continued CLI Description See Section i Show HBA information VPD information for QLA QL
153. appendices Section 1 Introduction This section provides a general overview of the product lists the supported QLogic HBAs and operating systems lists the system hardware and software requirements and provides contact information for technical support SN0054614 00 F PRELIMINARY 1 1 1 Introduction XX Guide Overview QLOGIC NENNEN 4 VO VC TH Section 2 Getting Started This section describes the two modes used in SANsurfer FC HBA CLI interactive and non interactive It also explains some special terms used in this guide Section 3 Initial Installation This section provides step by step instructions for installing and uninstalling SANsurfer FC HBA CLI on Windows Linux Solaris and Macintosh Section 4 Interactive Commands This section provides detailed explanations and examples of the command line options used in interactive mode Section 5 Non interactive Commands This section provides detailed explanations and examples of the command line options used in non interactive mode Appendix A XML Format 1 This appendix provides explanations and examples of XML files created with the x1 command line option Appendix B XML Format 2 This appendix provides explanations and examples of XML files created with the x2 command line option Appendix C Interactive Exit Codes This appendix lists the exit codes that can occur while running SANsurfer FC HBA CLI in interactive mode For each exit code number it provides the na
154. asuredTxBiasUnit gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt a lt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt TxBias gt lt TxPower gt lt MeasuredTxPowerUnit gt mW lt MeasuredTxPowerUnit gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt Pg HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt TxPower gt lt RxPower gt lt MeasuredRxPowerUnit gt mW lt MeasuredRxPowerUnit gt Value gt value lt Value gt Status gt value lt Status gt HighAlarm gt value lt HighAlarm gt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt LowAlarm gt value lt LowAlarm gt lt lt lt lt lt lt SN0054614 00 F B 23 B XML Format 2 XX Display System Information Command Line Option g QLOGIC A S lt RxPower gt lt Diagnostics gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt B 8 13 Host Topology Command Line Option tp The command format is scli tp x2 The XML Format 2 for an HBA type interconnect element is as follows this example shows a switch lt xml versi
155. aved to file BRAGI topology 06152007 093855 xml 4 1 2 3 2 Save to XML File Format 2 Command Line Option x2 1 General Information 2 Host Topology 3 Save As XML File 2 Save As XML File format 2 The system responds with the name of the XML Format 2 file for example Topology has been successfully saved to file BRAGI topology 06152007 093855 xml 4 1 3 Generate Report Command Line Option z 1 General Information 3 Report The Report Menu provides the option to select an individual port instance from a list of all HBAs or to select All HBAs M HBA Model L Port Number u Port WWPN L Port Status 4 1 3 1 Generate Report Per HBA Port 1 General Information gt 3 Report gt 1 n Port Number If you enter the number for an HBA port instance from the list the system shows a variety of HBA and system information including Es SANsurfer FC HBA CLI header Q Version and build a HBA header Host name OS type OS version SDM API version HBA Model Serial Number Port number Port WWPN HBA instance Status online offline DOCDOLD DOCU SN0054614 00 F 4 9 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC E S re HBA General Information Host Name HBA Instance HBA Model HBA Description HBA ID HBA Alias HBA Port Port Alias Node Name WWNN Port Name WWPN Port ID Serial Number Driver Version BIOS Version W
156. c gt lt AppName gt SANsurfer FC CLI lt AppName gt lt AppVersion gt vn nn nn Build n nn lt AppVersion gt lt HBA gt GenerallInfo Port value odel value HBAID value HBAALias HBAPort PortAlias WWNN value WWPN value Port ID value SerialNumber value DriverVersion valu BIOSVersion value FirmwareVersion valu Opt ionROMBIOSVersion value Opt ionROMCodeVersion value Opt ionROMEFIVersion value Opt ionROMFirmwareVersion value TargetCount value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value PortType value Status value HBA Status 0 lt Status gt Reboot 0 lt Reboot gt QLogic Here is the VPD information lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC CLI lt AppName gt lt AppVersion gt vn nn nn Build n nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt SN0054614 00 F A 5 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E S lt VPD gt lt VPDProductIdentifier value VPD RTAG PartNumber value SerialNumber value iscInformation value W anufacturingID value EFIDriverVersion value FirmwareVersion valu BIOSVersion value FCodeVersion value AssetTag value gt lt VPD gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0
157. ce HBA WWPN gt delete To view a port alias for the specified HBA port type scli pa HBA Instance HBA WWPN gt view q View or Set Target Link Speed 5 36 NOTE The q option is supported only on 4GB HBAs Type the following command to view the link speed of all Targets attached to one HBA or all HBA s scli q HBA Instance HBA WWPN gt all targets t SN0054614 00 F XX 5 Non interactive Commands QLOGIC Command Summary I Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA all Reports link speed for all targets on all HBAs in the system targets All Targets t all targets To view the link speed of a specific Target attached to an HBA type the following command scli q HBA Instance HBA WWPN gt Target WWPN gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Target WWPN World wide port name of the Target Type the following command to set the link speed of all Targets attached to one HBA or all HBA s to the designated speed scli q HBA Instance HBA WWPN all targets t gt lt speed gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA all Reports link speed for all targets on all HBAs in the system targets All Targets
158. ce settings before the HBA parameters update or re configure the boot settings after the update Do you want to proceed with the operation Es Yes No Enter Selection If you select 1 Yes you are prompted to enter the name of a file from which to update the HBA parameters 4 10 4 HBA Parameters Save Per HBA Port Command Line Option r and Reserved Word save 10 Utilities 4 HBA Parameters Save When you select the HBA Parameters Save option SANsurfer FC HBA CLI prompts you to select an HBA You then enter a file name to save the parameters for that HBA 4 10 5 HBA Parameters Template Per HBA or All HBAs Command Line Option n and OEM Name 10 Utilities 5 HBA Parameters Template SN0054614 00 F 4 57 4 Interactive Commands XX Utilities Menu QLOGIC EN PpBbLBV m h ZI When you select the HBA Parameters Template option SANsurfer FC HBA CLI prompts you to select an HBA port or All HBAs and then offers some or all of the following template types B EMC EMC specific settings HP HP specific settings HPQ HP specific settings 2Gb HP HBAs IBM IBM specific settings QLGC QLogic specific settings SUN SUN specific settings Select one of the templates to apply it immediately to the HBA port instance or All HBAs The following is returned Updating HBA Parameters on HBA instance n QLA2nnn Please wait HBA Parameters update complete Changes have been saved
159. ch handles aspects of the operation specific to the port type for example there is a port driver for SCSI In Red Hat SuSE Linux the driver layers include B SCSI Upper Layer This is the device management layer It handles device dependent tasks for devices such as disks and tapes m SCSI Middle Layer This is the SCSI traffic handling layer It directs requests between the kernel and the SCSI B SCSI Lower Layer This is the SCSI HBA driver It communications directly to the SCSI HBA The structure for Solaris SPARC drivers includes W Nexus Drivers Nexus drivers provide bus mapping and translation services to subordinate nexus and leaf devices These include drivers for PCI to PCI bridges PCMCIA adapters and SCSI HBAs W Leaf Drivers Leaf drivers provide the traditional character and block driver interfaces for reading and writing data to storage and communication devices These include drivers for peripheral devices including Glossary 2 QLA200 QLA2 xxx HBAs disks tapes network HBAs and frame buffers W Miniport Driver The lowest driver level and device specific This level is usually supplied by the manufacturer as a companion to a physical device m Monolithic Driver This level combines the functions of different driver levels in the same driver to increase perfor mance W Adjunct Driver This level works along side a driver at the same level to increase performance In NetWare the requ
160. cific device attached to an HBA remove target wwnn unbind port target wwnn gt p lt hba instance hba wwpn gt Displays the current persistent binding config all view uration on an HBA port or all HBAs p lt hba instance hba wwpn gt Binds all device s attached to an HBA port or all bind all all HBAs p hba instance hba wwpn gt Unbinds all device s attached to an HBA port all remove all unbind all orall HBAs pa lt hba instance hba wwpn gt Sets an alias to an HBA port alias pa lt hba instance gt lt hba wwpn gt Deletes the current alias of an HBA port delete pa lt hba instance hba wwpn gt Displays the current alias of an HBA port view q lt hba instance gt lt hba wwpn gt Modifies the iiDMA settings of selected tar lt target wwpn gt lt speed gt get s on an HBA port This feature is sup ported only on 4Gb or latest HBAs q lt hba instance hba wwpn Displays the current iiDMA settings of a spe target wwpn gt cific target on an HBA port q lt hba instance hba wwpn gt Modifies the iiDMA settings of all targets on an all targets t HBA port or all HBAs lt speed gt q lt hba instance hba wwpn gt Displays the current iiDMA settings of all tar all targets a gets on an HBA port or all HBAs lt hba instance gt lt hba wwpn gt Saves the
161. ct the HBA b From the device list select a device disk that is currently attached to this HBA c From the intelligent interleave factor speed list select the intelligent interleave factor 1 Gbps 2 Gbps 4 Gbps or 8 Gbps that you want to set for this device d Repeat the previous step for additional devices e Choose one of the following options C To proceed select Select the Apply changes to selected target s The following is returned The iiDMA settings have been saved to selected target s Q Toexit without making any changes select Return to Previous Menu 4 5 2 HBA Port Instance 5 Target Link Speed gt Target Link Speed Menu for HBA instance 1 n This option shows the Target Link Speed Menu or iiDMA Settings Menu for a specific Port Instance This menu looks like the Target List Menu shown in section 4 4 1 1 It includes a list of all targets attached to the selected port instance and specific information about each target including B X Target Type for example Disk L Product Vendor L Product ID 4 40 SN0054614 00 F 4 Interactive Commands Target Link Speed or iiDMA Settings Menu Command Line Option q XX QLOGIC ls 4 5 3 HBA Port Product Revision Serial Number Port Name Port ID OOOO Max Target Link Rate Next Target Type for example Disk Apply Changes to Selected Targets Here is an example of the Target Link Speed Menu for all HBA Instances Tar
162. ctive Mode 0000 eee eee D 1 Help Commands 2 eee ES ERR Hee Sete eee he eae p equ e p dee E 1 SN0054614 00 F Page xix SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC E G V k WAMwWS LVA Notes Page xx SN0054614 00 F Section 1 Introduction 1 1 Product Overview The SANsurfer FC HBA CLI tool provides a command line interface CLI that lets you easily install configure and deploy QLogic Fibre Channel FC host bus adapters HBAs It also provides robust diagnostic and troubleshooting capabilities and useful statistical information to optimize SAN performance This tool only configures HBAs on the local machine where SANsurfer FC HBA CLI is installed SANsurfer FC HBA CLI is a simplified condensed version of the SANsurfer FC HBA Manager graphical user interface GUI SANsurfer FC HBA CLI can be operated in two modes B Interactive mode menu driven interface This mode requires user intervention B q Non interactive mode command line interface Use this mode for scripting or when you want to do a single operation NOTE This guide uses interchangeably the terms HBA and adapter 1 2 Guide Overview This guide is intended for end users responsible for administration of QLogic FC HBAs 1 2 1 How this Guide is Organized The SANsurfer FC HBA CLI User s Guide is organized into the following sections and
163. d Line Option fg A 2 12 The XML Format 1 for the current driver settings information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt XHBA Port value WWNN value WWPN value gt DriverSettings Info PersistentPlusNew value PersistentOnly value BindbyWWPN value BindbyPortID value DriverSettings gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt Display All Information for One or All HBAs Command Line Option z The XML Format 1 for all adapter information is more complicated than its non XML counterpart because the tags cannot be repeated In non XML mode SANsurfer FC HBA CLI sequentially calls all the options in Table A 1 and each option is displayed in its standard output format If each option displays its own XML output the resulting display would have multiple duplicate tags Table A 1 Options Displayed by z Soon Description Section g Display system information 4 1 l Display HBA information 4 2 C Display HBA settings 4 3 t Display device list 4 4 L Display LUN list 4 4 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option ls Table A 1 Options Displayed by z Continued OD Description Section p Target persistent binding 4 6 m
164. d MSB value Reserved MSB Reserved LSB value Reserved LSB lt StatusControlBits gt lt DataReadyBar gt value lt DataReadyBar gt lt LOS gt value lt LOS gt T 1 1 x J 1 1 M i 3 1 NAKA AAA KA AA KAKA AKA AAA A A Jj x J On 1 NA AA AAA A SN0054614 00 F B 7 B XML Format 2 XX XML2 Tags for Each Option QLOGIC A J C C7 L f 1 S V A LVVV TXFault value TXFault SoftRXRateSelect value SoftRXRateSelect RXRateSelectState value lt RXRateSelectState gt SoftTXDisable value lt SoftTXDisable gt lt TXDisableState gt value lt TXDisableState gt lt StatusControlBits gt TXPowerLowAlarm gt value lt TXPowerLowAlarm gt TXPowerHighAlarm gt value lt TXPowerHighAlarm gt TXBiasLowAlarm gt value lt TXBiasLowAlarm gt TXBiasHighAlarm gt value lt TXBiasHighAlarm gt VccLowAlarm value lt VccLowAlarm gt VccHighAlarm value lt VccHighAlarm gt TempLowAlarm gt value lt TempLowAlarm gt TempHighAlarm gt value lt TempHighAlarm gt RXPowerLowAlarm gt value lt RXPowerLowAlarm gt RXPowerHighAlarm gt value lt RXPowerHighAlarm gt XPowerLowWarning gt value lt TXPowerLowWarning gt XPowerHighWarning gt value lt TXPowerHighWarning
165. d XX lt AppVersion gt lt AppXMLVersion gt X YY lt AppXMLVersion gt SN0054614 00 F B 1 B XML Format 2 XX Status Message QLOGIC E B 4 Status Message Before the closing main tag lt QLogic gt SANsurfer FC HBA CLI displays any returning status from the execution of the command line parameters and the error messages When the execution of the command line parameters is successful the following status is displayed Status 0 lt Status gt When the execution of the command line parameters fails the following status is displayed followed by an error message that provides additional details Status 1 lt Status gt B 5 Error Message When the execution of the command line parameters is fails an Error message appears between the Status and Reboot tags d the system must be restarted for the change to take effect the following message is displayed lt ErrorMsg gt Details of the failure lt ErrorMsg gt B 6 Reboot Message When the execution of the command line parameters is successful and the system must be restarted for the change to take effect the following message is displayed Reboot 1 lt Reboot gt When the execution of the command line parameters is successful and the system does not need to be restarted the following message is displayed Reboot 0 Reboot B 7 XML2 Tags for Each Option The following sections describe the XML Format 2 for each comm
166. d gt Port ID of a target device xx xx xx or xxxxxx lt target id gt ID of a target device lt lun id gt Logical Unit Number of a LUN lt address gt IP address Table E 1 Help Commands Command Line Arguments Function Action int Starts interactive mode a lt hba instance hba wwpn Flashes the HBA port LED to locate it in the host This feature is not supported on QLA22xx series HBAs hba instance hba wwpn Displays the current LED state on an HBA view port w SN0054614 00 F E 1 E Help Commands XX QLOGIC OO ee Table E 1 Help Commands Continued Command Line Arguments Function Action b all hba instance hba Updates the HBA boot code from a file where wwpn lt rg gt fw boot m lt rg gt Specifies Option ROM region all file name update mode W lt all gt Updates the flash from a full image file 1MB image file W lt fw gt Updates the firmware image only from a firmware file E boot Updates the boot code BIOS Fcode EFI image only from a boot code file E file name gt Flash image file name Note Region update is not available on 2Gb HBAs Flash update is not supported on 2Gb HBAs in Macintosh If selected multiple HBAs only HBAs that are compatible with the pro vided flash image will be updated b lt hba instance hba wwpn Saves the HB
167. de boot image 32 ERROR INCORRECT FULL IMAGE FILE Incorrect 1M Flash image 33 ERROR CORRUPTED FLASH IMAGE FILE Flash image file is corrupted 34 ERROR FLASH UPDATE FAILURE Failed to update flash 35 ERROR FLASH GET REGION FAILURE Failed to read flash update region from HBA 36 ERROR FLASH UPDATE NO VALID REGION Failed to validate flash update region read from HBA 37 ERROR FLASH UPDATE NO REGION LAYOUT HBA does not have flash update region layout 38 Reserved Not used 39 Reserved Not used 40 ERROR DIAGNOSTICS PARAM ERROR Diagnostics test returns invalid param eters D 2 SN0054614 00 F XX QLOGIC ls D Non interactive Error Codes Table D 1 Error Code Descriptions Non interactive Mode Continued SN0054614 00 F Code Name Description 41 ERROR DIAGNOSTICS LOOP DOWN Unable to run diagnostics because the loop is down 42 ERROR DIAGNOSTICS FAILURE Diagnostics test failed with errors 43 ERROR DIAGNOSTICS DATA MISCOMPARE Diagnostics test failed with data mis compare 44 ERROR DIAGNOSTICS UNKNOWN STATUS Unknown diagnostic test status 45 ERROR DIAGNOSTICS NO AVAIL TARGET Unable to run R W buffer test because there are no attached devices 46 ERROR DIAGNOSTICS NOT FOUND TARGET Unable to run R W buffer test because the excluded device is not available 47 ERROR DIAGNOSTICS MAX FRAME SETTING Unable to run diagnostics because of the HBA current frame size setting 48 ERROR INVALID DIAGNOSTICS SETTINGS I
168. de name port name WWPN and WWNN with variables xx in screen shots for security purposes Added a note to Display LUN List and Selective LUNs sections defining the maximum number of LUNs supported by the Solaris QLA and QLC driv ers Added text to the Target Persistent Binding section defining the number of targets and the range of tar get IDs for Solaris which is based in the HBA type Changed Boot Device Selection to Boot Device Settings Page iv Section 2 2 Section 2 3 Section 2 2 Section 2 3 Section 3 Section 4 Section 5 Section 3 2 1 2 These Solaris versions no longer supported Section 3 2 3 1 Section 3 3 3 1 Section 3 2 3 2 Section 3 3 3 2 Section 3 2 4 2 Section 3 3 1 1 Section 3 3 1 2 Section 3 3 4 Section 4 Section 4 7 Section 4 6 Section 4 6 2 Section 4 8 SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls Expanded Save Update Flash section to list which OSs and HBAs save update flash BIOS or the option ROM image Added description and preparation instructions for loopback and read write buffer tests Added description of these test results Section 4 10 Section 4 12 1 1 Section 4 12 2 The following options and commands were added in Rev E Host Topology command line option tp HBA Alias command line option ha HBA Port Alias command line option pa SF
169. definition of Glossary 3 Fast UTIL definition of Glossary 3 FCode definition of Glossary 3 saving and updating 5 7 FC P2P See point to point features unsupported 1 6 fg 4 54 5 4 5 13 A 10 B 10 file 4 8 txt 4 8 xml 4 8 text 4 8 XML 4 8 Flash definition of Glossary 3 saving file 4 56 update 4 56 Flash BIOS definition of Glossary 3 saving and updating 5 7 Format 1 XML 4 8 Format 2 XML 4 9 format non interactive commands 5 5 F port 5 21 Index 4 frame length errors 5 23 size 4 23 4 25 FrameSize parameter 5 32 fs 5 13 G g 4 2 5 1 5 4 A 3 B 10 G_Port Generic Port definition of Glossary 3 GBIC attached port 4 4 General Information menu 4 2 Generate Report Menu 4 9 generating reports 4 9 generating virtual user port 4 87 glossary of terms Glossary 1 gs 4 76 5 14 A 13 B 21 guide documentation conventions 1 2 organization of 1 1 H h 4 87 5 15 ha 4 18 5 16 A 14 B 21 hard loop ID 4 23 4 26 enabling 5 32 HardLooplD parameter 5 32 hardware requirements 1 5 HBA alias 4 18 5 6 A 14 setting and deleting 5 16 viewing B 21 boot device info for all 4 54 complete information displaying 5 4 viewing 5 2 configuration all 4 50 definition of Glossary 3 general information 4 2 SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters I E HBA continued hard loop ID 4 23 host informatio
170. e TXDisableState StatusControlBits TXPowerLowAlarm value lt TXPowerLowAlarm gt TXPowerHighAlarm value lt TXPowerHighAlarm gt TXBiasLowAlarm value lt TXBiasLowAlarm gt TXBiasHighAlarm value TXBiasHighAlarm VccLowAlarm value VccLowAlarm VccHighAlarm value lt VccHighAlarm gt TempLowAlarm value lt TempLowAlarm gt TempHighAlarm gt value lt TempHighAlarm gt RXPowerLowAlarm gt value lt RXPowerLowAlarm gt RXPowerHighAlarm gt value lt RXPowerHighAlarm gt TXPowerLowWarning gt value lt TXPowerLowWarning gt XPowerHighWarning gt value lt TXPowerHighWarning gt XBiasLowWarning gt value lt TXBiasLowWarning gt XBiasHighWarning gt value lt TXBiasHighWarning gt VccLowWarning value lt VccLowWarning gt VccHighWarning value lt VccHighWarning gt TempLowWarning value lt TempLowWarning gt TempHighWarning gt value lt TempHighWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt ReservedWarning gt value lt ReservedWarning gt RXPowerLowWarning gt value lt RXPowerLowWarning gt RXPowerLowWarning gt value lt RXPowerLowWarning gt lt VendorSpecific gt value lt VendorSpecific gt lt Address_A2 gt lt
171. e Continued m Name Description 204 Reserved Not used 205 Reserved Not used 206 Reserved Not used 207 Reserved Not used 208 Reserved Not used 209 Reserved Not used 210 ERROR MISSING IP ADDRESS IP address is required 211 ERROR MISSING NETMASK ADDRESS Netmask address is required 212 ERROR MISSING GATEWAY ADDRESS Gateway address is required 213 ERROR INVALID IP ADDRESS Invalid IP address 214 ERROR INVALID NET MASK Invalid netmask address 215 ERROR GET SWITCH INFO Failed to get switch information 216 ERROR SET SWITCH IP ADDRESS Failed to set switch IP address 217 ERROR INVALID SWITCH INPUT Invalid switch parameters settings 218 ERROR INVALID ADMIN ACCOUNT Admin account is required 219 ERROR INVALID ADMIN PASSWORD Admin password is incorrect 220 ERROR INVALID OPTION Switch input is invalid 221 Reserved Not used 222 Reserved Not used 223 Reserved Not used 224 Reserved Not used 225 Reserved Not used 226 Reserved Not used 227 Reserved Not used 228 Reserved Not used 229 Reserved Not used 230 ERROR GET TARGET IIDMA SETTINGS Failed to read target link speed C 10 SN0054614 00 F XX QLOGIC ls C Interactive Exit Codes Table C 1 Exit Code Descriptions Interactive Mode Continued dit Name Description 231 ERROR SAVE TARGET IIDMA SETTINGS Failed to set target link speed 232 ERROR SET TARGET IIDMA Target link speed option is not supported with U
172. e value PortState value gt lt InterconnectElement gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The InterconnectElement InterconnectElement sequence repeats for each interconnect element SN0054614 00 F B 25 B XML Format 2 XX Display System Information Command Line Option g QLOGIC m S Notes B 26 SN0054614 00 F Appendix C Interactive Exit Codes To list the exit codes while running SANsurfer FC HBA CLI in interactive mode 1 From the Main Menu select the Help option and then press ENTER 2 On the Help Menu select Exit Codes and then press ENTER The CLI lists the exit code numbers names and descriptions as shown in Table C 1 To see non interactive error codes see Appendix D NOTE Exit codes are continually being updated Although Table C 1 was accurate at the time this document was written you should check for the latest exit codes in the file Fcscli exicodes txt located in the SANsurfer FC HBA CLI installation directory Table C 1 Exit Code Descriptions Interactive Mode Return Tm Code Name Description 0 SUCCESS Command executed with no error 1 ERROR OPEN FILE ERROR READ FILE ERROR WRITE FILE ERROR CLOSE FILE ERROR INCORRECT FILE ERROR INCORRECT FILE SIZE ERROR UNSUPPORTED HBA ERROR NO HBA ERROR UNKNOWN HBA ERROR INVALID SSID ERROR MISMATCH SSID o OA N O oa A C PD gt a Oo
173. e E eed 4 37 4 5 Target Link Speed or iiDMA Settings Menu Command Line Option q 4 38 4 5 1 Configuring the iiDMA Settings liliis 4 39 4 5 2 HBA Part Instance ete Fale Mada dues eh ogee o RE E REOR ad 4 40 4 5 3 FIBA PO cnc EE REGERE RR I eeaa pA ETE REN a oes 4 41 4 5 3 1 Advanced Configuration eee ie ERR Rete 4 42 4 5 4 Target Link Speed All HBAS ullssllslselesllssss 4 43 4 5 4 1 Target Link Speed All HBAs Basic Configuration 4 43 4 5 4 2 Target Link Speed All HBAs Advanced Configuration 4 43 4 5 4 3 DMA Settings Disk 0 000 eee ee 4 45 4 5 5 IDMA AIL HBAS ei nae ted exa eee eee ee eee ENS 4 45 4 6 Target Persistent Bindings Menu Command Line Option p 4 45 4 6 1 Target Persistent Bindings Per HBA Port Command Line Option Phi ie toe eto ep P Ea dn cer Ug ae ee oves 4 46 4 6 1 1 Display Target Persistent Binding Command Line ODUOIeD S edes dece a cs rt edes e Rot e dete 4 46 4 6 1 2 Target Persistent Bindings Bind Target s Command Line Option p sioe Tee EC reg RO enbriqe rx ds Rs She 4 47 4 6 1 3 Target Persistent Binding Unbind Targets Command Line POM DI oos dod acte oe ene en if aede ates attri aud bie sd UR uu 4 48 4 6 2 Target Persistent Binding All HBAS 0055 4 48 4 6 2 1 Display Target Persistent Binding 0 0 4 49 4 6 2 2 Target Persistent Binding Bind Targets
174. e auto generate vp lt hba instance gt lt hba wwpn gt Deletes a virtual port on a physical HBA port delete lt vport wwpn gt vp lt hba instance gt lt hba wwpn gt Deletes all virtual port s on a physical HBA delete all port vp lt hba instance hba wwpn gt Lists a specific virtual port on a physical HBA list lt vport wwpn gt port vp lt hba instance gt lt hba wwpn gt Lists all virtual ports on a physical HBA port list all SN0054614 00 F E 7 E Help Commands XX QLOGIC OO ee Table E 1 Help Commands Continued Command Line Arguments Function Action Xx B Writes the output in XML format 1 Option x can be used to generate an old style format that is compatible with previous releases XML format 1 This option can be combined with other options however this option must be at the beginning or at the end of the command line x2 Writes the output in XML format 2 Option x2 can be used to generate a new style format that is matched with standard text output XML format 2 This option can be combined with other options however this option must be at the beginning or at the end of the command line z lt hba instance gt lt hba wwpn gt Creates a summary report of individual HBA or lt all gt all HBAs in the current host E 8 SN0054614 00 F Glossary adapter See HBA AL PA Arbitrated Loop Physical Address A low level
175. e other parameters scli kr HBA Instance DP FF The following example sets the data size to 16 bytes and has the test loop if an error occurs The other parameters use the current values scli kr HBA WWPN gt DS 16 OE 2 An example of a successful read write buffer test follows HBA 1 QEM2462 Port 1 WWPN xx xXx Xx xX Xx xX Xx xx Port ID 02 0E 00 Test Configuration Data Pattern Random Data Size Bytes 512 Number of test s 0 65535 500 Test Increment 1 65535 odb On Error Ignore Test Continuous OFF Diagnostics Loopback Test Result Note Press Enter to stop the test any time HBA Test Data Pattern Status CRC Disparity FrameLength Active 1 B4 31 0E AA AD CF D5 B0 Success 0 0 0 kr HBA Instance lt HBA WWPN gt EX EXCLUDE Target WWPN Parameter Name Parameter Alias Parameter Value SN0054614 00 F 5 25 5 Non interactive Commands XX Command Summary QLOGIC E ee 5 3 18 2 Run HBA Diagnostics Read write Buffer Test The ex exclude Target WWPN parameters specify a device that will be excluded from the read write buffer test The system shows the following information after a read write buffer test completes Loop ID status Data miscompare Link failure Loss of sync Loss of signal Invalid CRC Table 5 8 lists the Parameter Name Parameter Alias and Parameter
176. e test increment cannot be larger than the number of tests run see section 5 3 16 3 OnError OE 5 20 For the loopback test OnError is either OE Parameter Value OnError Parameter Value This parameter determines how errors are handled Table 5 6 lists the valid values SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary ls Table 5 6 OnError Values Value Description 0 The error is ignored This is the default value 1 The test stops on error 2 On error the data pattern and test repeat until the error is cleared 5 3 16 6 Run a Loopback Test The loopback test sends and receives messages through a loopback or through an echo command to the switch NOTE The loopback test is disabled if you are using the drivers from the OS installation NOTES Run an echo test instead of a loopback test under the following conditions m You have a QLA23xx QLA24xx QLE23xx or QLE24xx HBA that is connected to the fabric through a point to point connection F port B The HBA is connected to a switch B Your operating system has one of the driver versions listed in Table 5 7 Table 5 7 lists the operating system driver versions that do not require a loopback connector Table 5 7 Driver Versions Not Requiring a Loopback Connector Operating System Driver Version Windows XP Windows 2000 or Windows Server 2003 with SCSI 9 0 0 12 miniport driver
177. eady to Install the Program The wizard is ready to begin installation Click Install to begin the installation If you want to review or change any of your installation settings click Back Click Cancel to exit the wizard InstallShield S Cancel Figure 3 4 Ready to Install the Program Dialog Box 4 Read the information and then click Install The Setup Status dialog box appears as shown in Figure 3 5 SANsurfer FC CLI InstallShield Wizard Setup Status SANsurfer FC CLI is configuring your new software installation C QLogic Corporationi SAN surferCLI nvramdefs x0003 nvram dat KARARDA InstallShield Figure 3 5 Setup Status Dialog Box 3 4 SN0054614 00 F XKX 3 Initial Installation QLOGIC Installing SANsurfer FC HBA CLI o O 98 IUINAGSSIIEIE EINSNESEEUCULEI If you want to stop the installation click Cancel The InstallShield Wizard Complete dialog box appears as shown in Figure 3 6 SANsurfer FC CLI InstallShield Wizard InstallShield Wizard Complete Setup has finished installing SANsurfer FC CLI 1 06 16 Build 57 on your computer would like to launch SANsurfer FC CLI Click Finish to complete Setup lt Back Cancel Figure 3 6 InstallShield Wizard Complete Dialog Box 5 Optional Select one of the following E If you want to see more information about SANsurfer FC HBA CLI select the I would like to view the README f
178. ed with the parameter you want to change b Enterthe parameter value C Toreturn to the previous menu type 7 from the Read Write area or type 7 from the Loopback area 7 Type the number to run the loopback or read write buffer test The following warning message appears Warning The Diagnostic Loopback and Read Write Buffer tests require that the HBA has no outstanding input and output operations Please make sure there is no active I O before starting the test s Do you want to do the test s 1 Yes 2 No Type 1 to proceed or 2 to cancel the operation Here is an example of using the Diagnostics option to run a loopback test From the Main Menu link Enter Selection 13 SANsurfer FC HBA CLI vl x x Build x 4 68 SN0054614 00 F XX 4 Interactive Commands QLOGIC Diagnostics Menu Command Line Options kl kr and dm Diagnostics Menu 1 Loopback Test 2 Read Write Buffer Test 3 Transceiver details Note 0 to return to Main Menu Enter Selection 1 SANsurfer FC HBA CLI vl x x Build x Diagnostics Menu HBA Model QLA2300 2310 1 Port 1 WWPN XX XX XX XX XX XX XX XX Loop down HBA Model QEM2462 2 Port 1 WWPN XX XX XX XX XX XX XX Xx Online 3 Port 2 WWPN XxX XX XX XX XX XX XX XX Online HBA Model QLA210 4 Port 1 WWPN XxX XX XX XX XX XX XX XX Online Note 0 to return to Main Menu Enter Selection 2 SANsurfer FC HBA CLI vl x x Build
179. enerate 2 User Generate 3 Return to Previous Menu 4 86 SN0054614 00 F XX 4 Interactive Commands QLOGIC Help Menu Command Line Option h ls 4 14 1 3 1 Auto Generate 14 Virtual gt 1 Virtual Menu 3 Create a Virtual Port 1 Auto Generate When you select this option the system creates a Virtual Port on this HBA physical port and reports the WWPN of the virtual port For example Virtual Port 21 00 25 E0 8B 14 5A CF created successfully on HBA instance 4 To see the change to the virtual ports you must manually refresh the configuration Note that the second hexadecimal digit changes on the newly created virtual port 4 14 1 3 2 User Generate 14 Virtual gt 1 Virtual Menu 3 Create a Virtual Port 2 User Generate When you select this option you are prompted to enter a hex digit for the new virtual port WWPN This new hex number is assigned to the second field of the physical HBA port WWPN Enter Hex Pattern xx Type two hexadecimal digits The system creates the new Virtual Port for example Create Virtual Port Menu Enter Selection 2 Enter Hex Pattern Xxx EF The system returns Virtual Port 21 00 EF 8B 14 5A CF created successfully on HBA instance 4 Note that the entered hex digits EF now appear in byte 2 of the new Virtual Port WWPN To see the change to the virtual ports you must manually refresh the configuration 4 15 Help Menu Command L
180. eral Information option and then press ENTER The General Information menu contains the following options a Host Information Host Topology Report Refresh 4 1 1 Host Information Command Line Option g 1 General Information 1 Host Information This option shows you host information From the Main Menu type the number for General Information and then press ENTER From the General Information Menu type the number for Host Information and then press ENTER Host information includes the following data E Host name B OStype 4 2 SN0054614 00 F XX 4 Interactive Commands QLOGIC General Information Menu Command Line Option g ls OS version patches where applicable SDM API version A list of HBAs including for each HBA C HBA model and serial number SN Port number Ch WWPN HBA Instance number LC Status online offline QO Repeats for each HBA W X Total number of QLogic HBAs detected NOTE The SAN Device Management SDM API is a QLogic specific library required for SANsurfer FC HBA CLI The version number of this library is useful in debugging Host Name BRAGI OS Type Microsoft Windows Svr 2003 Enterprise Ed x86 OS Version Service Pack 1 Build 3790 SDM API Uersion 1 28 0 50 QLSDM DLL HBA Model QLA2342 SN C28750 F 1 WWPN 21 00 00 E0 8B 01 43 9B SN B05283 HBA Instance 0 Online Port 2 WWPN 21 01 00 E0 8B 21 43 9B SN B05283 HBA Instance 1 Online H
181. erved Not used 265 Reserved Not used 266 Reserved Not used 267 Reserved Not used 268 Reserved Not used 269 Reserved Not used 270 ERROR ADAPTER PROP MISSING Adapter property file is missing 280 ERROR CREATE VIRTUAL PORT Failed to create a virtual port of the HBA 281 ERROR DELETE VIRTUAL PORT Failed to delete a virtual port of the HBA 282 ERROR INVALID VIRTUAL PORT WWN Virtual port WWPN is invalid 283 ERROR VIRTUAL PORT NOT FOUND Unable to find the specific virtual port 284 ERROR NO VIRTUAL PORT EXIST This HBA does not have any virtual ports 285 ERROR DELETE ALL VIRTUAL PORTS Failed to delete all virtual ports of the HBA C 12 SN0054614 00 F Appendix D Non interactive Error Codes To list the SANsurfer FC HBA CLI non interactive error codes from the command line type scli ei To see the interactive exit codes see Appendix C Table D 1 Error Code Descriptions Non interactive Mode Code Name Description 0 SUCCESS Command executed with no error 1 ERROR OPEN FILE Failed to open file 2 ERROR READ FILE Failed to read file 3 ERROR WRITE FILE Failed to write to a file 4 ERROR CLOSE FILE Failed to close a file 5 ERROR INCORRECT FILE Selected file is incorrect 6 ERROR INCORRECT FILE SIZE File size is incorrect 7 ERROR UNSUPPORTED HBA HBA is unsupported 8 ERROR NO HBA Unable to open the HBA handle 9 ERROR UNKNOWN HBA HBA is unknown to SANsurfer FC HBA CLI 10 ERROR INVALID SSID HBA has invalid SSD
182. es not match with HBA 28 Reserved Internal used 29 ERROR FLASH CSUM MISMATCH Flash file has checksum mismatched 30 ERROR INCORRECT RISC CODE FILE Incorrect RISC image 31 ERROR INCORRECT BOOT CODE FILE Incorrect BIOS FCode boot image 32 ERROR INCORRECT FULL IMAGE FILE Incorrect 1M Flash image 33 ERROR CORRUPTED FLASH IMAGE FILE Flash image file is corrupted 34 ERROR FLASH UPDATE FAILURE Failed to update flash 35 ERROR FLASH GET REGION FAILURE Failed to read flash update region from HBA 36 ERROR FLASH UPDATE NO VALID _ Failed to validate flash update region read REGION from HBA C 2 SN0054614 00 F XX QLOGIC ls C Interactive Exit Codes Table C 1 Exit Code Descriptions Interactive Mode Continued Return ne Code Name Description 37 ERROR FLASH UPDATE NO REGION HBA does not have flash update region lay LAYOUT out 38 Reserved Not used 39 Reserved Not used 40 ERROR DIAGNOSTICS PARAM ERROR Diagnostics test returns invalid parameters 41 ERROR DIAGNOSTICS LOOP DOWN Unable to run diagnostics because the loop is down 42 ERROR DIAGNOSTICS FAILURE Diagnostics test failed with errors 43 ERROR DIAGNOSTICS DATA MISCOM Diagnostics test failed with data miscompare PARE 44 ERROR DIAGNOSTICS UNKNOWN Unknown diagnostics test status STATUS 45 ERROR DIAGNOSTICS NO AVAIL Unable to run R W buffer test because there TARGET are no attached devices 46 ERROR DIAGNOSTICS NOT FOUND
183. et World Wide Port Name format XX XX XX XX XX XX XX XX Or XXXXXXXX targets t All targets 4 5 1 Configuring the iiDMA Settings Use the Intelligent Interleave Factor Selection iiDMA menu to select the intelligent interleave factor settings per HBA type and device To configure iiDMA settings 1 From the SANsurfer FC HBA CLI main menu select iiDMA Settings 2 Select the HBA that you want to apply the Intelligent Interleave factor update 3 Select one of the following options CQ Basic Configuration if you want to apply the Intelligent Interleave factor update to all devices attached to this adapter CL Advanced Configuration if you want to select an apply different Intelligent Interleave factor update to each device attached to this adapter SN0054614 00 F 4 39 4 Interactive Commands XX Target Link Speed or iiDMA Settings Menu Command Line Option q QLOGIC EENENNNNNM 4 To use Basic Configuration a Select the HBA b Select the intelligent interleave factor from the intelligent interleave factor speed list 1 Gbps 2 Gbps 4 Gbps or 8 Gbps to all attached devices c Choose one of the following options Q To apply the new settings to all attached devices select Yes The following is returned iiDMA settings have been saved to selected target s on HBA instance n CQ Toexit iiDMA Settings without making any changes select No 5 Touse Advanced Configuration a Sele
184. et s All LUN s 4 4 2 1 Individual Target 4 Target LUN List N AIlHBAs 1 Individual Target SN0054614 00 F 4 33 4 Interactive Commands XX Target LUN List Menu Command Line Options t and l QLOGIC A S This choice shows the Target List Menu for All HBAs Information for each individual target includes W Target type on QLAxxxx HBA Instance n Vendor Product ID Product Revision Serial Number Port Name Port ID W Repeats for each target DODCDLULC Here is an example of the Target List Menu for All HBAs 1 Disk 0 on QLA2462 HBA Instance 0 Vendor SEAGATE Product ID ST336607FC Product Rev 0006 Serial Number 3JA9TN7600007517T6P1 Port Name 22 00 00 11 C6 2D 5B F9 Port ID 02 0A DC 1 Disk 1 on QLA2462 HBA Instance 0 Vendor SEAGATE Product ID ST336607FC Product Rev 0006 Serial Number 3JA9TN7600007517FK7W Port Name 22 00 00 11 C6 2D 5A B8 Port ID 02 0A EO And so on 4 4 2 2 Individual LUN 4 Target LUN List gt n PortNumber 1 IndividualLUN 1 n Target When you select an individual target the following target information appears Path Target Device ID Product Vendor Product ID Product Revision Node Name Port Name Product Type LUN Count s 4 34 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target LUN List Menu Command Line Options t and l N B Status Here is an example of the Ta
185. evice information set up in the HBA parameters updating the HBA parameters from a file may result in changing that information If you wish to preserve the boot device information please either update the file with the correct boot device settings before the HBA parameters update or re configure the boot settings after the update Do you want to proceed with the operation 1 Yes 2 No If you enter 1 to proceed the system returns a message similar to the following Restoring default settings on HBA instance 5 QLA2462 Please wait HBA Parameters restore completed Changes has been saved to HBA instance 5 You must reboot in order for the changes to becom ffectiv 4 3 2 HBA Parameters All HBAs 3 HBA Parameters gt n All HBAs When you select this option the parameters listed in HBA Parameters Per HBA Port on page 4 22 appear for every HBA SN0054614 00 F 4 29 4 Interactive Commands XX Target LUN List Menu Command Line Options t and l QLOGIC ee 4 4 Target LUN List Menu Command Line Options t and l 4 Target LUN List This option shows the main Target List Menu which includes a list of all HBAs and port instances detected on the host You have the option to select m Fach HBA port individually B All HBAs Here is an example of the Target List Menu HBA Model QLA2342 HBA Model QLA2300 HBA Model QLA2462 HBA Model
186. f Option ROM Update menu in the example text In non interactive mode added new a11 parameter following the boot parameter Save Update NVRAM r In interactive mode 4 11 removed the secondary subtitles of the NVRAM Update Menu in the example text SN0054614 00 F Page ix SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC E G V k WAMwWS LVA Notes Page x SN0054614 00 F Table of Contents Section 1 Introduction 1 1 Prod ct OVvervieWws cs 0 063 see ob daw ea ir MR buh feta a DEG Pd 1 1 1 2 GUIdE OVERVIEW ia vl fp Bo ARR es Sa SS yh LR BE S 1 1 1 2 1 How this Guide is Organized ase eer e REN eS 1 1 1 2 2 Documentation Conventions llle 1 2 1 3 Supported QLogic HBAS ve RERO oe baw TEES 1 4 1 4 Supported Operating Systems 0 cee ee ee eee 1 4 1 5 System Requirements 00 02 cee eee eee 1 5 1 5 1 Hardware Requirements 000 0c eee eee eee 1 5 1 5 2 Software Requirements 2 0042 cores Sees Gee Gee Pete eed we 1 6 1 5 2 1 Unsupported Features 2000 e eee ee 1 6 1 6 Technical SUDBDOF arem ben Me IRR thei ca en eae ean eh eae ed 1 7 1 6 1 Availability x i255 4 1 9 158 rca 130208 amp Ba ce ale HD bow a Feats a 1 8 1 6 2 PANIC sS texere baee Pp deo eta scq ets ria Dy gag ey Bee 1 8 1 7 Contact Information ebd RR exce eR era x ey vorne ds 1 8 Section 2 Getting Started 2 1 INTROD
187. formation Command Line Option g QLOGIC E C O B m scli p HBA Instance HBA WWPN gt all view x2 The XML Format 2 for the adapter target persistent binding information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value lt TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value HBA Status n lt Status gt Reboot n Reboot QLogic The lt HBA gt HBA sequence repeats for each HBA The Target binding sequence repeats for each bound target B 8 7 Display Device List Command Line Option t The command format is scli t HBA Instance HBA WWPN all x2 The XML Format 2 for adapter device information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value Target lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt I
188. get Link Speed Menu HBA Instance 0 QLA2463 Port 1 Online Desc QLA2462 PCI X 2 0 to 4Gb PC Dual Channel Apply Changes to Selected Target s 5 iiDMA Settings gt 1 n HBA Portn 1 Disk Vendor SEAGATE Product ID ST318453FC Product Rev DF12 Serial Number 3EVONYSGOO0072496DYD Port Name 22 00 00 04 CF 9C 24 CA Port ID 02 00 E1 ax Target Link Rate 4 Gbps 22 Dusk Vendor SEAGATE Product ID ST318453FC Product Rev 00006 Serial Number 3JA9AYSGOO00072496FBJ Port Name 22 00 00 0C 50 68 1E 9A Port ID 11 0A E2 ax Target Link Rate 4 Gbps m Disk Vendor SEAGATE Product ID ST318453FC Product Rev 0006 Serial Number 3JA9TQE00007249662ZK Port Name 22 00 00 11 C6 2D 5A 3F Port ID 02 0A E4 ax Target Link Rate 4 Gbps If you select a port for HBA model QLA2462 the following information appears SN0054614 00 F 4 41 4 Interactive Commands XX Target Link Speed or iiDMA Settings Menu Command Line Option q QLOGIC EN PV 3ww m 9 amp amp iiDMA Menu HBA Instance 3 QLA2462 Port 2 Online WWPN 21 01 00 E0 8B A5 8C 7C Desc QLA2462 PCI X 2 0 to 4Gb FC Dual Channel 1 Disk Vendor SEAGATE Product ID ST136403FC Product Rev gt FESE Serial Number LT06464600001011HGGH Port Name 21 00 00 20 37 1A 6B CF Port ID 11 01 EA Intelligent Interleave Factor 4 Gbps 25 Disk Vendor SEAGA
189. getReset valu LUNsPerTarget value gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt For clarity each parameter is listed on a separate line however multiple parameters can be on the same line For multiple adapters repeat the above sequence with the ID number ID Number value of the next adapter A 2 3 Display HBA Information Command Line Option i NOTE 4G HBAs include VPD information as an option to the 1 command The XML Format 1 for adapter general information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt GenerallInfo Port value odel value HBAID value HBAAlias value HBAPort value PortAlias value WWNN value WWPN value Port ID value SerialNumber value DriverVersion valu BIOSVersion value FirmwareVersion valu TargetCount value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value A 4 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option ls PortType value Status value lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt Here is the information for the 4G HBAs lt xml version 1 0 encoding ISO 8859 1 gt lt QLogi
190. gic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt v1 7 0 Build 15 lt AppVersion gt AppXmlVersion 2 0 AppXmlVersion lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt MediaInformation gt lt Vendor gt value lt Vendor gt lt Type gt value lt Type gt lt PartNumber gt value lt PartNumber gt B 22 SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g ls lt Speed gt value lt Speed gt lt Revision gt value lt Revision gt lt SerialNumber gt value lt SerialNumber gt lt MediaInformation gt lt Diagnostics gt lt Temperature gt lt MeasuredTemperature gt C lt MeasuredTemperature gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt lt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt Temperature gt lt Voltage gt lt MeasuredVoltage gt V lt MeasuredVoltage gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt lt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt Voltage gt lt TxBias gt lt MeasuredTxBiasUnit gt mA lt Me
191. gt lt Parameter Value gt x2 The XML Format 2 for the read write buffer test results is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt Loop ID value DataMiscompare value LinkFailure value LossOfSync value LossOfSignal value InvalidCRC value Result value gt lt Target gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The lt Target gt lt Target gt sequence repeats for each target B 8 4 Display LUN List Command Line Option l The command format is scli 1 HBA Instance HBA WWPN gt x2 The XML Format 2 for the adapter LUN list information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt Target lt WWNN gt value lt WWNN gt lt WWPN gt value lt WWPN gt lt LUN ID value WWULN
192. icable Port Alias if applicable Driver Version if applicable Firmware version if applicable Total number of devices targets if applicable Host if applicable DOCODCOCDIDODOCDUCCO 4 5 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC E N amp O O 3 A Here is an example InterConnect Element Type HBA World Wide Node Name 20 00 00 E0 8B 03 55 7C World Wide Port Name 21 00 00 E0 8B 03 55 7C Vendor Id QLogic Corporation HBA Model 2200 HBA Serial Number C28437 HBA Alias Port Alias I Driver Version SCSI Miniport 8 1 5 15 W2K IP Firmware Version 2 2 02203 Total Number of Devices 0 Host BRAGI Number of Port pod Beacon status Unsupported Port Type gt L Port Port State Online InterConnect Element Type Switch World Wide Name 10 00 00 C0 DD 00 6A 9F Domain ID 4 0x4 Management ID 0 IP Address 10 3 10 178 Model Symbolic Name Serial Number AC Address Firmware Version Port Count 8 Beacon Status Unsupported Port Information Physical Port Number a al Port Name 20 00 00 C0 DD 00 6A 9F Port state Offline Port Type 7 BE CPOTU TX Port Type Electrical EL Port Module Type GBIC Physical Port Number EPA 4 6 SN0054614 00 F XX 4 Interactive Commands
193. ice settings SETTINGS 97 Reserved Not used 98 Reserved Not used 99 Reserved Not used 100 ERROR INVALID DRIVER PARAM Driver parameter settings is invalid 101 ERROR READ DRIVER PARAM Failed to read current driver settings of the HBA 102 ERROR DRIVER PARAM NOT FOUND Unknown driver parameter settings 103 Reserved Not used SN0054614 00 F C 5 C Interactive Exit Codes XX QLOGIC E ee Table C 1 Exit Code Descriptions Interactive Mode Continued Return nsa Code Name Description 104 Reserved Not used 105 Reserved Not used 106 Reserved Not used 107 Reserved Not used 108 Reserved Not used 109 Reserved Not used 110 ERROR_DUPLICATE_TARGET_ID Target has duplicate ID 111 ERROR INVALID TARGET ID Target has invalid ID 112 ERROR MISMATCH TARGET ID Target has mismatch ID 113 ERROR READ FROM DRIVER Failed to read persistent binding data from driver database 114 ERROR READ FROM PERSISTENT Failed to read persistent binding data from STORAGE persistent database 115 ERROR MEMORY ALLOC FAILURE Unable to allocate memory 116 ERROR TARGET ENTRY NOT FOUND Unable to find the binding entry of the speci fied target 117 ERROR DELETE TARGET PERSISTENT Failed to delete target persistent binding ENTRY 118 ERROR LUN NOT FOUND The specified LUN ID not available 119 ERROR NO DEVICE FOUND HBA does not have attached devices 120 ERROR OPTION UNSUPPORTED DRV Option is not available with running driver 121 ERROR OPTION
194. id HBA serial number 81 ERROR GET NVRAM DATA Unable to read NVRAM from HBA 82 ERROR UPDATE NVRAM DATA Failed to update HBA parameters 83 ERROR PRESERVE NVRAM DATA Failed to preserve HBA parameters 84 ERROR MISSING NVRAM TEMPLATE FILE Unable to find the NVRAM template for the HBA 85 ERROR INVALID HBA Specified key value to program Parameters PROG OPTION NVRAM are invalid 86 Reserved Not used D 4 SN0054614 00 F XX QLOGIC o 9 9 97 a D Non interactive Error Codes Table D 1 Error Code Descriptions Non interactive Mode Continued SN0054614 00 F Code Name Description 87 Reserved Not used 88 Reserved Not used 89 Reserved Not used 90 ERROR READING BOOT DEVICE Failed to read boot device settings of the HBA 91 ERROR SAVING BOOT DEVICE Failed to save boot device settings to the HBA 92 ERROR BOOT CONFIG DISABLED DRIVER Boot device settings is disabled with running driver 93 ERROR BOOT TARGET NO LUN Boot device setting aborted because the boot target has no LUN 94 ERROR TARGET NO DIRECT ACCESS Boot device settings failed because the boot target not a direct access device 95 ERROR INVALID BOOT SETTINGS Boot device parameters is invalid incorrect 96 ERROR UNSUPPORTED BOOT SETTINGS Unsupported boot device settings 97 Reserved Not used 98 Reserved Not used 99 Reserved Not used 100 ERROR INVALID DRIVER PARAM Driver parameter settings is invalid 101 ERROR READ DRIV
195. ified in a command only the first one is processed These options however can be combined with one or more options that do not have a corresponding menu selection with the exception of F For all command line options SANsurfer FC HBA CLI shows the following when there are errors in the command line input Error error message SANsurfer FC HBA CLI vl x x Build xx Copyright 2003 2007 QLogic Corp All rights reserved Command Line QLogic FC Host Bus Adapters description of command entered Usage current command use usage SN0054614 00 F PRELIMINARY 2 5 2 Getting Started XX Terminology QLOGIC E ee 2 4 Terminology Some of the terms used in this guide are similar and some have changed slightly as technology changes The following definitions apply HBA Port HBA Port refers to the actual physical port on an HBA For example a QLA2462 has two ports called HBA port 1 and HBA port 2 HBA Instance HBA Instance number or HBA Port Instance When you install HBA in a system with other HBAs each HBA port gets assigned a number by the driver or API so it knows which HBA to communicate with This assigned number might be called HBA Instance HBA instance number or HBA Port Instance HBA Alias When an alias is assigned to a physical HBA no matter how many ports that HBA has the HBA Alias refers to the HBA not one of its ports Port Alias You can also assign an alias to an individual port on an HBA
196. ile check box W f you want to start SANsurfer FC HBA CLI select the I would like to launch SANsurfer FC CLI check box 6 Click Finish 3 2 1 2 Command Line Installation To install SANsurfer FC HBA CLI using the command line installation follow the steps for either standard or silent installation Standard installation See section 3 2 1 2 1 E Silent installation See section 3 2 1 2 2 3 2 1 2 1 Standard Command Line Installation Type the following text for a standard installation of SANsurfer FC HBA CLI on a Windows operating system where xx indicates the version of SANsurfer FC HBA CLI scli 1 x x xx windows exe SN0054614 00 F 3 5 3 Initial Installation XX Installing SANsurfer FC HBA CLI QLOGIC ee By default SANsurfer FC HBA CLI is installed in the following directory Program files QLogic Corporation SANsurferCLI If you want to change the default location enter the directory in the command line for example scli 1 x x xx windows exe installdir c sansurfercli 3 2 1 2 2 Silent Command Line Installation The command for a silent installation is the same as for a standard installation see section 3 2 1 2 1 with the addition of the command parameters listed in Table 3 2 Examples using these parameters follow the table Table 3 2 Windows Command Line Installation Parameters Parameter Meaning Description v Record mode To run the SANsurfer FC HBA CLI installation package in silent m
197. indows and Linux Firmware Version Flash BIOS Version Flash FCode Version Flash EFI Version Flash Firmware Version Actual Connection Mode Actual Data Rate PortType Topology Target Count PCI Bus Number Windows and Linux PCI Device Number Windows and Linux HBA Status online offline M HBA VPD Header Vital Product Data Information for QLA QLE24xx only HBA Instance HBA Type Port Number WWPN Port ID H The actual VPD information DODCDDCOCDODCODODDCODUDOOCDODOODUCCUO ODODO Product Identifier Part Number Serial Number Misc Information for example PCI and PCI X speeds Manufacturing ID EFI Driver Version Firmware Version BIOS Version Windows and Linux FCode Version Solaris DOCODDICUOLD 4 10 SN0054614 00 F XX 4 Interactive Commands QLOGIC General Information Menu Command Line Option g ls B HBA Parameters Settings Header Command Line Options c HBA Instance HBA Part Number Port Number WWPN Port ID DOCOLD B HBA Parameter Settings Connection Options Data Rate QLA23xx QLA24xx QLE23xx and QLE24xx HBAs Frame Size Hard Loop ID Loop Reset Delay in seconds Enable Host HBA BIOS Enable Hard Loop ID Enable FC Tape Support Operation Mode Interrupt Delay Timer Execution Throttle Login Retry Count Port Down Retry Count Enable LIP Full Login Link Down Timeout in seconds Enable Target Reset LUNs Per Target Enable Receive Out Of
198. ine Option h 14 or 15 Help When you enter this option the Help Menu appears with the following options a Contents is Exit Codes SN0054614 00 F 4 87 4 Interactive Commands XX Help Menu Command Line Option h QLOGIC EX B About Type the number for the option you want and press ENTER 4 15 1 Contents 14 or 15 Help gt 1 Contents When you select the Contents option SANsurfer FC HBA CLI shows the entire Help menu You can see the help menu options rearranged into alphabetical order in Appendix E 4 15 2 Exit Codes 14 or 15 Help gt 2 Exit Codes When you select the Exit Codes option SANsurfer FC HBA CLI shows the entire list of exit codes You can see the exit codes in Appendix D 4 15 3 About 14 or 15 Help 3 About When you select the About option SANsurfer FC HBA CLI shows the following information about this tool W Product name Version and Build number Copyright information All rights reserved Full Name Build Type Build Date 4 88 SN0054614 00 F Section 5 Non interactive Commands 5 1 Introduction This section contains the information in the help to view help enter the command h plus additional explanation and examples Each command line option is listed followed by a command description and examples of the command in use and typical responses from the system 5 2 Display System Information Command Line Options g z and tp When you enter one of
199. interactive mode options that have a corresponding interactive mode option see Table 5 1 This option must be the first or last command in the command line In non interactive mode the system shows result and status messages generated by SANsurfer FC HBA CLI by default unless suppressed by silent mode You can combine this option with the o option see section 5 3 23 so the output is saved in a file and does not appear on screen For example scli I all s o output txt 5 38 SN0054614 00 F XX 5 Non interactive Commands QLOGIC Command Summary ls 5 3 29 t Display Target Information To show the target information for a HBAs in the system type scli t all To show the target information for a specific HBA type scli t HBA Instance HBA WWPN gt To show specific target information for a specific target on an HBA type scli t HBA Instance HBA WWPN gt Target WWPN Target Port ID Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Target WWPN World wide port name of the target Target Port ID Port ID of the target To show the target information on all HBAs type t lt all gt To show the target information on a specific HBA type t lt HBA Instance gt lt HBA WWPN gt To show the target information for a specific target on a specific HBA type t lt HBA Instance gt lt HB
200. iption Name Alias Value Sets link status retrieval period AutoPoll AP 0 256 cycles Sets link status retrieval polling interval PollRate SR 5 30 seconds Save link status to CVS log file LogToFile LF Log file name a When the AutoPoll parameter is 0 the link status is retrieved automatically until the user aborts the operation When the AutoPoll parameter is in the range of 1 256 the link status is retrieved for the number of cycles specified by this value 5 3 21 M View Enable or Disable LUNs NOTES W fthe current driver setting is Bind by Port ID this option is not available M Under Solaris if you use the driver from the OS installation CDs QLC driver this feature is disabled W Under Linux if you use the ioctl or sysfs inbox driver this feature is disabled M Under Solaris the QLA HBA driver supports a maximum of 256 LUNs Under Solaris the QLC HBA driver supports a maximum of 16K LUNs B You must persistently bind the targets before configuring selective LUNs link Use the m command to B View all selective LUNs for all HBA ports 1 View an HBAs selective LUN list 2 View the current selective state of a LUN on a specific target 3 Enable select a LUN on a specific target on a specific HBA 4 SN0054614 00 F 5 29 5 Non interactive Commands XX Command Summary QLOGIC ee Disable deselect a LUN on a specific target on a specific HBA 5 Enable
201. ired drivers include W Host Adapter Module HAM HAM is the driver component associated with the host adapter hardware It provides the functionality to route requests to the bus where a specified device is attached W Custom Device Module CDM The drive component associated with storage devices It provides the functionality to build device specific commands from I O messages received from NetWare s Media Manager E Port Expansion Port A port in an FC switch that connects to another FC switch or bridge device by an inter switch link E ports are used to link FC switches to form a multi switch fabric echo diagnostic test Transmits a received signal back to the sender to verify the integrity of the device SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls F_Port The Fabric port in a FC fabric switch provides a point to point link attachment to a single N_Port F_Ports are intermediate ports in virtual point to point links between end ports for example N Port to F Port to F Portto N Port using a single FC fabric switch fabric A fabric consists of cross connected FC devices and switches fabric switch Also Switched Fabric A fabric switch connects multiple devices from indepen dent FC arbitrated loops FC ALs and point to point topologies into a fabric using FC switches Fast UTIL QLogic Fast UTIL FC HB
202. ize is 512 For a loopback test on Linux OSs the maximum size is 65535 the default size is 512 O test continuously 1 10 000 and 1 65535 total number of tests that will be executed Must be less than the TestCount value Table 5 9 Data Pattern DP Test Patterns Hex 00 55 5A A5 AA FF Binary 00000000 01010101 01011010 10100101 10101010 11111111 If the read write buffer test fails the system shows the following information B Loop port ID the loop ID of the HBA when operating in loop mode B Status QO Success The test passed Q Error A data miscompare or link status firmware error occurred Q Failed A link status error SCSI write buffer error or SCSI read buffer error occurred Unknown The target was not present CQ Unsupported The device does not support this test B Data Miscompare The possible values are ODODO 0 no data miscompares Device not present Get link status failed Read buffer failed R W buffer not supported SN0054614 00 F 5 27 5 Non interactive Commands XX Command Summary QLOGIC o X X L Write buffer failed Link Failure Number of link failures Loss of sync Number of sync loss errors Loss of signal Number of signal loss errors Invalid CRC Number of invalid CRCs 5 3 19 l Display LUN Info This command shows LUN information for W AIHBAs B Aspecific target B A specific L
203. le for example sethba0 txt and enter the following command in the text file n 0 co 2 dr 2 2 Save and close the file 3 Issue the scli command with the option input from command file scli f sethbaO txt scli f File Name SANsurfer FC HBA CLI specifies command line input from file 5 12 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary I 5 3 9 fg Show Driver Settings NOTE The g option is valid only in non interactive mode To show the driver settings type scli fg HBA Instance HBA WWPN gt view Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA 5 3 10 fs Configure Driver Settings Type the following command to configure the driver settings scli fs HBA Instance HBA WWPN gt Parameter Name Parameter Alias Param Value Where HBA Instance HBA instance number of an HBA port use g com mand to find HBA WWPN World wide port name of the HBA Parameter Name Name of the parameters Parameter Alias Alias of the parameters Parameter Value New value of the parameters The pairs lt Parameter Name gt lt Parameter Value gt and lt Parameter Alias gt lt Parameter Value gt can be repeated to set multiple parameters in a single command Table 5 3 lists the driver configuration parameter names and aliases Table 5 3 Driver Settings Parameters Alias Value
204. le or disable the BIOS boot setting When this setting is disabled the ROM BIOS on the HBA is disabled If you are booting from a FC hard disk attached to the HBA you must enable this setting The default is disabled 4 3 1 2 7 Enable HBA Hard Loop ID 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters n Enable HBA Hard Loop ID This choice gives you the option to enable or disable the Hard Loop ID Type the number you want and press ENTER 4 3 1 2 8 Enable Fibre Channel Tape Support 3 HBA Parameters gt N PortNumber 2 Configure HBA Parameters n Enable Fibre Channel Tape Support This choice gives you the option to enable or disable Fibre Channel Tape support Type the number you want and press ENTER 4 26 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Parameters Menu o 9 9 7 GIEEEEEEEEEEEEEU 4 3 1 2 9 Operation Mode 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters gt n Operation Mode This option shows the Operation Mode Menu From it you can select W Interrupt for every I O Completion a Interrupt when Interrupt DelayTimer expires W Interrupt when Interrupt Delay Timer expires or no active I O Type the number for the Operation Mode you want and press ENTER 4 3 1 2 10 Interrupt Delay Timer 3 HBA Parameters gt N PortNumber 2 Configure HBA Parameters n Interrupt Delay Timer This choice gives you the option to set the Interrupt
205. lears the selected current boot device set disable prim altl alt2 tings on an HBA port prim alt1 alt2 or alt3 a1t3 Boot Port Name Configures all LUNs of all devices attached to an HBA port Disable e lt hba instance lt hba wwpn gt Clears the selected current boot device set disable prim altl alt2 tings on an HBA port prim alt1 alt2 or alt3 a1t3 Boot Port Name e hba instance hba wwpn Configures the operating system to boot from target wwnn target wwpn a specific target ud prim altl alt W prim Primary Boot Port Name alt E alti Alternate 1 Boot Port Name E alt2 Alternate 2 Boot Port Name E alt3 Alternate 3 Boot Port Name e hba instance hba wwpn Configures the operating system to boot from target wwnn target wwpn a specific target E prim altl alt W prim Primary Boot Port Name alt E alti Alternate 1 Boot Port Name E alt2 Alternate 2 Boot Port Name E alt3 Alternate 3 Boot Port Name e view Shows the current boot device information on all HBAs e view Shows the current boot device information on all HBAs ei Lists the exit codes f lt file name gt Executes from a command input file Option f cannot be combined with any other options fg lt hba instance hba wwpn Shows the current driver settings view E 3 E Help Commands XX QLOGIC E ee Table E 1 Help Command
206. les serial o p 0x1 RATE SELECT implemented 0x1 SN0054614 00 F 4 73 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC BR max 0x00 BR min 0x00 Vendor SN AZ8P72890H23 Date code 070709 Diag Monitoring Type Address change required 0x0 Power Measurement 0x1 Externally Calibrated 0x0 Internally Calibrated 0x1 Digital diag monitoring 0x1 Legacy diagnostic 0x0 Enhanced Options Soft RATE_SELECT ctrl amp monitoring 0x0 Soft RX_LOS monitoring 0x1 Soft TX_FAULT monitoring 0x1 Soft TX_DISABLE ctrl amp monitoring 0x0 Alarm warning flags 0x1 SFF 8472 Compliance TBD CC_EXT 0x26 Vendor Specific Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Oxff Address A2 Temp High Alarm 0x5f00 Temp Low Alarm Oxf601 Temp High Warning 0x5500 Temp Low Warning Oxfb01 Voltage High Alarm 0x8dcc Voltage Low Alarm 0x7404 Voltage High Warning 0x8b10 Voltage Low Warning 0x76c0 Bias High Alarm 0x1194 Bias Low Alarm 0x03e8 Bias High Warning 0x109a Bias Low Warning 0x03e8 TX Signal Power High Alarm 0x1a68 TX Signal Power Low Alarm 0x03e8 TX Signal Power High Warning 0x1938 TX Signal Power Low Warning 0x0746 RX Signal Power High Alarm 0x2710 RX Signal Powe
207. line parameters and the SANsurfer FC HBA CLI version type the following scli h Or scli In Solaris SPARC include double quotes around the view option if the system is running with a csh or tsch shell For example scli e 0 For world wide node name WWNN world wide port name WWPN and port ID parameter inputs SANsurfer FC HBA CLI accepts the notation with and without the dash Hexadecimal values can be uppercase or lowercase The following input formats are valid for the WWNN and WWPN 20 00 00 E0 8B 01 83 C4 200000E08B0183C4 The following inputs are valid for the port ID 68 5C AB 685CAB All command line options must be preceded by the dash or forward slash notation Most options have a corresponding menu selection in interactive mode The valid command line options are listed in Table 2 1 SN0054614 00 F PRELIMINARY 2 3 2 Getting Started XX Starting Non interactive Mode QLOGIC E Se Table 2 1 Non interactive Mode Options CLI P Hed Hat SuSE Interactive m Option Menu Linux Solaris Menu Description Section Windows SPARC Macintosh a 11 11 11 Flash HBA beacon 5 3 1 b 10 10 m Save update BIOS FCode 5 3 2 b c 2 2 2 Show HBA settings 5 3 3 d 10 10 Update driver 5 3 4 qM 12 12 12 Transceiver details 5 3 9 e 8 8 8 Boot device settings 5 3 6 f Input from a file 5 3 8 fg 9 9 9 View Driver Settings 5 3 9 fs 9 9 9 Driver Settings 5
208. lligent Interleave Factor settings 4 38 5 39 iiDMA settings 4 38 configuring 4 39 iiDMA Settings Menu 4 38 information general 4 2 HBA 4 17 HBA host 4 2 system 5 14 target viewing 5 39 input from text file 5 5 5 12 input output control ioctl definition of Glossary 4 installation downloading package 3 2 Linux 3 7 Macintosh 3 11 package downloading 3 2 prerequisites of 3 1 Index 5 SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC EN PVhk V P installation continued Solaris 3 8 Solaris SPARC 8 9 10 3 8 Solaris x86 9 10 3 9 Windows 3 2 instance number 5 6 port definition of Glossary 6 interactive mode 4 1 See also non interactive mode definition of 2 1 exit codes 4 88 C 1 starting 2 1 4 1 interconnect element viewing details 4 4 interrupt delay timer 4 23 4 27 InterruptDelayTimer parameter 5 32 IOCB definition of Glossary 4 ioctl input output control definition of Glossary 4 ioctl driver 4 4 ioctl module driver features unavailable with 1 7 italicized text meaning of 1 3 J JBOD Just a Bunch of Disks definition of Glossary 4 K kl 4 62 4 63 5 17 5 21 A 9 B 13 kr 4 62 4 66 5 23 5 24 A 9 B 13 L 4 18 4 30 5 5 5 28 A 7 B 14 L Port Loop Port definition of Glossary 4 L1 cache Glossary 1 L2 cache Glossary 1 Leaf driver level definition of Glossary 2 Index 6 LED locating HBA 4
209. ls Temperature Voltage Tx Bias Tx Power Rx Power C V mA mW mW Value 34 17 3333 5 86 0 498 1 174 Status Normal Normal Normal Normal Normal High Alarm 95 00 3 63 9 00 0 676 4 000 High Warning 85 00 3 56 8 50 0 646 2 832 Low Warning 5 00 3 04 2 00 0 186 0 200 Low Alarm 10 00 2 91 2 00 0 100 0 100 4 12 3 2 Transceiver Details Details Select the Details option on the Transceiver Details menu to view detailed information for the selected HBA port The following shows an example I HBA Instance 4 QLE2562 Port 2 WWPN 21 01 00 1B 32 36 18 E PortID 01 0F 00 Optical Transceiver Digital Diagnostic Data Address AO Identifier SFP Ext Identifier GBIC SFP defined by serial ID only Connector LC Transceiver Data Compliance 0x00 0x00 0x00 0x00 FC Link Length Intermediate Distance I FC Transmitter Tech Shortwave Laser w o OFC SN FC Transmission Media Multi mode 50m M5 Multi mode 62 5m M6 FC Speed 200 MBytes Sec 400 MBytes Sec 800 MBytes Sec Encoding 8B10B BR Nominal 0x55 Length 9um km 0x00 Length 9um 0x00 Length 50um 0x05 Length 62 5um 0x02 Length Copper 0x00 Vendor name Intel Corp Vendor OUI 0x00 0x02 Oxb3 Vendor PN TXN31118D100000 Vendor Rev Wave Length 0x0352 CC BASE Oxcl Options Signal Loss as defined in SFP MSA 0x1 Signal Loss inverted from SFP MSA 0x0 TX FAULT signal implemented 0x1 TX DISABLE implemented amp disab
210. lue Tx PWR Offset Slope value T Slope rT Offset value T Offset Slope value V Slope V Offset value V Offset Checksum value Checksum Temperature MSB value Temperature MSB emperature LSB value lt Temperature_LSB gt Vcc MSB value Vcc MSB Vcc LSB value lt Vcc_LSB gt TX Bias MSB value TX Bias MSB X Bias LSB value TX Bias LSB TX Power MSB value TX Power MSB X Power LSB value TX Power LSB RX Power MSB value RX Power MSB RX Power LSB value RX Power LSB T 3 x NAKA KA AKA KA AA KA AAA NNA A y lt n x NA AA AAA A M A 18 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option A e e lt Reserved_MSB gt value lt Reserved_MSB gt lt Reserved_LSB gt value lt Reserved_LSB gt lt Reserved_MSB gt value lt Reserved_MSB gt lt Reserved_LSB gt value lt Reserved_LSB gt lt StatusControlBits gt lt DataReadyBar gt value lt DataReadyBar gt lt LOS gt value lt LOS gt lt TXFault gt value lt TXFault gt SoftRXRateSelect value lt SoftRXRateSelect gt RXRateSelectState value RXRateSelectState SoftTXDisable value lt SoftTXDisable gt TXDisableState valu
211. m Information Command Line Option g QLOGIC ee lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The XML Format 2 for 4G HBAs is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n n Build n lt AppVersion gt AppXmlVersion 2 0 AppXmlVersion lt HBA gt Generallnfo Instance value HBAModel value HBAID value HBAAlias HBAPort value PortAlias WWNN value WWPN value Port ID value SerialNumber value DriverVersion valu BIOSVersion value FirmwareVersion valu OptionROMBIOSVersion value OptionROMCodeVersion 2 value OptionROMEFIVersion value OptionROMFirmwareVersion value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value PortType value Status value HBA Status 0 lt Status gt Reboot 0 lt Reboot gt QLogic Here is the VPD information lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC CLI lt AppName gt lt AppVersion gt vn nn nn Build n nn lt AppVersion gt lt HBA gt lt HBAInstance value HBAModel value HBAPort value WWNN value WWPN value gt B 12 SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g I lt VPD gt lt VPD ProductIdentifier
212. mand see section 5 2 5 3 12 gS Show HBA Statistics To view the HBA statistics type scli gs lt HBA Instance gt lt HBA WWPN gt lt Parameter Name gt lt Parameter Alias gt lt Parameter Value gt 5 14 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Command Summary I Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Parameter Name Name of the parameter see table 4 7 Parameter Alias Alias of the parameter see table 4 7 Parameter Value New value of the parameter see table 4 7 Table 5 4 lists the HBA statistics parameter names aliases and values Table 5 4 HBA Statistics Parameters Description Name Alias Value Sets how often statistics are AutoPoll AP 0 256 retrieved Set the polling interval when PollRate SR 5 30 retrieving statistics seconds Saves the HBAs statistics to LogToFile LF Log file name a CVS log file Table Notes When the AutoPoll parameter is 0 statistics are retrieved automatically until the user aborts the operation When the AutoPoll parameter is in the range of 1 256 statistics are retrieved for the number of cycles specified by this value Under Solaris this feature is disabled if you are using the driver from the OS installation CDs QLC driver Under Linux this feature is disabled if you are using the ioctl or sysfs inbox driver 5 3 13 h Help Type the foll
213. mands QLOGIC Statistics Menu Command Line Options gs and Is ls To change the HBA statistics 1 From the Main Menu type the number for the Statistics option and then press ENTER 2 From the Statistics Menu type the number for the HBA Statistics option and then press ENTER 3 From the HBA Statistics Menu type the number for the Configuration option and then press ENTER The HBA Statistics Settings Menu contains the following options W Current Settings Restore Default Auto Poll Set Rate Log to File 4 To see the current port statistics select Current Settings and then press ENTER For example HBA Port Statistics Settings AutoPoll AP 10 SetRate SR 5 LogToFile LF null csv 5 Torestore the HBA defaults select Restore Default and then press ENTER The following message appears Resetting to default settings done 6 Tochange the polling select Auto Poll and then press ENTER Then select either Auto Poll or Manual Poll and press ENTER to enable that selection 7 To change the sampling rate select Set Rate and then press ENTER You are prompted to enter a rate value between 5 and 30 seconds the current rate is shown in parentheses Type a new rate and then press ENTER to update the sampling rate 8 To save the HBA statistics to a file select Log to File and then press ENTER Type the name of a csv file to save to and then press ENTER Table 4 10 shows the values for the
214. mber corresponding to the other option NOTE If you select a QLA22xx HBA all QLA22xx HBAs on the host will use the same settings If you select a 23xx HBA all 2G 4G HBAs on the host will also use the same settings To save your changes select Commit Changes Table 4 4 shows the driver settings Table 4 4 Driver Settings Parameter Name Alias Value param name param alias param value gt Description PersistentOnly PO 0 1 Present persistently bound target s only Persistent PN 0 1 Present persistently bound PlusNew target s plus any new tar get s with driver default NewOnly NO 0 1 Present targets with driver default BindWWPN BW 0 1 Bind devices by WWPNs SN0054614 00 F 4 55 4 Interactive Commands XX Utilities Menu QLOGIC kk Table 4 4 Driver Settings Continued Parameter Name Alias Value Description param name param alias param value gt BindPortID BP 0 1 Bind devices by Port IDs Driver Parameter NewOnly NO is supported only with the failover driver 4 10 Utilities Menu 10 Utilities When you select this option SANsurfer FC HBA CLI shows the following utilities options Flash Update Flash Save HBA Parameters Update HBA Parameters Save HBA Parameters Templates Driver Update Windows only Driver Rescan Solaris with QLA driver only 4 10 1 Flash Update Per HBA Port or All
215. me and description Appendix D Non interactive Error Codes This appendix lists the error codes that can occur while running SANsurfer FC HBA CLI in interactive mode For each error code number it provides the name and description Appendix E Help Commands This appendix provides an alphabetical list of the command line actions arguments and functions of the help commands Following the appendices are a glossary of terms used and an index that will help you quickly find the information you need 1 2 2 Documentation Conventions This guide uses the following documentation conventions B Textin bold font indicates a menu item dialog box tab button or check box in the user interface For example From the General Information Menu type the number for Host Topology B Textinasans serif font Courier New indicates CLI window text output For example The HBA already has the device selected as boot device B Textin a bold sans serif font Courier New indicates user input what you type For example 1 2 PRELIMINARY SN0054614 00 F XX 1 Introduction QLOGIC Guide Overview o a scli z W Text in ALL CAPITALS usually indicates the name of a key that you press on the keyboard For example Type the number for Host Information and then press ENTER W talicized text indicates either a document reference glossary term or emphasis For example Attached Port means a QLogic HBA For a complete
216. mmand failed because no space left on the drive 73 Reserved Not used 74 Reserved Not used 75 Reserved Not used 76 Reserved Not used 77 Reserved Not used 78 Reserved Not used 79 Reserved Not used 80 ERROR INVALID SERIAL NO Invalid HBA serial number 81 ERROR GET NVRAM DATA Unable to read NVRAM from HBA 82 ERROR UPDATE NVRAM DATA Failed to update HBA parameters C 4 SN0054614 00 F XX QLOGIC ls C Interactive Exit Codes Table C 1 Exit Code Descriptions Interactive Mode Continued Return ere Code Name Description 83 ERROR_PRESERVE_NVRAM_DATA Failed to preserve HBA parameters 84 ERROR MISSING NVRAM TEMPLATE Unable to find the NVRAM template for the FILE HBA 85 ERROR INVALID NVRAM PROG OPTION Specified key value to program NVRAM are invalid 86 Reserved Not used 87 Reserved Not used 88 Reserved Not used 89 Reserved Not used 90 ERROR READING BOOT DEVICE Failed to read boot device settings of the HBA 91 ERROR SAVING BOOT DEVICE Failed to save boot device settings to the HBA 92 ERROR BOOT CONFIG DISABLED _ Boot device settings is disabled with running DRIVER driver 93 ERROR BOOT TARGET NO LUN Boot device settings aborted because boot target has no LUN 94 ERROR TARGET NO DIRECT ACCESS Boot device settings failed because the boot target is not a direct access device 95 ERROR INVALID BOOT SETTINGS Boot device parameters is invalid incorrect 96 ERROR UNSUPPORTED BOOT Unsupported boot dev
217. n LUN Number When you select a particular LUN from the LUN list the following information for that LUN appears a Product Vendor Product ID Product Revision LUN Size Type WWULN OS LUN Name on Solaris and Linux Here is an example of the LUN information Product Vendor SEAGATE Product ID ST318453FC Product Revision 0006 LUN 0 Size SBC 2 Direct Access block device e g magnetic disk WWULN 20 00 00 11 C6 2D 5A 3F Hit Return to continue 4 32 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target LUN List Menu Command Line Options t and l A lM 4 4 1 3 All Targets 4 Target LUN List gt 1 n Target List Menu Portn 1 n Target gt m All LUNS When you select a particular LUN from the LUN list the following information for all LUNs appears Product Vendor Product ID Product Revision LUN Size Type WWULN OS LUN Name on Solaris and Linux Repeats for each LUN Here is an example of the LUN information Product Vendor SEAGATE Product ID ST318453FC Product Revision 0006 LUN iU Size SBC 2 Direct Access block device e g magnetic disk WWULN 20 00 00 11 C6 2D 5A 3F Hit Return to continue And so on Repeats for each LUN 4 4 2 Target LUN List All HBAs 4 Target LUN List gt N All HBAs This choice shows the Target List Menu for All HBAs a Individual Target Individual LUN All Targ
218. n SANsurfer FC HBA CLI shows the Loopback Test Menu containing the following options W X Display Test Parameters B Reset Test Parameters B Configure Test Parameters W Start Diagnostics Test Diagnostic tests interrupt normal HBA operations At the completion of the testing the HBAs state before the tests are restored Note the following W Run these tests when no other activities are required of the HBA m Tests read and write to sensitive areas on the HBA m Disruption of some diagnostic tests may require a complete update of the HBA s critical memory areas NOTE Although SANsurfer FC CLI protects against normal operation interruption and testing disruption it is your responsibility to ensure that the diagnostics are run without causing interruptions to other processes and disruptions to the actual testing process 4 64 SN0054614 00 F XX 4 Interactive Commands QLOGIC Diagnostics Menu Command Line Options kl kr and dm ls The loopback test is external to the HBA If the HBA port is in loop mode you can run the loopback test with a loopback connector If the HBA port is in point to point mode and attached to a switch an echo test is run instead no loopback connector is used In addition some driver versions do not require a loopback connector The test evaluates the ports transmit and receive transceivers on the HBA More specifically the loopback test transmits and receives loopback the specified data
219. n gt n All HBAs Depending on how many HBAs are in the host the number to select this option varies When you select that option the All HBAs menu shows the HBA Information and VPD Vital Product Data options a Information B VPD 4 2 2 1 Information 2 HBA Information gt n All HBAs 3 Information The Information menu shows the same HBA Information available from the General Information Menu See section 4 1 3 1 2 HBA Information n All HBAs 3 VPD The VPD menu shows the same Vital Product Data available from the HBA Information Menu See section 4 2 1 4 4 3 HBA Parameters Menu 3 HBA Parameters The HBA Parameters command shows the HBA Parameters Menu which is similar to the HBA Information Menu It also includes list of all detected HBAs and their ports as well as the options to view all HBAs and to return to the previous menu a HBA Model QLxnnnn Q 1 Port information QO Port number OQ WWPN Q Status Q additional port s as appropriate B q Additional HBAs as appropriate SN0054614 00 F 4 21 4 Interactive Commands XX HBA Parameters Menu QLOGIC ee B All HBAs Here is an example of an HBA Information Menu screen In this example the host includes three HBAs with two ports each and one HBA with a single port HBA Model QLA2342 1 Port 1 WWPN 21 00 00 EO 8B 01 43 9B Online 2 Port 2 WWPN 21 01 00
220. n viewing 4 2 iiDMA settings 4 45 information 4 17 4 18 5 2 viewing 5 17 A 4 A 10 B 11 B 17 viewing all 5 42 viewing by port number 4 18 instance 5 6 locating beacon LED 4 61 parameters 4 21 aborting changes to 4 29 configuring 4 23 displaying 4 22 names and aliases 5 32 restoring defaults 4 29 saving 4 57 settings viewing 5 8 template 4 57 templates using 4 58 updating 4 57 5 38 port alias 4 19 A 14 B 22 BIOS enable 4 23 diagnostics 4 63 iiDMA settings 4 41 statistics options 4 77 port BIOS enable 4 26 sampling rate setting 4 79 settings viewing A 3 B 2 statistics polling 4 78 saving to file 4 79 viewing and changing 4 76 4 79 A 13 B 21 viewing current 4 78 statistics viewing and changing 4 76 supported 1 4 template supported parameters 4 59 topology viewing 4 3 5 3 A 20 B 24 virtual ports 4 85 WWPN 5 6 HBA alias definition of Glossary 3 HBA port definition of Glossary 3 SN0054614 00 F HBA port alias definition of Glossary 3 HBA port beacon definition of Glossary 3 help 5 15 about the product 4 88 Help Menu 4 87 host configuration refreshing 4 17 configuration viewing 5 4 information viewing 4 4 5 1 topology 4 3 saving as text file 4 8 viewing 4 3 5 3 5 40 Host Adapter Module HAM definition of Glossary 2 Host Adapter Module HAM NetWare required driver Glossary 2 host bus adapter See HBA i 4 17 4 18 5 5 5 17 A 4 B 11 ID hard loop 4 23 enable 4 23 iiDMA Inte
221. nce lt HBA WWPN gt default Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Parameter Name Name of the parameters Parameter Alias Alias of the parameters Parameter Value New value of the parameters The pairs Parameter Name Parameter Value and Parameter Alias Parameter Value can be repeated to set multiple parameters with a single command SN0054614 00 F 5 31 5 Non interactive Commands XX Command Summary QLOGIC ee Table 5 11 lists the HBA parameter names and aliases Table 5 11 HBA Parameters 5 32 Connection Options 0 Loop only 1 Point to point only 2 Loop preferred otherwise point to point 3 Point to point preferred otherwise loop QLA22xx HBAs only Description Name Alias Value Connection options ConnectionOption CO See table note below Data rate DataRate DR See table note below Enable BIOS EnableBIOS EB 1 Enable 0 Disable Enable extended logging EnableExtendedLog EL 1 Enable 0 Disable ging Enable FC tape EnableFCTape EF 1 Enable 0 Disable Enable hard loop ID EnableHardLoopID HL 1 Enable 0 Disable Enable LIP full login EnableLIPFullLogin FL 1 Enable 0 Disable Enable LIP reset EnableLipReset LP 1 Enable 0 Disable Enable target reset EnableTargetReset TR 1 Enable 0 Disable Execution throttle ExecutionThrottle ET 1 65535 Fr
222. nfo Path value ID value Vendor value ProcuctID value Revision value SerialNumber value B 16 SN0054614 00 F XKX B XML Format 2 QLOGIC Display System Information Command Line Option g ls DeviceID value PortID value LunCount value Type value DeviceStatus value gt lt Target gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt The lt Target gt lt Target gt sequence repeats for each target The lt HBA gt lt HBA gt sequence repeats for each HBA B 8 8 Display All Information for One or All HBAs Command Line Option z The XML Format 2 for all adapter information is more complicated than its non XML counterpart because the tags cannot be repeated In non XML mode SANsurfer FC HBA CLI sequentially calls all the options in Table B 1 and each option is displayed in its standard output format If each option displays its own XML2 output the resulting display would have multiple duplicate tags Table B 1 Options Displayed by z i o e Setting Section g Display system information 5 3 11 C Display HBA settings 5 3 3 gt T Display HBA information 5 3 19 t Display device list 5 3 29 lt L Display LUN list 5 3 18 P Target persistent binding 5 3 24 m Selective LUNs 5 3 21 E Boot device 5 3 6 The command format is scli z lt HBA Instance gt lt HBA WWPN gt all x2
223. ning asking whether to continue the uninstall process For example The following package is currently installed QLSclix QLogic SANsurfer FC CLI HBA Configuration Utility x86 1 x x Build xx Do you want to remove this package 3 Type y and press ENTER The program shows a script warning asking whether to continue the uninstall process For example Removing installed package instance lt QLSclix gt This package contains scripts which will be executed with super user permission during the process of removing this package Do you want to continue with the removal of this package y n q 4 Type y and press ENTER The pkgrm program notifies you when the uninstall process is complete For example Verifying package dependencies Processing package information opt QLogic Corporation shared pathname not removed opt shared pathname not removed Executing postremove script Scli removed Menu property file removed Adapter property file removed SCLI property file removed Updating system information Removal of lt QLSclix gt was successful 3 3 4 Macintosh Uninstall Uninstalling SANsurfer FC HBA CLI is not necessary for Mac OS X the native installer automatically updates the product whenever it detects a change in the product version To manually uninstall SANsurfer FC HBA CLI delete its folder and any references to the SANsurfer installer package s in the
224. nition of Glossary 2 D d 4 60 5 8 data pattern parameter 5 18 size parameter 5 19 vital product VPD 4 20 data rate 4 23 4 25 5 32 DataPattern DP parameter 5 26 5 27 DataRate parameter 5 32 SN0054614 00 F XX QLOGIC SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters ls DataSize parameter 5 26 default restoring 4 78 restoring for link 4 81 defining port alias 5 36 definitions of terms Glossary 1 delay timer interrupt 4 23 4 27 delay loop reset 4 23 deleting virtual port 4 86 device configuring boot 4 53 definition of Glossary 1 list viewing A 6 B 16 diagnostics configuration settings 4 62 loopback test 4 63 A 9 loopback test results B 13 parameters 5 26 port 4 63 read write buffer test 4 66 4 67 A 9 read write buffer test results B 13 running loopback or read write buffer test 4 67 transceiver details 4 72 Diagnostics Menu 4 62 Digital Diagnostic Monitoring Interface 5 9 disable boot device 5 9 LUNs 5 29 disk configuring iiDMA settings 4 45 disparity errors 5 23 displaying binding information 5 34 boot device 4 52 configuration 4 49 diagnostics monitoring info 5 9 HBA information 5 42 host information 5 1 host topology 4 4 5 40 link status 5 28 LUN configuration 4 50 LUN information 5 28 system information 5 1 5 14 SN0054614 00 F target information 5 39 version number 5 40 dm 4 62 4 72 5 9 A 15 B 3 DMI SFF DMI viewing
225. nition of Glossary 4 NetWare required drivers Glossary 2 network adapter definition of Glossary 5 Network Interface Controller NIC definition of Glossary 5 Nexus driver level definition of Glossary 2 NIC definition of Glossary 5 NL Port definition of Glossary 5 Node Loop Port definition of Glossary 5 Node Port N Port definition of Glossary 4 non interactive mode See also interactive mode command format 5 5 commands 5 1 definition of 2 1 Index 7 SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC E non interactive mode continued error codes D 1 starting 2 3 Non volatile Random Access Memory NVRAM definition of Glossary 5 NPIV N Port ID Virtualization Virtual Menu option 4 83 NPIV definition of Glossary 4 number of tests parameter 5 20 5 26 NVRAM definition of Glossary 5 O 0 5 5 5 33 OE parameter 5 20 5 26 ONC definition of Glossary 5 OnError parameter 5 20 5 26 Open Network Computing ONC definition of Glossary 5 operating systems supported by SANsurfer FC HBA CLI 1 4 operation mode 4 23 4 27 5 32 OperationMode parameter 5 32 organization of guide 1 1 OS type 4 2 version 4 2 output in XML 5 5 to file 5 5 output messages to file 5 33 XML Format 1 5 41 P p 4 45 4 46 4 47 4 48 5 5 5 34 A 7 B 15 pa 4 19 5 36 A 14 B 22 parameters aborting changes to 4 29 data rate 4 23 diagnostic 5 26 fr
226. nly fw Update firmware only boot Update bootcode only BIOS FCode EFI image all Update all regions BIOS FCode EFI depending on the Flash image BIOS FCode File Name or path of file continuing update BIOS FCode Name Region update only supported on QLA QLE QMC246x HBAs To save the BIOS FCode to a file type scli b HBA Instance HBA WWPN gt SAVE BIOS FCode File Name Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA BIOS FCode File File name or a path to a file in which to save BIOS FCode Name 5 3 3 C Show Parameter Settings Use the c command to show the parameter settings for all HBAs in the system scli c all To show the parameter settings for a specific HBA type t scli c HBA Instance HBA WWPN gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA 5 3 4 d Update Device Driver Use the d command to update the HBA s device driver scli d File Name 5 8 SN0054614 00 F XX 5 Non interactive Commands QLOGIC Command Summary ls Where File Name Absolute or full path name of the setup INF file or the com pressed driver file in ZIP or EXE format The binary image of the device driver must reside in the same absolute or full path location For example scli d c temp ql2300 qlxxx inf 5 3 5 dm Display Diagnostics Monito
227. nostics option and then press ENTER 2 Fromthe Diagnostics Tests Menu type the number that corresponds to the test you want to run and then press ENTER B 1 loopback test B 2 read write buffer test 3 The Diagnostics Menu appears Type the number that corresponds to the HBA port you want to test and then press ENTER SN0054614 00 F 4 67 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC E Se 4 The Configure Diagnostic Loopback Test Parameters or Configure Diagnostic Read Write Buffer Test Parameters submenu appears Select one of the following options 1 Show Test Configuration Type 1 to show the current parameter values 2 Restore Test Configuration to Default Type 2 to return all parameters to their default values 3 Customize Test Configuration Type 3 to customize any or all of the parameter values Continue with Step 5 4 Run Diagnostic Test Type 4 to run the loopback or read write buffer test with the current parameter values To see these values type 1 Show Test Configuration 5 Return to the Diagnostics Test Menu Type 5 to go back to the Diagnostics Test Menu 6 Ifyou selected Customize Test Configuration in Step 4 the Diagnostic Test Configuration Menu appears See sections 4 17 1 2 1 through 4 17 1 2 5 for a description of the parameters and their values For each parameter you want to change follow these steps a Type the number associat
228. nvalid diagnostics test parameter set tings 49 Reserved Not used 50 ERROR FC LINK UNKNOWN STATUS Error getting FC link status 51 ERROR RESET LINK STATUS Unable to reset HBA link status 52 ERROR INVALIDE STATISTICS PARAMS Invalid link status statistics parameter settings 53 Reserved Not used 54 Reserved Not used 55 Reserved Not used 56 Reserved Not used 57 Reserved Not used 58 Reserved Not used 59 Reserved Not used 60 ERROR INVALID PARAM SETTINGS Invalid HBA parameter value key 61 ERROR PARAM UNSUPPORTED HBA Specified HBA parameter is not sup ported 62 ERROR PARAM UNSUPPORTED DRIVER Unable to update HBA parameters Driver unsupported D 3 D Non interactive Error Codes XX QLOGIC E e Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 63 ERROR RESTORE NVRAM DEFAULT Failed to restore HBA parameters to default settings 64 Reserved Not used 65 Reserved Not used 66 Reserved Not used 67 Reserved Not used 68 Reserved Not used 69 Reserved Not used 70 ERROR SAVE HBA FLASH TO FILE Failed to save HBA flash image to a file 71 ERROR READ HBA FLASH HBA Failed to read HBA flash 72 ERROR NO SPACE LEFT Command failed because no space left on the drive 73 Reserved Not used 74 Reserved Not used 75 Reserved Not used 76 Reserved Not used 77 Reserved Not used 78 Reserved Not used 79 Reserved Not used 80 ERROR INVALID SERIAL NO Inval
229. ode first run scli 1 x x xx windows exe With the r parameter to generate a response file which stores information about the data entered and options selected at run time By default the response file is created inside the system s Windows folder To specify an alternative response file name and location use the 1 parameter S Silent mode For an InstallScript MSI or InstallScript project the command scli 1 x x xx windows exe s runs the installation in silent mode based on the responses contained in the Setup iss file located in the same directory Response files are created by running Setup exe with the r option To specify an alternative file name or location of the response file use the 1 parameter f1 Specify alternative This parameter allows you to specify the name and location response file namea of the response file The 1 parameter is available when creating a response file with the x option and when using a response file with the s option 2 Specify alternative log When running an InstallScript MSI or InstallScript installation file namea in silent mode using the s parameter the log file Setup log is created in the same directory and with the same name except for the extension as the response file The 2 parameter allows you to specify an alternative log file location and file name InstallScript and InstallScript MSI projects only 3 6 SN0054614 00 F XX 3 Ini
230. on value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt InterConnectElement Type Switch gt lt SwitchWWPN value DomainID value anagementID valu IPAddress value odel value SymbolicName value SerialNumber value ACAddress value FirmwareVersion valu PortCount value BeaconStatus value lt PhysicalPortInformation gt lt PhysicalPortNumber value gt Port WWPN value State value Type value TXPortType value ModuleType value lt AttachedPort Type value gt lt HBANodeName value PortName value VendorID value Model value SerialNumber value W Alias value B 24 SN0054614 00 F XX B XML Format 2 QLOGIC Display System Information Command Line Option g o 9 9 7 EN PortAlias value DriverVersion value FirmwareVersion value Host value gt lt AttachPort gt lt PhysicalPort gt lt PhysicalPortInformation gt lt InterconnectElements gt InterconnectElementType HBA lt HBA WWNN value WWPN value VendorID value odel value SerialNumber value Alias value PortAlias value DriverVersion value FirmwareVersion value Host value TotalNumberOfDevices value NumberofPort value BeaconStatus value PortTyp
231. op down m Additional HBAs Q Additional Ports Virtual port options include the following B lt vport wwpn gt is the World Wide Port Name of a virtual port B lt vport hex gt is a single hex digit that will be part of the virtual port s WWPN Second byte 0 4 is reserved for physical HBA port Note that this feature is supported only with NPIV enabled driver 4 84 SN0054614 00 F XX 4 Interactive Commands QLOGIC Virtual Menu Command Line Option vp ls 4 14 1 Virtual Menu for HBA Instance 14 Virtual gt 1 Virtual Menu When you select this option the Virtual Port Menu appears with the following options W List Virtual Ports B X Delete a Virtual port W Create a Virtual port Enter the number for the option you want and then press ENTER With a virtual HBA the following SANsurfer FC HBA CLI features are not available HBA Parameters Display HBA Parameters Settings HBA Parameters Restore Default Flash Update from file Flash Save to file HBA Parameters Update from file HBA Parameters Save to file HBA Parameters Templates Driver Update Target Link Speed Boot Device Settings Driver Settings In addition the following notes apply B The maximum number of virtual HBAs that can be created of a physical HBA is 15 VPort means Virtual Port in all the displays In command line mode you must use the WWPN instead of HBA instance number to select a virtual port m After you crea
232. or SFF DMI general information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt MediaInformation gt lt Vendor gt value lt Vendor gt lt Type gt value lt Type gt lt PartNumber gt value lt PartNumber gt lt Speed gt value lt Speed gt lt Revision gt value lt Revision gt lt SerialNumber gt value lt SerialNumber gt lt MediaInformation gt lt Diagnostics gt lt Temperature gt lt MeasuredTemperature gt C lt MeasuredTemperature gt Value gt value lt Value gt Status gt value lt Status gt HighAlarm gt value lt HighAlarm gt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt Temperature gt lt Voltage gt lt MeasuredVoltage gt Vdc lt MeasuredVoltage gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt lt NA AA A HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt Voltage gt lt TxBias gt SN0054614 00 F A 15 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E S easuredTxBiasUnit gt mA lt MeasuredTxBiasUni
233. ormat 2 for the HBA alias option is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt SN0054614 00 F B 21 B XML Format 2 XX Display System Information Command Line Option g QLOGIC A S lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt HBAAlias gt lt AliasName value gt lt HBAAlias gt lt HBA gt lt Status gt n lt Status gt lt Reboot gt n Reboot gt lt QLogic gt B 8 12 HBA Port Alias Command Line Option pa The command format is scli pa lt HBA Instance gt lt HBA WWPN gt view x2 The XML Format 2 for the HBA port alias option is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt AppXmlVersion gt 2 0 lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt PortAlias gt lt Alias Name value gt lt PortAlias gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt The XML Format 2 for SFF DMI detailed information is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLo
234. ort Name Port ID Here is an example of a typical menu item 1 Disk Online Vendor SEAGATE Product ID ST318453FC Product Rev 0006 Serial Number 3JA9TN7600007517T6P1 Node Name 20 00 00 11 C6 2D 5B F9 Portname 22 00 00 11 C6 2D 5B F9 Port ID 02 0A DC 23 Disk Online Vendor SEAGATE Product ID ST318453FC Product Rev 0006 Serial Number 3JA9TN7600007523T6P1 Node Name 20 00 00 11 C6 2D 5B FA Portname 22 00 00 11 C6 2D 5B FA Port ID 02 0A DE And so on You can select any LUN and view additional information by entering its number at the prompt and then pressing ENTER 4 4 1 1 Per Target LUN 4 Target LUN List gt 1 nTargetListMenuPortn 1 n Target When you enter the number for an individual target the LUN list for that target appears It includes a list of all LUNs on that target and the following information for each LUN SN0054614 00 F 4 31 4 Interactive Commands XX Target LUN List Menu Command Line Options t and l QLOGIC ee e LUN Number CL Vendor NI Product ID L Port Name NI Port ID B All LUN s Here is an example of the LUN List Menu 1 LUN O Vendor SEAGATE Product ID ST318453FC Port Name 22 00 00 11 C6 2D 5B F9 Port ID 02 0A DC And so on M All LUN s N Return to Previous Menu 4 4 1 2 Per Target All LUNs 4 Target LUN List gt 1 n Target List Menu Portn b 1 n Target P 1
235. ort numbers from which you can select the port for which you want the link status To view the link status 1 Type the number for the Statistics option and then press ENTER 2 The Statistics Menu appears Type the number for the Link Status option and then press ENTER 3 TheLink Status Menu appears Type the number for the Show Link Status option and then press ENTER 4 You are prompted to select an HBA port Type the number for the port and then press ENTER The HBA link status for that port appears Link Status The following keys are in use during test lt R gt lt r gt Reset Current C c Refresh Current T t Refresh Total RETURN Abort Test Port Name Link Failure Sync Loss Signal Loss Invalid CRC Port WWPN 0 0 0 0 Disk WWPN 0 0 0 0 Disk WWPN 0 0 0 0 Disk WWPN 0 0 0 0 Disk WWPN 0 0 0 0 Disk WWPN 0 0 0 0 Press Enter to continue 4 14 Virtual Menu Command Line Option vp 14 Virtual Menu NOTE The option to use N Port ID Virtualization NPIV only appears on the Main Menu if the HBAs and system support it NPIV requires a Windows system running with a driver that supports NPIV SN0054614 00 F 4 83 4 Interactive Commands XX Virtual Menu Command Line Option vp QLOGIC ee QLogic s SANsurfer FC HBA CLI for Windows works in conjunction with QLogic s N_Port ID Virtualization NPIV capable Windows driver NPIV is an ANSI
236. ount s Sd Status Online LUN 0 Product Vendor SEAGATE Product ID ST118273 CLAR18 Product Revision SG1D LUN amp 0 Size 16 95 GB Type SBC 2 Direct access block device e g magnetic disk WWULN 20 00 00 20 37 11 FF EF Target Persistent Binding Information Fl e co No target persistent binding configuration on HBA instance 1 WWPN 21 01 00 1 B 23 55 7C Selective LUNs Information HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Device Vendor ID SEAGATE Device Product ID ST136403FC Serial Number LT06464600001011HGGH Device Port Name 21 00 00 20 37 1A 6B CF Device Port ID 11 01 E4 Target LUN Info Port Name LUN ID Enable Type HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Device Vendor ID SEAGATE Device Product ID ST118273 CLAR18 Serial Number LP60266900001919HO1K Device Port Name 21 00 00 20 37 11 FF EF Device Port ID 11 01 E8 Enable Type Target LUN Info Port Name LUN ID HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Boot Device Settings Selectable Boot Disabled 4 16 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Information Menu Command Line Option i ls Primary Boot Port Name LUN 00 00 00 00 00 00 00 00 0 Alternate
237. owing text to view the help file scli h Type the following text to view help information for an individual command scli Command Line Parameter h For example typing scli 1 h shows SANsurfer FC HBA CLI vl x x Build x Copyright 2003 2007 QLogic Corp All rights reserved SN0054614 00 F 5 15 5 Non interactive Commands XX Command Summary QLOGIC ee Command Line QLogic FC Host Bus Adapters scli 1 lt hba no lt hba wwpn gt shows LUN information for all HBAs scli 1 hba no hba wwpn gt lt target wwpn gt lt target portid gt shows LUN information for a specific target scli 1 hba no hba wwpn target wwpn target portid lun id shows LUN information for a specific LUN on a Specific target NOTE To view the current version information for SANsurfer FC HBA CLI use the v Option section 5 3 32 5 3 14 ha Set Delete HBA Alias With this command you can view set or delete the alias of a specific HBA To view the alias of a specified HBA type scli ha HBA Instance HBA WWPN gt view To set an alias for a specified HBA type scli ha HBA Instance HBA WWPN Alias To delete an alias of a specified HBA type scli ha HBA Instance HBA WWPN gt delete Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Alias
238. pliance gt CC EXT Ox7d CC EXT VendorSpecific value VendorSpecific Address A0 Address A2 lt TempHighAlarm gt value lt TempHighAlarm gt lt TempLowAlarm gt value lt TempLowAlarm gt lt TempHighWarning gt value lt TempHighWarning gt lt TempLowWarning gt value lt TempLowWarning gt lt VoltageHighAlarm gt value lt VoltageHighAlarm gt lt VoltageLowAlarm gt value lt VoltageLowAlarm gt lt VoltageHighWarning gt value lt VoltageHighWarning gt lt VoltageLowWarning gt value lt VoltageLowWarning gt lt BiasHighAlarm gt value lt BiasHighAlarm gt BiasLowAlarm value lt BiasLowAlarm gt lt BiasHighWarning gt value lt BiasHighWarning gt lt BiasLowWarning gt value lt BiasLowWarning gt PowerHighAlarm gt value lt TXPowerHighAlarm gt PowerLowAlarm gt value lt TXPowerLowAlarm gt PowerHighWarning gt value lt TXPowerHighWarning gt PowerLowWarning gt value lt TXPowerLowWarning gt RXPowerHighAlarm gt value lt RXPowerHighAlarm gt RXPowerLowAlarm gt value lt RXPowerLowAlarm gt RXPowerHighWarning gt value lt RXPowerHighWarning gt RXPowerLowWarning gt value lt RXPowerLowWarning gt Rx_PWR 4 gt value lt Rx_PWR 4 gt Rx_PWR 3 gt value lt Rx_PWR 3 gt Rx_PWR 2 gt value lt Rx_PWR 2 gt Rx_PWR 1 gt value lt Rx_PWR 1 gt Rx PWR 0 value Rx PWR 0 Ix I Slope value Tx I Slope Ix I Offset value Tx I Offset x PWR Offset va
239. point to point links through a fabric for example N Port to F Port to F Portto N Port using a single FC fabric switch See F Port Fabric Port SN0054614 00 F XKX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters I N_Port ID Virtualization power is removed NVRAM settings are The ability for a single physical FC end point N_Port to support multiple uniquely addressable logical end points With NPIV a host FC adapter is shared in such a way that each virtual adapter is assigned to a virtual server and is separately identifi able within the fabric Connectivity and access privileges within the fabric are controlled by identification of each virtual adapter and hence the virtual server using each virtual adapter NL_Port Node Loop Port A port capable of arbitrated loop functions and protocols An NL_ Port connects through an arbitrated loop to other NL Port and at most a single FL_Port NL Ports handle creation detection and flow of message units to and from the connected systems NL Ports are end ports in virtual point to point links through a fabric for example NL Port to F Port to F Portto N Port using a single FC fabric switch In the absence of a fabric switch FL Port NL Ports can communicate with other NL Ports in virtual point to point links through a FC AL open loop circuit often through FC AL Arbitrated Loop hub or loop switch devices See E
240. privileges go to System Preferences select Account and then Security Tab Make sure the Allow user to administer this computer check box is selected 2 Download the SCLI zip file with Safari or other browser 3 When the download has finished Stufflt expands the zip file to a tar file onto the desktop Double click the SCLI car file icon to create the SCLI pkg file Double click the SCLI pkg file icon Follow the Installer menu The installation directory is SHOME Applications QLogic Corporation SANsurferCLI where SHOME is Root 7 After the installation process has finished you can delete the SCLI pkg and tar files 3 2 4 2 Command Line Installation To install SANsurfer FC HBA CLI on a Macintosh follow these steps 1 Download the SCLI install package for Mac OS x compressed tar file to a local directory 2 Uncompress the file by typing the following command SN0054614 00 F 3 11 3 Initial Installation XX Uninstalling SANsurfer FC HBA CLI QLOGIC E V V tar zxvf lt file gt tgz For example qlogic root tar zxvf scli x x x x macos pkg tgz Scli x x x x pkg scli x x x x pkg Contents Scli x x x x pkg Contents Archive bom x x x pkg Contents Archive pax gz scli x This command extracts the compressed file to a directory named Scli x x x x pkg 3 Install the package to the default directory For example installer pkg scli x x x x pkg target This
241. ption SANsurfer FC HBA CLI shows information about all boot devices for all HBAs For details see Boot Device s Per HBA Port on page 4 52 W Product vendor a Product ID H Product revision 4 9 Driver Settings Menu Command Line Option fg 9 Driver Settings When you select this option SANsurfer FC HBA CLI shows the Driver Settings Menu that lists the ports on each HBA Select the number corresponding to the port that you want and then press ENTER to view the Target Display Options and Target Binding Options 4 54 SN0054614 00 F XX 4 Interactive Commands QLOGIC Driver Settings Menu Command Line Option fg A ENS NOTE Options on the Driver Settings menu differ according to the driver type failover non failover Windows Solaris or Macintosh B Present persistently bound target s plus any new target s with driver default option available for all drivers B Present persistently bound target s Only option available for all drivers B Present targets with driver default option available for failover driver only B Bind by World Wide Port Name option available for all drivers except Macintosh driver W Bind by Port ID option available for all drivers except Macintosh driver B Commit Changes The current settings for the Present persistently bound target s and Bind by are indicated by the word Current in parentheses after the selection To change these settings select the menu nu
242. ption must be the first or last command in the command line When you use this option the system shows all result and status messages in XML format 1 a legacy format These formats are described in Appendix A This option is usually combined with the o option see section 5 3 23 to create a text file with XML output so that it can be parsed by an XML compliant utility For example to show HBA general information and output it to an XML file named output xmil scli i all x o output xml SN0054614 00 F 5 41 5 Non interactive Commands XX Command Summary QLOGIC EN O a 5 3 35 X2 Output in XML Format 2 5 3 36 Z NOTE This option is valid only in non interactive mode You can use this option with all non interactive mode options that have a corresponding interactive mode option see Table 5 1 This option must be the first or last command in the command line When you use this option the system shows all result and status messages in XML format 2 standard XML format These formats are described in Appendix B This option is usually combined with the o option see section 5 3 23 to create a text file with XML output so that it can be parsed by an XML compliant utility For example to show HBA general information and output it to an XML file named output xmil scli i all x2 o output xml Display All HBA information for One or All HBAs 5 42 To show all information for one specific HBA or for
243. quence repeats for each HBA Each parameter is listed on a separate line for clarity however multiple parameters can be on the same line For multiple adapters repeat the above sequence with the ID number ID Number value of the next adapter Command Line Option dm The XML Format 2 for SFF DMI general information is as follows SN0054614 00 F B 3 B XML Format 2 XX XML2 Tags for Each Option QLOGIC E S scli dm lt HBA Instance gt lt HBA WWPN gt lt all gt general gen x2 The XML Format 2 for the boot device information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt lt HBA Instance value HBA Model value WWNN value WWPN value gt lt MediaInformation gt lt Vendor gt value lt Vendor gt lt Type gt value lt Type gt lt PartNumber gt value lt PartNumber gt lt Speed gt value lt Speed gt lt Revision gt value lt Revision gt lt SerialNumber gt value lt SerialNumber gt lt MediaInformation gt lt Diagnostics gt lt Temperature gt lt MeasuredTemperature gt C MeasuredTemperature Value gt value lt Value gt Status gt value lt Status gt HighAlarm value HighAlarm HighWarning value HighWarning LowWarning gt value lt LowWarning gt lt Low
244. r Frame 4 3 1 2 Configure HBA Parameters Command Line Option n 3 HBA Parameters gt n PortNumber gt 2 Configure HBA Parameters From the Configure HBA Parameters menu you can configure the following HBA parameters Connection Options Data Rate Frame Size Hard Loop ID Loop Reset Delay seconds Enable HBA Port BIOS Enable HBA Hard Loop ID Enable Fibre Channel Tape Support Operation Mode Interrupt Delay Timer Execution Throttle Login Retry Count Enable LIP Reset Port Down Retry Count Enable LIP Full Login QLA QLE23xx HBAs Link Down Timeout seconds Enable Target Reset LUNs per Target Enable Receive Out Of Order Frame Commit Changes Abort Changes Table 4 1 lists the configurable HBA parameters alphabetically by name and alias and provides values and descriptions of each SN0054614 00 F 4 23 4 Interactive Commands XX HBA Parameters Menu QLOGIC EE PVVV h m Table 4 1 HBA Parameters Settings NVRAM Parameter Name Alias Value Description ConnectionOption CO 0 3 See table note 1 DataRate DR 0 4 See table note 2 EnableBIOS EB 0 1 See table notes 3 4 EnableExtendedLogging E 0 1 See table notes 3 4 EnableFCTape EF 0 1 See table note 3 EnableHardLooplD HI 0 1 See table note 3 EnableLIPFullLogin FL 0 1 See table note 3 EnableLipReset LP 0 1 See table note 3 EnableReceiveOutOfOrderFrame E
245. r Low Alarm 0x00fb RX Signal Power High Warning Oxlba7 RX Signal Power Low Warning 0x01f5 Rx PWR 4 0x00000000 Rx PWR 3 0x00000000 Rx PWR 2 0x00000000 Rx PWR 1 0x00000000 Rx PWR 0 0x00000000 Tx I Slope 0x0000 4 74 SN0054614 00 F XX 4 Interactive Commands QLOGIC Diagnostics Menu Command Line Options kl kr and dm ls Tx_I Offset 0x0000 Tx PWR Slope 0x0000 Tx PWR Offset 0x0000 T Slope 0x0000 T Offset 0x0000 V Slope 0x0000 V Offset 0x0000 Checksum 0x63 Temperature MSB 0x22 Temperature LSB 0x2c Vcc MSB 0x82 Vcc LSB 0x21 TX Bias MSB 0x0b TX Bias LSB 0x76 X Power MSB 0x13 TX Power LSB 0x77 RX Power MSB 0x0b RX Power LSB Ox7b Reserved MSB 0x00 Reserved LSB 0x00 Reserved MSB 0x00 Reserved LSB 0x00 Status Control Bits Data Ready Bar 0x0 LOS 0x0 TX Fault 0x0 Soft RX Rate Select 0x0 RX Rate Select State 0x0 Soft TX Disable 0x0 TX Disable State 0x0 TX Signal Power Low Alarm 0x0 TX Signal Power High Alarm 0x0 TX Bias Low Alarm 0x0 TX Bias High Alarm 0x0 Vcc Low Alarm 0x0 Vcc High Alarm 0x0 Temp Low Alarm 0x0 Temp High Alarm 0x0 RX Signal Power Low Alarm 0x0 RX Signal Power High Alarm 0x0 TX Signal Power Low Warning 0x0 TX Signal Power High Warning 0x0 TX Bias Low Warning 0x0 TX Bias High Warning 0x0 Vcc Low Warning 0x0 Vcc High Warning 0x0 Temp Low Warning
246. r a read write buffer test 5 3 18 1 Run a Read Write Buffer Test This test runs on all devices or on the devices you select on the HBA you select This test sends the SCSI Write Buffer command to the target devices and uses the SCSI Read Buffer command to read the returned data and do a data comparison NOTE All devices attached to the HBA must support SCSI Read Write Buffer commands To do a read write buffer test using the current parameters type 5 24 SN0054614 00 F XX QLOGIC 5 Non interactive Commands Command Summary I t scli kr HBA Instance HBA WWPN gt To exclude a device or devices on the selected HBA port type t scli kr HBA Instance gt lt HBA WWPN gt EX EXCLUDE Target WWPN gt Parameter Name Parameter Alias Parameter Value gt Sections 6 17 0 0 1 through 6 17 0 0 5 describe the parameters and their default values The following examples do 500 read write buffer tests with a test increment of 10 a data pattern of FFh and a data size of 8 bytes The test stops if an error occurs scli kr HBA Instance DP FF DS 8 TC 500 TI 10 OE 1 scli kr HBA WWPN gt DP FF DS 8 TC 500 TI 10 OE 1 You do not have to set each parameter for the read write buffer test If you do not specify a parameter in the command line the current parameter value is used For example the following command sets the data pattern to FFh and uses the current values for th
247. rget information Path 0 Target 23 Device ID 0x87 Product Vendor SEAGATE Product ID ST336607FC Product Revision 0006 Serial Number 3JA9TN7600007517T6P1 Node Name 20 00 00 11 C6 2D 5B F9 Port Name 22 00 00 11 C6 2D 5B F9 Port ID 02 0A DC Product Type Disk LUN Count s aaa E Status Online 4 4 2 3 All Targets 4 Target LUN List gt n Port Number 1 Individual LUNs When you select this option SANsurfer FC HBA CLI shows the LUN List Menu containing Product Vendor Product ID Port Name Port ID LUN ID OS LUN Name on Solaris and Linux NOTE W Inthe Solaris OS the QLA HBA driver supports a maximum of 256 LUNs W Inthe Solaris OS the QLC HBA driver supports a maximum of 16K LUNs Here is an example of the LUN information Product Vendor SEAGATE Product ID ST336607FC Product Revision 0006 LUN 0 Size 34 18 GB Type SBC 2 Direct access block device e g magnetic disk SN0054614 00 F 4 35 4 Interactive Commands Target LUN List Menu Command Line Options t and l XX QLOGIC EN V 2 b WWULN 20 00 00 0C 50 68 11 E 9A Hit RETURN to continue 4 4 2 4 All Target s 4 Target LUN List gt n Port Number 3 All Target s This choice shows information for all targets connected to the system including Path Target Device ID Product Vendor Product ID Product Revision
248. rget it finds with a LUN select a boot port name of 00 00 00 selectable boot this applies only if the boot BIOS is enabled To set a particular target as the boot device for a specific HBA type the following command scli e HBA Instance lt HBA WWPN gt Target WWNN Target WWPN gt Target ID LUN ID NOTE Because x86 Solaris does not require the Target ID the Solaris command is scli e HBA Instance lt HBA WWPN gt Target WWNN Target WWPN gt LUN ID SANsurfer FC HBA CLI checks all parameters to verify that the HBA targets and LUNs are valid If you select an HBA with no target or a target with no LUN SANsurfer FC HBA CLI shows an error message and aborts In Solaris SPARC setting the target ID to the target of the boot selected LUN is equivalent to persistently binding the target see 5 3 24 Therefore if the target is persistently bound its boot device entry must have the same target ID For all operating systems if the HBA already has boot devices defined and they are different from the ones in the command parameter or menu selection you are prompted to confirm the boot device selection The HBA already has a boot device s selected Do you want to replace it with the new one For all operating systems if the HBA already has boot devices selected and they are the same as the ones in the command parameter or menu selection the following message appears The H
249. ring Info This option allows you to show general or detailed Digital Diagnostic Monitoring Interface for optical transceivers NOTES W This option is supported only for QLA QLE QEM24xx 4GB HBAs W Under Solaris this option is disabled if you are using Linux inbox drivers SLES 10 0 RHEL 5 0 or latest To show Transceiver monitoring general information type scli dm HBA Instance HBA WWPN gt lt all gt general gen To show Transceiver monitoring detailed information type t scli dm HBA Instance HBA WWPN gt all details det Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA all All HBAs in the system 5 3 6 e Boot Device View Select Disable Use the e command to W Show the current boot device selection for all HBAs 1 Show the current boot device selection for a specific HBA 2 Set a target device as the boot device for an HBA 3 Selectable boot The OS boots from the first target the BIOS finds 4 Delete the boot device from an HBA 5 SN0054614 00 F 5 9 5 Non interactive Commands XX Command Summary QLOGIC E Se 5 10 In these commands HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA Target WWNN World wide node name of the target Target WWPN World wide port name of the target Target ID ID to which the target is bound LUN ID ID of the LUN
250. rning asking whether to continue the uninstall process For example The following package is currently installed QLScli OLogic SANsurfer FC CLI HBA Configuration Utility sparc 1 x x Build xx Do you want to remove this package 3 Type y and press ENTER The program shows a script warning asking whether to continue the uninstall process For example Removing installed package instance lt QLScli gt This package contains scripts which will be executed with super user permission during the process of removing this package Do you want to continue with the removal of this package y n q 4 Type y and press ENTER The pkgrm program notifies you when the uninstall process is complete For example Verifying package dependencies Processing package information opt QLogic Corporation SANsurferCLI adapters properties opt QLogic Corporation SANsurferCLI Executing postremove script Scli removed enu property file removed Adapter property file removed SCLI property file removed Updating system information Removal of QLScli was successful 3 3 3 2 Solaris x86 8 9 and 10 Uninstall Follow these steps to uninstall SANsurfer FC HBA CLI 1 Type the following to remove SANsurfer FC HBA CLI pkgrm QLSclix 3 14 SN0054614 00 F XX 3 Initial Installation QLOGIC Uninstalling SANsurfer FC HBA CLI A 2 The program shows the package name and a script war
251. rt 2 WWPN 21 01 00 E0 8B 25 CB D8 Online HBA Model QLA2462 5 Port 1 WWPN 21 00 00 E0 8B 85 8C 7C Loop down 6 Port 2 WWPN 21 01 00 E0 8B A5 8C 7C Online 7 All HBAs 8 Return to Previous Menu 4 2 1 HBA General Information per HBA Port 2 HBA Information gt 1 n Port Number When you select one of the HBAs by number this option shows the HBA Information Menu for that HBA port The menu includes E Information HBA Alias HBA Port Alias VPD 4 2 1 1 HBA Information Command Line Option i 2 HBA Information gt n Port Number gt 1 HBA Information This option produces the same HBA Information Menu available from the General Information Report menu See section 4 1 3 1 4 2 1 2 HBA Alias Command Line Option ha 2 HBA Information gt n Port Number gt 2 HBA Alias When you select this option SANsurfer FC HBA CLI shows the following information about the HBA 4 18 SN0054614 00 F XX 4 Interactive Commands QLOGIC HBA Information Menu Command Line Option i ls HBA Model WWNN Serial number Alias With this option you can create modify or delete the symbolic name or alias for an HBA From the Main Menu follow these steps 1 Type the number for the HBA Information option and press ENTER Type the number for the HBA you want to configure and press ENTER 3 Type the number for the HBA Alias option and press ENTER The
252. rters QLogic Corporation 4601 Dean Lakes Blvd Shakopee MN 55379 USA QLogic Web Site www qlogic com Technical Support Web Site support glogic com Technical Support E mail support qlogic com Technical Training E mail tech training qlogic com North American Region E mail support qlogic com Phone 1 952 932 4040 Fax 1 952 974 4910 1 8 PRELIMINARY SN0054614 00 F XX 1 Introduction QLOGIC Contact Information o OO Vo VVB LUuwuesseennmnmmmmmm Europe Middle East and Africa Region E mail emeasupport qglogic com Phone Numbers by Language 353 1 6924960 English 353 1 6924961 Francais 353 1 6924962 Deutsch 353 1 6924963 Espanol 353 1 6924964 Portugu s 353 1 6924965 Italiano Asia Pacific Region E mail apacsupport qlogic com Phone Numbers by Language 63 2 885 6712 English 63 2 885 6713 Mandarin 63 2 885 67 14 Japanese 63 2 885 6715 Korean Latin and South America Region E mail calasupport qlogic com Phone Numbers by Language 52 55 5278 7016 English 52 55 5278 7017 Espanol 52 55 5278 7015 Portugu s SN0054614 00 F PRELIMINARY 1 9 1 Introduction XX Contact Information QLOGIC NEN OO 9 Notes 1 10 PRELIMINARY SN0054614 00 F 2 1 Introduction Section 2 Getting Started SANsurfer FC HBA CLI operates in two modes Interactive menu driven The CLI starts and then waits for and exec
253. s 0 Status When the execution of the command line parameters fails the status value of non zero is displayed followed by an error message that provides additional details Status 1 lt Status gt ErrorMsg Details of the failure lt ErrorMsg gt A 1 4 Reboot Message When the execution of the command line parameters is successful and the system must be restarted for the change to take effect the following message is displayed Reboot 1 Reboot When the execution of the command line parameters is successful and the system does not need to be restarted the following message is displayed Reboot 0 Reboot A 1 5 Error Message Before the closing main tag lt QLogic gt but following the Status message SANsurfer FC HBA CLI displays error information if the status is non zero indicating a failure ErrorMsg Details of the failure lt ErrorMsg gt A 2 XML Format 1 Tags for Each Option The following sections describe the XML format 1 for each command line option In these sections the term number refers to the adapter number displayed with the HBA general information command line option T A 2 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option A E a A 2 1 Display System Information Command Line Option g The XML format 1 for system information output is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic
254. s 1 10000 10000 Test Increment 1 10000 a SN0054614 00 F 4 71 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC PRE S On Error Ignore Test Continuous OFF Diagnostics Read Write Buffer Test Result Hit RETURN to abort Iter No Data Pattern Status 263 5B 57 4B E5 29 D2 6A 1E Success 4 12 3 Diagnostics Transceiver Details DMI Command Line Option dm 12 Diagnostics gt n Port Number 3 Transceiver Details The Transceiver Details options is displayed only for 4Gb and 8Gb When you select this option SANsurfer FC HBA CLI shows the Transceiver Details Menu containing the following options General a Details Select either General or Details and press ENTER to retrieve the transceiver information for this port instance 4 12 3 1 Transceiver Details General Select the General option on the Transceiver Details menu to view general information for the selected HBA port The following shows an example HBA Instance 4 QLE2562 Port 2 WWPN 21 01 00 1B 32 36 18 EE PortID 01 0F 00 Media Information Vendor Intel Corp Type 800 M6 SN I Part Number TXN31118D100000 Speed 200 MBytes Sec 400 MBytes Sec 800 MBytes Sec Revision Serial Number AZ8P72890H23 4 72 SN0054614 00 F XX 4 Interactive Commands QLOGIC Diagnostics Menu Command Line Options kl kr and dm
255. s Continued Command Line Arguments Function Action fs lt hba instance hba wwpn Configures the driver settings lt param name gt lt param alias gt lt param value gt gs lt hba instance gt lt hba wwpn gt Shows the current statistics on an HBA port lt param name gt lt param alias gt lt param value gt zh qo Lists all the command options and syntax Option h can be combined with a command line option to display the usage of that individ ual command ha lt hba instance hba wwpn gt Sets an alias to an HBA alias ha lt hba instance gt lt hba wwpn gt Deletes the current alias of an HBA delete ha lt hba instance hba wwpn gt Displays the current alias of an HBA view i lt hba instance gt hba wwpn gt Views the general or VPD information of an vpd HBA port i all vpd Views the general or VPD information of all HBAs kl lt hba instance hba wwpn Runs a diagnostics loopback test on an HBA lt param name lt param port alias gt lt param value gt kr lt hba instance gt lt hba wwpn gt Runs a diagnostics read write buffer test to all x xclude target target device s attached to an HBA port wwpn lt param name gt lt param alias param value lt hba instance hba wwpn gt Displays
256. s gt N PortNumber b 2 Configure HBA Parameters n Data Rate This option shows the Data Rate menu Note that data rate configuration is not available for all HBA port instances From this menu you can select Auto B 1 Gbps B 2Gbps B 4Gbps BH 8Gbps NOTE The 1 Gbps data rate is not supported with 8Gi HBAs Type the number for the data rate you want and press ENTER 4 3 1 2 3 Frame Size 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters gt n Frame Size This option shows the Frame Size menu From it you can select SN0054614 00 F 4 25 4 Interactive Commands XX HBA Parameters Menu QLOGIC EN AB 31 OV o uu Frame Size 512 ul Frame Size 1024 E Frame Size 2048 Type the number for the frame size you want and press ENTER 4 3 1 2 4 Hard Loop ID 3 HBA Parameters gt N PortNumber gt 2 Configure HBA Parameters gt n Hard Loop ID This option prompts you to enter a valid Hard Loop ID from 0 to 125 Type the number you want and press ENTER 4 3 1 2 5 Loop Reset Delay 3 HBA Parameters gt N PortNumber 2 Configure HBA Parameters gt n Loop Reset Delay This option prompts you to enter a Reset Delay from 0 to 255 seconds Type the number you want for the loop reset delay and press ENTER 4 3 1 2 6 Enable HBA Port BIOS 3 HBA Parameters gt N Port Number 2 Configure HBA Parameters gt n Enable HBA Port BIOS This option allows you to enab
257. s 3 13 3 3 3 Solaris Uninstall Sacro scutes Ronde Sete e Bra ante Oe ue Shee ee E 3 13 3 3 3 1 Solaris SPARC 8 9 and 10 Uninstall 3 14 3 3 3 2 Solaris x86 8 9 and 10 Uninstall 0 00 3 14 3 3 4 Macintosh Wminstalls sve geo eo ee 9r ad ie nea ERE es 3 15 Section 4 Interactive Commands 4 1 General Information Menu Command Line Option g 4 2 4 1 1 Host Information Command Line Option 9 lusus 4 2 4 1 2 Host Topology Command Line Option tp topology 4 3 4 1 2 1 Display Host Topology Command Line Option tp TODOIOQY cea acd mone oe re vi diem o dos etel e 4 4 4 1 2 2 Save As Txt File Command Line Option b 4 8 4 1 2 3 save As AME Fil amp 22364 thase date wt oe bP a athe RA RES 4 8 4 1 3 Generate Report Command Line Option z 4 9 4 1 3 1 Generate Report Per HBA Port 2005 4 9 4 1 3 2 Generate Report All HBAs Command Line Option z 4 17 4 1 4 BGIIGSI ee tacos A toc T BY EL Lt abi RM LE ME nar MI a e 4 17 4 2 HBA Information Menu Command Line Option i 4 17 4 2 1 HBA General Information per HBA Port 0 0000 4 18 4 2 1 1 HBA Information Command Line Option i 4 18 4 2 1 2 HBA Alias Command Line Option ha 4 18 4 2 1 3 HBA Port Alias Command Line Option pa 4 19 4 2 1 4 HBA VPD Information
258. s S exte ROTER FEEGAU QUe eu ke ues 5 5 5 3 1 a View or Toggle Beacon Status nannaa aaea 5 6 5 3 2 b Save or Update the Flash BIOS or Fcode 5 7 5 3 3 c Show Parameter Settings 0 00 e eee eee 5 8 5 3 4 d Update Device Driver 02 00 ee 5 8 5 3 5 dm Display Diagnostics Monitoring Info 5 9 5 3 6 e Boot Device View Select Disable 0 5 9 5 3 7 ei List SANsurfer FC HBA CLI Error Codes 4 5 12 5 3 8 f Input Parameter Options from a Text File 5 12 5 3 9 fg Show Driver Settings 0 0 0 cece te eee 5 13 5 3 10 fs Configure Driver Settings 0 0222 e ee eee 5 13 5 3 11 g Display System Information 000 cee eee eee 5 14 5 3 12 gs Show HBA Statistics 2s 4400 m RR RIS 5 14 5 3 13 sel de eres doe po he RB teer EO ee PES Bs 5 15 5 83 14 ha Set Delete HBA Alias llli 5 16 5 3 15 i Display HBA General Information or VPD Information for One or AI HBAS ec ts eae Badii eren mae fa te eRe e d 5 17 SN0054614 00 F Page xv SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC e S 5 3 16 5 3 16 1 5 3 16 2 5 3 16 3 5 3 16 4 5 3 16 5 5 3 16 6 5 3 17 5 3 18 5 3 18 1 5 3 18 2 5 3 19 5 3 20 5 3 21 5 3 22 5 3 23 5 3 24 5 3 25 5 3 26 5 3 27 5 3 28 5 3 29 5
259. s in either section 4 17 1 1 interactive mode or section 4 17 1 2 6 non interactive mode SN0054614 00 F 4 65 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC DEEXECETNROIGANENEEGK SS After completing the loopback test do the following steps to prepare for normal HBA operations 1 Remove the loopback connector from the HBA connector 2 Reconnect the cable that you disconnected before installing the loopback connector 3 From the Connections Options menu interactive mode or the N command non interactive mode change the setting back to its previous setting 4 12 1 2 Run Loopback Test When you select Start Diagnostics Test for the loopback test the following is returned example HBA Instance 4 QLE2562 Port 2 WWPN 21 01 00 1B 32 36 18 EE PortID 01 0F 00 Test Configuration Data Pattern Random Data Size Bytes s4512 Number of test s 1 65535 65535 Test Increment 1 65535 SET On Error Ignore Test Continuous OFF Diagnostics Loopback Test Result Hit RETURN to abort HBA Test Data Pattern Status CRC Disparity FrameLength 4 BB 54 01 BD AC 24 DD 80 Success 0 0 0 Finished 6376 iterations in 1 second s 4 12 2 Diagnostics Read Write Buffer Test 12 Diagnostics gt n Port Number 2 Read Write Buffer Test When you select this option SANsurfer FC HBA CLI shows the Read Write Buffer Test Men
260. s restore default Flash update from file Flash save to file HBA parameters update from file HBA parameters save to file HBA parameters update from templates 1 6 Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic HBA products QLogic direct customers may contact QLogic Technical Support others will be redirected to their authorized maintenance provider SN0054614 00 F PRELIMINARY 1 7 1 Introduction XX Contact Information QLOGIC ee 9 9 9 9 Visit the QLogic support Web site at support glogic com for the latest firmware and product updates 1 6 1 Availability QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays 1 6 2 Training QLogic offers certification training for the technical professional for both the QLogic FC HBAs and switches From the training link at www glogic 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 e mail at tech training qlogic com 1 7 Contact Information Support Headqua
261. sSerialOP gt value lt TX_DisableImplementedAndDisablesSerialOP gt lt RATE_SelectImplemented gt value lt RATE_Select Implemented gt lt Options gt lt BR Max gt value lt BR Max gt lt BR Min gt value lt BR Min gt lt VendorSN gt value lt VendorSN gt lt DateCode gt value lt DateCode gt lt DiagMonitoringType gt lt AddressChangeRequired gt value lt AddressChangeRequired gt lt PowerMeasurement gt value lt PowerMeasurement gt lt ExternallyCalibrated gt value lt ExternallyCalibrated gt lt InternallyCalibrated gt value lt InternallyCalibrated gt lt DigitalDiagMonitoring gt value lt DigitalDiagMonitoring gt lt LegacyDiagnostic gt value lt LegacyDiagnostic gt lt DiagMonitoringType gt lt EnhancedOptions gt lt SoftRateSelectCtrlAndMonitoring gt value lt SoftRateSelectCtrlAndMonitoring gt SoftRXLOSMonitoring value SoftRXLOSMonitoring SoftTXFaultMonitoring value lt SoftTXFaultMonitoring gt SoftTXDisableCtrlAndMonitoring value SoftTXDisableCtrlAndMonitoring Alarm WarningFlags value lt Alarm WarningFlags gt lt lt lt lt lt lt lt SN0054614 00 F A 17 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC R S lt EnhancedOptions gt lt SFF 8472 Compliance gt value lt SFF 8472 Com
262. stance When you have set the link speed for all the instances you want to type the number for Apply changes to Selected Target s and press ENTER The system returns a message indicating the changes have been saved For example New iiDMA setting has been saved to seleted target s on HBA instance O0 4 5 4 3 IiDMA Settings Disk 5 iiDMA Settings gt 1 n HBA Portn gt n Diskn When you select a specific disk on the HBA port the following options are available on the iiDMA Menu Advanced 1 Gps B 2Gps m 44Gps 4 5 5 IiDMA All HBAs 5 iiDMA Settings gt n All HBAs When you select All HBAs to configure the options for Basic Configuration and Advance Configuration appear on the menu See 4 5 1 Configuring the iiDMA Settings 4 6 Target Persistent Bindings Menu Command Line Option p 6 Target Persistent Bindings SN0054614 00 F 4 45 4 Interactive Commands XX Target Persistent Bindings Menu Command Line Option p QLOGIC EN VV V When you select this option SANsurfer FC HBA CLI shows the Target Persistent Binding menu listing standard HBA port instances see 4 5 2 where you can select an individual HBA port or All HBAs The following sections describe how to view set and delete the HBA s target persistent binding in interactive and non interactive modes NOTES B Ina Solaris OS QLA QLE24xx and QEM2462 HBAs with a QLA driver allow up to 2048 targets with target IDs in
263. stent Q Group Binding Devices LUNs Information Selective LUNs Information C Boot Device Settings To show the information for a single HBA type the following command scli z lt HBA Instance gt lt HBA WWPN gt Where HBA Instance HBA number use g command to find HBA WWPN World wide port name of the HBA To show the information for all HBAs type scli z all 5 2 SN0054614 00 F XKX 5 Non interactive Commands QLOGIC Display System Information Command Line Options g z and tp ls 5 2 3 Host Topology Command Line Option tp NOTE Under Linux host topology tp is disabled if you are using the ioctl or sysfs inbox driver The command format for Host Topology is scli tp When you select this option the SANsurfer FC HBA CLI tool shows the information in section 5 2 2 as well as the following additional information W Interconnect Element switch or HBA Type Switch or HBA World wide name Domain ID Management ID IP address Model Symbolic name Serial number MAC address Firmware version Port count Beacon status DODCDDOCOCODOCOLD W Interconnect element HBA Type World wide node name World wide port name Vendor ID HBA Model HBA Serial Number HBA Alias Port Alias Driver Version Firmware Version Total Number of Devices Host Number of Port Beacon status Port Type DOCOCODDOCDOIDOCODOCUO SN0054614 00 F 5 3 5 Non interactive Comm
264. sup ported with current HBA 233 ERROR INVALID IIDMA SETTINGS Selected target link speed rate not supported with current HBA 234 Reserved Not used 235 Reserved Not used 236 Reserved Not used 237 Reserved Not used 238 Reserved Not used 239 Reserved Not used 240 ERROR NO TARGET SELECTED Unable to run target beacon because no device is selected 241 ERROR GET BEACON STATE Unable to get the beacon status 242 ERROR SET BEACON STATE Unable to set the beacon status 243 ERROR BEACON UNSUPPORTED Beacon operation is unsupported 244 ERROR INVALID BEACON PARAMETERS Beacon settings is invalid 245 Reserved Not used 246 Reserved Not used 247 Reserved Not used 248 Reserved Not used 249 Reserved Not used 250 ERROR GET HBA ALIAS Failed to retrieve HBA alias of the HBA 251 ERROR UPDATE HBA ALIAS Failed to update HBA alias of the HBA 252 ERROR GET PORT ALIAS Failed to retried port alias of the HBA 253 ERROR UPDATE PORT ALIAS Failed to update port alias of the HBA 254 Reserved Not used 255 Reserved Not used 256 Reserved Not used SN0054614 00 F D 11 D Non interactive Error Codes XX QLOGIC E e Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 257 Reserved Not used 258 Reserved Not used 259 Reserved Not used 260 ERROR DRIVER RESCAN Driver rescan operation failed Solaris 261 Reserved No
265. support hours 1 8 R r 4 57 5 38 rate data 4 25 read write buffer test 4 66 results A 9 B 13 running 4 67 5 23 5 24 reboot message XML Format 1 A 2 XML Format 2 B 2 receive out of order frame enable 4 23 Red Hat SuSE Linux driver layers Glossary 2 refresh configuration of host 4 17 report all HBAs 4 17 one port instance 4 9 rescan driver Solaris 4 60 reset target 5 32 ResetDelay parameter 5 32 restore link default 4 81 restoring default 4 78 default HBA parameters 4 29 default settings 4 78 revision history of guide ii SN0054614 00 F rs 4 60 running diagnostic tests 4 67 S s 5 5 5 38 SAN Storage Area Network definition of Glossary 6 SAN Device Management SDM API 4 3 sans serif font meaning of 1 2 SANsurfer FC HBA CLI downloading installation package 3 2 hardware requirements 1 5 HBAs supported 1 4 operating systems supported 1 4 product overview 1 1 software requirements 1 6 saving configuration 4 54 Fcode 5 7 Flash BIOS 5 7 Flash file 4 56 HBA parameters 4 57 topology as text file 4 8 saving as XML file 4 8 XML Format 1 4 8 XML Format 2 4 9 SCSI definition of Glossary 6 layers definition of Glossary 2 SDM API 4 3 SDM API version 4 3 select boot device 5 9 selectable boot 5 9 selective LUNs 4 49 settings driver 4 54 SFF DMI viewing A 15 B 3 Index 9 SANsurfer FC HBA CLI User s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters XX QLOGIC E Se
266. t 2 XX Display System Information Command Line Option g QLOGIC ee B 7 4 View Driver Settings Command Line Option fg The command format is scli fg HBA Instance lt HBA WWPN gt VIEW x2 The XML Format 2 for the current driver settings information is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt HBA gt HBA Instance value HBAModel value HBAPort value WWNN value WWPN value gt lt DriverSettings gt lt Info PersistentPlusNew value PersistentOnly value BindbyWWPN value BindbyPortID value DriverSettings HBA Status n lt Status gt ErrorMsg message ErrorMsg Reboot n Reboot QLogic B 8 Display System Information Command Line Option g The command format is scli g x2 The XML Format 2 for system information output is as follows lt xml version value encoding value gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLISANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn n nn Build nn lt AppVersion lt AppXmlVersion gt n nn lt AppXmlVersion gt lt Host gt lt Name gt Host Name lt Name gt lt OSType gt OS Type lt OSType gt lt OSVersion gt OS Version lt Build value lt OSVersion gt lt SDMAPIVersion gt n nn nn nn lt SD
267. t AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt Target gt lt WWNN gt Target WWNN lt WWNN gt lt WWPN gt Target WWPN lt WWPN gt lt EnabledLUN ID value LUNWWNN value LUNWWPN value gt lt Target gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt The lt HBA gt lt HBA gt sequence repeats for each HBA The Target Target sequence repeats for each Target The EnabledLUN sequence repeats for each enabled LUN under the target Boot Device Command Line Option e The XML Format 1 for the boot device information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt BootDevice TargetWWPN value LUNID value gt lt HBA gt lt Status gt 0 lt Status gt A 8 SN0054614 00 F XX A XML Format 1 QLOGIC XML Format 1 Tags for Each Option I e M lt Reboot gt 0 lt Reboot gt lt QLogic gt The lt BootDevice gt sequence is repeated for each boot device of the adapter In Windows and Linux the Target ID value field is not present A 2 9 Diagnostics Results Loopback Test Command Line Option kl The XML Format 1 for
268. t BiasLowWarning gt value lt BiasLowWarning gt PowerHighAlarm gt value lt TXPowerHighAlarm gt PowerLowAlarm gt value lt TXPowerLowAlarm gt PowerHighWarning gt value lt TXPowerHighWarning gt PowerLowWarning gt value lt TXPowerLowWarning gt RXPowerHighAlarm value lt RXPowerHighAlarm gt RXPowerLowAlarm gt value lt RXPowerLowAlarm gt RXPowerHighWarning gt value lt RXPowerHighWarning gt RXPowerLowWarning gt value lt RXPowerLowWarning gt Rx PWR 4 value Rx PWR 4 PWR 3 value Rx PWR 3 Rx PWR 2 value Rx PWR 2 Rx PWR 1 value Rx PWR 1 Rx PWR 0 value Rx PWR 0 Slope value Tx I Slope Offset value Tx I Offset PWR Slope value Tx PWR Slope PWR Offset value Tx PWR Offset lope value T Slope ffset value T Offset V Slope value V Slope V Offset value V Offset lt Checksum gt value lt Checksum gt Temperature_MSB gt value lt Temperature_MSB gt Temperature_LSB gt value lt Temperature_LSB gt Vcc MSB value lt Vcc_MSB gt Vcc LSB value lt Vcc_LSB gt TX Bias MSB value TX Bias MSB X Bias LSB value TX Bias LSB TX Power MSB value TX Power MSB TX Power LSB value TX Power LSB RX Power MSB value RX Power MSB RX Power LSB value RX Power LSB Reserved MSB value Reserved MSB Reserved LSB value Reserved LSB Reserve
269. t HBA gt lt HBA gt sequence is repeated for each HBA B The lt Target gt lt Target gt sequence is repeated for each target W The lt LUN parameter is repeated for each LUN a The lt EnabledLUN ID parameter is repeated for each enabled LUN The TargetBinding parameter is repeated for each target persistent binding entry B The lt BootDevice gt parameter is repeated for each boot device selection entry 4 2 13 Link Statistics Command Line Option Is The XML Format 1 for the link statistics option is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWPN value WWNN value gt lt LinkStatus PortName value LinkFailure value SyncLoss value SignalLoss value InvalidCRC value TimeStamp value gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt A 2 14 HBA Statistics Command Line Option gs The XML Format 1 for the HBA statistics option is as follows SN0054614 00 F A 13 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC eea S lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value
270. t any port and press ENTER to view the disk details of that port including the current beacon status HBA Instance 1 2200 Port 2 Online WWPN 21 01 00 E0 8B 23 55 7C Desc QLA2200 02 12 04 QLA2202FS QCP2202 1 Disk Vendor SEAGATE Product ID ST136403FC Port Name 21 00 00 20 37 1A 6B CF kort ID 11 01 EA Beacon No 2 Disk Vendor SEAGATE Product ID ST118273 CLAR18 Port Name 21 00 00 20 37 11 FF EF Port ID 11 01 E8 Beacon No 3 Beacon Selected Target s 4 Return to Previous Menu SN0054614 00 F 4 61 4 Interactive Commands XX Diagnostics Menu Command Line Options kl kr and dm QLOGIC You can select a disk number to blink the LED on that target The blinking asterisk below the Device Port Name line shows that the target beacon is active HBA Instance 1 2200 Port 2 WWPN 21 01 00 E0 8B 23 55 7C PortID 11 06 00 Target Beacon Hit lt RETURN gt to abort Device Port Name Beacon Status 21 00 00 20 37 11 FF EF On Active 4 11 2 1 Beacon Selected Target s 11 Beacon gt 2 Locate Target s 3 Beacon Selected Target s When you select the Beacon Selected Target s option SANsurfer FC HBA CLI shows a list of the targets associated with the HBA You can select any target to toggle the Beacon LED for that target 4 12 Diagnostics Menu Command Line Options kl kr and dm 12 Diagnostics When you select
271. t gt Value gt value lt Value gt Status gt value lt Status gt HighAlarm gt value lt HighAlarm gt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt lt LowAlarm gt value lt LowAlarm gt lt TxBias gt lt TxPower gt lt MeasuredTxPowerUnit gt mW lt MeasuredTxPowerUnit gt lt Value gt value lt Value gt lt Status gt value lt Status gt lt HighAlarm gt value lt HighAlarm gt lt HighWarning gt value lt HighWarning gt lt lt lt lt lt lt lt lt LowWarning gt value lt LowWarning gt LowAlarm gt value lt LowAlarm gt lt TxPower gt lt RxPower gt easuredRxPowerUnit gt mW lt MeasuredRxPowerUnit gt Value gt value lt Value gt Status gt value lt Status gt HighAlarm gt value lt HighAlarm gt HighWarning gt value lt HighWarning gt LowWarning gt value lt LowWarning gt LowAlarm gt value lt LowAlarm gt lt RxPower gt lt Diagnostics gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt NA AA AA A The XML Format 1 for SFF DMI detailed information is as follows lt xml version 1 0 encoding ISO 8859 1 gt lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt lt AppVersion gt vn nn nn Build nn lt AppVersion gt lt HBA gt lt HBA Port value WWNN value WWPN value gt lt OpticalTransceiverDigitalDiagnosticData gt
272. t used 262 Reserved Not used 263 Reserved Not used 264 Reserved Not used 265 Reserved Not used 266 Reserved Not used 267 Reserved Not used 268 Reserved Not used 269 Reserved Not used 270 ERROR ADAPTER PROP MISSING Adapter property file is missing 280 ERROR CREATE VIRTUAL PORT Failed to create a virtual port of the HBA 281 ERROR DELETE VIRTUAL PORT Failed to delete a virtual port of the HBA 282 ERROR INVALID VIRTUAL PORT WWN Virtual port WWPN is invalid 283 ERROR VIRTUAL PORT NOT FOUND Unable to find the specific virtual port 284 ERROR NO VIRTUAL PORT EXIST This HBA does not have any virtual ports 285 ERROR DELETE ALL VIRTUAL PORTS Failed to delete all virtual ports of the HBA D 12 SN0054614 00 F Appendix E Help Commands Table E 1 is an alphabetic listing of the Help commands Unless otherwise noted only one command line option per input file is valid The hyphen and slash characters are equivalent Thatis scli g and scli g are both valid commands Table E 1 uses the following variables hba instance HBA instance number of an HBA port hba wwpn gt World Wide Port Name of an HBA port xx XX XxX XxX XX XX XX XX OF XXXXXXXXXXXXXX target wwnn gt World Wide Node Name of a target device XX XX XX XX XX XX XX XX Of XKXXXXXXEXXXXXXX target wwpn gt World Wide Port Name of a target device xx XX XX XX XX XX XX XX Of XKXXXXXXXXXXXXX target porti
273. t veces Seow EE ee Poe a RE eS 4 13 1 2 Show HBA Statistics llli lesse Page xiv SN0054614 00 F XX SANsurfer FC HBA CLI User s Guide QLOGIC Command Line Interface for QLogic Fibre Channel Host Bus Adapters lls 4 13 2 Link Status Command Line Option Is 020000e eee 4 80 4 13 2 1 CONNQUIAIION es dor Esdr PE be A ouo eae dd 4 80 4 13 2 2 Show Ink StatUS ss secs eeens e ru Re Rue OX ENDE ER PAG 4 82 4 14 Virtual Menu Command Line Option vp isses 4 83 4 14 1 Virtual Menu for HBA Instance slllslesssuesss 4 85 4 14 1 1 List Virtual Ports 5s kroan ban se lee Gai es X Re ante a 4 85 4 14 1 2 Delete Virtual Port S ssi ode oe bare EE RR 4 86 4 14 1 3 Create Virtual Port S aoc RES RRERLA ELDER eonas 4 86 4 15 Help Menu Command Line Option h s an saanane 4 87 4 15 1 Coments oss dore besruP P RARRCEWEAC NER RI equ Eb E qd esed 4 88 4 15 2 EXILCOUSS Soin iR Nu edo A torta en Arai ye edd ee 4 88 4 15 3 PDO pe TE TETTE TENERE 4 88 Section 5 Non interactive Commands 5 1 Introductio yy ewe P eI NX XR ERR EE ERR ERE EXER ES 5 1 5 2 Display System Information Command Line Options g z and tp 5 1 5 2 1 Host Information Command Line Option 9 lusus 5 1 5 2 2 Host Configuration Command Line Option z 5 2 5 2 3 Host Topology Command Line Option tp lsssessss 5 3 5 2 4 Host Configuration y Rp IEEE RReP ERE REGES 5 4 5 3 Command Summary 3
274. talDiagMonitoring gt value lt DigitalDiagMonitoring gt LegacyDiagnostic gt value lt LegacyDiagnostic gt lt DiagMonitoringType gt lt EnhancedOptions gt lt SoftRateSelectCtrlAndMonitoring gt value lt SoftRateSelectCtrlAndMonitoring gt SoftRXLOSMonitoring value SoftRXLOSMonitoring SoftTXFaultMonitoring value lt SoftTXFaultMonitoring gt lt SoftTXDisableCtrlAndMonitoring gt value SoftTXDisableCtrlAndMonitoring lt EnhancedOptions gt 8472 Compliance value SFF 8472 Compliance EXT Ox7d CC EXT SFF CC Alarm WarningFlags value lt Alarm WarningFlags gt VendorSpecific value VendorSpecific Address A0 Address A2 lt TempHighAlarm gt value lt TempHighAlarm gt lt TempLowAlarm gt value lt TempLowAlarm gt B 6 SN0054614 00 F XX B XML Format 2 QLOGIC XML2 Tags for Each Option I a lt TempHighWarning gt value lt TempHighWarning gt lt TempLowWarning gt value lt TempLowWarning gt lt VoltageHighAlarm gt value lt VoltageHighAlarm gt lt VoltageLowAlarm gt value lt VoltageLowAlarm gt lt VoltageHighWarning gt value lt VoltageHighWarning gt lt VoltageLowWarning gt value lt VoltageLowWarning gt lt BiasHighAlarm gt value lt BiasHighAlarm gt lt BiasLowAlarm gt value lt BiasLowAlarm gt lt BiasHighWarning gt value lt BiasHighWarning gt l
275. te or delete a virtual HBA you should refresh the configuration to see the changes 4 14 1 1 List Virtual Port s 14 Virtual gt 1 Virtual Menu 3 List Virtual Ports When you select this option the menu of virtual ports on this physical HBA port appears showing SN0054614 00 F 4 85 4 Interactive Commands XX Virtual Menu Command Line Option vp QLOGIC E S W List Virtual Ports including for each Q Instance Number Q Virtual Port Number OQ WWPN OY Status Online or Loop Down Here is an example Virtual Menu HBA Model QLA2462 0 VPort 3 WWPN 21 00 7B E0 8B 14 5A CF Online 1 VPort 2 WWPN 21 00 67 E0 8B 14 5A CF Online 4 Return to Previous Menu 4 14 1 2 Delete Virtual Port s 14 Virtual gt 1 Virtual Menu 3 Delete a Virtual Port To delete a virtual port select a virtual port number from the Delete a Virtual Port menu To see the change you must manually refresh the virtual port configuration 4 14 1 3 Create Virtual Port s 14 Virtual gt 1 Virtual Menu 3 Create a Virtual Port When you select this option the Create Virtual Port Menu for this HBA Instance appears showing a HBA Instance n L HBA Model Port Number L Status Q Description B Followed by the menu Auto Generate L User Generate Here is an example Create Virtual Port Menu HBA Instance 4 QLA2462 Port 1 Online Desc QLA2462 PCI X 2 0 to 4Gb FD Dual Channel 1 Auto G
276. the information about LUNs attached to an HBA port lt hba instance hba wwpn Displays the information about LUNs of a tar target wwpn target get device attached to an HBA port portid l lt hba instance hba wwpn Displays the information about a specific LUN target wwpn target of a target device attached to an HBA port portid lun id E 4 SN0054614 00 F XX QLOGIC E Help Commands I Table E 1 Help Commands Continued SN0054614 00 F Command Line Arguments Function Action ls lt hba instance hba wwpn Shows the current link status on an HBA port lt param name gt lt param alias gt lt param value gt m lt hba instance hba wwpn Views selective LUN information of all devices view attached to an HBA port m lt hba instance hba wwpn Views selective LUN information of a single target wwnn target wwpn gt device attached to an HBA port lun id view m lt hba instance hba wwpn Configures all LUNs of a device attached to an select enable target wwnn gt HBA port Enable target wwpn gt m lt hba instance gt hba wwpn Configures all LUNs of all devices attached to select all an HBA port Enable m lt hba instance hba wwpn Configures all LUNs of all devices attached to unselect disable
277. the range of 0 2047 B Ina Solaris OS QLA QLE23xx HBAs with a QLA driver allow up to 256 targets with target IDs in the range of 0 2047 W Under Solaris this feature is disabled if you are using the driver from the OS installation CDs QLC driver Under Linux this feature is disabled if you are using the ioctl or sysfs inbox driver Whether you select a particular HBA Port Instance or All HBAs the Target Persistent Bindings Menu appears 4 6 1 Target Persistent Bindings Per HBA Port Command Line Option p 6 Target Persistent Bindings 1 n Target Persistent Bindings HBA Instance n When you select an HBA Instance to view or change its binding this menu the Target Persistent Bindings Menu for a particular HBA instance appears It shows the binding options you can choose from W Display Configuration W Bind Target s W Unbind Target s Type the number for the option you want and press ENTER 4 6 1 1 Display Target Persistent Binding Command Line Option p 6 Target Persistent Binding gt 1 n Target Persistent Binding HBA Instance n gt 1 Display Configuration When you select the Display Configuration option the following information appears Or the message No target persistent binding configuration on HBA instance n appears instead B Bind status Yes W Device type Disk for example 4 46 SN0054614 00 F XX 4 Interactive Commands QLOGIC Target Persistent Bindings Menu Command
278. these options general information appears in various formats For example m scli g shows Host Information see section 5 2 1 a scli z shows Host Configuration see section 5 2 2 a scli tp shows Host Topology see section 5 2 3 5 2 1 Host Information Command Line Option g The command format to show host information is scli g When you enter this option the following information about the local machine appears Host Name OS type OS version patches where applicable SAN target management SDM API version List of HBAs HBA model port number WWPN serial number SN HBA number HBA 0 n and status online offline W Total number of QLogic FC HBAs detected SN0054614 00 F 5 1 5 Non interactive Commands XX Display System Information Command Line Options g z and tp QLOGIC ee NOTE The failover and SAN device management APIs are QLogic specific libraries required for SANsurfer FC HBA CLI The versions of these libraries are useful for debugging purposes 5 2 2 Host Configuration Command Line Option z The command line option z shows all of the HBA s information in a single command The command format is scli z The SANsurfer FC HBA CLI tool shows the information in section 5 2 1 as well as the following additional information E HBA General information HBA Vital Product Data VPD HBA Parameter Settings Driver Settings Information Q Group Persi
279. tial Installation QLOGIC Installing SANsurfer FC HBA CLI lS To create a response file for a silent installation of SANsurfer FC HBA CLI enter the following scli 1 x x xx windows exe r fl C NTempMinstall 1l iss To run the installation in silent mode with a log file enter the following Scli 1 x x xx windows exe s f1 C Temp install_2 iss To run the installation in silent mode with an alternate file in a temporary directory enter the following Scli 1 x x xx windows exe s f1 C Temp install_l iss 2 C Temp install_3 log NOTE After installing SANsurfer FC HBA CLI you can create an uninstallation script for future use by creating a response file with a different name For example scli 1 x x xx windows exe r 1 C Temp uninstall iss 3 2 2 Linux Installation To install SANsurfer FC HBA CLI on a Red Hat SuSE Linux operating system follow these steps 1 Download the scli x xx xx xx i1386 rpm gz file from the QLogic Web site or the FC HBA Manager CD ROM to your local machine In the file name x xx xx stands for the current version of SANsurfer FC HBA CLI 2 Uncompress the file with the following command gunzip file name 3 Enter the following command to install the package rpm iv scli x xx xx xx i386 rpm NOTE For SuSE SLES IA64 the command line is rpm iv scli x xx xx xx ia64 rpm nodeps The new package is installed in the following directory opt QLogic Corporation SANsurferCLI
280. tion is available only on Windows systems running with a driver that supports NPIV N Port ID Virtualization SN0054614 00 F 4 1 4 Interactive Commands XX General Information Menu Command Line Option g QLOGIC ee Selections from the Main Menu open new menus For example if you click item 1 General Information on the main interactive menu the system shows a new menu the General Information Menu From this menu you have several choices including 1 Host Information 2 Host Topology and so forth On every menu you can type the number for Return to Previous Menu and move to the next higher level parent menu In the remainder of this section you will see a breadcrumbs line following most subsection headings The breadcrumbs line shows you how to access that option that is it shows the hierarchical path from the top level to the command under discussion For example to reach the Save to Txt File options from the main SANsurfer FC HBA CLI menu you would select option 1 to open the General Information menu 2 to open the Host Topology menu and 2 again to see the Save As Txt File options The following shows the breadcrumbs example 1 General Information 2 Host Topology 2 Save As Txt File 4 1 General Information Menu Command Line Option g 1 General Information This option shows you general information for the HBA To see the HBA General Information menu from the Main Menu type the number for the Gen
281. to enter a value for Manual Poll iteration Manual Poll iteration 1 256 Enter a value from 1 to 256 and press ENTER The system updates the Manual Poll iteration value and returns the following message Manual Poll updated 4 13 1 1 4 Set Rate 13 Statistics 1 HBA Statistics 1 Configuration 4 Set Rate The system prompts you to enter a value for the sampling rate the current rate is shown in parentheses Sampling Rate Seconds 5 30 n Enter a value from 5 to 30 and press ENTER The system updates the sampling rate and returns a message Sampling rate updated 4 13 1 1 5 Log to File 13 Statistics gt 1 HBA Statistics 1 Configuration 5 Log To file When you select the Log to File option the system prompts you to enter a file name or press RETURN to cancel If you press the ENTER key the HBA Statistics Settings Menu reappears If you enter a file name for example MyFile the system saves the log to that file and returns a message Save to file option enabled MyFile csv The file name extension csv indicates a Comma Separated Value file type 4 13 1 2 Show HBA Statistics 13 Statistics gt 1 HBA Statistics 1 Show HBA Statistics To view the HBA port statistics 1 From the Main Menu type the number for the Statistics option and then press ENTER 2 From the Statistics Menu type the number for the HBA Statistics option and then press ENTER SN0054614 00 F 4 79 4
282. u containing the following options 4 66 SN0054614 00 F XX QLOGIC 4 Interactive Commands Diagnostics Menu Command Line Options kl kr and dm ls 4 12 2 1 Configure W Display Test Parameters B Reset Test Parameters B Configure Test Parameters W Start Diagnostics Test The read write buffer test sends specified data through the SCSI Write Buffer command to a target device disk It then reads the data back through the SCSI Read Buffer command and compares the data for errors The test also compares the link status of the target before and after the read write buffer test If errors occur the test indicates a broken or unreliable link between the HBA port and the target NOTE M Under Solaris this feature is disabled if you are using the driver from the OS installation CDs QLC driver W Some targets may not support read write buffer commands Check with your hardware vendors or manufacturer Read Write Test Parameters To prepare for a read write buffer test follow these steps 1 The read write buffer test must be run on a disk device Before running the read write buffer test verify that the HBA port is connected to at least one target by viewing the host configuration information In interactive mode from the Show System Information option type the number for the Host Configuration option and then press ENTER To run a loopback test or a read write buffer test 1 Selectthe number for the Diag
283. u for HBA Instance m including the HBA model number and details about its specifications You can choose to configure the following W Primary Boot Device Alternate 1 Boot Device Alternate 2 Boot Device Alternate 3 Boot Device 4 8 1 2 1 Boot Device Settings 8 Boot Device gt n Port Number 2 Configure Boot Device 2 Boot Device Settings When you select this option SANsurfer FC HBA CLI shows the Boot Device Settings menu with information about each one including W Device type for example Disk LC Order Primary secondary and so forth Boot Port Name WWPN B BIOS Boot Default 4 8 1 2 2 LUN List Menu 8 Boot Device gt n Port Number 2 Configure Boot Device 2 Boot Device Settings 1 LUN List Menu When you select this option SANsurfer FC HBA CLI shows the LUN List Menu which includes a list of LUNs on the selected device You can select any of the IUNs as the boot device m LUN 0 a LUN 1 And so on SN0054614 00 F 4 53 4 Interactive Commands XX Driver Settings Menu Command Line Option fg QLOGIC pGLn 9 4 8 1 2 3 Save Configuration 8 Boot Device gt n Port Number 2 Config BootDevice 2 Device Settings 1 LUN List 1 Save Configuration When you select this option the CLI shows the Save Configuration menu H Proceed a Cancel 4 8 2 Boot Device s All HBAs 8 Boot Device gt 1 All HBAs When you select this o
284. ue Vendor value Product value Revision value Size value gt Type value gt lt Target gt lt HBA gt lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt The lt LUN gt sequence is repeated for each LUN attached to the target The LUN list is listed under the target not the adapter The lt Target gt lt Target gt sequence is repeated for each LUN attached to the target A 2 6 Target Persistent Binding Command Line Option p The XML Format 1 for the adapter target persistent binding information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt AppVersion vn nn nn Build nn lt AppVersion gt HBA lt HBA Port value WWNN value WWPN value lt TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value gt lt HBA gt SN0054614 00 F A 7 A XML Format 1 XX XML Format 1 Tags for Each Option QLOGIC E ee A 2 7 lt Status gt 0 lt Status gt lt Reboot gt 0 lt Reboot gt lt QLogic gt The TargetBinding sequence is repeated for each target bound to the adapter Selective LUNs Command Line Option m A 2 8 The XML Format 1 for the selective LUNs information is as follows lt xml version 1 0 encoding ISO 8859 1 lt QLogic gt lt AppName gt SANsurfer FC HBA CLI lt AppName gt l
285. ue gt lt Port WWPN value State value Type value TXPortType value ModuleType value gt lt AttachedPort Type Initiator gt lt HBA NodeName value PortName value VendorId value odel value SerialNumber value Alias value PortAlias value A 20 SN0054614 00 F XX QLOGIC A XML Format 1 XML Format 1 Tags for Each Option I e M DriverVersion value FirmwareVersion value TotalNumberOfDevices value Host value gt lt AttachedPort gt lt PhysicalPort gt lt PhysicalPort Number value gt TXPortType lt lt lt P TXPortType lt lt P TXPortType valu Port WWPN value Stat n value ModuleType value lt AttachedPort Type Initiator gt lt HBA PortName value Host DataUnavailable gt lt AttachedPort gt PhysicalPort gt PhysicalPort gt hysicalPort Number value gt valu Port WWPN value Stat Type valu Type valu value ModuleType value PhysicalPort gt hysicalPort Number value gt Port WWPN 20 0A 00 C0 DD 00 B9 09 Port WWPN value State value Type valu value ModuleType value lt AttachedPort Type Target gt lt Target NodeName value PortName val VendorId value ProductId value ProductRevision value ProductSerialNumber value gt lt AttachedPort gt ue W W lt AttachedPort Type
286. urce efficiency Available in Windows 2000 Windows Server 2003 Novell NetWare and Red Hat SuSE Linux loopback Diagnostic tool that routes transmit data through a loopback connector back to the same HBA Glossary 4 loop ID The device s AL PA on the loop LUN Logical Unit Number a subdivision of a SCSI target It is the small integer handle that differentiates an individual disk drive or partition volume within a common SCSI target device such as a disk array Technically a LUN can be a single physical disk drive multiple physical disk drives or a portion volume of a single physical disk drive However LUNs are typically not entire disk drives but rather virtual partitions volumes of a RAID set Using LUNs the FC host can address multiple peripheral devices that may share a common controller LUN masking A software feature that assigns LUNs to specific servers or hides LUNs from specific servers for maximum access and availability control media Physical layer information carriers FC supports several different physical media copper multimode optical and single mode optical All FC protocols are supported on all media NPIV N Port ID Virtualization N Port Node Port A port that connects by a point to point link to either a single N Port or a single F Port N Ports handle creation detec tion and flow of message units to and from the connected systems N Ports are end ports in virtual
287. urity descriptor during driver update 143 ERROR SET SECURITY DESCRIPTOR Failed to set security descriptor during driver update 144 ERROR FAIL UPDATE DRIVER Failed to update driver 145 ERROR HARDWARE ID NO MATCH HBA hardware ID does not match with the driver config file 146 ERROR DRIVER UPDATE UNSUPPORTED Driver update is not allowed with this HBA 147 ERROR NO DRV INF FILE Driver inf file is missing in the driver package 148 ERROR CREATE TEMP DIR Failed to create temporary directory 149 ERROR OPEN ZIP FILE Failed to open zip file 150 ERROR CLOSE ZIP FILE Failed to close zip file Failed to read zip file D 7 D Non interactive Error Codes XX QLOGIC OO O X Table D 1 Error Code Descriptions Non interactive Mode Continued Code Name Description 152 ERROR EXTRACT ZIP FILE Failed to extract zip file 153 ERROR CORRUPTED ZIP FILE The zip file appears to be corrupted 154 ERROR CREATE ZIP FILE Failed to create zip file 155 ERROR MISSING DRV FILE Driver sys file is missing in the driver package 156 ERROR EMPTY FOLDER Driver folder is empty 157 ERROR GET REGISTRY KEY Failed to get a registry key 158 ERROR SET REGISTRY KEY Failed to set a registry key 159 ERROR STORPORT NOT SUPPORTED Operation failed with Stor miniport driver 160 ERROR INVALID VPD DATA HBA had invalid VPD data 161 Reserved Not used 162 Reserved Not used 163 Reserved Not used 164 Reserved
288. us to the Port Down Retry Count setting which is used when the port is down The following tables list the parameter settings supported by templates for the specified HBAs Table 4 5 Template Supported Parameter Settings for QLA246x QLE246x and QLE256x HBAs Setting QLogic HP IBM SUN Execution Throttle 65535 65535 65535 65535 Descending Loop ID 0 0 0 0 Search Maximum LUNs Per Target 128 128 256 128 Port Down Retry Count 30 16 30 30 Link Down Timeout 30 8 30 30 Table 4 6 Template Supported Parameter Settings for QLA23xx HBAs SN0054614 00 F ISP2312 Setting QLogic EMC HP HPQ IBM SUN Execution Throttle 16 256 16 16 256 16 Descending Loop 0 1 0 0 0 0 ID Search Maximum LUNs 128 256 128 128 256 8 Per Target Port Down Retry 30 45 16 16 30 30 Count Link Down Timeout 30 45 8 8 30 0 4 59 4 Interactive Commands Utilities Menu XX QLOGIC EE ee Table 4 7 Template Supported Parameter Settings for QLA23xx HBAs ISP2300 2310 Setting QLogic EMC IBM SUN Execution Throttle 16 256 256 16 Descending Loop ID 0 1 0 0 Search Maximum LUNs Per Target 128 256 0 8 Port Down Retry Count 30 45 30 30 Link Down Timeout 30 45 30 0 Table 4 8 Template Supported Parameter Settings for QLA23xx HBAs ISP2322 Setting QLogic EMC Execution Throttle 16 256 Descending Loop ID Search 0 1 Maximum LUNS Per Target 128 256 Port Down Retr
289. utes input commands until terminated by the user Use this mode to do multiple operations Section 4 Interactive Commands covers this interface Non interactive command line The CLI starts does the functions defined by the list of parameters provided and then terminates Use this mode to run SANsurfer FC HBA CLI from a script file or when you want to do a single operation Section 5 Non interactive Commands covers this interface SANsurfer FC HBA CLlis not case sensitive in either mode However file names in some operating systems are case sensitive in this case SANsurfer FC HBA CLI is case sensitive for that specific file 2 2 Starting Interactive Mode To start SANsurfer FC HBA CLI in interactive mode use one of these methods M For Windows click the SANsurfer FC CLI icon on the desktop W For Linux or Solaris open a command window and type scli INT Or scli NOTE When starting SANsurfer FC HBA CLI from a Solaris console serial port connection the CLI may take a long time to come up To resolve this issue specify the INT flag as shown in the preceding bullet m For Mac OS X follow these steps SN0054614 00 F 1 Double click the SANsurfer FC HBA CLI SCLI icon 2 A terminal window opens SCLI interactive mode scans the host for QLogic HBAs and SAN storage PRELIMINARY 2 1 2 Getting Started XX Starting Interactive Mode QLOGIC ee 3 Run SCLI commands as required 4 When finished return
290. which might have to take different actions when receiving retries of the request from another initiator or on a different port point to point Also FC P2P Two FC nodes directly connected not in a loop port Access points in a device where a link attaches There are four types of ports as follows Glossary 5 SANsurfer FC HBA CLI User s Guide XX Command Line Interface for QLogic Fibre Channel Host Bus Adapters QLOGIC EENENNM W N Port Node Port an FC port that target supports point to point topology The storage device endpoint of a SCSI W NL Port Node Loop Port an FC session Initiators request data from port that supports loop topology targets Targets are typically disk drives W FF Port Fabric Port a port in a fabric tape drives or other media devices target but an HBA may in some cases be a target A target can contain many LUNs A target is a device that responds to a W FL Port Fabric Loop Port a port in a fabric where an NL Port can attach port instance requested by an initiator the host system The number of the port in the system Peripherals are targets but for some Each HBA may have one or multiple ports commands for example a SCSI COPY identified with regard to the HBA as port 0 command the peripheral may act as an port 1 and so forth to avoid confusion initiator when dealing with a system containing numerous ports each port is assigned a larget binding port instance
291. wing operating systems Microsoft Windows J Windows 2000 SP4 Server and Advanced Server CQ Windows 2003 SP2 IA 32 IA 64 x64 Server and Enterprise Server SP2 C Windows XP IA 32 x64 SP1 2 OQ Windows Vista A 32 x64 C Windows 2008 Server IA 32 1A 64 x64 Linux u Red Hat Enterprise Linux RHEL 3 0 IA 32 IA 64 and x86 64 Update 8 9 C RHEL 4 0 IA 32 IA 64 and x86 64 Update 5 6 C RHEL 5 0 IA 32 IA 64 and x86 64 Update 0 1 QO SuSE Linux Enterprise Server SLES 8 IA 32 IA64 and x86 64 versions SP 3 4 L SLES 9 IA 32 IA64 and x86 64 versions SP 3 4 L SLES 10 A 32 IA64 and x86 64 versions SP O 1 NOTE RHEL 3 0 and SLES 8 do not support 8Gb Solaris C Solaris SPARC 2 8 9 10 with latest patches PRELIMINARY SN0054614 00 F XX 1 Introduction QLOGIC System Requirements TO AG GGOQEEEEE EK ENN C Solaris x86 9 10 with latest patches W Apple Macintosh Qj Mac OS X 10 3 x PowerPC PPO 10 4 x PPC Intel and 1 5 x PPC Intel m VMware LU VMware ESX Server 3 5 NOTE VMware does not support 8Gb NOTE Throughout this guide the terms Windows Linux Solaris and Macintosh refer to all the respective supported operating systems unless otherwise noted 1 5 System Requirements The hardware and software requirements for SANsurfer FC HBA CLI are described in the following sections 1 5 1 Hardware Requirements The minimum hardware requirements are as follows
292. y Count 30 45 Link Down Timeout 30 45 4 10 6 Driver Update Command Line Option d 10 Utilities gt 6 Driver Update The Driver Update option is available on Windows systems only When you select Driver Update from the Utilities menu SANsurfer FC HBA CLI prompts you to select an HBA port and then enter a file name 1 which to update the driver for that port 4 10 7 Driver Rescan Command Line Option rs 10 Utilities 6 Driver Rescan NF ZIP Of EXE with The Driver Rescan option is available only on Solaris systems with the QLA driver When you select Driver Rescan from the Utilities menu SANsurfer FC HBA CLI prompts you to select an HBA port to rescan 4 60 SN0054614 00 F XX 4 Interactive Commands QLOGIC Beacon Menu M EN 4 11 Beacon Menu 11 Beacon When you select the Beacon option SANsurfer FC HBA CLI shows the Beacon Menu containing these options B Locate HBA m Locate Target s 4 11 1 Locate HBA HBA Beacon Command Line Option a 11 Beacon gt 1 Locate HBA When you select this option SANsurfer FC HBA CLI shows the HBA Beacon Menu that lists all HBA ports Select any port and press ENTER to toggle the Beacon LED for that port 4 11 2 Locate Target s Target Beacon Command Line Option tb 11 Beacon gt 2 Locate Target s When you select this option SANsurfer FC HBA CLI shows the Target Beacon Menu that lists all HBA ports Selec
293. ze Test Configuration Run Diagnostic Test Return to Diagnostics Test Menu OP WBN FE Note 0 to return to Main Menu Enter Selection 4 SANsurfer FC HBA CLI 4 70 SN0054614 00 F XX 4 Interactive Commands QLOGIC Diagnostics Menu Command Line Options kl kr and dm ls vl x x Build x Warning The Diagnostic Loopback and Read Write Buffer Tests require that the HBA has no outstanding input and output operations Please make sure there is no active I O before starting the test s Do you want to proceed with the test s 1 Yes 2 No Note 0 to return to Main Menu Enter Selection 1 HBA 1 QEM2462 Port 1 WWPN xx xx XxXx xX Xx xX Xxx xx Port ID 02 0E 00 Test Configuration Data Pattern Random Data Size Bytes ES B Number of test s 1 65535 500 Test Increment 1 65535 3 On Error Ignore Test Continuous OFF Diagnostics Loopback Test Result Note Press Enter to stop the test any time HBA Test Data Pattern Status CRC Disparity FrameLength Active 1 B4 31 0E AA AD CF D5 BO0 Success 0 0 0 4 12 2 2 Run Read Write Buffer Test When you select Start Diagnostics Test for the read write buffer test the following is returned example HBA Instance 4 QLE2562 Port 2 WWPN 21 01 00 1B 32 36 18 I E PortID 01 0rF 00 Test Configuration Data Pattern Random Data Size Bytes 428 Number of test

Q-Logic 2310F Network Card User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents