Qlogic SANsurfer FC/CNA HBA CLI User Manual Download Page 159

Page: 159 / 348

3–Interactive Commands

QoS Menu (Command Line Option -qos)

SN0054614-00 K

3-107

QoS Bandwidth Percentage Menu

15: QoS

: Port number

2: QoS Bandwidth

2: Bandwidth Percentage

To set the bandwidth percentage for a virtual port:

From the

QoS Bandwidth Percentage Menu

, type the number

corresponding to the virtual port that you want to change. Take note of
whether or not that virtual port is currently

Enabled

and

Unlocked

, and then

press ENTER.

If the virtual port is already enabled and unlocked, proceed to

Step 3

Otherwise:

The virtual port must be

Enabled

to set the bandwidth. To enable a

currently disabled vPort, enter

for the

Enable/Disable QoS Settings

option and then

again to

Enable

the vPort.

The virtual port must be

Unlocked

to set the bandwidth. To unlock a

currently locked vPort, enter

for the

Lock/Unlock QoS Settings

option and then

again to

Unlock

the vPort.

On the

QoS Bandwidth Percentage Menu

, select the

Modify QoS

Settings

option.

The

Enter Bandwidth Percentage

prompt shows the allowable range and

current percentage in square brackets. Enter a new percentage value and
then press ENTER.

The

QoS Bandwidth Percentage Menu

reappears and lists all the virtual

ports.

Verify that the bandwidth percentage is correct for the virtual port that you
changed.

(Optional) To prevent further changes to the virtual port, set the mode to

Locked

(Optional) To change the bandwidth percentage for additional virtual ports,
repeat the previous steps.

When the

QoS Bandwidth Percentage Menu

reappears, select the

Apply

QoS Settings

option to save your changes.

The following confirmation appears:

Changes in QoS settings have been applied to selected vPort(s)

NOTE:

No changes made to QoS settings in the previous steps are saved until
you select

Apply QoS Settings

Summary of Contents for SANsurfer FC/CNA HBA CLI

Page 1: ...SN0054614 00 K SANsurfer FC CNA HBA CLI User s Guide Command Line Interface for QLogic FC and FCoE Adapters ...

Page 2: ...vision 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 29 2008 Revision G June 30 2008 Revision H July 16 2008 Revision J March 11 2009 Revision K June 15 2009 Changes Sections Affected Revision K Changes Changed product name from SANsurfer FC HBA CLI to SANsurfer FC CNA HBA CLI All Added...

Page 3: ...ded new message passing interface MPI options for the Utilities menu Update MPI Config Table on page 3 71 Save MPI Config Table on page 3 71 Updated loopback and read write buffer test descriptions and examples Diagnostics Loopback Test Command Line Option kl on page 3 77 Diagnostics Read Write Buffer Test on page 3 83 Updated the transceiver details output examples Diagnostics Transceiver Details...

Page 4: ...iv SN0054614 00 K SANsurfer FC CNA HBA CLI User s Guide Command Line Interface for QLogic FC and FCoE Adapters Notes ...

Page 5: ...ng Systems 1 3 System Requirements 1 4 Hardware Requirements 1 4 Software Requirements 1 5 Unsupported Features 1 5 Downloading the Installation Package 1 6 Installing SANsurfer FC CNA HBA CLI 1 7 Windows Installation 1 8 Standard GUI Installation 1 8 Command Line Installation 1 12 Linux Installation 1 14 Solaris Installation 1 15 Solaris SPARC 8 9 10 Installation 1 15 Solaris x86 9 and 10 Install...

Page 6: ...neral Information Menu Command Line Option g 3 4 Host Information Command Line Option g 3 4 Host Topology Command Line Option tp topology 3 5 Display Host Topology Command Line Option tp topology 3 6 Save As Txt File Command Line Option b 3 10 Save As XML File 3 10 Generate Report Command Line Option z 3 10 Generate Report Per Adapter Port 3 11 Generate Report All Adapters Command Line Option z 3 ...

Page 7: ...st All Adapters 3 42 Individual Target 3 42 Individual LUN 3 43 All Targets 3 43 All Target s 3 44 All LUN s 3 45 Target Link Speed or iiDMA Settings Menu Command Line Option q 3 47 Configuring the iiDMA Settings 3 48 HBA Port Instance 3 49 HBA Port 3 50 Advanced Configuration 3 51 Target Link Speed All HBAs 3 51 Target Link Speed All HBAs Basic Configuration 3 52 Target Link Speed All HBAs Advanc...

Page 8: ...g 3 62 Utilities Menu 3 64 Update Flash Per Adapter Port or All HBAs Command Line Option b 3 65 Save Flash Per Adapter Port Command Line Option b and Reserved Word save 3 65 Update HBA Parameters Per Adapter Port or All HBAs Command Line Option r 3 65 Save HBA Parameters Per Adapter Port Command Line Option r and Reserved Word save 3 66 HBA Parameters Template Per Adapter or All HBAs Command Line ...

Page 9: ...3 85 Transceiver Details General 3 86 Transceiver Details Details 3 86 Statistics Menu Command Line Options gs and ls 3 89 HBA Statistics Monitoring Command Line Option gs 3 90 Configuration 3 90 Show HBA Statistics 3 93 Link Status Command Line Option ls 3 93 Configuration 3 94 Show Link Status 3 96 Virtual Menu Command Line Option vp 3 97 Virtual Menu for Adapter Instance 3 98 List Virtual Port ...

Page 10: ...ation 4 4 Command Summary 4 5 a View or Toggle Beacon Status 4 6 b Save or Update the Flash BIOS or FCode 4 7 c Show Parameter Settings 4 8 cna FCoE Utilities Menu for QLx81xx Adapters 4 8 d Update Device Driver 4 10 dm Display Diagnostics Monitoring Info 4 10 e Boot Device View Select Disable 4 11 ei List SANsurfer FC CNA HBA CLI Error Codes 4 13 f Input Parameter Options from a Text File 4 13 fc...

Page 11: ...ding Info 4 38 pa Define Port Alias 4 40 pl Show Add and Delete Persistent Names 4 41 q View or Set Target Link Speed 4 42 qos QoS Menu 4 43 r Update HBA Parameters 4 44 s Silent Mode 4 45 t Display Target Information 4 45 tb Target Beacon On Off 4 46 tp Display Host Topology 4 46 u Firmware Area Update Save 4 46 v Display Version 4 47 vp Virtual Port 4 47 x Output in XML Format 1 4 48 x2 Output i...

Page 12: ...s A 14 HBA Statistics Command Line Option gs A 14 HBA Alias Command Line Option ha A 15 HBA Port Alias Command Line Option pa A 15 HBA Transceiver Details Command Line Option dm A 16 Host Topology Command Line Option tp A 20 Display FCoE Information A 22 Display FCoE Parameters A 23 Display FCoE Link Events A 23 Display FCoE DCBX A 25 Display FCoE Network Interface Statistics A 26 B XML Format 2 O...

Page 13: ...Alias Command Line Option ha B 18 HBA Port Alias Command Line Option pa B 18 HBA Transceiver Details Command Line Option dm B 20 Host Topology Command Line Option tp B 25 Display FCoE Information B 27 Display FCoE Parameters B 27 Display FCoE Link Events B 27 Display FCoE DCBX B 29 Display FCoE Network Interface Statistics B 30 C Error Exit Return Codes D Help Commands Glossary Index List of Figur...

Page 14: ...ISP2312 3 68 3 9 Template Supported Parameter Settings for QLA23xx Adapters ISP2322 3 68 3 10 Adapter Diagnostics Configuration Settings 3 81 3 11 Adapter Port Statistics Options 3 91 3 12 Statistics Link Status Options 3 94 3 13 DCBX and ETS Configuration Parameters 3 113 4 1 Options Shown by z 4 4 4 2 Command Variables 4 6 4 3 DCE Statistics Parameters 4 10 4 4 FCoE Engine Parameters 4 15 4 5 Dr...

Page 15: ...d condensed version of the SANsurfer FC HBA Manager graphical user interface GUI which manages both local and remote hosts SANsurfer FC CNA HBA CLI can be operated in two modes Interactive mode menu driven interface This mode requires user intervention Non interactive mode command line interface Use this mode for scripting or when you want to do a single operation Intended Audience This guide is i...

Page 16: ...ML files created with the x1 command line option Appendix B XML Format 2 provides explanations and examples of XML files created with the x2 command line option Appendix C Error Exit Return Codes lists the error return codes that can occur while running SANsurfer FC CNA HBA CLI in interactive and non interactive modes For each return code number it provides the name and description Appendix D Help...

Page 17: ...r the latest firmware and product updates For information on the Virtual Menu see Virtual Menu for Adapter Instance on page 3 98 In 3 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 SAN...

Page 18: ... the Education Training tab at the left The QLogic Global Training Portal offers online courses certification exams and scheduling of in person training Technical certification courses include installation maintenance and troubleshooting QLogic products Upon demonstrating knowledge using live equipment QLogic awards a certificate identifying the student as a Certified Professional The training pro...

Page 19: ... HBA CLI on page 1 7 Uninstalling SANsurfer FC CNA HBA CLI on page 1 21 Prerequisites Before you run SANsurfer FC CNA HBA CLI ensure that the following requirements are met The adapters must be installed The adapter drivers must be installed For QLE81xx and QMI81xx adapters a QLogic specific small form factor pluggable SFP must be installed NOTE Some SANsurfer FC CNA HBA CLI features are not avail...

Page 20: ...nformation see Unsupported Features on page 1 5 NOTE If SANsurfer FC CNA HBA CLI detects an unsupported adapter the following message appears where X is the adapter instance number and YYYYYYY is the adapter model Unsupported HBA Instance X YYYYYYY If SANsurfer FC CNA HBA CLI detects an adapter for which no information is known the following message appears where X is the adapter instance number 0...

Page 21: ... bit Intel IA64 Intel 64 AMD64 Red Hat RHEL AS ES 4 5 32 bit 64 bit Intel IA64 Intel 64 AMD64 Red Hat RHEL AS ES 4 0 32 bit 64 bit Intel IA64 Intel 64 AMD64 Red Hat RHEL AS ES 3 0 32 bit 64 bit Intel x86 Intel 64 AMD64 Red Hat PowerPC64 Novell SLES 10 32 bit 64 bit Intel IA64 Intel 64 AMD64 Novell SLES 9 32 bit 64 bit Intel IA64 Intel 64 AMD64 Novell SLES 8 32 bit 64 bit Intel x86 AMD64 Novell Pow...

Page 22: ... 1 8 MHz or greater with 512 MB of memory FC devices such as disks and RAID subsystems QLogic FC adapters SANsurfer FC CNA 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 http connect qlogic com interopguide Interoperability asp NOTES Throughout this guide the terms Windo...

Page 23: ...ing on your system not all SANsurfer FC adapter features are available 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 ports Adapter parameters settings Adapter parameters restore default Flash update from file Flash save to file Adapter parameters update from file Adapte...

Page 24: ...ics Driver settings Host topology Link status Loopback test 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 Adapter parameters settings Adapter parameters restore default Flash update from file Flash save to file Adapter parameters update from file Adapter parameters save to file Adapter para...

Page 25: ...nload the file Installing SANsurfer FC CNA HBA CLI Follow the installation instructions in the section that corresponds to your operating system OS Windows Installation on page 1 8 Linux Installation on page 1 14 Solaris Installation on page 1 15 Macintosh Installation on page 1 18 VMware Installation on page 1 20 NOTE If you have a previous version of SANsurfer FC HBA CLI already installed the in...

Page 26: ...and Line Installation on page 1 12 Standard GUI Installation Follow these steps to install SANsurfer FC CNA HBA CLI on a Windows operating system using the standard GUI method To install SANsurfer FC CNA HBA CLI on Windows GUI 1 Locate and double click the installer package The Preparing to Install dialog box appears as shown in Figure 1 2 The status bar indicates that the installation package is ...

Page 27: ...moval Installing SANsurfer FC CNA HBA CLI SN0054614 00 K 1 9 After the install package is loaded the Welcome dialog box appears as shown in Figure 1 3 Figure 1 3 Welcome Dialog Box 2 Read the information and then click Next ...

Page 28: ... Dialog Box 3 In the Choose Destination Location dialog box do one of the following To select the destination location in the dialog box click Next recommended The default location for a Windows system is Program Files QLogic Corporation SANsurferCLI To select a different location a Click Browse b Select an installation location c The Choose Destination Location dialog box reappears Click Next ...

Page 29: ...00 K 1 11 The Ready to Install the Program dialog box appears as shown in Figure 1 5 Figure 1 5 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 1 6 Figure 1 6 Setup Status Dialog Box ...

Page 30: ...g If you want to see more information about SANsurfer FC CNA HBA CLI select the I would like to view the README file check box If you want to start SANsurfer FC CNA HBA CLI select the I would like to launch SANsurfer FC CLI check box 6 Click Finish Command Line Installation To install SANsurfer FC CNA HBA CLI using the command line installation follow the steps for either standard or silent instal...

Page 31: ... Installation Parameters Parameter Meaning Description r Record modea To run the SANsurfer FC CNA HBA CLI installation package in silent mode 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 alt...

Page 32: ... site or the SANsurfer for FC and FCoE Adapters CD ROM download to your local machine following file scli x xx xx xx i386 rpm gz Where x xx xx xx specifies the current version of SANsurfer FC CNA HBA CLI f2 Specify alternative log file namea When running an InstallScript MSI or InstallScript installation in silent mode using the s parameter the log file Setup log is created in the same directory a...

Page 33: ...the steps in one of these sections Solaris SPARC 8 9 10 Installation on page 1 15 Solaris x86 9 and 10 Installation on page 1 17 Solaris SPARC 8 9 10 Installation Follow these steps to install SANsurfer FC CNA HBA CLI on a Solaris SPARC 8 9 or 10 operating system To install SANsurfer FC CNA HBA CLI on Solaris 8 9 or 10 1 From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD ROM dow...

Page 34: ...nstance QLScli from space chuynh scli qlogic Solaris pkgs x QLogic SANsurfer FC CNA HBA CLI HBA Configuration Utility sparc x xx xx Build xx QLogic Corporation Executing checkinstall script Using 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...

Page 35: ...urfer for FC and FCoE Adapters CD ROM download to a temporary directory for example tmp on your machine the following file scli x xx xx xx x86 Solaris pkg 2 To decompress the file type the following uncompress scli x xx xx xx x86 Solaris pkg 3 To see 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 SANsurf...

Page 36: ... installed Verifying disk space requirements Checking for conflicts with packages already installed Checking for setuid setgid programs verifying class none Executing postinatall script Installation of QLSclix was successful Macintosh Installation To install SANsurfer FC CNA HBA CLI on a Macintosh system follow either the standard GUI or command line installation method Standard GUI Installation o...

Page 37: ...CNA HBA CLI on a Macintosh using the command line method To install SANsurfer FC CNA HBA CLI on Macintosh command line 1 Download the SCLI install package for Mac OS x compressed tar file to a local directory 2 Decompress the file by typing the following command tar zxvf file 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...

Page 38: ... installer Upgrading volume mounted at installer The upgrade was successful VMware Installation Follow these steps to install SANsurfer FC CNA HBA CLI on a system running VMware ESX 3 5 To install SANsurfer FC CNA HBA CLI on VMware ESX 3 5 1 From either the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD ROM download to your local machine the following file scli x xx xx xx i386 rpm gz...

Page 39: ...stall SANsurfer FC CNA HBA CLI on Windows using the GUI method To uninstall SANsurfer FC CNA HBA CLI on Windows GUI 1 From the Control Panel click Add or Remove Programs 2 Highlight SANsurfer FC CNA 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 Command Line Uninstall Follow these steps to uninstall ...

