Manuals / Q-Logic / Computer Equipment / Network Card

Q-Logic FC HBA CLI manual Hba Id

Models: FC HBA CLI

1 280

Download 280 pages 22.31 Kb

Page 65

A

4 – Interactive Commands General Information Menu (Command Line Option -g)

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
v1.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		: BRAGI
OS Type		: Microsoft Windows Server 2003 Enterprise Edition x86
OS Version		: Service Pack 1 (Build 3790)
SDM API Version		: 1.28.0.50 QLSDM.DLL

------------------------------------------------------------------------------

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):				2)	Online
Port	1	WWPN 21-00-00-E0-8B-05-CB-D8 (HBA instance
Port	2	WWPN 21-01-00-E0-8B-25-CB-D8 (HBA instance		3)	Online
HBA Model QLA2462 (SN FFC0551D59564):			(HBA instance	4)	Loop down
Port	1	WWPN 21-00-00-E0-8B-85-8C-7C
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	:
Node Name	: 20-00-00-E0-8B-03-55-7C

SN0054614-00 F

4-13

Image 65

Q-Logic FC HBA CLI manual Hba Id

Contents

SANsurfer FC HBA CLI User’s Guide Changes Sections Affected Revision F Changes Document Revision HistoryRevision E Changes Added Appendix B XML FormatSection Following options and commands were changed in Rev. E Following options and commands were added 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 Tables List of FiguresPage How this Guide is Organized Product OverviewGuide Overview Topology Documentation ConventionsGeneral Information Supported Operating Systems Supported QLogic HBAsHardware Requirements System RequirementsSoftware Requirements Unsupported FeaturesFeatures Not Available When Running Sysfs Inbox Driver Features Not Available When Running ioctl Module DriverFeatures Not Available When Running VMware Driver Technical SupportTraining AvailabilityContact Information Support HeadquartersLatin and South America Region Europe, Middle East, and Africa RegionAsia Pacific Region Preliminary Introduction Starting Interactive ModeVirtual if available Following inputs are valid for the port ID Starting Non-interactive ModeWindows Macintosh InteractiveRed Hat/SuSE Menu Description Section Option Interactive Interactive Menu Non-interactive Mode OptionsHBA Port TerminologyDownloading the Installation Package Initial InstallationStandard GUI Installation Installing SANsurfer FC HBA CLIWindows Installation Welcome Dialog Box Ready to Install the Program Dialog Box Standard Command Line Installation Command Line InstallationParameter Meaning Description Silent Command Line InstallationWindows Command Line Installation Parameters New package is installed in the following directory Linux InstallationFor SuSE Sles IA64, the command line is Solaris Sparc 8, 9, 10 Installation Solaris InstallationTo install SANsurfer FC HBA CLI, type the following Available packages appear. For exampleSolaris x86 9 and 10 Installation Enter Macintosh Installation For example Uninstalling SANsurfer FC HBA CLIStandard GUI Uninstall Windows UninstallCommand Line Uninstall Linux UninstallSolaris x86 8, 9, and 10 Uninstall Solaris Sparc 8, 9, and 10 UninstallMacintosh Uninstall Page Interactive Commands General Information Menu Command Line Option -gHost Information General Information Host InformationGeneral Information 2 Host Topology Command Line Option -tp -topologyHost Topology Display Host Topology SN0054614-00 F HBA Here is an exampleSeagate Command Line Option Command Line Option -bSave As Txt File Save As XML FileSave to XML File Format Command Line Option -zGenerate Report Generate Report Per HBA Port‰ HBA ID ‰ Wwpn ‰ Size ‰ Type ‰ HBA Part Number ‰ Port NumberHBA ID SN0054614-00 F LUN LUN ID HBA Information Menu Generate Report All HBAsRefresh HBA General Information per HBA Port Command Line Option -haHBA Information HBA AliasHBA Port Alias Command Line Option -paHBA VPD Information Command Line Option -l and Reserved Word vpdInformation HBA Information All HBAsHBA Parameters Menu HBA Information n All HBAsHBA Parameters Per HBA Port Command Line Option -c#Display HBA Parameters HBA Parameters n Port InstanceCommand Line Option -n Configure HBA ParametersParameter Name Alias Value Description HBA Parameters Settings NvramFrame Size Connection OptionsData Rate Enable HBA Port Bios Loop Reset DelayEnable HBA Hard Loop ID Enable Fibre Channel Tape SupportInterrupt Delay Timer Operation ModeLogin Retry Count Enable LIP ResetLink Down Timeout Enable LIP Full LoginEnable Target Reset LUNs per TargetAbort Changes Restore DefaultsHBA Parameters All HBAs Choose this option to stop without making any changesTarget/LUN List Menu Command Line Options -t and -lTarget/LUN Information Target/LUN ListPer Target/LUN Target/LUN List Per HBA Port„ Size „ Type Per Target/All LUNsSo on Target/LUN List All HBAs All TargetsIndividual Target So on. Repeats for each LUNIndividual LUN „ LUN ID „ Status Here is an example of the Target informationTarget/LUN List n Port Number So forthHitachi All LUNsTarget Link Speed or 5 iiDMA Settings Target Link Speed or iiDMA Settings MenuCommand Line Option -q 3lists the target link speed settings and descriptions Configuring the iiDMA SettingsTarget Link Speed Settings Target Link Speed Settings DescriptionHBA Port Instance To use Basic ConfigurationHBA Port IiDMA Settings 1 n HBA Port nAdvanced Configuration Target Link Speed All HBAs Advanced Configuration Target Link Speed All HBAs Basic ConfigurationTarget Link Speed All HBAs Target Link Speed 2 All HBAs4.2.1 Command Line Option -p IiDMA Settings DiskIiDMA All HBAs Target Persistent Bindings MenuTarget Persistent Binding Target Persistent Bindings Per HBA PortDisplay Target Persistent Binding Target Persistent Bindings Bind Targets Target Persistent Binding Unbind Targets Target Persistent Binding FC Port ConfigurationTarget Persistent Binding All HBAs Target Persistent Binding p All HBAsTarget Persistent Binding Bind Targets Command Line Option -mSelective LUNs Menu Selective LUNs Per HBA PortSelective LUNs 1 All HBAs Display LUN ConfigurationSelective LUNs All HBAs Auto Configure LUNs Manual Configure LUNsBoot Device Menu Command Line Option -e„ Wwpn Boot Devices Per HBA PortLUN List Menu Configure Boot DevicesBoot Device Settings Boot Devices All HBAs Save ConfigurationDriver Settings Menu Command Line Option -fgParameter Name Alias Value Description Param name Driver SettingsCommand Line Option -b and Reserved Word save Flash Update Per HBA Port or All HBAsUtilities Menu Flash Save Per HBA PortHBA Parameters Template Per HBA or All HBAs HBA Parameters Update Per HBA Port or All HBAsHBA Parameters Save Per HBA Port Using HBA Parameter Templates IBM SUN Setting QLogicCommand Line Option -d Driver UpdateCommand Line Option -rs Driver RescanCommand Line Option -tb Command Line Option -aBeacon Menu Locate HBA HBA BeaconCommand Line Options -kl, -kr, and -dm Diagnostics MenuHBA Diagnostics Configuration Settings Beacon Selected TargetsDiagnostics n Port Number Diagnostics Loopback TestCommand Line Option -kl Configure Loopback Test Parameters SN0054614-00 F Run Loopback Test Diagnostics Read/Write Buffer TestConfigure Read/Write Test Parameters SN0054614-00 F SN0054614-00 F SN0054614-00 F Run Read/Write Buffer Test Transceiver Details General Diagnostics Transceiver Details DMICommand Line Option -dm Transceiver Details Details SN0054614-00 F SN0054614-00 F Command Line Options -gs and -ls ConfigurationCommand Line Option -gs Statistics MenuResetting to default settings..., done 10. HBA Port Statistics Options Current SettingsAuto Poll Show HBA Statistics Set RateLog to File Link Status Command Line Option -lsAuto Poll Menu Restore Default11. Statistics/Link Status Options SANsurfer FC HBA CLI displays two polling optionsShow Link Status Virtual Menu Command Line Option -vpVirtual Menu Scli -vp -h Virtual Virtual Menu for HBA InstanceList Virtual Ports ‰ Status Online or Loop Down Here is an example Delete Virtual PortsCreate Virtual Ports Auto Generate Command Line Option -hUser Generate Help MenuAbout ContentsExit Codes Display System Information Command Line Options -g, -z, and -tpCommand format to show host information is To show the information for all HBAs, type Host ConfigurationWhere Command Line Option -tp Description See Section Options Shown by -zCommand format for non-interactive mode is Command Summary„ -s= Silent mode see .3.28. For example OnlyCommand Variables 2defines the command variablesView or Toggle Beacon Status Variable Definition FormatTo start or stop flashing the HBA’s LED beacon, type Save or Update the Flash Bios or FcodeTo view the HBA port’s LED Beacon state, type Update Device Driver Show Parameter SettingsTo save the BIOS/FCode to a file, type To show the parameter settings for a specific HBA, typeTo show Transceiver monitoring detailed information, type Display Diagnostics Monitoring InfoBoot Device View Select Disable To view the current boot device selection on all HBAs These commandsTo disable delete the boot device for a specific HBA, type Input Parameter Options from a Text File List SANsurfer FC HBA CLI Error CodesSANsurfer FC HBA CLI specifies command line input from file Configure Driver Settings Show Driver SettingsType the following command to configure the driver settings 3lists the driver configuration parameter names and aliasesDisplay System Information For details of this command, see sectionShow HBA Statistics To view system information, typeHBA Statistics Parameters HelpType the following text to view the help file For example, typing scli -l-hshowsSet Delete HBA Alias To do a loopback test with customized parameters, type Loopback TestTo show general or VPD information for a specific HBA, type For the loopback test, the data pattern is either DataPattern DPTo enter a customized value in the range of 00-FF, type 5lists all valid data patternsData Pattern Values DataSize DSFor the loopback test, the data size is either Hex BinaryFor the loopback test, OnError is either OnError OETestCount TC Test Increment TIDriver Versions Not Requiring a Loopback Connector OnError ValuesTo do a loopback test using the current parameters, type Run a Loopback TestAn example of a successful loopback test follows To do a loopback test with custom parameters, typeTo do a read/write test with customized parameters, type Run HBA Diagnostics Loopback TestRun Read/Write Buffer Test HBA Wwpn Run a Read/Write Buffer TestAn example of a successful read/write buffer test follows Name Alias Value Description Run HBA Diagnostics Read-write Buffer TestDiagnostics Parameters „ Status Data Pattern DP Test PatternsTo view the link status, type Display LUN InfoDisplay Link Status 10. Link Status Parameters View, Enable, or Disable LUNsTo view the current select state of a specific LUN, type To view all selective LUNs for all HBA ports, typeTo view an HBA’s selective LUN list, type To restore the default Bios 4G HBAs only, type To enable select all LUNs of all targets on a specific HBASet Selected HBA Parameter To set a specific parameter on a specific HBA, type11. HBA Parameters 11lists the HBA parameter names and aliasesOutput to a File To show persistent binding information for all HBAs, type Display Persistent Target Binding InfoTo unbind a specific target, type To bind a selected target to a specific HBA, typeView or Set Target Link Speed Define Port AliasTo 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 Silent Mode Update HBA ParametersTo update the HBA Parameters, type To save the HBA parameters to a file, typeTarget Beacon On/Off Display Target InformationDisplay Version Display Host TopologyVirtual Port System shows the following informationTo create a virtual port with a specific WWPN, type Output in XML FormatTo create a virtual port with an automatic WWPN, type Display All HBA information for One or All HBAs 2 covers this commandUtility Header Main TagError Message Reboot MessageStatus Message XML Format 1 Tags for Each OptionCommand Line Option -c Display Adapter SettingsXML Format 1 for adapter settings information is as follows XML format 1 for system information output is as followsDisplay HBA Information Here is the VPD information Here is the information for the 4G HBAsDisplay Device List Command Line Option -tXML Format 1 for adapter device information is as follows Target…/Target sequence is repeated for each HBA targetTarget Persistent Binding Command Line Option -lDisplay LUN List Selective LUNs Boot DeviceXML Format 1 for the boot device information is as follows Diagnostics Results Read/Write Buffer Test Diagnostics Results -Loopback TestCommand Line Option -kr XML Format 1 for the loopback test results is as followsDisplay All Information for One or All HBAs View Driver SettingsTable 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 HBA Statistics Link 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 port alias option is as follows XML Format 1 for the HBA alias option is as followsXML Format 1 for SFF DMI general information is as follows SFF DMIXML 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 XML2 Tags for Each Option Command format isXML Format 2 for SFF DMI general information is as follows XML Format 2 for adapter settings 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 a single HBAs is Command format for all 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 XML Format 2 for the loopback test results is as follows Diagnostics Results Loopback TestTarget... /Target sequence repeats for each target Scli -m all view ? XML Format 2 for adapter device information is as follows XML Format 2 for all adapter information is as follows Non-interactive Setting Section OptionTable B-1. Options Displayed by -z XML Format Display System Information Command Line Option -g SN0054614-00 F XML Format 2 for the link statistics option is as follows LinkStatus…/ parameter repeats for each link View HBA AliasXML 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 Return Name Description Code Table C-1. Exit Code Descriptions Interactive ModeErrormismatchchecksum Errorflashupdatenoregion Errorinvalidparamsettings Errorpreservenvramdata Errorduplicatetargetid Errorfailoverdriverloaded Errorclosezipfile Errorsavesellunconfig Errormissingipaddress Errorsavetargetiidmasettings Erroradapterpropmissing Code Name Description Table D-1. Error Code Descriptions Non-interactive ModeTo see the interactive exit codes, see Appendix C 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 All file name Command Arguments FunctionDisable 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 Comma separated values CSV file For the HBA and initializing and testing the HBAs ISPSee HBA Red Hat/SuSE Linux, the driver layers include DriverQLogic Fast!UTIL FC HBA Bios utility Fabric consists of cross-connected FC devices and switchesPort in a fabric where an NPort can attach Flash Prom contains the Bios code for the HBANPort ID Virtualization As opposed to a SAN. See SAN Storage Area NetworkDevice’s Alpa on the loop Also FC-P2P. Two FC nodes directly connected not in a loop Remote procedure call developed by Sun MicrosystemsNetwork Interface Controller SAN Storage Area Network Index Index-2 SN0054614-00 F SN0054614-00 F Index-3 Txt Xml 4-8 text 4-8 XML Fg4-54,5-4,5-13,A-10,B-10 fileHBA hard loop ID 4-23host LED SN0054614-00 F Index-7 Index-8 SN0054614-00 F SDM API Definition of Glossary-6 layers, definition of Glossary-2Index-10 SN0054614-00 F Txt 4-8 text file XML