SN0054614-00 F | Q-Logic FC HBA CLI specification

A

4 – Interactive Commands Diagnostics Menu (Command Line Options -kl, -kr, and -dm)

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
TX Power MSB:	0x13
TX Power LSB:	0x77
RX Power MSB:	0x0b
RX Power LSB:	0x7b
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: 0x0

-Temp High Warning: 0x0

-Reserved Warning: 0x0

-Reserved Warning: 0x0

SN0054614-00 F

4-75

Image 127

Q-Logic FC HBA CLI manual SN0054614-00 F

Contents

SANsurfer FC HBA CLI User’s Guide Changes Sections Affected Revision F Changes Document Revision History Revision E Changes Added Appendix B XML Format Section Following options and commands were changed in Rev. E Following options and commands were added in Rev. E SN0054614-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 Guide Overview Product OverviewHow this Guide is Organized Topology Documentation Conventions General Information Supported Operating Systems Supported QLogic HBAs Hardware Requirements System Requirements Software Requirements Unsupported Features Technical Support Features Not Available When Running ioctl Module DriverFeatures Not Available When Running Sysfs Inbox Driver Features Not Available When Running VMware Driver Support Headquarters AvailabilityTraining Contact Information Asia Pacific Region Europe, Middle East, and Africa RegionLatin and South America Region Preliminary Introduction Starting Interactive Mode Virtual if available Following inputs are valid for the port ID Starting Non-interactive Mode Red Hat/SuSE Menu Description Section Option InteractiveWindows Macintosh Interactive Interactive Menu Non-interactive Mode Options HBA Port Terminology Downloading the Installation Package Initial Installation Windows Installation Installing SANsurfer FC HBA CLIStandard GUI Installation Welcome Dialog Box Ready to Install the Program Dialog Box Standard Command Line Installation Command Line Installation Windows Command Line Installation Parameters Silent Command Line InstallationParameter Meaning Description For SuSE Sles IA64, the command line is Linux InstallationNew 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 following Solaris x86 9 and 10 Installation Enter Macintosh Installation For example Uninstalling SANsurfer FC HBA CLI Linux Uninstall Windows UninstallStandard GUI Uninstall Command Line Uninstall Solaris x86 8, 9, and 10 Uninstall Solaris Sparc 8, 9, and 10 Uninstall Macintosh Uninstall Page Interactive Commands General Information Host Information Command Line Option -gGeneral Information Menu Host Information Host Topology Command Line Option -tp -topologyGeneral Information 2 Host Topology Display Host Topology SN0054614-00 F HBA Here is an example Seagate Save As XML File Command Line Option -bCommand Line Option Save As Txt File Generate Report Per HBA Port Command Line Option -zSave to XML File Format Generate Report ‰ HBA ID ‰ Wwpn ‰ Size ‰ Type ‰ HBA Part Number ‰ Port Number HBA ID SN0054614-00 F LUN LUN ID Refresh Generate Report All HBAsHBA Information Menu HBA Alias Command Line Option -haHBA General Information per HBA Port HBA Information HBA Port Alias Command Line Option -pa HBA VPD Information Command Line Option -l and Reserved Word vpd HBA Information n All HBAs HBA Information All HBAsInformation HBA Parameters Menu HBA Parameters n Port Instance Command Line Option -c#HBA Parameters Per HBA Port Display HBA Parameters Command Line Option -n Configure HBA Parameters Parameter Name Alias Value Description HBA Parameters Settings Nvram Data Rate Connection OptionsFrame Size Enable Fibre Channel Tape Support Loop Reset DelayEnable HBA Port Bios Enable HBA Hard Loop ID Enable LIP Reset Operation ModeInterrupt Delay Timer Login Retry Count LUNs per Target Enable LIP Full LoginLink Down Timeout Enable Target Reset Choose this option to stop without making any changes Restore DefaultsAbort Changes HBA Parameters All HBAs Target/LUN List Command Line Options -t and -lTarget/LUN List Menu Target/LUN Information Per Target/LUN Target/LUN List Per HBA Port So on Per Target/All LUNs„ Size „ Type So on. Repeats for each LUN All TargetsTarget/LUN List All HBAs Individual Target Individual LUN „ LUN ID „ Status Here is an example of the Target information Target/LUN List n Port Number So forth Hitachi All LUNs Command Line Option -q Target Link Speed or iiDMA Settings MenuTarget 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 Settings HBA Port Instance To use Basic Configuration HBA Port IiDMA Settings 1 n HBA Port n Advanced Configuration Target Link Speed 2 All HBAs Target Link Speed All HBAs Basic ConfigurationTarget Link Speed All HBAs Advanced Configuration Target Link Speed All HBAs 4.2.1 Target Persistent Bindings Menu IiDMA Settings DiskCommand Line Option -p IiDMA All HBAs Display Target Persistent Binding Target Persistent Bindings Per HBA PortTarget 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 HBAs Selective LUNs Per HBA Port Command Line Option -mTarget Persistent Binding Bind Targets Selective LUNs Menu Selective LUNs All HBAs Display LUN ConfigurationSelective LUNs 1 All HBAs Command Line Option -e Manual Configure LUNsAuto Configure LUNs Boot Device Menu „ Wwpn Boot Devices Per HBA Port Boot Device Settings Configure Boot DevicesLUN List Menu Command Line Option -fg Save ConfigurationBoot Devices All HBAs Driver Settings Menu Parameter Name Alias Value Description Param name Driver Settings Flash Save Per HBA Port Flash Update Per HBA Port or All HBAsCommand Line Option -b and Reserved Word save Utilities Menu HBA Parameters Save Per HBA Port HBA Parameters Update Per HBA Port or All HBAsHBA Parameters Template Per HBA or All HBAs Using HBA Parameter Templates IBM SUN Setting QLogic Driver Rescan Driver UpdateCommand Line Option -d Command Line Option -rs Locate HBA HBA Beacon Command Line Option -aCommand Line Option -tb Beacon Menu Beacon Selected Targets Diagnostics MenuCommand Line Options -kl, -kr, and -dm HBA Diagnostics Configuration Settings Command Line Option -kl Diagnostics Loopback TestDiagnostics n Port Number Configure Loopback Test Parameters SN0054614-00 F Run Loopback Test Diagnostics Read/Write Buffer Test Configure Read/Write Test Parameters SN0054614-00 F SN0054614-00 F SN0054614-00 F Run Read/Write Buffer Test Command Line Option -dm Diagnostics Transceiver Details DMITransceiver Details General Transceiver Details Details SN0054614-00 F SN0054614-00 F Statistics Menu ConfigurationCommand Line Options -gs and -ls Command Line Option -gs Resetting to default settings..., done Auto Poll Current Settings10. HBA Port Statistics Options Log to File Set RateShow HBA Statistics Link Status Command Line Option -ls SANsurfer FC HBA CLI displays two polling options Restore DefaultAuto Poll Menu 11. Statistics/Link Status Options Show Link Status Virtual Menu Command Line Option -vpVirtual Menu Scli -vp -h List Virtual Ports Virtual Menu for HBA InstanceVirtual Create Virtual Ports Delete Virtual Ports‰ Status Online or Loop Down Here is an example Help Menu Command Line Option -hAuto Generate User Generate Exit Codes ContentsAbout Command format to show host information is Command Line Options -g, -z, and -tpDisplay System Information Where Host ConfigurationTo show the information for all HBAs, type Command Line Option -tp Description See Section Options Shown by -z Only Command SummaryCommand format for non-interactive mode is „ -s= Silent mode see .3.28. For example Variable Definition Format 2defines the command variablesCommand Variables View or Toggle Beacon Status To view the HBA port’s LED Beacon state, type Save or Update the Flash Bios or FcodeTo 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, type Boot Device View Select Disable Display Diagnostics Monitoring InfoTo show Transceiver monitoring detailed information, type To view the current boot device selection on all HBAs These commands To disable delete the boot device for a specific HBA, type SANsurfer FC HBA CLI specifies command line input from file List SANsurfer FC HBA CLI Error CodesInput 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 settings To view system information, type For details of this command, see sectionDisplay System Information Show HBA Statistics For example, typing scli -l-hshows HelpHBA Statistics Parameters Type the following text to view the help file Set Delete HBA Alias To show general or VPD information for a specific HBA, type Loopback TestTo 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, type Hex Binary DataSize DSData Pattern Values For the loopback test, the data size is either Test Increment TI OnError OEFor the loopback test, OnError is either TestCount TC Run a Loopback Test OnError ValuesDriver Versions Not Requiring a Loopback Connector To do a loopback test using the current parameters, type An example of a successful loopback test follows To do a loopback test with custom parameters, type Run Read/Write Buffer Test Run HBA Diagnostics Loopback TestTo do a read/write test with customized parameters, type HBA Wwpn Run a Read/Write Buffer Test An example of a successful read/write buffer test follows Diagnostics Parameters Run HBA Diagnostics Read-write Buffer TestName Alias Value Description „ Status Data Pattern DP Test Patterns Display Link Status Display LUN InfoTo view the link status, type 10. Link Status Parameters View, Enable, or Disable LUNs To view an HBA’s selective LUN list, type To view all selective LUNs for all HBA ports, 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 Parameter 11. HBA Parameters 11lists the HBA parameter names and aliases Output to a File To show persistent binding information for all HBAs, type Display Persistent Target Binding Info To unbind a specific target, type To bind a selected target to a specific HBA, type To 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, type Target Beacon On/Off Display Target Information System shows the following information Display Host TopologyDisplay Version Virtual Port To create a virtual port with an automatic WWPN, type Output in XML FormatTo create a virtual port with a specific WWPN, type Display All HBA information for One or All HBAs 2 covers this command Utility Header Main Tag XML Format 1 Tags for Each Option Reboot MessageError Message Status Message XML format 1 for system information output is as follows Display Adapter SettingsCommand Line Option -c XML Format 1 for adapter settings information is as follows Display HBA Information Here is the VPD information Here is the information for the 4G HBAs Target…/Target sequence is repeated for each HBA target Command Line Option -tDisplay Device List XML Format 1 for adapter device information is as follows Display LUN List Command Line Option -lTarget Persistent Binding XML Format 1 for the boot device information is as follows Boot DeviceSelective LUNs XML Format 1 for the loopback test results is as follows Diagnostics Results -Loopback TestDiagnostics Results Read/Write Buffer Test Command Line Option -kr Non-interactive Description Section Option View Driver SettingsDisplay All Information for One or All HBAs Table A-1. Options Displayed by -z XML 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 follows XML Format 1 for the HBA port alias option is as follows XML Format 1 for the HBA alias option is as follows XML Format 1 for SFF DMI general information is as follows SFF DMI XML 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 is XML Format 2 for SFF DMI general information is as follows XML Format 2 for adapter settings information is as follows XML 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 is HBA 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 Test Target... /Target sequence repeats for each target Scli -m all view ? XML Format 2 for adapter device information is as follows Table B-1. Options Displayed by -z Non-interactive Setting Section OptionXML 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 follows XML 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 Mode Errormismatchchecksum Errorflashupdatenoregion Errorinvalidparamsettings Errorpreservenvramdata Errorduplicatetargetid Errorfailoverdriverloaded Errorclosezipfile Errorsavesellunconfig Errormissingipaddress Errorsavetargetiidmasettings Erroradapterpropmissing To see the interactive exit codes, see Appendix C Table D-1. Error Code Descriptions Non-interactive ModeCode 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 Function Disable 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 See HBA For the HBA and initializing and testing the HBAs ISPComma separated values CSV file Red Hat/SuSE Linux, the driver layers include Driver Flash 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 attach Device’s Alpa on the loop As opposed to a SAN. See SAN Storage Area NetworkNPort ID Virtualization Network Interface Controller Remote procedure call developed by Sun MicrosystemsAlso 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 file HBA 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-2 Index-10 SN0054614-00 F Txt 4-8 text file XML