Page 40: ...tall SANsurfer FC CNA HBA CLI To uninstall SANsurfer FC CNA HBA CLI on Solaris SPARC 8 9 and 10 1 Type the following pkgrm QLScli 2 The program shows the package name and a script warning asking whether to continue the uninstall process For example The following package is currently installed QLScli QLogic SANsurfer FC CNA HBA CLI HBA Configuration Utility sparc 1 x x Build xx Do you want to remov...

Page 41: ...ng whether to continue the uninstall process For example The following package is currently installed QLSclix QLogic SANsurfer FC CNA HBA CLI HBA Configuration Utility x86 1 x x Build xx Do you want to remove this package 3 Type y and then press ENTER The program shows a script warning asking whether to continue the uninstall process For example Removing installed package instance QLSclix This pac...

Page 42: ...rfer FC CNA HBA CLI delete its folder and any references to the SANsurfer installer package s in the Library Receipts directory For example rm rf Library Receipts scli x x x x pkg VMware Uninstall To uninstall SANsurfer FC CNA HBA CLI on a VMware ESX 3 5 system go to the command line and type one of the following commands where x xx xx is the current version of the CLI rpm e scli x xx xx xx rpm e ...

Page 43: ...overs this interface Non interactive command line The CLI starts executes the functions defined by the list of parameters provided and then terminates Use this mode to run SANsurfer FC CNA HBA CLI from a script file or when you want to do a single operation 4 Non Interactive Commands covers this interface SANsurfer FC CNA HBA CLI is not case sensitive in either mode However file names in some oper...

Page 44: ...lowing SANsurfer FC CNA HBA CLI v1 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 supported by adapter 15 Exit or 15 QoS if supported by adapter or 16 FCo...

Page 45: ...peed or iiDMA Settings The Virtual menu selection is available only on Windows systems running with a driver that supports NPIV N_Port ID virtualization The QoS menu selection is available only on Windows systems with an 8Gb adapter The FCoE menu selection is available only if an FCoE or converged network adapter is present For a converged network adapter with an inbox driver the Main Menu contain...

Page 46: ...surfer FC CNA HBA CLI accepts the notation with and without the dash Hexadecimal values can be uppercase or lowercase The following input formats are both 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...

Page 47: ...0 dm 12 12 12 Transceiver details dm Display Diag nostics Monitoring Info on page 4 10 e 8 8 8 Boot device settings e Boot Device View Select Dis able on page 4 11 f Input from a file f Input Parame ter Options from a Text File on page 4 13 fg 9 9 9 View driver settings fg Show Driver Settings on page 4 16 fs 9 9 9 Driver settings fs Configure Driver Settings on page 4 16 10 10 10 Adapter utilitie...

Page 48: ...ral Informa tion or VPD Infor mation for One or All HBAs on page 4 20 kl 12 12 12 Loopback test kl Loopback Test on page 4 20 kr 12 12 12 Read write buffer test kr Run Read Write Buffer Test on page 4 27 l 4 4 4 Show LUN list l Display LUN Info on page 4 32 ls 13 13 13 Show Link status ls Display Link Status on page 4 32 m 7 7 7 Selective LUNs m View Enable or Disable LUNs on page 4 33 Table 2 1 N...

Page 49: ...mes pl Show Add and Delete Persis tent Names on page 4 41 q 5 5 5 Target link speed q View or Set Target Link Speed on page 4 42 qos 15 Quality of service qos QoS Menu on page 4 43 r Save update NVRAM r Update HBA Parameters on page 4 44 1 1 1 Refresh 15 16 15 16 15 16 Quit s Silent mode s Silent Mode on page 4 45 t 4 4 4 Show device list t Display Target Information on page 4 45 Table 2 1 Non int...

Page 50: ... on page 4 46 u 10 10 10 Update or save firm ware preload area u Firmware Area Update Save on page 4 46 v Show version v Display Ver sion on page 4 47 vp 14 14 Virtual portsc vp Virtual Port on page 4 47 x 1 1 1 Output in XML format x Output in XML Format 1 on page 4 48 z 2 2 2 Show all information for one or all adapters z Display All HBA information for One or All HBAs on page 4 49 Table Notes a...

Page 51: ...r For example a QLA2462 has two ports called HBA port 1 and HBA port 2 adapter instance adapter instance number or adapter port instance When you install adapter in a system with other adapters each adapter port gets assigned a number by the driver or API so it knows which adapter to communicate with This assigned number might be called adapter instance adapter instance number or adapter port inst...

Page 52: ...h eventually translates to IOPS or allocating bandwidth to them Setting the QoS by bandwidth lets you allocate up to 80 of the number of gigabits per second Gbps transmission speed of the physical port s capacity to its defined virtual ports NPIV Using this feature lets you guarantee a transmission rate for each virtual port that requires a specific bandwidth to run mission critical applications f...

Page 53: ...n Menu Command Line Option i on page 3 19 HBA Parameters Menu on page 3 24 Target LUN List Menu Command Line Options t and l on page 3 36 Target Link Speed or iiDMA Settings Menu Command Line Option q on page 3 47 Target Persistent Bindings Menu Command Line Option p on page 3 54 Selective LUNs Menu Command Line Option m on page 3 58 Boot Device Menu Command Line Option e on page 3 60 Driver Setti...

Page 54: ...he 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 supported by adapter 15 Exit or 15 QoS if supported by adapter or 16 FCoE if supported b...

Page 55: ...ion 1 to open the General Information menu 2 to open the Host Topology menu and then 2 again to see the Save As Txt File options The following shows the breadcrumbs example NOTES Selections on the Main Menu are dynamic and what you see depends on your system s operating system drivers and adapter type Based on your specific system this menu may contain different items For example Selection 5 may b...

Page 56: ... Topology see Host Topology Command Line Option tp topology on page 3 5 Report see Generate Report Command Line Option z on page 3 10 Refresh see Refresh on page 3 19 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 ...

Page 57: ...FC0551C34679 Port 1 WWPN 21 00 00 E0 8B 1F 9D F0 SN FFC0519U93213 HBA Instance 4 Online Port 2 WWPN 21 01 00 E0 8B 3F 9D P0 SN FFC0519U93213 HBA Instance 5 Loop down HBA Model QLA21O SN C655417 Port 1 WWPN 21 00 00 E0 8B 1A 3F E0 SN R61343 HBA Instance 6 Online Total QLogic HBA s 4 Host Topology Command Line Option tp topology 1 General Information 2 Host Topology This option shows you the HBA Hos...

Page 58: ... switch Interconnect element switch Type Switch or adapter World wide name Domain ID Management ID IP address Model Symbolic name Serial number MAC address Firmware version Port count Beacon status If the interconnect element is an adapter Interconnect element adapter Type World wide node name World wide port name Vendor ID Adapter Model Adapter Serial Number Adapter Alias Port Alias Driver Versio...

Page 59: ...iator Node Name Port Name Vendor ID Product ID if applicable Product Revision if applicable Product Serial Number if applicable Adapter Model if applicable Adapter Serial Number if applicable Adapter Alias if applicable Port Alias if applicable Driver Version if applicable Firmware version if applicable Total number of devices targets if applicable Host if applicable Here is an example InterConnec...

Page 60: ... Firmware Version Port Count 8 Beacon Status Unsupported Port Information Physical Port Number 1 Port Name 20 00 00 C0 DD 00 6A 9F Port state Offline Port Type F_Port TX Port Type Electrical EL Port Module Type GBIC Physical Port Number 2 Port Name 20 01 00 C0 DD 00 6A 9F Port state Offline Port Type Vendor Specific Reserved Port Type TX Port Type Electrical EL Port Module Type GBIC Attached Port ...

Page 61: ...e 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 02 03 Total Number of Devices 0 Host BRAGI InterConnect Element Type HBA World Wide Node Name 20 00 00 E...

Page 62: ...u with options to Save as XML Format 1 Save as XML Format 2 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 Topology has been successfully saved to file BRAGI_topology_06152009_093855 xml Save to XML File Format 2 Command Line Option x2 1 Gener...

Page 63: ...on including SANsurfer FC CNA HBA CLI header Version and build Adapter header Host name OS type OS version SDM API version Adapter Model Serial Number Port number Port WWPN Adapter instance Status online offline Adapter General Information Host Name Adapter Instance Adapter Model Adapter Description Adapter ID Adapter Alias Adapter Port Port Alias Node Name WWNN Port Name WWPN Port ID Serial Numbe...

Page 64: ...e actual VPD information 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 Flash Image Version Adapter Parameters Settings Header Command Line Options c Adapter Instance Adapter Part Number Port Number WWPN Port ID Adapter Parameter Settings Connect...

Page 65: ...tance Adapter Part Number Port Number WWPN Port ID Driver Settings repeats for each adapter 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 adapter instance Adapter Instance Adapter Part Number Port Number WWPN PORT ID Device LUNs ...

Page 66: ...evice Vendor ID Device Product ID Serial Number Device Port Name Device Port ID Boot Device Settings Selectable Boot Primary Boot Port Name 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 CNA HBA CLI vx x x Build x Copy...

Page 67: ...A 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 2009 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...

Page 68: ...op ID Disabled Enable FC Tape Support Enabled Execution Throttle 16 Login Retry Count 8 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...

Page 69: ...1 E4 Product Type Disk LUN Count s 1 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 0 Target 1 Device ID 0x83 Product Vendor SEAGATE Product ID ST118273 CLAR18 Product Revision ...

Page 70: ...1 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 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 Device Vendor ID SEAGATE Device Product ID ST118273 CLAR18 Serial Number LP60266900001919H...

Page 71: ...e system shows the report information for all adapters See Generate Report Per Adapter Port on page 3 11 in which data repeats for every adapter Refresh 1 General Information 4 Refresh This selection returns the option to refresh the configuration for the current host HBA Information Menu Command Line Option i 2 HBA Information This command shows the HBA Information Menu that includes list of all ...

Page 72: ...7 All HBAs 8 Return to Previous Menu In the following example the QLE8042 adapter includes an FCoE engine HBA Information Menu HBA Model QLE2562 1 Port 1 WWPN 21 00 00 1B 32 16 C3 EE Online 2 Port 2 WWPN 21 01 00 1B 32 36 C3 EE SFP not installed HBA Model QLE8042 3 Port 1 WWPN 21 00 00 E0 8B 80 5F 0F Link Down 4 FCoE Engine 5 Port 2 WWPN 21 01 00 E0 8B A0 5F 0F Link Down HBA Model QLE220 6 Port 1 ...

Page 73: ...formation Command Line Option i 2 HBA Information n Port Number 1 HBA Information This option produces the same HBA Information Menu available from the General Information Report menu See Generate Report Per Adapter Port on page 3 11 To view FCoE information enter the following command line option scli fcoe hba instance hba wwpn info For the QLx81xx adapters only additional information includes th...

Page 74: ...er for the adapter model and then press ENTER 5 Create modify or delete the adapter alias as follows a To create or modify an the adapter alias type a symbolic name maximum 100 characters at the HBA Alias prompt and then press ENTER b To delete an existing adapter alias leave the HBA Alias field empty and then press ENTER Here is an example of the HBA Alias option HBA Alias Menu 1 HBA Model QLA246...

Page 75: ...select a port number from the Port Alias Menu the CLI prompts you to enter a Port Alias as follows Port Alias _ To keep the current port alias enter the number for Cancel and then press ENTER To change the port alias type a new name and then press ENTER To delete an existing port alias leave the field blank and then press ENTER HBA VPD Information Command Line Option l and Reserved Word vpd 2 HBA ...

Page 76: ...The Information menu shows the same adapter Information available from the General Information Menu See Generate Report Per Adapter Port on page 3 11 2 HBA Information n All HBAs 3 VPD The VPD menu shows the same Vital Product Data available from the HBA Information Menu See HBA VPD Information Command Line Option l and Reserved Word vpd on page 3 23 HBA Parameters Menu 3 HBA Parameters The HBA Pa...

Page 77: ... 8 All HBAs 9 Return to Previous Menu The following example of an HBA Parameters Menu includes adapter QLE8042 with an FCoE engine see HBA Parameters Per FCoE Engine HBA Model QLE2562 1 Port 1 WWPN 21 00 00 1B 32 16 C3 EE Online 2 Port 2 WWPN 21 01 00 1B 32 36 C3 EE SFP not installed HBA Model QLE8042 3 Port 1 WWPN 21 00 00 E0 8B 80 5F 0F Link Down 4 FCoE Engine 5 Port 2 WWPN 21 01 00 E0 8B A0 5F ...

Page 78: ...ottle 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 Order Frame Configure HBA Parameters Command Line Option n 3 HBA Parameters n Port Number 2 Configure HBA Parameters From the Configure HBA Parameters menu you can configure the following adapter parameters Connection Options Data ...

Page 79: ...0 3 See table note 1 DataRate DR 0 4 See table note 2 EnableBIOS EB 0 1 See table notes 3 4 EnableExtendedLogging EL 0 1 See table notes 3 4 EnableFCTape EF 0 1 See table note 3 EnableHardLooplD HL 0 1 See table note 3 EnableLIPFullLogin FL 0 1 See table note 3 EnableLipReset LP 0 1 See table note 3 EnableReceiveOutOfOrderFrame EO 0 1 See table notes 3 5 EnableTargetReset TR 0 1 See table note 3 E...

Page 80: ... Interrupt when Interrupt Delay Timer expires 6 Interrupt when Interrupt Delay Timer expires or no active I O Connection Options 3 HBA Parameters 1 Port Number 2 Configure HBA Parameters n Connection Options From this menu you can configure the connection options 0 Loop Only 1 Point to Point Only 2 Loop Preferred Otherwise Point to Point 3 Point to Point Otherwise Loop QLA22xx adapter only Type th...

Page 81: ...ize menu From it you can select Frame Size 512 Frame Size 1024 Frame Size 2048 Type the number for the frame size you want and then press ENTER Hard Loop ID 3 HBA Parameters N Port Number 2 Configure HBA Parameters 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 then press ENTER Loop Reset Delay 3 HBA Parameters N Port Number 2 Config...

Page 82: ...ble Fibre Channel Tape support Type the number you want and then press ENTER Operation Mode 3 HBA Parameters N Port Number 2 Configure HBA Parameters n Operation Mode This option shows the Operation Mode Menu From it you can select Interrupt for every I O Completion Interrupt when Interrupt Delay Timer expires Interrupt when Interrupt Delay Timer expires or no active I O Type the number for the Op...

Page 83: ...e LIP Full Login 3 HBA Parameters 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 Link Down Timeout 3 HBA Parameters N Port Number 2 Configure HBA Parameters n Link Down Timeout This choice gives you the option to set the Link Down timeout to a value from 0 to 240 Enable Target Reset 3 HBA Parameters N Port Numbe...

Page 84: ...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 device settings before the HBA parameters update or re configure the boot settings after the upd...

Page 85: ...at instance as shown in the following example FCoE Port Selection Menu FCoE Engine QLE8042 Desc QLE8042 Mercury CNA 1 Port 0 2 Port 1 3 Return to Previous Menu Note 0 to return to Main Menu Enter Selection 1 FCoE Parameters Port 0 Host Name TARGET3 HBA Instance 3 HBA Model QLE8042 HBA Description QLE8042 Mercury CNA Port Type Access Pause Type Priority Flow Control Priority Pause Mask 0 1 2 3 x 4 ...

Page 86: ...the port is configured as an access port packets are untagged and do not contain a VLAN tag Pause Type 3 HBA Parameters n FCoE Engine 2 Configure FCoE Parameters n Pause Type This option shows the Pause Type menu Pause types include Standard Pause and Priority Flow Control per priority pause Pause is a frame that controls the flow between transmitter and receiver if the transmitter sends data at a...

