Manuals / Q-Logic / Computer Equipment / Network Card

Q-Logic FC HBA CLI manual 4.2.1

Models: FC HBA CLI

1 280

Download 280 pages 22.31 Kb

Page 96

4 – Interactive Commands

Target Link Speed or iiDMA Settings Menu (Command Line Option -q)

S

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	: 3EV0NYSG000072496DYD
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)

Vendor	: SEAGATE
Product ID	: ST318453FC
Product Rev	: 00006
Serial Number	: 3JA9AYSG000072496FBJ
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	: 3AJA9ALAG0000724966ZK
Port Name	: 22-00-00-11-C6-2D-5A-3F
Port ID	: 11-0A-E2

Max Target Link Rate : 4 Gbps

...
n: Disk	: SEAGATE
Vendor	: SEAGATE
Product ID	: ST318453FC
Product Rev	: 0006
Serial Number	: 3JA9TQE0000724966ZK
Port Name	: 22-00-00-11-C6-2D-5A-3F
Port ID	: 02-0A-E4

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 2: All HBAs 1: Advanced Configuration 1 - n: Link speed

4-44	SN0054614-00 F

Image 96

Q-Logic FC HBA CLI manual 4.2.1

Contents

SANsurfer FC HBA CLI User’s Guide Document Revision History Changes Sections Affected Revision F ChangesAdded Appendix B XML Format Revision E ChangesSection Following options and commands were added in Rev. E Following options and commands were changed in Rev. ESN0054614-00 F Revision D Changes Following options and commands were changed in Rev. D Page Page Table of Contents Section Interactive Commands SN0054614-00 F SN0054614-00 F Section Non-interactive Commands Appendix a XML Format Appendix B XML Format SN0054614-00 F List of Figures List of TablesPage Product Overview Guide OverviewHow this Guide is Organized Documentation Conventions TopologyGeneral Information Supported QLogic HBAs Supported Operating SystemsSystem Requirements Hardware RequirementsUnsupported Features Software RequirementsFeatures Not Available When Running ioctl Module Driver Features Not Available When Running Sysfs Inbox DriverFeatures Not Available When Running VMware Driver Technical SupportAvailability TrainingContact Information Support HeadquartersEurope, Middle East, and Africa Region Asia Pacific RegionLatin and South America Region Preliminary Starting Interactive Mode IntroductionVirtual if available Starting Non-interactive Mode Following inputs are valid for the port IDInteractive Red Hat/SuSE Menu Description Section OptionWindows Macintosh Non-interactive Mode Options Interactive Interactive MenuTerminology HBA PortInitial Installation Downloading the Installation PackageInstalling SANsurfer FC HBA CLI Windows InstallationStandard GUI Installation Welcome Dialog Box Ready to Install the Program Dialog Box Command Line Installation Standard Command Line InstallationSilent Command Line Installation Windows Command Line Installation ParametersParameter Meaning Description Linux Installation For SuSE Sles IA64, the command line isNew package is installed in the following directory Solaris Installation Solaris Sparc 8, 9, 10 InstallationTo install SANsurfer FC HBA CLI, type the following Available packages appear. For exampleSolaris x86 9 and 10 Installation Enter Macintosh Installation Uninstalling SANsurfer FC HBA CLI For exampleWindows Uninstall Standard GUI UninstallCommand Line Uninstall Linux UninstallSolaris Sparc 8, 9, and 10 Uninstall Solaris x86 8, 9, and 10 UninstallMacintosh Uninstall Page Interactive Commands Command Line Option -g General Information MenuHost Information General Information Host InformationCommand Line Option -tp -topology Host TopologyGeneral Information 2 Host Topology Display Host Topology SN0054614-00 F Here is an example HBASeagate Command Line Option -b Command Line OptionSave As Txt File Save As XML FileCommand Line Option -z Save to XML File FormatGenerate Report Generate Report Per HBA Port‰ HBA ID ‰ Wwpn ‰ HBA Part Number ‰ Port Number ‰ Size ‰ TypeHBA ID SN0054614-00 F LUN LUN ID Generate Report All HBAs RefreshHBA Information Menu Command Line Option -ha HBA General Information per HBA PortHBA Information HBA AliasCommand Line Option -pa HBA Port AliasCommand Line Option -l and Reserved Word vpd HBA VPD InformationHBA Information All HBAs InformationHBA Parameters Menu HBA Information n All HBAsCommand Line Option -c# HBA Parameters Per HBA PortDisplay HBA Parameters HBA Parameters n Port InstanceConfigure HBA Parameters Command Line Option -nHBA Parameters Settings Nvram Parameter Name Alias Value DescriptionConnection Options Data RateFrame Size Loop Reset Delay Enable HBA Port BiosEnable HBA Hard Loop ID Enable Fibre Channel Tape SupportOperation Mode Interrupt Delay TimerLogin Retry Count Enable LIP ResetEnable LIP Full Login Link Down TimeoutEnable Target Reset LUNs per TargetRestore Defaults Abort ChangesHBA Parameters All HBAs Choose this option to stop without making any changesCommand Line Options -t and -l Target/LUN List MenuTarget/LUN Information Target/LUN ListTarget/LUN List Per HBA Port Per Target/LUNPer Target/All LUNs So on„ Size „ Type All Targets Target/LUN List All HBAsIndividual Target So on. Repeats for each LUNIndividual LUN „ Status Here is an example of the Target information „ LUN IDSo forth Target/LUN List n Port NumberAll LUNs HitachiTarget Link Speed or iiDMA Settings Menu Command Line Option -qTarget Link Speed or 5 iiDMA Settings Configuring the iiDMA Settings 3lists the target link speed settings and descriptionsTarget Link Speed Settings Target Link Speed Settings DescriptionTo use Basic Configuration HBA Port InstanceIiDMA Settings 1 n HBA Port n HBA PortAdvanced Configuration Target Link Speed All HBAs Basic Configuration Target Link Speed All HBAs Advanced ConfigurationTarget Link Speed All HBAs Target Link Speed 2 All HBAs4.2.1 IiDMA Settings Disk Command Line Option -pIiDMA All HBAs Target Persistent Bindings MenuTarget Persistent Bindings Per HBA Port Display Target Persistent BindingTarget Persistent Binding Target Persistent Bindings Bind Targets Target Persistent Binding FC Port Configuration Target Persistent Binding Unbind TargetsTarget Persistent Binding All HBAs Target Persistent Binding p All HBAsCommand Line Option -m Target Persistent Binding Bind TargetsSelective LUNs Menu Selective LUNs Per HBA PortDisplay LUN Configuration Selective LUNs All HBAsSelective LUNs 1 All HBAs Manual Configure LUNs Auto Configure LUNsBoot Device Menu Command Line Option -eBoot Devices Per HBA Port „ WwpnConfigure Boot Devices Boot Device SettingsLUN List Menu Save Configuration Boot Devices All HBAsDriver Settings Menu Command Line Option -fgDriver Settings Parameter Name Alias Value Description Param nameFlash Update Per HBA Port or All HBAs Command Line Option -b and Reserved Word saveUtilities Menu Flash Save Per HBA PortHBA Parameters Update Per HBA Port or All HBAs HBA Parameters Save Per HBA PortHBA Parameters Template Per HBA or All HBAs Using HBA Parameter Templates Setting QLogic IBM SUNDriver Update Command Line Option -dCommand Line Option -rs Driver RescanCommand Line Option -a Command Line Option -tbBeacon Menu Locate HBA HBA BeaconDiagnostics Menu Command Line Options -kl, -kr, and -dmHBA Diagnostics Configuration Settings Beacon Selected TargetsDiagnostics Loopback Test Command Line Option -klDiagnostics n Port Number Configure Loopback Test Parameters SN0054614-00 F Diagnostics Read/Write Buffer Test Run Loopback TestConfigure Read/Write Test Parameters SN0054614-00 F SN0054614-00 F SN0054614-00 F Run Read/Write Buffer Test Diagnostics Transceiver Details DMI Command Line Option -dmTransceiver Details General Transceiver Details Details SN0054614-00 F SN0054614-00 F Configuration Command Line Options -gs and -lsCommand Line Option -gs Statistics MenuResetting to default settings..., done Current Settings Auto Poll10. HBA Port Statistics Options Set Rate Log to FileShow HBA Statistics Command Line Option -ls Link StatusRestore Default Auto Poll Menu11. Statistics/Link Status Options SANsurfer FC HBA CLI displays two polling optionsShow Link Status Command Line Option -vp Virtual MenuVirtual Menu Scli -vp -h Virtual Menu for HBA Instance List Virtual PortsVirtual Delete Virtual Ports Create Virtual Ports‰ Status Online or Loop Down Here is an example Command Line Option -h Auto GenerateUser Generate Help MenuContents Exit CodesAbout Command Line Options -g, -z, and -tp Command format to show host information isDisplay System Information Host Configuration WhereTo show the information for all HBAs, type Command Line Option -tp Options Shown by -z Description See SectionCommand Summary Command format for non-interactive mode is„ -s= Silent mode see .3.28. For example Only2defines the command variables Command VariablesView or Toggle Beacon Status Variable Definition FormatSave or Update the Flash Bios or Fcode To view the HBA port’s LED Beacon state, typeTo start or stop flashing the HBA’s LED beacon, type Show Parameter Settings Update Device DriverTo save the BIOS/FCode to a file, type To show the parameter settings for a specific HBA, typeDisplay Diagnostics Monitoring Info Boot Device View Select DisableTo show Transceiver monitoring detailed information, type These commands To view the current boot device selection on all HBAsTo disable delete the boot device for a specific HBA, type List SANsurfer FC HBA CLI Error Codes SANsurfer FC HBA CLI specifies command line input from fileInput Parameter Options from a Text File Show Driver Settings Configure Driver SettingsType the following command to configure the driver settings 3lists the driver configuration parameter names and aliasesFor details of this command, see section Display System InformationShow HBA Statistics To view system information, typeHelp HBA Statistics ParametersType the following text to view the help file For example, typing scli -l-hshowsSet Delete HBA Alias Loopback Test To show general or VPD information for a specific HBA, typeTo do a loopback test with customized parameters, type DataPattern DP For the loopback test, the data pattern is eitherTo enter a customized value in the range of 00-FF, type 5lists all valid data patternsDataSize DS Data Pattern ValuesFor the loopback test, the data size is either Hex BinaryOnError OE For the loopback test, OnError is eitherTestCount TC Test Increment TIOnError Values Driver Versions Not Requiring a Loopback ConnectorTo do a loopback test using the current parameters, type Run a Loopback TestTo do a loopback test with custom parameters, type An example of a successful loopback test followsRun HBA Diagnostics Loopback Test Run Read/Write Buffer TestTo do a read/write test with customized parameters, type Run a Read/Write Buffer Test HBA WwpnAn example of a successful read/write buffer test follows Run HBA Diagnostics Read-write Buffer Test Diagnostics ParametersName Alias Value Description Data Pattern DP Test Patterns „ StatusDisplay LUN Info Display Link StatusTo view the link status, type View, Enable, or Disable LUNs 10. Link Status ParametersTo view all selective LUNs for all HBA ports, type To view an HBA’s selective LUN list, typeTo view the current select state of a specific LUN, type To enable select all LUNs of all targets on a specific HBA To restore the default Bios 4G HBAs only, typeSet Selected HBA Parameter To set a specific parameter on a specific HBA, type11lists the HBA parameter names and aliases 11. HBA ParametersOutput to a File Display Persistent Target Binding Info To show persistent binding information for all HBAs, typeTo bind a selected target to a specific HBA, type To unbind a specific target, typeDefine Port Alias View or Set Target Link SpeedTo delete a port alias for the specified HBA port, type To view a port alias for the specified HBA port, type# scli -q HBA Instance HBA Wwpn Target Wwpn Update HBA Parameters Silent ModeTo update the HBA Parameters, type To save the HBA parameters to a file, typeDisplay Target Information Target Beacon On/OffDisplay Host Topology Display VersionVirtual Port System shows the following informationOutput in XML Format To create a virtual port with an automatic WWPN, typeTo create a virtual port with a specific WWPN, type 2 covers this command Display All HBA information for One or All HBAsMain Tag Utility HeaderReboot Message Error MessageStatus Message XML Format 1 Tags for Each OptionDisplay Adapter Settings Command Line Option -cXML Format 1 for adapter settings information is as follows XML format 1 for system information output is as followsDisplay HBA Information Here is the information for the 4G HBAs Here is the VPD informationCommand Line Option -t Display Device ListXML Format 1 for adapter device information is as follows Target…/Target sequence is repeated for each HBA targetCommand Line Option -l Display LUN ListTarget Persistent Binding Boot Device XML Format 1 for the boot device information is as followsSelective LUNs Diagnostics Results -Loopback Test Diagnostics Results Read/Write Buffer TestCommand Line Option -kr XML Format 1 for the loopback test results is as followsView Driver Settings Display All Information for One or All HBAsTable A-1. Options Displayed by -z Non-interactive Description Section OptionXML Format 1 for all adapter information is as follows XML Format XML Format 1 Tags for Each Option Link Statistics HBA StatisticsXML Format 1 for the link statistics option is as follows XML Format 1 for the HBA statistics option is as followsXML Format 1 for the HBA alias option is as follows XML Format 1 for the HBA port alias option is as followsSFF DMI XML Format 1 for SFF DMI general information is as followsXML Format XML Format 1 Tags for Each Option XML Format 1 XML Format 1 Tags for Each Option XML Format XML Format 1 Tags for Each Option XML Format 1 XML Format 1 Tags for Each Option Host Topology XML Format 1 XML Format 1 Tags for Each Option InterConnectElement Status 0 /Status Reboot 0 /Reboot QLogic Appendix B Command format is XML2 Tags for Each OptionXML Format 2 for adapter settings information is as follows XML Format 2 for SFF DMI general information is as followsXML Format 2 for the boot device information is as follows XML Format 2 for SFF DMI detailed information is as follows XML Format XML2 Tags for Each Option XML Format 2 XML2 Tags for Each Option Command format for all HBAs is Command format for a single HBAs isHBA Instance HBA Wwpn view ? XML Format 2 for system information output is as follows XML Format 2 for adapter general information is as follows XML Format 2 for 4G HBAs is as follows Diagnostics Results Loopback Test XML Format 2 for the loopback test results is as followsTarget... /Target sequence repeats for each target Scli -m all view ? XML Format 2 for adapter device information is as follows Non-interactive Setting Section Option Table B-1. Options Displayed by -zXML Format 2 for all adapter information is as follows XML Format Display System Information Command Line Option -g SN0054614-00 F XML Format 2 for the link statistics option is as follows View HBA Alias LinkStatus…/ parameter repeats for each linkXML Format 2 for the HBA statistics option is as follows Statistics.../ sequence repeats for each HBAXML Format 2 for the HBA port alias option is as follows SN0054614-00 F Scli -tp SN0054614-00 F Page Table C-1. Exit Code Descriptions Interactive Mode Return Name Description CodeErrormismatchchecksum Errorflashupdatenoregion Errorinvalidparamsettings Errorpreservenvramdata Errorduplicatetargetid Errorfailoverdriverloaded Errorclosezipfile Errorsavesellunconfig Errormissingipaddress Errorsavetargetiidmasettings Erroradapterpropmissing Table D-1. Error Code Descriptions Non-interactive Mode To see the interactive exit codes, see Appendix CCode Name Description Errorflashupdatenovalidregion Errordiagnosticsdatamiscompare Errormissingnvramtemplatefile Errorbootconfigdisableddriver Errorreadfrompersistentstorage Errorinualidhbawwid Driver sys file is missing in the driver Failed to save selective LUN configu 205 Reserved Not used 206 207 208 209 210 Errorsettargetiidmaunsupported 257 Reserved Not used 258 259 260 Table E-1. Help Commands Command Arguments Function All file nameDisable prim alt1 alt2 Param name param Alias param value Hba instance hba wwpn Lun id view ? Hba instance hba wwpn Target portid target id Hba instance hba wwpn Portid All Writes the output in XML format 1. Option For the HBA and initializing and testing the HBAs ISP See HBAComma separated values CSV file Driver Red Hat/SuSE Linux, the driver layers includeFabric consists of cross-connected FC devices and switches QLogic Fast!UTIL FC HBA Bios utilityPort in a fabric where an NPort can attach Flash Prom contains the Bios code for the HBAAs opposed to a SAN. See SAN Storage Area Network Device’s Alpa on the loopNPort ID Virtualization Remote procedure call developed by Sun Microsystems Network Interface ControllerAlso FC-P2P. Two FC nodes directly connected not in a loop SAN Storage Area Network Index Index-2 SN0054614-00 F SN0054614-00 F Index-3 Fg4-54,5-4,5-13,A-10,B-10 file Txt Xml 4-8 text 4-8 XMLHBA hard loop ID 4-23host LED SN0054614-00 F Index-7 Index-8 SN0054614-00 F Definition of Glossary-6 layers, definition of Glossary-2 SDM APIIndex-10 SN0054614-00 F Txt 4-8 text file XML