Manuals / Q-Logic / Computer Equipment / Network Card

Q-Logic FC HBA CLI manual Wwpn

Models: FC HBA CLI

1 280

Download 280 pages 22.31 Kb

Page 63

A

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

HBA Parameters Settings Header (Command Line Options -c)

HBA Instance

HBA Part Number

Port Number

WWPN

Port ID

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 Order Frame

Driver Settings Information Header (Command Line Options -fg)

HBA Instance

HBA Part Number

Port Number

WWPN

Port ID

Driver Settings (repeats for each HBA Instance)

Driver Settings - Group: Persistent

Persistently bound Plus New targets

Persistently bound targets only

Driver Settings - Group: Binding

Bind by WWPN

Bind by Port ID

Device/LUNs Information Header (Repeats for each HBA Instance)

HBA Instance

SN0054614-00 F

4-11

Image 63

Q-Logic FC HBA CLI manual ‰ Wwpn

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 Product Overview Guide OverviewHow this Guide is Organized Topology Documentation ConventionsGeneral Information Supported Operating Systems Supported QLogic HBAsHardware Requirements System RequirementsSoftware Requirements Unsupported FeaturesTechnical Support Features Not Available When Running ioctl Module DriverFeatures Not Available When Running Sysfs Inbox Driver Features Not Available When Running VMware DriverSupport Headquarters AvailabilityTraining Contact InformationEurope, Middle East, and Africa Region Asia Pacific RegionLatin and South America Region Preliminary Introduction Starting Interactive ModeVirtual if available Following inputs are valid for the port ID Starting Non-interactive ModeInteractive Red Hat/SuSE Menu Description Section OptionWindows Macintosh Interactive Interactive Menu Non-interactive Mode OptionsHBA Port TerminologyDownloading the Installation Package Initial InstallationInstalling SANsurfer FC HBA CLI Windows InstallationStandard GUI Installation Welcome Dialog Box Ready to Install the Program Dialog Box Standard Command Line Installation 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 Available packages appear. For example Solaris InstallationSolaris Sparc 8, 9, 10 Installation To install SANsurfer FC HBA CLI, type the followingSolaris x86 9 and 10 Installation Enter Macintosh Installation For example Uninstalling SANsurfer FC HBA CLILinux Uninstall Windows UninstallStandard GUI Uninstall Command Line UninstallSolaris x86 8, 9, and 10 Uninstall Solaris Sparc 8, 9, and 10 UninstallMacintosh Uninstall Page Interactive Commands General Information Host Information Command Line Option -gGeneral Information Menu Host InformationCommand Line Option -tp -topology Host TopologyGeneral Information 2 Host Topology Display Host Topology SN0054614-00 F HBA Here is an exampleSeagate Save As XML File Command Line Option -bCommand Line Option Save As Txt FileGenerate Report Per HBA Port Command Line Option -zSave to XML File Format Generate Report‰ HBA ID ‰ Wwpn ‰ Size ‰ Type ‰ HBA Part Number ‰ Port NumberHBA ID SN0054614-00 F LUN LUN ID Generate Report All HBAs RefreshHBA Information Menu HBA Alias Command Line Option -haHBA General Information per HBA Port HBA InformationHBA Port Alias Command Line Option -paHBA VPD Information Command Line Option -l and Reserved Word vpdHBA Information n All HBAs HBA Information All HBAsInformation HBA Parameters MenuHBA Parameters n Port Instance Command Line Option -c#HBA Parameters Per HBA Port Display HBA ParametersCommand Line Option -n Configure HBA ParametersParameter Name Alias Value Description HBA Parameters Settings NvramConnection Options Data RateFrame Size Enable Fibre Channel Tape Support Loop Reset DelayEnable HBA Port Bios Enable HBA Hard Loop IDEnable LIP Reset Operation ModeInterrupt Delay Timer Login Retry CountLUNs per Target Enable LIP Full LoginLink Down Timeout Enable Target ResetChoose this option to stop without making any changes Restore DefaultsAbort Changes HBA Parameters All HBAsTarget/LUN List Command Line Options -t and -lTarget/LUN List Menu Target/LUN InformationPer Target/LUN Target/LUN List Per HBA PortPer Target/All LUNs So on„ Size „ Type So on. Repeats for each LUN All TargetsTarget/LUN List All HBAs Individual TargetIndividual LUN „ LUN ID „ Status Here is an example of the Target informationTarget/LUN List n Port Number So forthHitachi All LUNsTarget Link Speed or iiDMA Settings Menu Command Line Option -qTarget Link Speed or 5 iiDMA Settings Target Link Speed Settings Description Configuring the iiDMA Settings3lists the target link speed settings and descriptions Target Link Speed SettingsHBA Port Instance To use Basic ConfigurationHBA Port IiDMA Settings 1 n HBA Port nAdvanced Configuration Target Link Speed 2 All HBAs Target Link Speed All HBAs Basic ConfigurationTarget Link Speed All HBAs Advanced Configuration Target Link Speed All HBAs4.2.1 Target Persistent Bindings Menu IiDMA Settings DiskCommand Line Option -p IiDMA All HBAsTarget Persistent Bindings Per HBA Port Display Target Persistent BindingTarget Persistent Binding Target Persistent Bindings Bind Targets Target Persistent Binding p All HBAs Target Persistent Binding FC Port ConfigurationTarget Persistent Binding Unbind Targets Target Persistent Binding All HBAsSelective LUNs Per HBA Port Command Line Option -mTarget Persistent Binding Bind Targets Selective LUNs MenuDisplay LUN Configuration Selective LUNs All HBAsSelective LUNs 1 All HBAs Command Line Option -e Manual Configure LUNsAuto Configure LUNs Boot Device Menu„ Wwpn Boot Devices Per HBA PortConfigure Boot Devices Boot Device SettingsLUN List Menu Command Line Option -fg Save ConfigurationBoot Devices All HBAs Driver Settings MenuParameter Name Alias Value Description Param name Driver SettingsFlash Save Per HBA Port Flash Update Per HBA Port or All HBAsCommand Line Option -b and Reserved Word save Utilities MenuHBA 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 IBM SUN Setting QLogicDriver Rescan Driver UpdateCommand Line Option -d Command Line Option -rsLocate HBA HBA Beacon Command Line Option -aCommand Line Option -tb Beacon MenuBeacon Selected Targets Diagnostics MenuCommand Line Options -kl, -kr, and -dm HBA Diagnostics Configuration SettingsDiagnostics Loopback Test Command Line Option -klDiagnostics n Port Number 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 Diagnostics Transceiver Details DMI Command Line Option -dmTransceiver Details General Transceiver Details Details SN0054614-00 F SN0054614-00 F Statistics Menu ConfigurationCommand Line Options -gs and -ls Command Line Option -gsResetting to default settings..., done Current Settings Auto Poll10. HBA Port Statistics Options Set Rate Log to FileShow HBA Statistics Link Status Command Line Option -lsSANsurfer FC HBA CLI displays two polling options Restore DefaultAuto Poll Menu 11. Statistics/Link Status 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 Help Menu Command Line Option -hAuto Generate User GenerateContents 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 Description See Section Options Shown by -zOnly Command SummaryCommand format for non-interactive mode is „ -s= Silent mode see .3.28. For exampleVariable Definition Format 2defines the command variablesCommand Variables View or Toggle Beacon StatusSave 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 To show the parameter settings for a specific HBA, type Show Parameter SettingsUpdate Device Driver To save the BIOS/FCode to a file, typeDisplay Diagnostics Monitoring Info Boot Device View Select DisableTo show Transceiver monitoring detailed information, type To view the current boot device selection on all HBAs These commandsTo 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 3lists the driver configuration parameter names and aliases Show Driver SettingsConfigure Driver Settings Type the following command to configure the driver settingsTo view system information, type For details of this command, see sectionDisplay System Information Show HBA StatisticsFor example, typing scli -l-hshows HelpHBA Statistics Parameters Type the following text to view the help fileSet Delete HBA Alias Loopback Test To show general or VPD information for a specific HBA, typeTo do a loopback test with customized parameters, type 5lists all valid data patterns DataPattern DPFor the loopback test, the data pattern is either To enter a customized value in the range of 00-FF, typeHex Binary DataSize DSData Pattern Values For the loopback test, the data size is eitherTest Increment TI OnError OEFor the loopback test, OnError is either TestCount TCRun a Loopback Test OnError ValuesDriver Versions Not Requiring a Loopback Connector To do a loopback test using the current parameters, typeAn example of a successful loopback test follows To do a loopback test with custom parameters, typeRun HBA Diagnostics Loopback Test Run Read/Write Buffer TestTo do a read/write test with customized parameters, type HBA Wwpn Run a Read/Write Buffer TestAn example of a successful read/write buffer test follows Run HBA Diagnostics Read-write Buffer Test Diagnostics ParametersName Alias Value Description „ Status Data Pattern DP Test PatternsDisplay LUN Info Display Link StatusTo view the link status, type 10. Link Status Parameters View, Enable, or Disable LUNsTo 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 set a specific parameter on a specific HBA, type To enable select all LUNs of all targets on a specific HBATo restore the default Bios 4G HBAs only, type Set Selected HBA Parameter11. 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, typeTo view a port alias for the specified HBA port, type Define Port AliasView or Set Target Link Speed To delete a port alias for the specified HBA port, type# scli -q HBA Instance HBA Wwpn Target Wwpn To save the HBA parameters to a file, type Update HBA ParametersSilent Mode To update the HBA Parameters, typeTarget Beacon On/Off Display Target InformationSystem shows the following information Display Host TopologyDisplay Version Virtual PortOutput in XML Format To create a virtual port with an automatic WWPN, typeTo create a virtual port with a specific WWPN, type Display All HBA information for One or All HBAs 2 covers this commandUtility Header Main TagXML Format 1 Tags for Each Option Reboot MessageError Message Status MessageXML format 1 for system information output is as follows Display Adapter SettingsCommand Line Option -c XML Format 1 for adapter settings information is as followsDisplay HBA Information Here is the VPD information Here is the information for the 4G HBAsTarget…/Target sequence is repeated for each HBA target Command Line Option -tDisplay Device List XML Format 1 for adapter device information is as followsCommand Line Option -l Display LUN ListTarget Persistent Binding Boot Device XML Format 1 for the boot device information is as followsSelective LUNs XML Format 1 for the loopback test results is as follows Diagnostics Results -Loopback TestDiagnostics Results Read/Write Buffer Test Command Line Option -krNon-interactive Description Section Option View Driver SettingsDisplay All Information for One or All HBAs Table A-1. Options Displayed by -zXML Format 1 for all adapter information is as follows XML Format XML Format 1 Tags for Each Option XML Format 1 for the HBA statistics option is as follows Link StatisticsHBA Statistics XML Format 1 for the link 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 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 Statistics.../ sequence repeats for each HBA View HBA AliasLinkStatus…/ parameter repeats for each link XML Format 2 for the HBA statistics option is as followsXML 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 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 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 For the HBA and initializing and testing the HBAs ISP See HBAComma separated values CSV file Red Hat/SuSE Linux, the driver layers include DriverFlash Prom contains the Bios code for the HBA Fabric consists of cross-connected FC devices and switchesQLogic Fast!UTIL FC HBA Bios utility Port in a fabric where an NPort can attachAs 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 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