Page 87: ... Priority Flow Control type length value TLV this parameter is configured on the adapter When not connected to a DCBX enabled peer or before receipt of a Priority Flow Control TLV on setting of this parameter on the adapter FCoE COS 3 HBA Parameters N FCoE Engine 2 Configure FCoE Parameters n FCoE COS This option prompts you to configure a persistent value for the FCoE class of service CoS for pri...

Page 88: ...lking to a switch that does not support DCBX HBA Parameters All HBAs 3 HBA Parameters n All HBAs When you select this option the parameters listed in HBA Parameters Per Adapter Port on page 3 25 appear for every adapter 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 adapters and port instances detected on...

Page 89: ... Vendor SEAGATE Product ID ST318453FC Product Rev 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 2 Disk Online Table 3 2 Target LUN Information Variable Description address IP address hba instance Adapter number adapter instance number hba wwpn Adapter world wide port name format xx xx xx xx xx xx xx xx or xxxxxxxx lun i...

Page 90: ...get the LUN List Menu for that target appears It includes a list of all LUNs on that target and the following information for each LUN LUN Number Vendor Product ID Port Name Port ID All LUN s Here is an example of the LUN List Menu 1 LUN 0 Vendor SEAGATE Product ID ST318453FC Port Name 22 00 00 11 C6 2D 5B F9 Port ID 02 0A DC And so on n All LUN s n Return to Previous Menu Per Target All LUNs 4 Ta...

Page 91: ...ULN OS LUN Name on Solaris and Linux For example Product Vendor HP Product ID MSA VOLUME Product Revision 6 68 LUN 8 Size 4 88 GB Type SBC 2 Direct access block device e g magnetic disk WWULN 60 05 08 B3 00 90 8D B0 AF 57 A1 B0 88 40 00 20 OS LUN Name dev sdh Persistent Names Menu Command Line Option pl 4 Target LUN List 1 n Target List Menu Port n 1 n Target 1 n LUN Number 2 Persistent Names In l...

Page 92: ...dor HP Product ID MSA VOLUME Product Revision 6 68 LUN 8 WWULN 60 05 08 B3 00 90 8D B0 AF 57 A1 B0 88 40 00 20 OS LUN Name dev sdh Persistent LUN Name 2 Add To add persistent binding for the LUN select 2 on the Persistent Names Menu The following device information is shown and you are prompted to enter a new persistent device name For example Product Vendor HP Product ID MSA VOLUME Product Revisi...

Page 93: ...F 53 50 00 00 00 00 00 00 00 1C OS LUN Name dev sdbh dev sg59 Persistent LUN Name test1 Persistent device name of LUN 28 TID 1 has been deleted Please reboot or run udevtrigger command for the changes to take effect Hit RETURN to continue For the persistent device name deletion to take effect you must either reboot the system or run the udevtrigger command All Targets 4 Target LUN List 1 n Target ...

Page 94: ...ws the Target List Menu for All HBAs Individual Target Individual LUN All Target s All LUN s Individual Target 4 Target LUN List N All HBAs 1 Individual Target This choice shows the Target List Menu for All HBAs Information for each individual target includes Target type on QLAxxxx adapter instance n Vendor Product ID Product Revision Serial Number Port Name Port ID Repeats for each target Here is...

Page 95: ...g target information appears Path Target Device ID Product Vendor Product ID Product Revision Node Name Port Name Product Type LUN Count s Status Here is an example of the Target information Path 0 Target 3 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 ...

Page 96: ...ect access block device e g magnetic disk WWULN 20 00 00 0C 50 68 1E 9A Hit RETURN to continue All Target s 4 Target LUN List 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 Serial Number Node Name Port Name Port ID Product Type LUN Count s Status NOTE In the Solaris OS the...

Page 97: ...1 00 00 20 37 1A 6B CF Port ID 11 01 E4 Product Type Disk LUN Count s 1 Status Online And so forth All LUN s 4 Target LUN List n Port Number 3 All LUN s When you select this option SANsurfer FC CNA HBA CLI shows the following information about all LUNs for all adapter port instances Product Vendor Product ID Product Revision LUN Size in GB or MB Type for example magnetic disk WWULN world wide uniq...

Page 98: ...e 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 LUN 0 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 Produ...

Page 99: ...0 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 P0 Loop down HBA Model QLA21O 7 Port 1 WiIPN 21 00 00 E0 8B 1A 3F E0 Online 8 All HBAs 9 Return to Previous Menu Table 3 3 lists the target link speed settings and descriptions NOTE Depending on your system ...

Page 100: ...ect an apply different iiDMA update to each device attached to this adapter 4 To use Basic Configuration a Select the adapter b Select the iiDMA 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 To apply the new settings to all attached devices select Yes The following is returned target id Target ID targe...

Page 101: ... target s The following is returned The iiDMA settings have been saved to selected target s To exit without making any changes select Return to Previous Menu HBA Port Instance 5 Target Link Speed 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 Per Target L...

Page 102: ...9A Port ID 11 0A E2 Max Target Link Rate 4 Gbps m Disk 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 n Apply Changes to Selected Target s HBA Port 5 iiDMA Settings 1 n HBA Port n If you select a port for adapter model QLA2462 the following information appears iiDMA Menu HBA Inst...

Page 103: ...m the Target Link Menu the Target Link Speed Menu Advanced appears It includes the link speed options The options vary according to the adapter in use For example 1 Gbps 2 Gbps 4Gbps 8 Gbps Type the number for the link speed you want for the adapter port instance selected and then press ENTER The same menu reappears allowing you to set the link speed for every port instance you want When you have ...

Page 104: ...All HBAs 1 Advanced Configuration This option shows the Target Link Speed Menu Advanced for All HBAs This menu lists all targets on all adapters and shows information about each target Target Type Target number Adapter model and instance Product vendor Product ID Product revision Serial Number Port Name Port ID Max Target Link Rate Next Target Type Target number Adapter model and instance Apply Ch...

Page 105: ...te 4 Gbps p Apply Changes to Selected Target s Target Link Speed All HBAs Advanced Configuration 5 Target Link Speed 2 All HBAs 1 Advanced Configuration 1 n Link speed When you select an adapter to set its link speed the Target Link Speed Menu Advanced menu for a specific adapter instance appears It shows the link speed options you can choose from The options vary according to the adapter in use F...

Page 106: ...rfer FC CNA HBA CLI shows the Target Persistent Binding menu listing standard adapter port instances see HBA Port Instance on page 3 49 where you can select an individual adapter port or All HBAs The following sections describe how to view set and delete the adapter s target persistent binding in interactive and non interactive modes Whether you select a specific adapter port instance or All HBAs ...

Page 107: ... 1 n Target Persistent Binding HBA Instance n 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 Bind status Yes or No Device type Disk for example Target information model name and number for example Port Name Port ID Target ID Target Persistent Bindi...

Page 108: ...o Target ID m Disk 2 on QLA2462 HBA Instance 1 Vendor SEAGATE 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 C6 2D 5A 3F Port ID 02 0A E4 Bind No Target ID p All Target s Target Persistent Binding FC Port Configuration Command Line Option p 6 Target Persistent Binding 1 n Target Persistent...

Page 109: ... Display Configuration Bind Target s Unbind Target s Display Target Persistent Binding 6 Target Persistent Binding p All HBAs 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 Bind status Yes or No Device type Disk for example Target information model...

Page 110: ...on 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 Selective LUNs All HBAs 7 Selective LUNs 1 All HBAs When you select this option SANsurfer FC CNA HBA CLI shows the following options for all adapters Display LUN Configuration Manual Configure LUNs Auto Configure LUNs Display LUN Configurati...

Page 111: ...FC CNA HBA CLI lists the disks on the selected adapter port and shows the current configuration of each Select the number for the disk you want to configure and then 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 confi...

Page 112: ...the Boot Device Settings menu for adapter instance m You can choose to Display Boot Device s Configure Boot Device s Boot Device s Per Adapter Port 8 Boot Device n Port Number 1 Display Boot Device s When you select this option SANsurfer FC CNA HBA CLI shows the following information about the boot devices for this adapter instance Adapter Instance Number Adapter Model Number QLAxxxx Port Number o...

Page 113: ...r 2 Configure Boot Device s When you select this option SANsurfer FC CNA HBA CLI shows the Boot Device Settings menu for adapter instance m including the adapter model number and details about its specifications You can choose to configure the following Primary Boot Device Alternate 1 Boot Device Alternate 2 Boot Device Alternate 3 Boot Device Boot Device Settings 8 Boot Device n Port Number 2 Con...

Page 114: ...t 1 Save Configuration When you select this option the CLI shows the Save Configuration menu Proceed Cancel Boot Device s All HBAs 8 Boot Device 1 All HBAs When you select this option SANsurfer FC CNA HBA CLI shows information about all boot devices for all adapters For details see Boot Device s Per Adapter Port on page 3 60 Product vendor Product ID Product revision Driver Settings Menu Command L...

Page 115: ...t s Only option available for all drivers Present targets with driver default option available for failover driver only Bind by World Wide Port Name option available for all drivers except Macintosh driver Bind by Port ID option available for all drivers except Macintosh driver Commit Changes NOTE If you select a QLA22xx adapter all QLA22xx adapters on the host will use the same settings If you se...

Page 116: ... see page 3 66 HBA Parameters Templates see page 3 66 Update Driver Windows only see page 3 69 Update Firmware Preload Table 8Gb adapters only see page 3 69 Save Firmware Preload Table 8Gb adapters only see page 3 70 Update MPI Config Table see page 3 71 Save MPI Config Table see page 3 71 Driver Rescan Solaris with QLA driver only see page 3 72 Firmware Area Update 8Gb adapters only see page 3 72...

Page 117: ...Updating Adapter flash NIC Boot Code Updating Adapter flash NIC MPI FW Updating Adapter flash FC Boot Code FW Updating Adapter flash uncompressed FW Updating Adapter flash FC VPD Updating Adapter flash NIC VPD Flash update complete Changes have been saved to both ports of this HBA Save Flash Per Adapter Port Command Line Option b and Reserved Word save 10 Utilities 2 Save Flash When you select thi...

Page 118: ... HBA Parameters When you select the Save HBA Parameters option SANsurfer FC CNA HBA CLI prompts you to select an adapter You then enter a file name to save the parameters for that adapter HBA Parameters Template Per Adapter or All HBAs Command Line Option n and OEM Name 10 Utilities 5 HBA Parameters Template Use templates to set OEM specific storage qualified adapter parameters to a pre determined...

Page 119: ...ed adapters by ISP number NOTE Settings that are effected by the template apply only to the ISP 2300 2310 2312 2Gb adapters and the ISP2422 2432 4Gb adapters Table 3 5 Template Supported Parameter Settings for QLA24xx QLE24xx and QLE256x Adapters ISP2422 Setting QLogic EMC HP IBM Sun Execution Throttle 16 256 16 256 256 Descending Loop ID Search 0 0 0 0 0 Maximum LUNs Per Target a a Information no...

Page 120: ...nding Loop ID Search 0 1 0 0 Maximum LUNs Per Target 128 256 0 8 Port Down Retry Count 30 45 30 30 Link Down Timeout 30 45 30 0 Table 3 8 Template Supported Parameter Settings for QLA23xx Adapters ISP2312 Setting QLogic EMC HP HPQ IBM Sun Execution Throttle 16 256 16 16 256 16 Descending Loop ID Search 0 1 0 0 0 0 Maximum LUNs Per Target 128 256 128 128 256 8 Port Down Retry Count 30 45 16 16 30 3...

Page 121: ...nd then enter a file name INF ZIP or EXE with which to update the driver for that port Update Firmware Preload Table 10 Utilities n Update Firmware Preload Table The preload table is basically a list of register addresses and data values The only flexibility is provided by means of flags that indicate which function and for what type of reset the entry applies The ROM code simply walks the list an...

Page 122: ...le Warning Please update the HBA flash region with extreme care Incorrectly updating the flash region may render the HBA inoperable Do you want to proceed with the operation 1 Yes 2 No Enter Selection 1 Enter a file name or Hit RETURN to abort QLE2562_fwp dat Save Firmware Preload Table 10 Utilities n Save Firmware Preload Table The Save Firmware Preload Table option is supported only for 8Gb adap...

Page 123: ...firmware When you select this option from the Utilities menu SANsurfer FC CNA HBA CLI prompts you to select either an 8Gb adapter port QLx81xx or All HBAs to update The CLI displays the current version of the MPI config table for the adapter for example MPI Config Table CNA Current Version v1 0 The CLI then warns you of the danger inherent in updating the table and prompts you twice to confirm the...

Page 124: ...re Area Update The Firmware Area Update operation takes a firmware preload table dat file and writes the data to the Flash on the card This option is visible only if you have selected an 8Gb adapter To update the firmware area 1 On the Utilities menu select the number for the Firmware Area Update option The following menu is shown for example Firmware Area Update Menu HBA Model QLE2562 1 Port 1 WW...

Page 125: ...E A companion file with DEF file extension must be present to insure that file comparision during DVT testing will pass Revision History REV DATE WHO ER DESCRIPTION OF CHANGE a 08 24 07 kd xxxxx Initial Document b 08 31 07 kc xxxxx Fix entries for Gen2 ZCNT and Gen1 TLTH c 09 20 07 kc xxxxx Add Version field Init Version 1 Set default number of MSI X vectors to 2 Add disabled entry for Extended MS...

Page 126: ... menu select the number for the Firmware Area Save option The following menu is shown for example Firmware Area Save Menu HBA Model QLE2562 1 Port 1 WWPN 21 00 00 1B 32 16 18 EE Loop Down 2 Port 2 WWPN 21 01 00 1B 32 36 18 EE Online HBA Model QLE8000 Port 1 WWPN 21 00 00 1B 32 0A A9 B4 Link Down FCoE Engine Port 2 WWPN 21 01 00 1B 32 2A A9 B4 Link Down HBA Model QLE220 Port 1 WWPN 21 00 00 E0 8B 9...

Page 127: ...n 1 Locate HBA When you select this option SANsurfer FC CNA HBA CLI shows the HBA Beacon Menu that lists all adapter ports Select any port and then press ENTER to toggle the Beacon LED for that port Locate Target s Target Beacon Command Line Option tb 11 Beacon 2 Locate Target s When you select this option SANsurfer FC CNA HBA CLI shows the Target Beacon Menu that lists all adapter ports Select an...

Page 128: ... On Active Beacon Selected Target s 11 Beacon 2 Locate Target s 3 Beacon Selected Target s When you select the Beacon Selected Target s option SANsurfer FC CNA HBA CLI shows a list of the targets associated with the adapter You can select any target to toggle the Beacon LED for that target Diagnostics Menu Command Line Options kl kr and dm 12 Diagnostics The Diagnostics menu provides end to end di...

Page 129: ... 4Gb and 8Gb only Test Results Test results for loopback and read write buffer tests may include the following Loopback test results Test Status CRC Error Disparity Error Frame Length Error Read Write buffer test results Loop ID Status Data Miscompare Link Failure Loss of Sync Loss of Signal Invalid CRC Diagnostics Loopback Test Command Line Option kl 12 Diagnostics n Port Number 1 Loopback Test W...

Page 130: ...opback 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 adapter More specifically the loopback test transmits and receives loopback the specified data and checks for the frame CRC disparity and length errors To prepare for a loopback test 1 In interactive mode type the number for the Configu...

Page 131: ...pback connector do the following a Disconnect the cable from the appropriate adapter connector b Install the loopback connector on the adapter connector 4 Follow the steps in either Start Diagnostic Test Loopback on page 3 82 interactive mode or kl Loopback Test on page 4 20 non interactive mode After completing the loopback test follow these steps to prepare for normal adapter operations To prepa...

