SANsurfer FC HBA CLI User’s Guide
Document Revision History
Changes Sections Affected Revision F Changes
Added Appendix B XML Format
Revision E Changes
Section
Following options and commands were added in Rev. E
Following options and commands were changed in Rev. E
SN0054614-00 F
Revision D Changes
Following options and commands were changed in Rev. D
Page
Page
Table of Contents
Section Interactive Commands
SN0054614-00 F
SN0054614-00 F
Section Non-interactive Commands
Appendix a XML Format
Appendix B XML Format
SN0054614-00 F
List of Figures
List of Tables
Page
Guide Overview
Product Overview
How this Guide is Organized
Documentation Conventions
Topology
General Information
Supported QLogic HBAs
Supported Operating Systems
System Requirements
Hardware Requirements
Unsupported Features
Software Requirements
Features Not Available When Running VMware Driver
Features Not Available When Running ioctl Module Driver
Features Not Available When Running Sysfs Inbox Driver
Technical Support
Contact Information
Availability
Training
Support Headquarters
Asia Pacific Region
Europe, Middle East, and Africa Region
Latin and South America Region
Preliminary
Starting Interactive Mode
Introduction
Virtual if available
Starting Non-interactive Mode
Following inputs are valid for the port ID
Red Hat/SuSE Menu Description Section Option
Interactive
Windows Macintosh
Non-interactive Mode Options
Interactive Interactive Menu
Terminology
HBA Port
Initial Installation
Downloading the Installation Package
Windows Installation
Installing SANsurfer FC HBA CLI
Standard GUI Installation
Welcome Dialog Box
Ready to Install the Program Dialog Box
Command Line Installation
Standard Command Line Installation
Windows Command Line Installation Parameters
Silent Command Line Installation
Parameter Meaning Description
For SuSE Sles IA64, the command line is
Linux Installation
New package is installed in the following directory
To install SANsurfer FC HBA CLI, type the following
Solaris Installation
Solaris Sparc 8, 9, 10 Installation
Available packages appear. For example
Solaris x86 9 and 10 Installation
Enter
Macintosh Installation
Uninstalling SANsurfer FC HBA CLI
For example
Command Line Uninstall
Windows Uninstall
Standard GUI Uninstall
Linux Uninstall
Solaris Sparc 8, 9, and 10 Uninstall
Solaris x86 8, 9, and 10 Uninstall
Macintosh Uninstall
Page
Interactive Commands
Host Information
Command Line Option -g
General Information Menu
General Information Host Information
Host Topology
Command Line Option -tp -topology
General Information 2 Host Topology
Display Host Topology
SN0054614-00 F
Here is an example
HBA
Seagate
Save As Txt File
Command Line Option -b
Command Line Option
Save As XML File
Generate Report
Command Line Option -z
Save to XML File Format
Generate Report Per HBA Port
HBA ID
Wwpn
HBA Part Number Port Number
Size Type
HBA ID
SN0054614-00 F
LUN
LUN ID
Refresh
Generate Report All HBAs
HBA Information Menu
HBA Information
Command Line Option -ha
HBA General Information per HBA Port
HBA Alias
Command Line Option -pa
HBA Port Alias
Command Line Option -l and Reserved Word vpd
HBA VPD Information
HBA Parameters Menu
HBA Information All HBAs
Information
HBA Information n All HBAs
Display HBA Parameters
Command Line Option -c#
HBA Parameters Per HBA Port
HBA Parameters n Port Instance
Configure HBA Parameters
Command Line Option -n
HBA Parameters Settings Nvram
Parameter Name Alias Value Description
Data Rate
Connection Options
Frame Size
Enable HBA Hard Loop ID
Loop Reset Delay
Enable HBA Port Bios
Enable Fibre Channel Tape Support
Login Retry Count
Operation Mode
Interrupt Delay Timer
Enable LIP Reset
Enable Target Reset
Enable LIP Full Login
Link Down Timeout
LUNs per Target
HBA Parameters All HBAs
Restore Defaults
Abort Changes
Choose this option to stop without making any changes
Target/LUN Information
Command Line Options -t and -l
Target/LUN List Menu
Target/LUN List
Target/LUN List Per HBA Port
Per Target/LUN
So on
Per Target/All LUNs
Size Type
Individual Target
All Targets
Target/LUN List All HBAs
So on. Repeats for each LUN
Individual LUN
Status Here is an example of the Target information
LUN ID
So forth
Target/LUN List n Port Number
All LUNs
Hitachi
Command Line Option -q
Target Link Speed or iiDMA Settings Menu
Target Link Speed or 5 iiDMA Settings
Target Link Speed Settings
Configuring the iiDMA Settings
3lists the target link speed settings and descriptions
Target Link Speed Settings Description
To use Basic Configuration
HBA Port Instance
IiDMA Settings 1 n HBA Port n
HBA Port
Advanced Configuration
Target Link Speed All HBAs
Target Link Speed All HBAs Basic Configuration
Target Link Speed All HBAs Advanced Configuration
Target Link Speed 2 All HBAs
4.2.1
IiDMA All HBAs
IiDMA Settings Disk
Command Line Option -p
Target Persistent Bindings Menu
Display Target Persistent Binding
Target Persistent Bindings Per HBA Port
Target Persistent Binding
Target Persistent Bindings Bind Targets
Target Persistent Binding All HBAs
Target Persistent Binding FC Port Configuration
Target Persistent Binding Unbind Targets
Target Persistent Binding p All HBAs
Selective LUNs Menu
Command Line Option -m
Target Persistent Binding Bind Targets
Selective LUNs Per HBA Port
Selective LUNs All HBAs
Display LUN Configuration
Selective LUNs 1 All HBAs
Boot Device Menu
Manual Configure LUNs
Auto Configure LUNs
Command Line Option -e
Boot Devices Per HBA Port
Wwpn
Boot Device Settings
Configure Boot Devices
LUN List Menu
Driver Settings Menu
Save Configuration
Boot Devices All HBAs
Command Line Option -fg
Driver Settings
Parameter Name Alias Value Description Param name
Utilities Menu
Flash Update Per HBA Port or All HBAs
Command Line Option -b and Reserved Word save
Flash Save Per HBA Port
HBA Parameters Save Per HBA Port
HBA Parameters Update Per HBA Port or All HBAs
HBA Parameters Template Per HBA or All HBAs
Using HBA Parameter Templates
Setting QLogic
IBM SUN
Command Line Option -rs
Driver Update
Command Line Option -d
Driver Rescan
Beacon Menu
Command Line Option -a
Command Line Option -tb
Locate HBA HBA Beacon
HBA Diagnostics Configuration Settings
Diagnostics Menu
Command Line Options -kl, -kr, and -dm
Beacon Selected Targets
Command Line Option -kl
Diagnostics Loopback Test
Diagnostics n Port Number
Configure Loopback Test Parameters
SN0054614-00 F
Diagnostics Read/Write Buffer Test
Run Loopback Test
Configure Read/Write Test Parameters
SN0054614-00 F
SN0054614-00 F
SN0054614-00 F
Run Read/Write Buffer Test
Command Line Option -dm
Diagnostics Transceiver Details DMI
Transceiver Details General
Transceiver Details Details
SN0054614-00 F
SN0054614-00 F
Command Line Option -gs
Configuration
Command Line Options -gs and -ls
Statistics Menu
Resetting to default settings..., done
Auto Poll
Current Settings
10. HBA Port Statistics Options
Log to File
Set Rate
Show HBA Statistics
Command Line Option -ls
Link Status
11. Statistics/Link Status Options
Restore Default
Auto Poll Menu
SANsurfer FC HBA CLI displays two polling options
Show Link Status
Virtual Menu
Command Line Option -vp
Virtual Menu
Scli -vp -h
List Virtual Ports
Virtual Menu for HBA Instance
Virtual
Create Virtual Ports
Delete Virtual Ports
Status Online or Loop Down Here is an example
User Generate
Command Line Option -h
Auto Generate
Help Menu
Exit Codes
Contents
About
Command format to show host information is
Command Line Options -g, -z, and -tp
Display System Information
Where
Host Configuration
To show the information for all HBAs, type
Command Line Option -tp
Options Shown by -z
Description See Section
-s= Silent mode see .3.28. For example
Command Summary
Command format for non-interactive mode is
Only
View or Toggle Beacon Status
2defines the command variables
Command Variables
Variable Definition Format
To view the HBA port’s LED Beacon state, type
Save or Update the Flash Bios or Fcode
To start or stop flashing the HBA’s LED beacon, type
To save the BIOS/FCode to a file, type
Show Parameter Settings
Update Device Driver
To show the parameter settings for a specific HBA, type
Boot Device View Select Disable
Display Diagnostics Monitoring Info
To show Transceiver monitoring detailed information, type
These commands
To view the current boot device selection on all HBAs
To disable delete the boot device for a specific HBA, type
SANsurfer FC HBA CLI specifies command line input from file
List SANsurfer FC HBA CLI Error Codes
Input Parameter Options from a Text File
Type the following command to configure the driver settings
Show Driver Settings
Configure Driver Settings
3lists the driver configuration parameter names and aliases
Show HBA Statistics
For details of this command, see section
Display System Information
To view system information, type
Type the following text to view the help file
Help
HBA Statistics Parameters
For example, typing scli -l-hshows
Set Delete HBA Alias
To show general or VPD information for a specific HBA, type
Loopback Test
To do a loopback test with customized parameters, type
To enter a customized value in the range of 00-FF, type
DataPattern DP
For the loopback test, the data pattern is either
5lists all valid data patterns
For the loopback test, the data size is either
DataSize DS
Data Pattern Values
Hex Binary
TestCount TC
OnError OE
For the loopback test, OnError is either
Test Increment TI
To do a loopback test using the current parameters, type
OnError Values
Driver Versions Not Requiring a Loopback Connector
Run a Loopback Test
To do a loopback test with custom parameters, type
An example of a successful loopback test follows
Run Read/Write Buffer Test
Run HBA Diagnostics Loopback Test
To do a read/write test with customized parameters, type
Run a Read/Write Buffer Test
HBA Wwpn
An example of a successful read/write buffer test follows
Diagnostics Parameters
Run HBA Diagnostics Read-write Buffer Test
Name Alias Value Description
Data Pattern DP Test Patterns
Status
Display Link Status
Display LUN Info
To view the link status, type
View, Enable, or Disable LUNs
10. Link Status Parameters
To view an HBA’s selective LUN list, type
To view all selective LUNs for all HBA ports, type
To view the current select state of a specific LUN, type
Set Selected HBA Parameter
To enable select all LUNs of all targets on a specific HBA
To restore the default Bios 4G HBAs only, type
To set a specific parameter on a specific HBA, type
11lists the HBA parameter names and aliases
11. HBA Parameters
Output to a File
Display Persistent Target Binding Info
To show persistent binding information for all HBAs, type
To bind a selected target to a specific HBA, type
To unbind a specific target, type
To delete a port alias for the specified HBA port, type
Define Port Alias
View or Set Target Link Speed
To view a port alias for the specified HBA port, type
# scli -q HBA Instance HBA Wwpn Target Wwpn
To update the HBA Parameters, type
Update HBA Parameters
Silent Mode
To save the HBA parameters to a file, type
Display Target Information
Target Beacon On/Off
Virtual Port
Display Host Topology
Display Version
System shows the following information
To create a virtual port with an automatic WWPN, type
Output in XML Format
To create a virtual port with a specific WWPN, type
2 covers this command
Display All HBA information for One or All HBAs
Main Tag
Utility Header
Status Message
Reboot Message
Error Message
XML Format 1 Tags for Each Option
XML Format 1 for adapter settings information is as follows
Display Adapter Settings
Command Line Option -c
XML format 1 for system information output is as follows
Display HBA Information
Here is the information for the 4G HBAs
Here is the VPD information
XML Format 1 for adapter device information is as follows
Command Line Option -t
Display Device List
Target…/Target sequence is repeated for each HBA target
Display LUN List
Command Line Option -l
Target Persistent Binding
XML Format 1 for the boot device information is as follows
Boot Device
Selective LUNs
Command Line Option -kr
Diagnostics Results -Loopback Test
Diagnostics Results Read/Write Buffer Test
XML Format 1 for the loopback test results is as follows
Table A-1. Options Displayed by -z
View Driver Settings
Display All Information for One or All HBAs
Non-interactive Description Section Option
XML Format 1 for all adapter information is as follows
XML Format XML Format 1 Tags for Each Option
XML Format 1 for the link statistics option is as follows
Link Statistics
HBA Statistics
XML Format 1 for the HBA statistics option is as follows
XML Format 1 for the HBA alias option is as follows
XML Format 1 for the HBA port alias option is as follows
SFF DMI
XML Format 1 for SFF DMI general information is as follows
XML Format XML Format 1 Tags for Each Option
XML Format 1 XML Format 1 Tags for Each Option
XML Format XML Format 1 Tags for Each Option
XML Format 1 XML Format 1 Tags for Each Option
Host Topology
XML Format 1 XML Format 1 Tags for Each Option
InterConnectElement Status 0 /Status Reboot 0 /Reboot QLogic
Appendix B
Command format is
XML2 Tags for Each Option
XML Format 2 for adapter settings information is as follows
XML Format 2 for SFF DMI general information is as follows
XML Format 2 for the boot device information is as follows
XML Format 2 for SFF DMI detailed information is as follows
XML Format XML2 Tags for Each Option
XML Format 2 XML2 Tags for Each Option
Command format for all HBAs is
Command format for a single HBAs is
HBA Instance HBA Wwpn view ?
XML Format 2 for system information output is as follows
XML Format 2 for adapter general information is as follows
XML Format 2 for 4G HBAs is as follows
Diagnostics Results Loopback Test
XML Format 2 for the loopback test results is as follows
Target... /Target sequence repeats for each target
Scli -m all view ?
XML Format 2 for adapter device information is as follows
Table B-1. Options Displayed by -z
Non-interactive Setting Section Option
XML Format 2 for all adapter information is as follows
XML Format Display System Information Command Line Option -g
SN0054614-00 F
XML Format 2 for the link statistics option is as follows
XML Format 2 for the HBA statistics option is as follows
View HBA Alias
LinkStatus…/ parameter repeats for each link
Statistics.../ sequence repeats for each HBA
XML Format 2 for the HBA port alias option is as follows
SN0054614-00 F
Scli -tp
SN0054614-00 F
Page
Table C-1. Exit Code Descriptions Interactive Mode
Return Name Description Code
Errormismatchchecksum
Errorflashupdatenoregion
Errorinvalidparamsettings
Errorpreservenvramdata
Errorduplicatetargetid
Errorfailoverdriverloaded
Errorclosezipfile
Errorsavesellunconfig
Errormissingipaddress
Errorsavetargetiidmasettings
Erroradapterpropmissing
To see the interactive exit codes, see Appendix C
Table D-1. Error Code Descriptions Non-interactive Mode
Code Name Description
Errorflashupdatenovalidregion
Errordiagnosticsdatamiscompare
Errormissingnvramtemplatefile
Errorbootconfigdisableddriver
Errorreadfrompersistentstorage
Errorinualidhbawwid
Driver sys file is missing in the driver
Failed to save selective LUN configu
205 Reserved Not used 206 207 208 209 210
Errorsettargetiidmaunsupported
257 Reserved Not used 258 259 260
Table E-1. Help Commands
Command Arguments Function
All file name
Disable prim alt1 alt2
Param name param Alias param value Hba instance hba wwpn
Lun id view ? Hba instance hba wwpn
Target portid target id Hba instance hba wwpn
Portid All
Writes the output in XML format 1. Option
See HBA
For the HBA and initializing and testing the HBAs ISP
Comma separated values CSV file
Driver
Red Hat/SuSE Linux, the driver layers include
Port in a fabric where an NPort can attach
Fabric consists of cross-connected FC devices and switches
QLogic Fast!UTIL FC HBA Bios utility
Flash Prom contains the Bios code for the HBA
Device’s Alpa on the loop
As opposed to a SAN. See SAN Storage Area Network
NPort ID Virtualization
Network Interface Controller
Remote procedure call developed by Sun Microsystems
Also FC-P2P. Two FC nodes directly connected not in a loop
SAN Storage Area Network
Index
Index-2 SN0054614-00 F
SN0054614-00 F Index-3
Fg4-54,5-4,5-13,A-10,B-10 file
Txt Xml 4-8 text 4-8 XML
HBA hard loop ID 4-23host
LED
SN0054614-00 F Index-7
Index-8 SN0054614-00 F
Definition of Glossary-6 layers, definition of Glossary-2
SDM API
Index-10 SN0054614-00 F
Txt 4-8 text file
XML