Page 132: ...estored immediately Restoring default settings done Configure Test Parameters Loopback 12 Diagnostics n Port Number 1 Loopback Test 3 Configure Test Parameters Select the Configure Test Parameters option to set the parameters for the loopback test For example Diagnostic Menu Loopback HBA Instance 2 QLE2562 Port 1 Online WWPN 21 00 00 1B 32 1B 4E 4C Desc QLE2562 PCI Express to 8Gb FC Dual Channel 1...

Page 133: ...le note 5 LoopbackType LT 0 1 2 See table note 6 Table Notes 1 DataPattern is the test pattern in hexadecimal format user defined pattern hex or random pat tern Hex Binary 00 00000000 55 01010101 5A 01011010 A5 10100101 AA 10101010 FF 11111111 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 ...

Page 134: ...Desc QLE2562 PCI Express to 8Gb FC Dual Channel 1 10 bit Internal Loopback 2 1 bit Serial Loopback 3 External Loopback Current 4 Return to Previous Menu Start Diagnostic Test Loopback 12 Diagnostics n Port Number 1 Loopback Test 4 Start Diagnostic 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...

Page 135: ...een the adapter port and the target Configure Test Parameters Read Write The read write buffer test must be run on a disk device Before running the read write buffer test verify that the adapter 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...

Page 136: ...Parameters in Step 4 the Diagnostic Menu R W Buffer appears For example 1 Data Pattern 2 Data Size 3 Number of Test s 4 Test Increment s 5 On Error Policy 6 Enable Disable Test Continuously 7 Enable Disable Device s allows you to select or deselect targets and LUNs on which to run diagnostics 8 Return to Previous Menu See Table 3 10 on page 3 81 for a description of the parameters and their values...

Page 137: ...r Ignore Test Continuous OFF Diagnostics Read Write Buffer Test Result Hit ENTER to abort Iter No Data Pattern Status 7219 F8 B8 7D 52 D1 0B 28 A2 Success 7220 Error Data mis compare C5 01 00 1 Expected Data 37 1C 6C B0 B9 CE EE A2 Received Data 00 00 00 F0 00 00 00 00 9999 A6 EE 1C B0 04 8A 65 BF Success Diagnostics Transceiver Details DMI Command Line Option dm 12 Diagnostics n Port Number 3 Tra...

Page 138: ...ed Yes Temperature Voltage Tx Bias Tx Power Rx Power C V mA mW mW Value 35 84 3 33 8 04 0 5835 0 6172 Status Normal Normal Normal Normal Normal High Alarm 78 00 3 70 11 80 0 8318 1 0000 High Warning 73 00 3 60 10 80 0 7079 0 7943 Low Warning 239 00 3 00 5 00 0 3162 0 0158 Low Alarm 244 00 2 90 4 00 0 2512 0 0100 Transceiver Details Details Select the Details option on the Transceiver Details menu ...

Page 139: ... Signal Loss as defined in SFP MSA 0x1 Signal Loss inverted from SFP MSA 0x0 TX_FAULT signal implemented 0x1 TX_DISABLE implemented disables serial o p 0x1 RATE_SELECT implemented 0x0 BR max 0x00 BR min 0x00 Vendor SN UDL0019 Date code 090220 Diag Monitoring Type Address change required 0x0 Power Measurement 0x1 Externally Calibrated 0x0 Internally Calibrated 0x1 Digital diag monitoring 0x1 Legacy...

Page 140: ... Low Alarm 0x09d0 TX Signal Power High Warning 0x1ba7 TX Signal Power Low Warning 0x0c5a RX Signal Power High Alarm 0x2710 RX Signal Power Low Alarm 0x0064 RX Signal Power High Warning 0x1f07 RX Signal Power Low Warning 0x009e Rx_PWR 4 0x00000000 Rx_PWR 3 0x00000000 Rx_PWR 2 0x00000000 Rx_PWR 1 0x3f800000 Rx_PWR 0 0x00000000 Tx_I Slope 0x0100 Tx_I Offset 0x0000 Tx_PWR Slope 0x0100 Tx_PWR Offset 0x...

Page 141: ...igh 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 Reserved Warning 0x0 Reserved Warning 0x0 Reserved Warning 0x0 Reserved Warning 0x0 RX Power Low Warning 0x0 RX Power High Warning 0x0 Vendor Spec...

Page 142: ...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 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 A...

Page 143: ...stics 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 3 11 shows the values for the adapter port statistics options Current Settings 13 Statistics 1 HBA Statistics 1 Configuration 1 Current Settings The system shows the current settings for AutoPoll AP SetRate SR LogToFile LF Restore Defaults 13 Statistics 1 HBA Statistics 1 Confi...

Page 144: ...eration value and returns the following message Manual Poll updated 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 then press ENTER The system updates the sampling rate and returns a message Sampling rate updated Log ...

Page 145: ...elect an adapter port Type the number for the port and then press ENTER The adapter 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 R r 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 Link...

Page 146: ... Status 1 Configuration 1 Current Settings Select the Current Settings option to have the system show the current link status settings for AutoPoll AP SetRate SR LogToFile LF 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 Table 3 12 Statistics Link Status Opt...

Page 147: ... iteration value and returns the following message Manual Poll updated Set Rate 13 Statistics 2 Link Status 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 through 30 and then press ENTER The system updates the sampling rate and returns a message Sampling rate updated...

Page 148: ...e Statistics Menu appears Type the number for the Link Status option and then press ENTER 3 The Link Status Menu appears Type the number for the Show Link Status option and then press ENTER 4 You are prompted to select an adapter port Type the number for the port and then press ENTER The adapter link status for that port appears Link Status The following keys are in use during test R r Reset Curre...

Page 149: ...IV capable Windows driver with QLogic s SANsurfer FC CNA HBA CLI to create delete and manage virtual ports You can deploy and migrate virtual ports in conjunction with virtual machines VMs in your Solaris and Windows Virtual Server environment using Microsoft System Center Virtual Machine CLI 2007 For more information about QLogic and Microsoft solutions see the following documents HBA Virtualizat...

Page 150: ...te that this feature is supported only with an NPIV enabled driver Virtual Menu for Adapter Instance 14 Virtual 1 Virtual Menu When you select this option the Virtual Port Menu appears with the following options List Virtual Ports Delete a Virtual port Create a Virtual port Enter the number for the option you want and then press ENTER With a virtual adapter the following SANsurfer FC CNA HBA CLI f...

Page 151: ... 3 List Virtual Ports When you select this option the menu of virtual ports on this physical adapter port appears showing List Virtual Ports including for each Instance Number Virtual Port Number WWPN Status Online or Loop Down Here is an example Virtual Menu HBA Model QLA2462 0 vPort 3 WWPN 21 7B 00 E0 8B 14 5A CF Online 1 vPort 2 WWPN 21 67 00 E0 8B 14 5A CF Online 4 Return to Previous Menu Dele...

Page 152: ...enu Auto Generate 14 Virtual 1 Virtual Menu 3 Create a Virtual Port 1 Auto Generate When you select this option the system creates a virtual port on this adapter s physical port and reports the WWPN of the virtual port For example Virtual Port 21 25 00 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 User Gener...

Page 153: ...al ports by either setting priorities or allocating bandwidth SANsurfer FC CNA HBA CLI provides an easy to use interface that lets you assign QoS to virtual ports by either setting priorities or allocating bandwidth to them Setting the QoS by bandwidth lets you allocate up to 80 of the number of gigabits per second Gbps transmission speed of the physical port s capacity to its defined virtual port...

Page 154: ...odel QMH2562 1 Port 1 WWPN 50 06 0B 00 00 C2 AE 00 Online 2 Port 2 WWPN 50 06 0B 00 00 C2 AE 02 Online 3 Return to Previous Menu Note 0 to return to Main Menu Enter Selection 1 Select one of the online physical ports for this adapter and then press ENTER to open the QoS Type Menu for that adapter port This menu prompts you to select one of the following as the quality of service type where the cur...

Page 155: ...er or not that virtual port is currently Enabled and Unlocked and then press ENTER 2 If the virtual port is already enabled and unlocked proceed to Step 3 Otherwise a The virtual port must be Enabled to set the priority To enable a currently disabled vPort enter 1 for the Enable Disable QoS Settings option and then 1 again to Enable the vPort b The virtual port must be Unlocked to set the priority...

Page 156: ...two different types of bandwidth for virtual ports Bandwidth Speed specifies that the maximum bandwidth speed of all virtual ports cannot exceed the maximum actual connection speed For details see QoS Bandwidth Speed Menu on page 3 105 Bandwidth Percentage specifies that the maximum bandwidth percentage of all virtual ports cannot exceed 100 For details see QoS Bandwidth Percentage Menu on page 3 ...

Page 157: ...bps is reserved to handle non QoS applications or VMs QoS Bandwidth Speed Menu 15 QoS n Port number 2 QoS Bandwidth 1 Bandwidth Speed The QoS Bandwidth Speed Menu lists all virtual ports for the selected adapter physical port To set the bandwidth speed for a virtual port 1 From the QoS Bandwidth Speed Menu type the number corresponding to the virtual port that you want to change Take note of wheth...

Page 158: ...select either 1 for Mbps or 2 for Gbps 5 The Enter Bandwidth Speed prompt shows the allowable range and current speed in square brackets Type a new speed value and then press ENTER The QoS Bandwidth Speed Menu reappears and lists all the virtual ports 6 Verify that the bandwidth speed is correct for the virtual port that you changed 7 Optional To prevent further changes to the virtual port set the...

Page 159: ... vPort enter 2 for the Lock Unlock QoS Settings option and then 2 again to Unlock the vPort 3 On the QoS Bandwidth Percentage Menu select the Modify QoS Settings option 4 The Enter Bandwidth Percentage prompt shows the allowable range and current percentage in square brackets Enter a new percentage value and then press ENTER The QoS Bandwidth Percentage Menu reappears and lists all the virtual por...

Page 160: ... FC services such as WWNs zoning and LUN masking The FCoE menu is available only for the QLE80xx QLE81xx and QMI81xx adapters When you select FCoE from the main menu SANsurfer FC CNA HBA CLI displays a submenu that varies depending on whether the installed adapter is a QLE80xx FCoE adapter or a QLx81xx converged network adapter Refer to the appropriate section for your adapter type FCoE Utilities ...

Page 161: ...ce Stats Select the Network Interface Stats option to show network statistics link NSL port statistics for one of the available port numbers The following example shows the output of that option NSL Port Statistics Details Port 0 NSL Port Statistics Number of Transmitted Packets 64 bytes 0 Number of Transmitted Packets 64 bytes 0 Number of Transmitted Packets 127 bytes 0 Number of Transmitted Pack...

Page 162: ...ved Unicast Packets 0 Number of Received Multicast Packets 0 Number of Received Broadcast Packets 0 Number of Received Packets with VLAN tag 0 Number of Received Oversized Packets with Good CRC 0 Number of Received Oversized Packets 0 Number of Received Packets Discarded by the MAC 0 Number of Received Undersized Packets with Good CRC 0 Number of Received Undersized Packets with Bad CRC 0 Number o...

Page 163: ... option to show information similar to the following example LogID 9 LogName DCX 000 00 00 00 250 dcx_initialize DCX enabled and initialized FCoE Utilities Menu for QLx81xx Adapters Command Line Option cna The FCoE Utilities menu for the QLE81xx and QMI81xx converged network adapters first prompts you to select an FCoE port for example FCoE Utilities Menu HBA Model QLE8142 1 Port 1 WWPN 21 00 00 C...

Page 164: ...dapter is displayed as shown in the following example HBA Instance 0 QLE8142 Port 1 WWPN 21 00 00 C0 DD 12 0D ED PortID C5 02 20 General Info VN Port MAC Address 0E FC 00 C5 02 20 VLAN ID 1002 Max Frame Size 2500 Baby Jumbo Addressing Mode FPMA Data Center Bridging 16 FCoE 2 Data Center Bridging When you select the Data Center Bridging option from the FCoE Utilities Menu for QLE81xx QMI81xx adapte...

Page 165: ...smitter sends data at a higher rate than the receiver In such situations the receiver sends a PAUSE frame to the transmitter and the transmitter suspends transmission for the specified time Standard applies to all the frames Standard pause is enabled by default on the server facing Ethernet ports as well as the network facing Ethernet ports This setting affects the connection only when connected t...

Page 166: ...d to a DCBX enabled peer or before receiving a port CoS value the port CoS TLV is based on this parameter setting Priority Txt Mode Specifies the priority mode for data transfer as one of the following Strict disables the other bandwidth settings When other settings are disabled the switch negotiates the port bandwidth according to settings configured on that switch Bandwidth specifies that a perc...

Page 167: ...he current Sampling Rate in seconds To change the sampling rate enter a numeric value between 5 and 30 Set Details 16 FCoE 3 DCE Statistics 4 Set Details Select the Set Details option to view the current DCE Statistics Details To change the detail setting from the current setting to one of the other two options select that option and then press ENTER The example below indicates that Absolute is th...

Page 168: ...8 Receive Packets 7038642 Receive Packets Ok 1447366 Receive Broadcast Packets 157285 Receive Multicast Packets 1105617 Receive Unicast Packets 184464 Receive Undersize Packets 0 Receive Oversize Packets 0 Receive Jabber Packets 0 Receive Undersize FCS Error Packets 0 Receive Control Packets 18 Receive Pause Packets 0 Receive Packets 64Octets 307157 Receive Packets 65to127Octets 3811507 Receive Pa...

Page 169: ... Priority 0 0 Transmit Packets Priority 1 0 Transmit Packets Priority 2 0 Transmit Packets Priority 3 123851 Transmit Packets Priority 4 0 Transmit Packets Priority 5 0 Transmit Packets Priority 6 0 Transmit Packets Priority 7 0 Receive Packets Discarded Priority 0 0 Receive Packets Discarded Priority 1 0 Receive Packets Discarded Priority 2 0 Receive Packets Discarded Priority 3 0 Receive Packets...

Page 170: ...ameters Details for CNA Instance 0 QLE8142 Fri May 01 14 27 08 2009 DCBX TLV Type Length Value Data DCBX Parameter Type and Length DCBX Parameter Length 13 DCBX Parameter Type 2 DCBX Parameter Information Parameter Type Current Pad Byte Present Yes DCBX Parameter Valid Yes Reserved 0 DCBX Parameter Data Priority Group ID of Priority 1 0 Priority Group ID of Priority 0 0 Priority Group ID of Priori...

Page 171: ...lid Yes Reserved 0 DCBX Parameter Data Priority Group ID of Priority 1 0 Priority Group ID of Priority 0 0 Priority Group ID of Priority 3 1 Priority Group ID of Priority 2 0 Priority Group ID of Priority 5 0 Priority Group ID of Priority 4 0 Priority Group ID of Priority 7 0 Priority Group ID of Priority 6 0 Priority Group 0 Percentage 50 Priority Group 1 Percentage 50 Priority Group 2 Percentage...

Page 172: ...select the Raw option TLV data appears such as in the following example DCBX Parameters Raw Data for CNA Instance 0 QLE8142 Fri May 01 14 27 10 2009 DCBX TLV Type Length Value Data 0D 04 0E 00 00 01 00 00 32 32 00 00 00 00 00 00 02 00 0D 00 00 01 00 00 32 32 00 00 00 00 00 00 02 00 0C 00 00 01 00 00 32 32 00 00 00 00 00 00 02 00 02 06 0A 00 08 08 09 00 08 08 08 00 08 01 Help Menu Command Line Opti...

Page 173: ...see the help menu options rearranged into alphabetical order in Appendix D Exit Codes 14 or 15 Help 2 Exit Codes When you select the Exit Codes option SANsurfer FC CNA HBA CLI shows the entire list of exit codes You can see the exit codes in Appendix C About 14 or 15 Help 3 About When you select the About option SANsurfer FC CNA HBA CLI shows the following information about this tool Product name ...

Page 174: ...3 Interactive Commands Help Menu Command Line Option h 3 122 SN0054614 00 K Notes ...

Page 175: ...and Summary on page 4 5 Display System Information Command Line Options g z and tp When you enter one of these options general information appears in various formats For example scli g shows the host information see Host Information Command Line Option g on page 4 1 scli z shows the host configuration see Host Configuration Command Line Option z on page 4 2 scli tp shows the host topology see Host...

Page 176: ...Command Line Option g on page 4 1 as well as the following additional information HBA General information HBA Vital Product Data VPD HBA Parameter Settings Driver Settings Information Group Persistent Group Binding Devices LUNs Information Selective LUNs Information Boot Device Settings To show the information for a single adapter type the following command scli z hba instance hba wwpn Where To sh...

Page 177: ...ditional information Interconnect Element switch or adapter Type switch or adapter World wide name Domain ID Management ID IP address Model Symbolic name Serial number MAC address Firmware version Port count Beacon status Interconnect element adapter Type World wide node name World wide port name Vendor ID HBA Model Adapter Serial Number Adapter Alias Port Alias Driver Version Firmware Version Tot...

Page 178: ...ter model if applicable Adapter serial number if applicable Adapter alias if applicable Port alias if applicable Driver version Firmware version Total number of devices if applicable Host if applicable Host Configuration Use these options to show the information for one or all of the adapter ports in the system The z option shows the combination of the commands listed in Table 4 1 The commands are...

Page 179: ...s in XML format see x Output in XML Format 1 on page 4 48 For example scli i all x o output xml g Show system information g Display System Information on page 4 18 i Show adapter information i Display HBA General Information or VPD Information for One or All HBAs on page 4 20 l Show LUN list l Display LUN Info on page 4 32 m Configure selective LUNs m View Enable or Disable LUNs on page 4 33 p Con...

Page 180: ...atus Use the a command to either view 1 or change 2 the status of a beacon Table 4 2 Command Variables Variable Definition Format hba instance Adapter numbera a You can use the g command to find adapter numbers hba wwpn Adapter world wide port name xx xx xx xx xx xx xx xx or xxxxxxxxxxxxxx alias Adapter alias Symbolic adapterb name b You assign the symbolic name It is limited to 100 characters in ...

Page 181: ...I 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 CNA HBA CLI is not in silent mode see s Silent Mode on page 4 45 one of the following messages appears to indicate the LED s current state The LED Flashing for hba instance hba wwpn has been turned ON The LED Flashing for hba instance hba wwpn has been turned OFF The h...

Page 182: ...Use the cna command to work with converged network adapters QLE81xx and QMI81xx all All adapters of the same type in the system are updated with the new BIOS FCode hba instance Adapter number use g command to find hba wwpn World wide port name rg Flash region update mode 4GB adapters onlya a Region update only supported on QLA QLE QMC246x adapters all Update all regions BIOS FCode EFI depending on...

Page 183: ...command scli cna hba instance hba wwpn savecfg mpi file To view DCBX Type Length Value TLV data sent and received over the adapter port connection issue the following command scli cna hba instance hba wwpn tlv detail raw To view data center Ethernet DCE network activity information sent and received over the adapter port connection issue the following command scli cna hba instance hba wwpn mon dce...

Page 184: ...rameters Parameter Name Parameter Alias Parameter Value Description AutoPoll AP 0 1 256 Set to auto polling mode Set to manual polling mode iteration SetRate SR 5 30 Set the polling interval rate seconds Details DT 0 2 Set the detailed display mode 0 Absolute 1 Rate per second 2 Baseline file name Absolute or full path name of the setup INF file or the com pressed driver file in ZIP or EXE format ...

Page 185: ...adapter scli e hba instance hba wwpn 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 adapter s currently selected boot device is shown in the following format hba instance hba wwpn target wwnn target wwpn lun id Solaris shows each adapter s currently selected boot device in the f...

Page 186: ... 00 00 00 00 00 00 00 00 00 00 00 00 00 0 Press Enter to continue To cause the OS to boot from the first target 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 specific target as the boot device for a specific adapter type the following command scli e hba instance hba wwpn target wwnn target wwpn target id lun id SANsur...

Page 187: ... parameter or menu selection the following message appears The HBA 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 target wwnn and lun id inputs to all zeroes For example type scli e hba instance hba wwpn enable 0 0 0 To disable delete the boot device for a specific adapter type scli e hba instance hba wwp...

Page 188: ...om file fcoe Display and Configure FCoE Engine Parameters Use the fcoe commands to view and modify the FCoE engine for QLE8042 and Cisco Unified Computing System UCS converged network adapters Display Commands To show the current FCoE engine firmware version issue the following command scli fcoe hba instance hba wwpn info To show the FCoE engine parameters issue the following command scli fcoe hba...

Page 189: ...rt1 FCoE access port 1 Table 4 4 FCoE Engine Parameters Parameter Name param name Alias param alias Value param value Description PortType AT 0 1 0 Access default 1 Trunk PauseType PT 1 2 1 Standard Pause default 2 Priority Flow Control PriorityPause Mask PM 0 1 7 Specifies the bit location of the pause mask to be set to 1 that is a PriorityPauseMask type of 1 3 4 means that bit 1 3 4 is 1 the res...

Page 190: ...mmands the variables indicate the following fg Show Driver Settings To show the driver settings type scli fg hba instance hba wwpn view Where fs Configure Driver Settings Type the following command to configure the driver settings scli fs hba instance hba wwpn param name param alias param value hba instance Adapter instance number of an adapter port hba wwpn World wide port name of an adapter port...

Page 191: ...port use g command to find hba wwpn World wide port name of the adapter param name Name of the parameters param alias Alias of the parameters param value New value of the parameters Table 4 5 Driver Settings Parameters Description Parameter Name param name Alias param alias Valuea param value a 0 Disabled 1 Enabled Persistently bound target s only PersistentOnly PO 0 1 Present persistently bound t...

Page 192: ... the IOCTL or sysfs inbox driver hba instance Adapter number use g command to find hba wwpn World wide port name of the adapter param name Name of the parameter see table 4 7 param alias Alias of the parameter see table 4 7 param value New value of the parameter see table 4 7 Table 4 6 Adapter Statistics Parameters Description Name Alias Value Sets how often statistics are retrieved AutoPoll AP 0 ...

Page 193: ...wpn target wwpn target portid shows LUN information for a specific target scli l hba no hba wwpn target wwpn target portid lun id shows LUN information for a specific LUN on a specific target ha Set Delete HBA Alias With this command you can view set or delete the alias of a specific adapter To view the alias of a specified adapter type scli ha hba instance hba wwpn view To set an alias for a spec...

Page 194: ...g command scli i all VPD Where To show general or VPD information for a specific adapter type scli I hba instance hba wwpn VPD To show VPD QLA QLE24xx only for all adapter ports in the system type scli i VPD scli i all VPD Where kl Loopback Test Use the kl command to perform the loopback test Use the kr command to perform the read write buffer test see Run a Read Write Buffer Test on page 4 28 To ...

Page 195: ... the data pattern is either DP param value DataPattern param value hba instance Adapter number use g command to find hba wwpn World wide port name of the adapter ex or exclude World wide port name of the target device to be excluded from the read write test param name One of the following DataPattern see DataPattern DP on page 4 21 DataSize see DataSize DS on page 4 23 TestCount see TestCount TC o...

Page 196: ... CSPAT for a loopback test For example scli kl hba instance hba wwpn DP CJTPAT Table 4 7 lists all valid data patterns Table 4 7 Data Pattern Values Hexadecimal Binary 00 00000000 55 01010101 5A 01011010 A5 10100101 AA 10101010 FF 11111111 Random Customized 00 FF CRPATa loopback test only a Compliant random data pattern in a valid FC frame as defined by the ANSI document Methodologies for Jitter a...

Page 197: ... 32 64 128 256 512 1024 2048 4096 8192 16384 32768 or 65535 The default value is 512 bytes TestCount TC The test count specifies the number of loopback tests TC param value TestCount param 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 t...

Page 198: ...type parameter specifies the type of loopback tests that you can select from as shown in Table 4 9 Be sure to select the appropriate adapter connector for testing For internal loopback a loopback connector must be plugged in the adapter connector Run a Loopback Test The loopback test sends and receives messages through a loopback or through an echo command to the switch Table 4 8 OnError Values Va...

Page 199: ...s scli kl hba wwpn DP FF DS 8 TC 500 TI 10 OE 1 NOTE The loopback test is disabled if you are using the drivers from the OS installation and not functional on the QLE8042 adapter NOTE Run an echo test instead of a loopback test under the following conditions You have a QLA23xx QLA24xx QLE23xx or QLE24xx adapter that is connected to the fabric through a point to point connection F_Port The adapter ...

Page 200: ...kl hba wwpn DS 16 OE 2 An example of a successful loopback test follows Test Configuration Data Pattern Random Data Size 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 ...

Page 201: ...r Disparity error Frame length error kr Run Read Write Buffer Test Use the kr command to do read write buffer test To run the loopback test use the kl command see kl Loopback Test on page 4 20 To do a read write test using the default parameters type scli kr hba instance hba wwpn To do a read write test with customized parameters type scli kr hba instance hba wwpn EX EXCLUDE target wwpn param name...

Page 202: ...Read Buffer command to read the returned data and do a data comparison hba instance Adapter number use g command to find hba wwpn World wide port name of the adapter ex or exclude World wide port name of the target device that is excluded from the read write test param name One of the following DataPattern see DataPattern DP on page 4 21 DataSize see DataSize DS on page 4 23 TestCount see TestCoun...

Page 203: ...and 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 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 DS 16 OE 2 An example of a successful read write buffer t...

Page 204: ...ption DataPattern DP Test pattern in hex formata Customized 00 FF Random pattern CRPATb CJTPATc CSPATd a Valid two character case insensitive hexadecimal patterns b Compliant 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 00 55 5A A5 AA FF see Table 4 12 Loopback test only Loopback te...

Page 205: ...upported Write buffer failed c Compliant jitter tolerance pattern in a FC frame as defined by the ASIC document listed above d Compliant supply noise test sequence in a valid FC frame as defined by the ASIC document listed above e 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 Wind...

Page 206: ...e hba wwpn To show the LUN information for a specific device for a specific adapter port type scli l hba instance hba wwpn target port id target wwpn To show the LUN information for a specific LUN on a specific target device for a specific adapter port instance type scli l hba instance hba wwpn target port id target wwpn lun id Where ls Display Link Status To view the link status type scli ls hba ...

Page 207: ...ed 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 Sets link status retrieval polling interval PollRate SR 5 30 seconds Save link status to CVS log file LogToFile LF Log file name Table Notes NOTE If the current driver setting is Bind by Port ID this option is not av...

Page 208: ...ective LUN list type scli m hba instance hba wwpn 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 CNA HBA CLI shows the adapter s enabled LUN list in the following format target wwnn target wwpn lun id To view the current select state of a specific LUN type scli m hba instance hba wwpn ta...

Page 209: ...pecific adapter scli m hba instance hba wwpn select all To disable deselect all LUNs of all targets on a specific adapter scli m hba instance hba wwpn deselect all n Set Selected HBA Parameter To set a specific parameter on a specific adapter type scli n hba instance hba wwpn param name param alias param value To restore the default BIOS 4G adapters only type scli n hba instance hba wwpn default W...

Page 210: ...1 Enable 0 Disable 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 Frame size FrameSize FR 512 1024 2048 Hard loop...

Page 211: ... c EnableBIOS option not available on 4Gb adapter d EnableExtendedLogging option not available on PPC64 or SPARC e Operation mode QLA QLE23xx QLA QLE24xx and 8Gb adapters 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 QLA200 210 adapters have a limited set of parameters that can be changed NOT...

Page 212: ...istent binding information for a specific adapter port type scli p hba instance hba wwpn view To show persistent binding information for all adapters type scli p all view Where Windows syslog log in the current directory Linux var log messages Macintosh var log system log Solaris var adm messages NOTE Under Solaris if you use the driver from the OS installation CDs QLC driver these features are di...

Page 213: ... scli p hba instance hba wwpn target wwnn target wwpn target port id target id Where To bind multiple targets with a single command repeat the following group target wwnn target wwpn target port id target id To bind all targets on a specific adapter or to bind all targets on all adapters type scli p hba instance hba wwpn all bind all Where To unbind a specific target type scli p hba instance hba w...

Page 214: ...the specified adapter type scli pa hba instance hba wwpn alias Where To delete a port alias for the specified adapter port type scli pa hba instance hba wwpn delete To view a port alias for the specified adapter port type scli pa hba instance hba wwpn view hba instance Adapter number use g command to find hba wwpn World wide port name of the adapter target wwnn World wide node name of the target h...

Page 215: ...N type scli pl hba instance hba wwpn del target id lun id lun name Where NOTE The pl option is available only on Linux RHEL 5 x systems this option is not supported for SLES 11 CAUTION Do not delete a LUN s persistent device name if there is any active I O on the LUN hba instance Adapter instance number of adapter port hba wwpn World wide port name of the adapter port target id Target ID of the de...

Page 216: ...d enter the following command scli q hba instance hba wwpn all targets t speed Where NOTE The q option is supported only on 4GB adapters hba instance Adapter number use g command to find hba wwpn World wide port name of the adapter all Reports link speed for all targets on all adapters in the system targets All targets t All targets hba instance Adapter number use g command to find hba wwpn World ...

Page 217: ...ttings for a specific virtual port on a physical adapter port enter the following command scli qos hba instance hba wwpn info vp vport wwpn To change QoS settings for specified virtual ports enter the following command scli qos hba instance hba wwpn vp vport wwpn pri priority bwspd speed bwper percent lock lock value enable enable value Where hba instance Adapter number use g command to find hba w...

Page 218: ...peed to assign to the virtual port speed Value of bandwidth speed bwper Bandwidth percentage to assign to the virtual port percent Value of bandwidth percent lock Specify the lock value lock value Lock value 1 for lock or 0 for unlock enable Specify whether the virtual port is enabled enable value Enable value 1 for enable or 0 for disable hba instance Adapter number use g command to find hba wwpn...

Page 219: ...specific adapter type scli t hba instance hba wwpn To show specific target information for a specific target on an adapter type scli t hba instance hba wwpn target wwpn target port id Where To show the target information on all adapters type t all To show the target information on a specific adapter type t hba instance hba wwpn NOTE The s option is valid only in non interactive mode You can use th...

Page 220: ...n 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 Host Topology Command Line Option tp on page 4 3 covers this command u Firmware Area Update Save Use the u option to update the firmware preload area of the adapter from a DAT file or to save the current firmware preload area of the adapter to a DA...

Page 221: ...he following information SANsurfer FC CNA HBA CLI v1 x x Build x Copyright 2003 2009 QLogic Corp All rights reserved Command Line QLogic FC Host Bus Adapters Build Type Release Build Date xx xx xxxx xx xx xx AM vp Virtual Port To list all virtual ports on a physical adapter port type scli vp hba instance hba wwpn list all Where To list a specific virtual port on a physical adapter port type NOTE T...

Page 222: ... instance hba wwpn delete vport wwpn x Output in XML Format 1 You can use this option with all non interactive mode options that have a corresponding interactive mode option see Table 4 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 1 a legacy format These formats are described in Appendix A...

Page 223: ...mats are described in Appendix B This option is usually combined with the o option see o Output to a File on page 4 37 to create a text file with XML output so that it can be parsed by an XML compliant utility For example to show adapter general information and output it to an XML file named output xml scli i all x2 o output xml z Display All HBA information for One or All HBAs To show all informa...

Page 224: ...4 Non Interactive Commands Command Summary 4 50 SN0054614 00 K Notes ...

Page 225: ... Tag When SANsurfer FC CNA HBA CLI is in XML mode all outputs are within the main tag QLogic QLogic Utility Header The following header information is shown after the main tag AppName SANsurfer Command Line Utility AppName AppVersion X YY ZZ Build XX AppVersion NOTE XML files created using the x1 command line option do not match standard output They are designed for backward compatibility with cus...

Page 226: ...n 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 shown 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 shown Reboot 0 Reboot Error Message Before the closing main tag QLogic but following the Status...

Page 227: ...11 Link Statistics Command Line Option ls on page A 14 HBA Statistics Command Line Option gs on page A 14 HBA Alias Command Line Option ha on page A 15 HBA Port Alias Command Line Option pa on page A 15 Display FCoE Information on page A 22 Display FCoE Parameters on page A 23 Display FCoE Link Events on page A 23 Display FCoE DCBX on page A 25 Display FCoE Network Interface Statistics on page A 2...

Page 228: ...A CLI AppName AppVersion vn nn nn Build nn AppVersion HBA HBA Port value WWNN value WWPN value Param ConnectionOption value DataRate value FrameSize value HardLoopID value LoopResetDelay value EnableHostAdapterBIOS value EnableHardLoopId value FibreChannelTapeSupport value OperationMode value IntDelayTimer value ExecutionThrottle value EnableExtendedLogging value LoginRetryCount value EnableLipRes...

Page 229: ...eneralInfo Port value Model value HBAID value HBAAlias value HBAPort value PortAlias value WWNN value WWPN value PortID value SerialNumber value DriverVersion value BIOSVersion value FirmwareVersion value TargetCount value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value PortType value Status value HBA Status 0 Status Reboot 0 Reboot QLogic Here is the information for t...

Page 230: ...Count value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value PortType value Status value HBA Status 0 Status Reboot 0 Reboot QLogic Here is the VPD information xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build n nn AppVersion HBA HBA Port value WWNN value WWPN value VPD VPDProductIdentifier value VPD RTAG PartN...

Page 231: ... Target WWPN WWPN Info Path value ID value Vendor value ProductID value Revision value SerialNumber value DeviceID value PortID value LunCount value Type value DeviceStatus value Target HBA Status 0 Status Reboot 0 Reboot QLogic The Target Target sequence is repeated for each adapter target Display LUN List Command Line Option l The XML Format 1 for the adapter LUN list information is as follows x...

Page 232: ...at 1 for the adapter target persistent binding information is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build nn AppVersion HBA HBA Port value WWNN value WWPN value TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value HBA Status 0 Status Reboot 0 Reboot QLogic The TargetBinding sequence is repeate...

Page 233: ...ormation is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build nn AppVersion HBA HBA Port value WWNN value WWPN value BootDevice TargetWWPN value LUNID value HBA Status 0 Status Reboot 0 Reboot QLogic The BootDevice sequence is repeated for each boot device of the adapter In Windows and Linux the TargetID value field is not pres...

Page 234: ...lue WWPN value Target WWNN Target WWNN WWNN WWPN Target WWPN WWPN Loop ID value DataMiscompare value LinkFailure value LossOfSync value LossOfSignal value InvalidCRC value Result value Target HBA Status 0 Status Reboot 0 Reboot QLogic The Target sequence is repeated for each device attached to the adapter View Driver Settings Command Line Option fg The XML Format 1 for the current driver settings ...

Page 235: ...s as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build nn AppVersion Table A 1 Options Shown by z Non interactive Option Description See Section g Show system information General Information Menu Command Line Option g on page 3 4 i Show adapter information HBA Information Menu Command Line Option i on page 3 19 c Show adapter sett...

Page 236: ...as value WWNN value WWPN value PortID value SerialNumber value DriverVersion value BIOSVersion value FirmwareVersion value TargetCount value PCIBus value PCIDevice value ActualConnectionMode value ActualDataRate value PortType value Status value VPD VPD Product Identifier VPD Param ConnectionOption value DataRate value FrameSize value HardLoopID value LoopResetDelay value EnableHostAdapterBIOS val...

Page 237: ...lue PortID value LunCount value Type value DeviceStatus value LUN ID value WWULN value Vendor value Product value Revision value Size value Type value EnabledLUN ID value LUNWWNN value LUNWWPN value Target TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value BootDevice TargetWWNN value TargetWWPN value LUNID value DriverSettings Info PersistentPlusNew value PersistentO...

Page 238: ...gic HBA Statistics Command Line Option gs The XML Format 1 for the adapter statistics option is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build nn AppVersion HBA HBA Port value WWPN value WWNN value Statistics LoopID value PortError value NOTE The HBA HBA sequence is repeated for each adapter The Target Target sequence is rep...

Page 239: ...SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build nn AppVersion HBA HBA Port value WWNN value WWPN value HBAAlias Alias Name value HBAAlias HBA Status 0 Status Reboot 0 Reboot QLogic HBA Port Alias Command Line Option pa The XML Format 1 for the adapter port alias option is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn B...

Page 240: ...sion SerialNumber value SerialNumber MediaInformation Diagnostics Temperature MeasuredTemperature C MeasuredTemperature Value value Value Status value Status HighAlarm value HighAlarm HighWarning value HighWarning LowWarning value LowWarning LowAlarm value LowAlarm Temperature Voltage MeasuredVoltage Vdc MeasuredVoltage Value value Value Status value Status HighAlarm value HighAlarm HighWarning va...

Page 241: ...ormat 1 for adapter transceiver details detailed information is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build nn AppVersion HBA HBA Port value WWNN value WWPN value OpticalTransceiverDigitalDiagnosticData OpticalTransceiverDigit alDiagnosticData Address_A0 Identifier value Identifier Ext Identifier value Ext Identifier Conn...

Page 242: ...x BR Min value BR Min VendorSN value VendorSN DateCode value DateCode DiagMonitoringType AddressChangeRequired value AddressChangeRequired PowerMeasurement value PowerMeasurement ExternallyCalibrated value ExternallyCalibrated InternallyCalibrated value InternallyCalibrated DigitalDiagMonitoring value DigitalDiagMonitoring LegacyDiagnostic value LegacyDiagnostic DiagMonitoringType EnhancedOptions ...

Page 243: ...ue RXPowerHighWarning RXPowerLowWarning value RXPowerLowWarning Rx_PWR 4 value Rx_PWR 4 Rx_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 Tx_I_Slope value Tx_I_Slope Tx_I_Offset value Tx_I_Offset Tx_PWR_Offset value Tx_PWR_Offset T_Slope value T_Slope T_Offset value T_Offset V_Slope value V_Slope V_Offset value V_Offset Checksum value Checksum Temperat...

Page 244: ...arning value TXBiasLowWarning TXBiasHighWarning value TXBiasHighWarning VccLowWarning value VccLowWarning VccHighWarning value VccHighWarning TempLowWarning value TempLowWarning TempHighWarning value TempHighWarning ReservedWarning value ReservedWarning ReservedWarning value ReservedWarning ReservedWarning value ReservedWarning ReservedWarning value ReservedWarning ReservedWarning value ReservedWa...

Page 245: ...omainID value ManagementID value IPAddress value Model value SymbolicName value SerialNumber value MACAddress value FirmwareVersion value PortCount value BeaconStatus value PhysicalPortInformation PhysicalPort Number value Port WWPN value State value Type value TXPortType value ModuleType value AttachedPort Type Initiator HBA NodeName value PortName value VendorId value Model value SerialNumber va...

Page 246: ...e TXPortType value ModuleType value AttachedPort Type Target Target NodeName value PortName value VendorId value ProductId value ProductRevision value ProductSerialNumber value AttachedPort AttachedPort Type Target Target NodeName value PortName value VendorId value ProductId value ProductRevision value ProductSerialNumber value AttachedPort PhysicalPort PhysicalPortInformation InterConnectElement...

Page 247: ...encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA HBA Port 3 WWNN 20 00 00 E0 8B 80 5F 0F WWPN 21 00 00 E0 8B 80 5F 0F Menlo Parameters PortSelection 0 PortType Access PauseType Prioriry Flow Control PriorityPauseMask 0xcc PriorityPauseBitMask 0 1 2 x 3 x 4 5 6 x 7 x FCoEConfig Pre T11 Frame Format FCoECOS 5 Menlo HBA Status 0 Status Reboot 0 Re...

Page 248: ...00 02 03 120 Host fibre channel port 0 physical link up Entry No 1 Info 000 00 02 03 120 Host fibre channel port 1 physical link up Entry No 2 Info No Data Entry No 3 Info No Data Entry No 4 Info No Data Entry No 5 Info No Data Entry No 6 Info No Data Entry No 7 Info No Data Entry No 8 Info No Data Entry No 9 Info No Data Entry No 10 Info No Data Entry No 11 Info No Data Entry No 12 Info No Data E...

Page 249: ...A CLI AppName AppVersion 1 7 1 23 AppVersion HBA HBA Port 3 WWNN 20 00 00 E0 8B 80 5F 0F WWPN 21 00 00 E0 8B 80 5F 0F xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA FCoELogs LogID ID 9 LogName DCX Entry No 0 Info 000 00 00 00 250 dcx_initialize DCX enabled and initialized Entry No 1 Info No Data Entry No 2 Info No Data Entry N...

Page 250: ...ry No 19 Info No Data FCoELogs HBA Status 0 Status Reboot 0 Reboot QLogic HBA QLogic Display FCoE Network Interface Statistics The XML Format 1 for FCoE network interface statistics output is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA HBA Port 3 WWNN 20 00 00 E0 8B 80 5F 0F WWPN 21 00 00 E0 8B 80 5F 0F NSLPortSt...

Page 251: ...s 0 NumberofTransmittedPacketsLessThanOrEqual1518bytes NumberofTransmittedPacketsLessThanOrEqual2047bytes 0 NumberofTransmittedPacketsLessThanOrEqual2047bytes NumberofTransmittedPacketsLessThanOrEqual4095bytes 0 NumberofTransmittedPacketsLessThanOrEqual4095bytes NumberofTransmittedPacketsLessThanOrEqual8191bytes 0 NumberofTransmittedPacketsLessThanOrEqual8191bytes NumberofTransmittedPacketsLessTha...

Page 252: ...swithVLANtag NumberofTransmitted_802_3x_PauseControlPackets 0 NumberofTransmitted_802_3x_PauseControlPackets NumberofTransmittedPer PriorityPausePackets 0 NumberofTransmittedPer PriorityPausePackets NumberofTransmittedPacketswithError 0 NumberofTransmittedPacketswithError NumberofReceivedPacketsLessThan64bytes 0 NumberofReceivedPacketsLessThan64bytes NumberofReceivedPacketsEqual64bytes 0 NumberofR...

Page 253: ...qual4095bytes 0 NumberofReceivedPacketsLessThanOrEqual4095bytes NumberofReceivedPacketsLessThanOrEqual8191bytes 0 NumberofReceivedPacketsLessThanOrEqual8191bytes NumberofReceivedPacketsLessThanOrEqual9215bytes 0 NumberofReceivedPacketsLessThanOrEqual9215bytes NumberofReceivedPacketsLessThanOrEqual9216bytes 0 NumberofReceivedPacketsLessThanOrEqual9216bytes TotalNumberofReceivedPackets_IncludingThos...

Page 254: ...cketsDiscardedbytheMAC 0 NumberofReceivedPacketsDiscardedbytheMAC NumberofReceivedUndersizedPacketsWithGoodCRC 0 NumberofReceivedUndersizedPacketsWithGoodCRC NumberofReceivedUndersizedPacketsWithBadCRC 0 NumberofReceivedUndersizedPacketsWithBadCRC NumberofReceivedPacketsWithCRCError 0 NumberofReceivedPacketsWithCRCError NumberofReceivedPacketsWithLengthError 0 NumberofReceivedPacketsWithLengthErro...

Page 255: ...A XML Format 1 XML Format 1 Tags for Each Option SN0054614 00 K A 31 NumberofReceivedPer PriorityPausePackets NSLPortStatistics HBA Status 0 Status Reboot 0 Reboot QLogic ...

Page 256: ...A XML Format 1 XML Format 1 Tags for Each Option A 32 SN0054614 00 K Notes ...

Page 257: ...h consists of the following parts Main Tag on page B 1 Utility Header on page B 2 Status Message on page B 2 Reboot Message on page B 2 Error Message on page B 2 Main Tag When SANsurfer FC CNA HBA CLI is in XML2 mode all outputs are between the main tags QLogic QLogic NOTE XML files created using the x2 command line option match standard output They do not match the X1 files see Appendix A which a...

Page 258: ...command line parameters fails the following status is shown followed by an error message that provides additional details Status 1 Status 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 shown Reboot 1 Reboot When the execution of the command line parameters is successful and the s...

Page 259: ...l on page B 11 Diagnostics Results Read Write Buffer Test Command Line Option kr on page B 12 View Driver Settings Command Line Option fg on page B 12 Display All Information for One or All Adapters Command Line Option z on page B 13 Link Statistics Command Line Option ls on page B 16 HBA Statistics Command Line Option gs on page B 17 HBA Alias Command Line Option ha on page B 18 HBA Port Alias Co...

Page 260: ...ion SDMAPIVersion n nn nn nn SDMAPIVersion HBA Instance value HBAModel value HBAPort value WWNN value WWPN value NumOfHBA n NumOfHBA Host Status n Status ErrorMsg message ErrorMsg Reboot n Reboot QLogic The parameter HBA repeats for each adapter in the system Display Adapter Settings Command Line Option c The command format is scli c 0 x2 The XML Format 2 for adapter settings information is as fol...

Page 261: ...h adapter Each parameter is listed on a separate line for clarity however multiple parameters can be on the same line For multiple adapters repeat the preceding sequence with the ID number ID Number value of the next adapter Display HBA Information Command Line Option I The command format is scli i hba instance hba wwpn all x2 Another version of the command shows all information or VPD information...

Page 262: ...L Format 2 for 4G adapters is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn n n Build n AppVersion AppXmlVersion 2 0 AppXmlVersion HBA GeneralInfo Instance value HBAModel value HBAID value HBAAlias HBAPort value PortAlias WWNN value WWPN value PortID value SerialNumber value DriverVersion value BIOSVersion value FirmwareVersion value O...

Page 263: ...rtNumber value SerialNumber value MiscInformation value ManufacturingID value EFIDriverVersion value FirmwareVersion value BIOSVersion value FCodeVersion value VPD HBA Status 0 Status Reboot 0 Reboot QLogic 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 xml version value encoding valu...

Page 264: ...get The HBA HBA sequence repeats for each adapter Display LUN List Command Line Option l The command format is scli l hba instance hba wwpn x2 The XML Format 2 for the adapter LUN list information is as follows xml version value encoding value QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn n nn Build nn AppVersion AppXmlVersion n nn AppXmlVersion HBA HBA Instance value HBAModel valu...

Page 265: ...C CNA HBA CLI AppName AppVersion vn n nn Build nn AppVersion AppXmlVersion n nn AppXmlVersion HBA HBA Instance value HBAModel value HBAPort value WWNN value WWPN value TargetBinding TargetWWNN value TargetWWPN value TargetPortID value TargetID value HBA Status n Status Reboot n Reboot QLogic The HBA HBA sequence repeats for each adapter The Target binding sequence repeats for each bound target Sel...

Page 266: ...rmat for a single adapter is e hba instance hba wwpn view x2 The XML Format 2 for the boot device information is as follows xml version value encoding value QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn n nn Build nn AppVersion AppXmlVersion n nn AppXmlVersion HBA HBA Instance value HBAModel value HBAPort value WWNN value WWPN value BootDeviceInfo BootParam EnableSelectableBoot val...

Page 267: ... AppVersion vn n nn Build nn AppVersion AppXmlVersion n nn AppXmlVersion HBA HBA Instance value HBAModel value HBAPort value WWNN value WWPN value Loop ID value CRCError value DisparityError value FrameLengthError value Result Success HBA NOTE If EnableSelectableBoot is set to 1 in the BootParam EnableSelectable Boot tag it does not appear in the BootDevice TargetWWPN tag BootParam EnableSelectabl...

Page 268: ... nn AppXmlVersion HBA HBA Instance value HBAModel value HBAPort value WWNN value WWPN value Target WWNN Target WWNN WWNN WWPN Target WWPN WWPN Loop ID value DataMiscompare value LinkFailure value LossOfSync value LossOfSignal value InvalidCRC value Result value Target HBA Status n Status Reboot n Reboot QLogic The Target Target sequence repeats for each target View Driver Settings Command Line Opt...

Page 269: ...ll the options in Table B 1 and each option is shown in its standard output format If each option shows its own XML2 output the resulting display would have multiple duplicate tags Table B 1 Options Shown by z Non interactive Option Description See User Guide Section g Show system information Display System Information Command Line Options g z and tp on page 4 1 i Show adapter information i Displa...

Page 270: ...IVersion HBA Instance value HBAModel value HBAPort value WWNN value WWPN value NumOfHBA Number of HBA s detected NumOfHBA Host HBA HBA Instance value HBAModel value HBAPort value WWNN value WWPN value GeneralInfo Instance value HBAModel value HBAID value HBAAlias value HBAPort value PortAlias value WWNN value WWPN value PortID value SerialNumber value DriverVersion value BIOSVersion value Firmware...

Page 271: ...ntDelayTimer value ExecutionThrottle value LoginRetryCount value EnableLipReset value PortDownRetryCount value EnableLipFulllogin value LinkDownTimeout value EnableTargetReset value LUNsPerTarget value Target WWNN Target WWNN WWNN WWPN Target WWPN WWPN Info Path value ID value Vendor value ProductID value Revision value SerialNumber value DeviceID value PortID value LunCount value Type value Devic...

Page 272: ... param name param alias param value x2 The XML Format 2 for the link statistics option is as follows xml version value encoding value QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn n nn Build nn AppVersion AppXmlVersion n nn AppXmlVersion NOTE The HBA HBA sequence repeats for each adapter The DriverSettings sequence repeats for each adapter The VPD Product Identifier sequence repeat...

Page 273: ...d Line Option gs The command format is scli gs hba instance hba wwpn param name param alias param value x2 The XML Format 2 for the adapter statistics option is as follows xml version value encoding value QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn n nn Build nn AppVersion AppXmlVersion n nn AppXmlVersion HBA HBA Instance value HBAModel value HBAPort value WWNN value WWPN value S...

Page 274: ...HBAModel value HBAPort value WWNN value WWPN value HBAAlias AliasName value HBAAlias HBA Status n Status Reboot n Reboot QLogic HBA Port Alias Command Line Option pa The command format is scli pa hba instance hba wwpn view x2 The XML Format 2 for the adapter port alias option is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn nn nn Build...

Page 275: ...umber value SerialNumber MediaInformation Diagnostics Temperature MeasuredTemperature C MeasuredTemperature Value value Value Status value Status HighAlarm value HighAlarm HighWarning value HighWarning LowWarning value LowWarning LowAlarm value LowAlarm Temperature Voltage MeasuredVoltage V MeasuredVoltage Value value Value Status value Status HighAlarm value HighAlarm HighWarning value HighWarnin...

Page 276: ...tatus Reboot 0 Reboot QLogic HBA Transceiver Details Command Line Option dm The XML Format 2 for adapter transceiver details general information is as follows scli dm hba instance hba wwpn all general gen x2 The XML Format 2 for the boot device information is as follows xml version value encoding value QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion vn n nn Build nn AppVersion AppXmlVer...

Page 277: ...LowAlarm value LowAlarm Voltage TxBias MeasuredTxBiasUnit mA MeasuredTxBiasUnit Value value Value Status value Status HighAlarm value HighAlarm HighWarning value HighWarning LowWarning value LowWarning LowAlarm value LowAlarm TxBias TxPower MeasuredTxPowerUnit mW MeasuredTxPowerUnit Value value Value Status value Status HighAlarm value HighAlarm HighWarning value HighWarning LowWarning value LowWa...

Page 278: ...fier Ext Identifier value Ext Identifier Connector value Connector TransceiverData Compliance value Compliance FCLinkLength value FCLinkLength FCTransmitterTech value FCTransmitterTech FCTransmissionMedia value FCTransmissionMedia FCSpeed value FCSpeed TransceiverData Encoding value Encoding BR Nominal value BR Nominal Length 9um km value Length 9um km Length 9um value Length 9um Length 50um value...

Page 279: ...Monitoring SoftTXDisableCtrlAndMonitoring value SoftTXDisableCtrlAndMonitoring Alarm WarningFlags value Alarm WarningFlags EnhancedOptions SFF 8472 Compliance value SFF 8472 Compliance CC_EXT 0x7d CC_EXT VendorSpecific value VendorSpecific Address_A0 Address_A2 TempHighAlarm value TempHighAlarm TempLowAlarm value TempLowAlarm TempHighWarning value TempHighWarning TempLowWarning value TempLowWarnin...

Page 280: ...SB 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 Reserved_MSB value Reserved_MSB Reserved_LSB value Reserved_LSB StatusControlBits DataReadyBar value DataReadyBar LOS value LOS TXFault value TXFault SoftRXRateSelect value SoftRXRateSelect RXRateSelectState value RXRateSelectState SoftT...

Page 281: ...alue ReservedWarning RXPowerLowWarning value RXPowerLowWarning RXPowerLowWarning value RXPowerLowWarning VendorSpecific value VendorSpecific Address_A2 HBA Status n Status ErrorMsg message ErrorMsg Reboot n Reboot QLogic Host Topology Command Line Option tp The command format is scli tp x2 The XML Format 2 for an adapter type interconnect element is as follows this example shows a switch xml versi...

Page 282: ...verVersion value FirmwareVersion value Host value AttachPort PhysicalPort PhysicalPortInformation InterconnectElements InterconnectElementType HBA HBA WWNN value WWPN value VendorID value Model value SerialNumber value Alias value PortAlias value DriverVersion value FirmwareVersion value Host value TotalNumberOfDevices value NumberofPort value BeaconStatus value PortType value PortState value Inte...

Page 283: ...QLogic Display FCoE Parameters The XML Format 2 for FCoE parameter output is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA HBA Instance 3 HBAModel QLE8402 HBAPort 1 WWNN 20 00 00 E0 8B 80 5F 0F WWPN 21 00 00 E0 8B 80 5F 0F Menlo Parameters PortSelection 0 PortType Access PauseType Prioriry Flow Control PriorityPaus...

Page 284: ...me AppVersion 1 7 1 23 AppVersion HBA FCoELogs LogID ID 8 LogName Link Events Entry No 0 Info 000 00 01 58 480 Host fibre channel port 0 physical link up Entry No 1 Info 000 00 02 03 120 Host fibre channel port 1 physical link up Entry No 2 Info No Data Entry No 3 Info No Data Entry No 4 Info No Data Entry No 5 Info No Data Entry No 6 Info No Data Entry No 7 Info No Data Entry No 8 Info No Data En...

Page 285: ...QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA HBA Instance 3 HBAModel QLE8402 HBAPort 1 WWNN 20 00 00 E0 8B 80 5F 0F WWPN 21 00 00 E0 8B 80 5F 0F xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA FCoELogs LogID ID 9 LogName DCX Entry No 0 Info 000 00 00 00 250 dcx_initialize DCX enabled and in...

Page 286: ...ry No 17 Info No Data Entry No 18 Info No Data Entry No 19 Info No Data FCoELogs HBA Status 0 Status Reboot 0 Reboot QLogic HBA QLogic Display FCoE Network Interface Statistics The XML Format 2 for FCoE network interface statistics output is as follows xml version 1 0 encoding ISO 8859 1 QLogic AppName SANsurfer FC CNA HBA CLI AppName AppVersion 1 7 1 23 AppVersion HBA HBA Instance 3 HBAModel QLE8...

Page 287: ...dPacketsLessThanOrEqual1024bytes NumberofTransmittedPacketsLessThanOrEqual1518bytes 0 NumberofTransmittedPacketsLessThanOrEqual1518bytes NumberofTransmittedPacketsLessThanOrEqual2047bytes 0 NumberofTransmittedPacketsLessThanOrEqual2047bytes NumberofTransmittedPacketsLessThanOrEqual4095bytes 0 NumberofTransmittedPacketsLessThanOrEqual4095bytes NumberofTransmittedPacketsLessThanOrEqual8191bytes 0 Nu...

Page 288: ...mittedBroadcastPackets NumberofTransmittedPacketswithVLANtag 0 NumberofTransmittedPacketswithVLANtag NumberofTransmitted_802_3x_PauseControlPackets 0 NumberofTransmitted_802_3x_PauseControlPackets NumberofTransmittedPer PriorityPausePackets 0 NumberofTransmittedPer PriorityPausePackets NumberofTransmittedPacketswithError 0 NumberofTransmittedPacketswithError NumberofReceivedPacketsLessThan64bytes ...

Page 289: ...umberofReceivedPacketsLessThanOrEqual2047bytes NumberofReceivedPacketsLessThanOrEqual4095bytes 0 NumberofReceivedPacketsLessThanOrEqual4095bytes NumberofReceivedPacketsLessThanOrEqual8191bytes 0 NumberofReceivedPacketsLessThanOrEqual8191bytes NumberofReceivedPacketsLessThanOrEqual9215bytes 0 NumberofReceivedPacketsLessThanOrEqual9215bytes NumberofReceivedPacketsLessThanOrEqual9216bytes 0 NumberofR...

Page 290: ...ceivedOversizedPackets 0 NumberofReceivedOversizedPackets NumberofReceivedPacketsDiscardedbytheMAC 0 NumberofReceivedPacketsDiscardedbytheMAC NumberofReceivedUndersizedPacketsWithGoodCRC 0 NumberofReceivedUndersizedPacketsWithGoodCRC NumberofReceivedUndersizedPacketsWithBadCRC 0 NumberofReceivedUndersizedPacketsWithBadCRC NumberofReceivedPacketsWithCRCError 0 NumberofReceivedPacketsWithCRCError Nu...

Page 291: ...Tags for Each Option SN0054614 00 K B 35 NumberofReceived_802_3x_PauseControlPackets NumberofReceivedPer PriorityPausePackets 0 NumberofReceivedPer PriorityPausePackets NSLPortStatistics HBA Status 0 Status Reboot 0 Reboot QLogic ...

Page 292: ...B XML Format 2 XML Format 2 Tags for Each Option B 36 SN0054614 00 K Notes ...

Page 293: ... NOTE Error return codes are continually being updated Although Table C 1 was accurate at the time this document was written you should check for the latest return codes in the file Fcscli exicodes txt located in the SANsurfer FC CNA HBA CLI installation directory Table C 1 Error Exit Return Codes Return Code Name Description 0 SUCCESS Command executed with no error 1 ERROR_OPEN_FILE Failed to ope...

Page 294: ...t used 18 Reserved Not used 19 ERROR_FLASH_UPDATE_UNSUPPORTED Flash update is not supported with this adapter 20 ERROR_FLASH_OPTION_DISABLED_HBA Flash update is disabled with this adapter 21 ERROR_FLASH_OPTION_DISABLED_OS Flash update is disabled with this OS 22 ERROR_FLASH_INVALID_HEADER_ SIGNATURE Flash file has invalid header signature 23 ERROR_FLASH_INVALID_DATA_ SIGNATURE Flash file has inval...

Page 295: ...NVALID_VPD Flash contains invalid VPD 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_ MISCOMPARE Diagnostics test failed with data miscom pare 44 ERROR_DIAGNOSTICS_UNKNOWN_ STATUS Unknown diagnosti...

Page 296: ...M_UNSUPPORTED_HBA Specified adapter parameters is not cur rently supported 62 ERROR_PARAM_UNSUPPORTED_DRIVER Unable to update adapter parameters the driver is unsupported 63 ERROR_RESTORE_NVRAM_DEFAULT Failed to restore adapter parameters to default settings 64 ERROR_PARAM_UNSUPPORTED_OS Unable to apply new adapter parameters the OS is unsupported 65 ERROR_PARAM_DISABLE_SETTINGS Current parameter ...

Page 297: ... 84 ERROR_MISSING_NVRAM_TEMPLATE_ FILE Unable to find the NVRAM template for the adapter 85 ERROR_INVALID_NVRAM_PROG_OPTION Specified key value to program NVRAM are invalid 86 ERROR_SPECIFIC_OEM_TEMPLATE_ UNSUPPORT Incorrect or unsupported OEM template type for selected adapter 87 Reserved Not used 88 Reserved Not used 89 Reserved Not used 90 ERROR_READING_BOOT_DEVICE Failed to read boot device se...

Page 298: ...r settings 103 ERROR_UNSUPPORTED_DRIVER_PARAM Unsupported driver parameter 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 ...

Page 299: ...bled because of current driver 125 ERROR_UPDATE_LUN_DATA_PERSIST_ BINDING Failed to update LUN data during persistent 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 130 ERROR_INVALID_HBA_WWID Adapter WWPN WWNN specified is invalid 131 ERROR_INVALID_HBA_PID Adapter instance specif...

Page 300: ...ed to create temporary directory 149 ERROR_OPEN_ZIP_FILE Failed to open zip file 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 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...

Page 301: ... 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 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 IB...

Page 302: ...t used 202 Reserved Not used 203 Reserved Not used 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 a...

Page 303: ...used 229 Reserved Not used 230 ERROR_GET_TARGET_IIDMA_SETTINGS Failed to query current intelligent inter leaved direct memory access setting 231 ERROR_SAVE_TARGET_IIDMA_SETTINGS Failed to set intelligent interleaved direct memory access factor 232 ERROR_SET_TARGET_IIDMA_ UNSUPPORTED Intelligent interleaved direct memory access factor setting is not supported with selected adapter 233 ERROR_INVALID...

Page 304: ... 248 Reserved Not used 249 Reserved Not used 250 ERROR_GET_HBA_ALIAS Failed to retrieve adapter alias of the adapter 251 ERROR_UPDATE_HBA_ALIAS Failed to update adapter alias of the adapter 252 ERROR_GET_PORT_ALIAS Failed to retrieve port alias of the adapter 253 ERROR_UPDATE_PORT_ALIAS Failed to update port alias of the adapter 254 Reserved Not used 255 Reserved Not used 256 Reserved Not used 257...

Page 305: ... a virtual port of the adapter 281 ERROR_DELETE_VIRTUAL_PORT Failed to delete a virtual port of the adapter 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 adapter does not have any virtual ports 285 ERROR_DELETE_ALL_VIRTUAL_PORTS Failed to delete all virtual ports of the ...

Page 306: ...irmware version 302 ERROR_UPDATE_MENLO_FW Failed to update FCoE firmware 303 ERROR_MANAGE_MENLO_INFO Failed to execute FCoE operation com mands 304 ERROR_GET_MENLO_CONFIG Failed to retrieve FCoE parameters 305 ERROR_SET_MENLO_CONFIG Failed to update FCoE parameters 306 ERROR_NOT_A_FCOE_DEVICE Selected adapter is not an FCoE adapter 307 ERROR_INVALID_FW_SEGMENT_SIZE Invalid FCoE firmware segment si...

Page 307: ...22 ERROR_INVALID_BYTES Invalid bytes input 323 ERROR_INVALID_DIAG_ADDRESS Invalid FCoE memory buffer address 324 ERROR_INVALID_DIAG_SIZE Invalid FCoE memory buffer size 325 ERROR_INVALID_DIAG_INPUTS Invalid FCoE inputs 326 ERROR_RETRIEVING_MENLO_PANIC_LOG Failed to retrieve FCoE panic log 327 ERROR_NO_PANIC_LOG_FOUND FCoE panic log not found 328 ERROR_FCOE_PARAMS_INVALID FCoE parameter settings is...

Page 308: ...id udev persistent device name 345 ERROR_OS_UNSUPPORTED_ PERSISTENT_NAME Udev persistent device name feature is not supported with current OS kernel 346 ERROR_UNSUPPORTED_LUN_TYPE Selected device is not supported with udev persistent device name feature 347 ERROR_UDEV_NAME_NOT_FOUND Specified device is not currently configured with udev persistent device name 348 Reserved Not used 349 Reserved Not...

Page 309: ...NABLE_STATE Failed to enable disable QoS enable set ting state 371 ERROR_UPDATE_VPORT_LOCK_STATE Failed to modify QoS lock setting state 372 ERROR_UPDATE_PPORT_ENABLE_STATE Failed to modify QoS enable setting state Selected port is a physical port 373 ERROR_UPDATE_PPORT_LOCK_STATE Failed to lock unlock QoS lock setting state Selected port is a physical port 374 ERROR_INVALID_QOS_TYPE Unsupported Q...

Page 310: ...hecksum 433 ERROR_SFP_UPDATE_FAILED Failed to update Electronic Dispersion Compensation EDC firmware 434 ERROR_SFP_UPDATE_UNSUPPORTED Selected option is unsupported 435 ERROR_SFP_UPDATE_NON_ZERO_ COUNT_STATUS Status error count is nonzero 436 Reserved Not used 437 Reserved Not used 438 ERROR_SFP_INVALID_FW_FILE Incorrect Vitesse EDC firmware file 439 ERROR_SFP_READ_FW_VERSION Failed to read EDC fi...

Page 311: ..._BOOT_CODE Failed to update FC boot code 459 ERROR_UPDATE_FC_FIRMWARE Failed to update FC firmware 460 ERROR_MPI_CFG_UPDATE_FAILURE Failed to update MPI configuration 461 ERROR_MPI_CFG_SAVE_FAILURE Failed to save MPI configuration 462 ERROR_GET_MPI_CFG_VERSION_HBA Failed to get MPI configuration version from adapter 463 ERROR_GET_MPI_CFG_VERSION_FILE Failed to get MPI configuration version from fi...

Page 312: ... used 474 Reserved Not used 475 Reserved Not used 476 Reserved Not used 477 Reserved Not used 478 Reserved Not used 479 Reserved Not used 480 ERROR_GET_DCBX_PARAMETERS Failed to get DCBX TLV Table C 1 Error Exit Return Codes Continued Return Code Name Description ...

Page 313: ...number of an adapter port hba wwpn World wide port name of an adapter port xx xx xx xx xx xx xx xx or xxxxxxxxxxxxxx enable value Enable value 1 for enable or 0 for disable file name Firmware preload table dat file lock value Lock value 1 for lock or 0 for unlock log id FCoE log ID 0 x lun id Logical unit number of a LUN lun name Persistent device name assigned to the designated LUN percent Value ...

Page 314: ...LED state on an adapter port b all hba instance hba wwpn rg fw boot all file name Updates the adapter boot code from a file where rg Specifies Option ROM region update mode all Updates the flash from a full image file 1MB image file file name Flash image file name Note Region update is not available on 2Gb adapters Flash update is not sup ported on 2Gb adapters in Macintosh If selected multiple ad...

Page 315: ...inds e hba instance hba wwpn view Shows the current boot device information on an adapter port e hba instance hba wwpn view Shows the current boot device information on an adapter port e hba instance hba wwpn disable prim alt1 alt2 alt3 Clears the selected current boot device set tings on an adapter port prim alt1 alt2 or alt3 Boot Port Name Configures all LUNs of all devices attached to an adapte...

Page 316: ...y other options fcoe hba instance hba wwpn info Shows current FCoE firmware version fcoe hba instance hba wwpn getparam portx Shows FCoE parameters of specified port fcoe hba instance hba wwpn setparam portx param name param alias param value Modifies FCoE parameters of specified port fcoe hba instance hba wwpn loadfw firmware file Updates FCoE firmware fcoe hba instance hba wwpn mon nsl portx Sho...

Page 317: ...r VPD information of an adapter port i all vpd Views the general or VPD information of all adapters kl hba instance hba wwpn param name param alias param value Runs a diagnostics loopback test on an adapter port kr hba instance hba wwpn ex exclude target wwpn param name param alias param value Runs a diagnostics read write buffer test to all target device s attached to an adapter port l hba instan...

Page 318: ...vices attached to an adapter port Disable m hba instance hba wwpn unselect all Configures all LUNs of all devices attached to an adapter port Disable m hba instance hba wwpn target wwnn target wwpn lun id 0 1 enable select unselect Configures individual LUN of a device attached to an adapter port n hba instance hba wwpn param name param alias param value Modifies the adapter parameters of an adapt...

Page 319: ...an adapter port pa hba instance hba wwpn view Shows the current alias of an adapter port pl hba instance hba wwpn info target id lun id Shows persistent device names for a spe cific LUN or all LUNs Linux only pl hba instance hba wwpn set target id lun id lun name Adds a persistent device name to a specific LUN Linux only pl hba instance hba wwpn del target id lun id lun name Removes the existing p...

Page 320: ...me Updates the adapter parameters of an adapter port or all adapters from a file 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 t hba instance hba wwpn Shows the information about devices disks or tapes attached to an adapter port t hba instance hba wwpn target wwpn target portid Shows the inform...

Page 321: ...r port vp hba instance hba wwpn list all Lists all virtual ports on a physical adapter port x 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 O...

Page 322: ...D Help Commands D 10 SN0054614 00 K Notes ...

Page 323: ...d loop_physical address See AL_PA basic input output system See BIOS 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 adapter at startup boot code The program that initializes a system or an adapter Boot code is the first program to run when a system or a device within...

Page 324: ...gies Enhanced Ethernet and Fibre Channel over Ethernet FCoE converged network adapter See CNA CoS Class of service CoS is a 3 bit field within a layer two Ethernet frame header when using IEEE 802 1Q It specifies a priority value of between 0 signifying best effort and 7 signifying priority real time data that can be used by quality of service disci plines to differentiate traffic CoS is a way of ...

Page 325: ...faces between the file system and a physical data storage device or network media E_Port Expansion port A port in an FC switch that connects to another FC switch or bridge device by an inter switch link ISL 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 Enhanced Ethernet Al...

Page 326: ...ibre Channel over Ethernet See FCoE FL_Port Fabric loop port In 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 ...

Page 327: ...zation process The initializa tion 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 transmis sion on the loop is suspended during a LIP load balancing A software feature that improves system performance by balancing device access between multiple adapters for maximum resource efficiency Available in...

Page 328: ...registers Optional features in MSI 64 bit addressing and interrupt masking are mandatory with MSI X 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 detection and flow of message units to and from the connected systems N_Ports are end ports in virtual point to point links through a fabric for example N_Port to F_Por...

Page 329: ...is guide open network computing See ONC ONC Open network computing A remote proce dure call developed by Sun Microsystems path A path to a device is a combination of a adapter 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 adapter initiator and the target Because a path is a com...

Page 330: ...ontroller bus SerDes A Serializer Deserializer SerDes pronounced sir dees is a pair of functional blocks commonly used in high speed communications These blocks convert data between serial data and parallel inter faces in each direction small computer system interface See SCSI SFP Small form factor pluggable is a 1 2 4 8 Gbps transceiver device smaller than a Gigabit interface converter that plugs...

Page 331: ...ovides a user space Appli cation Programming Interface API to access information about current system devices udev relies on device information available through sysfs virtual logical area network See VLAN virtual machine See VM VLAN Virtual logical area network LAN A group of hosts with a common set of require ments that communicate as if they were attached to the same wire regardless of their ph...

Page 332: ...SANsurfer FC CNA HBA CLI User s Guide Command Line Interface for QLogic FC and FCoE Adapters Glossary 10 SN0054614 00 K Notes ...

Page 333: ... FCoE engine 3 33 adapter port BIOS enabling 3 26 3 30 definition of Glossary 1 diagnostics 3 77 iiDMA settings 3 50 statistics options 3 91 adapter port alias creating modifying deleting 3 22 definition of Glossary 1 XML Format 1 A 15 XML Format 2 B 18 adapter port beacon definition of Glossary 1 adapter statistics polling 3 92 saving to file 3 92 viewing and changing 3 89 3 90 3 93 A 14 B 17 vie...

Page 334: ...tus toggling 4 6 status viewing 4 6 target locating 3 75 target starting and stopping 4 46 Beacon Menu 3 75 bind by port ID parameter 4 17 by WWPN parameter 4 17 targets 3 57 binding information viewing persistent target 4 38 BIOS adapter port enabling 3 26 definition of Glossary 1 enabling 4 36 blue text meaning of xvii bold text meaning of xvi boot code definition of Glossary 1 boot device A 9 a...

Page 335: ... 4 47 x 3 10 4 48 x2 3 10 4 48 z 3 10 3 19 4 2 4 4 4 49 A 11 B 13 config table MPI saving 3 71 updating 3 71 configuration saving 3 62 configuring adapter statistics 3 90 boot device 3 61 4 4 driver settings 4 16 iiDMA settings 3 48 link status 3 94 loopback test parameters 3 80 LUNs automatically 3 59 LUNs manually 3 59 selective LUNs 4 5 target persistent binding 4 5 connection loop only 3 28 lo...

Page 336: ... 94 defining port alias 4 40 definitions of terms Glossary 1 delay timer interrupt 3 26 3 30 delay loop reset 3 26 deleting virtual port 3 99 device configuring boot 3 61 definition of Glossary 3 driver updating 4 10 list viewing A 7 B 7 diagnostics configuration settings 3 80 loopback test 3 77 A 9 B 11 parameters 4 30 port 3 77 read write buffer test 3 83 A 10 B 12 running loopback or read write...

Page 337: ... 30 FC tape support 3 26 Fibre Channel tape support 3 30 LIP full login 3 27 3 31 LIP reset 3 26 3 31 LUNs 4 33 receive out of order frame 3 27 target reset 3 27 3 31 virtual port 3 103 3 106 3 107 end user license agreement xvii Enhanced Ethernet definition of Glossary 3 enhanced transmission selection See ETS ENode MAC address 3 21 error codes interactive mode C 1 listing 4 13 non interactive mo...

Page 338: ...nnel over Ethernet See FCoE Fibre Channel definition of Glossary 4 file 3 10 txt 3 10 xml 3 10 text 3 10 XML 3 10 firmware preload table saving 3 70 preload table updating 3 69 updating on ASIC chip 3 109 version of FCoE 3 21 firmware area saving 3 74 4 46 updating 3 72 4 46 Flash definition of Glossary 4 image version 3 12 saving file 3 65 updating 3 65 Flash BIOS definition of Glossary 4 saving ...

Page 339: ...r second IOPS definition of Glossary 5 installation downloading package 1 7 Linux 1 14 Macintosh 1 18 package downloading 1 7 prerequisites of 1 1 Solaris 1 15 Solaris SPARC 8 9 10 1 15 Solaris x86 9 10 1 17 VMware 1 20 Windows 1 8 instance number 4 6 port definition of Glossary 8 intelligent interleaved direct memory access See iiDMA interactive mode 3 1 See also non interactive mode definition o...

Page 340: ...s driver 3 5 uninstalling from 1 22 LIP definition of Glossary 5 full login enabling 3 27 3 31 4 36 reset enabling 3 26 4 36 listing error codes 4 13 target LUN 3 36 virtual ports 3 99 load balancing definition of Glossary 5 locating adapter beacon LED 3 75 selected target beacon LED 3 76 target beacon LED 3 75 log to file adapter statistics parameter 4 18 link status 3 95 logging enabling extende...

Page 341: ...ary 6 message passing interface See MPI message signaled interrupts extension See MSI X messages output to XML Format 1 4 48 Microsoft System Center Virtual Machine CLI 2007 3 97 Microsoft s Windows Virtual Server 2005 3 97 mode interactive definition of 2 1 interactive starting 2 1 non interactive definition of 2 1 non interactive starting 2 4 operation 3 26 silent 4 45 monospace font meaning of ...

Page 342: ...6 adapter configuring 3 26 adapter viewing 3 24 3 26 4 8 data rate 3 26 parameters continued defaults restoring 3 32 diagnostic 4 30 FCoE engine A 23 B 27 FCoE configuring 3 33 FCoE viewing 3 33 frame size 3 26 hard loop ID 3 26 loop reset delay 3 26 loopback test resetting 3 80 loopback test setting 3 80 loopback test showing 3 79 saving adapter 3 66 template supported 3 66 3 67 updating 3 66 4 4...

Page 343: ... 101 4 43 QoS Bandwidth Menu 3 104 QoS Menu 3 101 QoS Priority Menu 3 103 quality of service See QoS R r 3 65 3 66 4 44 rate data 3 29 read write buffer test 3 83 results A 10 B 12 running 3 83 4 27 4 28 reboot message XML Format 1 A 2 XML Format 2 B 2 receive out of order frame enabling 3 27 refresh configuration of host 3 19 reporting all adapters 3 19 one port instance 3 11 rescan driver Solari...

Page 344: ...requirement for 1 1 silent mode 4 5 4 45 size frame 3 29 SLA service level agreement 3 101 small computer system interface definition of Glossary 8 small form factor pluggable See SFP software requirements 1 5 Solaris installing on 1 15 NPIV supported 3 97 operating systems supported 1 3 target ID 4 12 uninstalling from 1 22 1 23 speed bandwidth 3 105 starting DCE statistics 3 115 starting interac...

Page 345: ...24xx adapters ISP2422 3 67 QLA24xx QLE24xx adapters ISP2432 3 67 QLE256x adapters ISP2422 3 67 QLE256x adapters ISP2432 3 67 ten bit internal loopback test 3 82 terminology used in guide 2 9 terms definitions of Glossary 1 test count parameter 4 23 diagnostics loopback 3 77 increment parameter 4 23 loopback preparing for 3 78 number of tests parameter 4 23 4 30 parameters loopback 3 79 pattern 4 3...

Page 346: ...tings 4 4 beacon status 4 6 boot device 4 11 driver settings 4 4 link status 3 96 LUN list 4 5 4 33 viewing continued parameter settings 4 8 system information 4 5 target link speed 4 42 target list 4 5 virtual ports list 3 99 virtual LAN See VLAN virtual machine VM Virtual Menu 3 97 for adapter instance 3 98 virtual ports 3 97 auto generating 3 100 creating 3 100 deleting 3 99 enabling 3 103 3 10...

Page 347: ...Glossary 9 notation for 2 4 WWPN bind by WWPN parameter 4 17 definition of Glossary 9 notation for 2 4 X x 3 10 4 5 4 48 x1 A 1 x2 3 10 4 48 XML file saving as 3 10 Format 1 3 10 4 48 A 1 Format 2 3 10 4 48 B 1 xml file 3 10 Z z adapter reporting interactive mode 3 10 3 19 adapter reporting non interactive mode 4 2 4 4 4 49 adapter reporting XML Format 1 A 11 adapter reporting XML Format 2 B 13 ...

Page 348: ...istered trademarks of Novell Inc IBM and PowerPC are registered trademarks of International Business Machines Corporation Red Hat is a registered trademark of Red Hat Inc Solaris is a registered trademark of Sun Microsystems Inc SPARC is a registered trademark of SPARC International Inc in the USA and other countries StuffIt is a registered trademark of Smith Micro Software Inc VMware is a registe...

Search results

Summary of Contents for SANsurfer FC/CNA HBA CLI

Reviews:

Qlogic SANsurfer FC/CNA HBA CLI, User Manual, Page: 159 / 348

Search results

Summary of Contents for SANsurfer FC/CNA HBA CLI

Reviews: