R
S i m p l i f y
SANsurfer FC HBA CLI
User’s Guide
Command Line Interface for QLogic
Fibre Channel Host Bus Adapters
SN0054614-00 F
Page i
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
Changed HBA No. to HBA Instance.
All
Changed SFF DMI to HBA transceiver details.
Updated supported QLogic HBA list.
All
Updated supported operating system list.
All non-interactive information moved from
Command line options put in alphabetical order.
Added port virtualization (NPIV) information.
Added support for Red Hat Linux REL 5.1.
Solaris SPARC 6 and 7.
Added NPIV information.
Added OS LUN Name (Solaris and Linux).
tion of what’s in the guide and documentation con-
ventions used.
Added interactive mode exit codes listing.
Moved tables other than help commands from
Help Commands appendix to appropriate interac-
tive commands sections.
Expanded iiDMA settings information.
Added Virtual Menu information.
Expanded HBA parameter templates information.
Expanded diagnostic testing information.
Revision E Changes:
Expanded product description.
Split supported HBAs and operating systems into
two sections. Updated list of supported operating
systems.
Added system requirements section.
SN0054614-00 F
Page iii
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
Changed bullets describing interactive and
non-interactive modes.
Clarified the note about starting SANsurfer FC
HBA CLI on a Solaris console serial port.
driver on the OS installation CD (inbox driver).
Split Windows command line installation into two
sections (standard and silent). Changed installa-
tion instructions. Added new parameters to com-
mand line for silent installation.
Split Solaris installation and uninstallation into
three sections:
Solaris SPARC 6 and 7
Solaris SPARC 8, 9, 10
Solaris x86 8, 9, 10
(These Solaris versions no longer supported.)
Added Mac OS X command line installation
instructions.
In Windows uninstall (standard), added how to
invoke the exe package and remove the installed
features.
uninstall directions.
the package.
Replaced node name, port name, WWPN, and
WWNN with variables (xx) in screen shots for
security purposes.
Added a note to Display LUN List and Selective
LUNs sections defining the maximum number of
LUNs supported by the Solaris QLA and QLC driv-
ers.
defining the number of targets and the range of tar-
get IDs for Solaris, which is based in the HBA type.
Changed Boot Device Selection to Boot Device
Settings.
Page iv
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
OSs and HBAs save/update flash, BIOS, or the
option ROM image.
loopback and read/write buffer tests. Added
description of these test results.
The following options and commands were added in Rev. E:
Host Topology (command line option -tp)
HBA Alias (command line option -ha)
HBA Port Alias (command line option -pa)
SFF DMI (command line option -dm)
The following options and commands were changed in Rev. E:
Host Information (command line option -g):
removed QLogic direct driver version from the list
of displayed information.
For Host Configuration (command line option -z),
made the following changes to the list of displayed
information:
Added VPD information to display HBA information
(command line option -I).
Added view driver settings (command line option
-fg).
Removed run loopback test (command line option
-kl).
Removed run read/write test (command line option
-kr).
Removed display and change HBA statistics (com-
mand line option -gs).
Removed display and change link status (com-
mand line option -ls).
Also changed the list order to reflect the order in
which the commands are displayed.
Show HBA Information (command line option -i):
Added HBA Alias and Port Alias to list of shown
information.
Changed PCI bus number to PCI device number.
Show Device List (command line option -t): added 4.5, 4.4.1
Serial Number to the list of displayed information.
SN0054614-00 F
Page v
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
Configure HBA Settings (-n): added option to
restore the BIOS (QLA/QLE/QEM24xx HBAs).
Selective LUNs (command line option -m): added
ALL option to command line to view all selective
LUNs for all HBA ports.
Set Boot Device (-e): removed references to OSs
from the third paragraph; this command now
applies to all OSs.
4.9.2.1.1
Diagnostics (command line options -kl and -dr):
DataPattern (DP) parameter: added CRPAT,
CSPAT, and CJTPAT.
DataSize (DS) parameter: added 128-byte value
for read/write buffer test. Added 128, 256, 512,
1024, 2048, 4096, 8192, 16384, 32768, 65535
byte values for loopback test. Added default val-
ues.
loopback tests that can be run from 0–10000 to
0–65535.
ment for the loopback test from 1–10000 to
1–65535.
Output in XML Format (command line option -x):
Added XML format for HBA alias (command line
option -ha).
Added XML format for HBA port alias (command
line option -pa).
Added XML format for SFF DMI (command line
option -dm).
Added XML format for host topology (command
line option -tp).
Target Persistent Binding (command line option
-p): added ALL parameter to show target persistent
binding information for all HBA ports.
Page vi
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
Revision D Changes:
Operating systems supported:
All
Windows 2003 Server™ and Enterprise Server:
added x64; removed IEM64T and AMD64. Added
Windows® XP.
Red Hat™ Linux® AS: added x86_64; removed
IEM64T and AMD64.
SuSE® Linux Enterprise Server (SLES) 8 and 9:
added x86_64; removed IEM64T and AMD64.
Removed Power PC (PPC) SLES 8 and 9.
Solaris® SPARC®: removed v2.7; added version 7.
Solaris: removed 9 x86 and 10 x86; added x86,
v2.9, 10.
Removed the sentence “SANsurfer FC HBA CLI
does not provide any features that require a GUI.”
Section 1
Section 1
3.1.1.1
Added QEM2462 and QLA/QLE2xx to list of sup-
ported HBAs.
Changed standard (GUI) install instructions for
Windows operating systems.
Changed package name version to xx, which indi- 3.1.1.2, 3.1.3.1, 3.12.3.3
cates the current version of SANsurfer FC HBA
CLI.
Changed step 1 of the Mac OX installation proce-
dure. Removed the steps to create the root user,
log out of the current user account, and log into the
root user (previously steps 2, 3, 4).
3.1.4
Changed WWPN in example text to generic xx for Section 4
consistency.
Changed name of Show System Information sub-
menus.
4.2.1, 4.2.2, 4.2.4, 4.2.5
Changed name of Boot Device to Boot Device
4.10
Selection in interactive mode.
HBA Parameters (Table 4-2, Table 6-12):
4.6.1.2, Table 5-9
Changed value of ResetDelay, ExecutionThrottle,
and LinkDownTimeOut parameters. Added
(QLA/QLE23xx HBAs) quantifier to EnableEx-
tended Logging and EnableLIPFullLogin parame-
ters.
Added a list of valid data patterns for the DataPat- 4.17.1.2.1, Table 5-6
tern diagnostic parameter (Table 4-4, Table 5-6).
SN0054614-00 F
Page vii
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
The following options and commands were changed in Rev. D:
Interactive mode commands: Changed instructions
and the example text to new port sorting and num-
bering scheme. No change to command function.
Non-interactive mode commands: Changed the
HBA Port No.parameter to HBA No.parameter
to support new port sorting and numbering
scheme. No change to command function.
Display HBA Settings (-c)
DisplayHBA Information (-i)
Display Device List (-t)
Display LUN List (-l)
4.3, 5.3.3
4.4, 5.3.1
5 4.5, 5
4.6, 5
Configure HBA Settings (-n)
Target Persistent Binding (-p)
Selective LUNs (-m)
4.7, 5
4.8, 5
4.9, 5
Boot Device Selection (-e)
Driver Settings (-fs)
4.10, 5
4.11, 5
4.12, 5
4.12, 5
4.11, 5
4.16, 5
4.17, 5
4.18, 5
View Driver Settings (-fg)
Save/Update Flash (-b)
Save/Update NVRAM (-r)
Flash HBA Beacon (-a and -tb)
Diagnostics (-kl and -kr)
Statistics (-gs and -ls)
Host Information (-g):
4.2.1, 4.2.4
Quantified that the direct driver version is only
displayed in Windows.
No longer shows firm-
ware version. Shows new HBA number (HBA 0–n)
Display HBA Information (-I).
4.4, 5.4.8
The following new general information shows:
HBA instance, HBA ID, OptionROM BIOS version,
OptionROM FCode version, OptionROM EFI ver-
sion, OptionROM firmware version, total number of
devices.
The following general information has been
removed:
The following VPD information has been removed:
Asset tag End tag
Device target count
Page viii
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
Display LUN List (-l):
4.6
In interactive mode, added target type to infor-
mation displayed.
Removed asset tag and end tag from list of
VPD information.
In example text, changed the first two option
names of the Selective LUN(s) Display Configura-
tion menu.
In example text, changed the first two option
names of the Selective LUN(s) Configuration -
HBA/Device menu.
Boot Device Selection (-eE): In interactive mode,
added new HBA Boot Device menu to example
text.
4.10, 5.3.6
4.8, 5.9
Target Persistent Binding (-p):
In interactive mode, changed first two option
names of Target Persistent Binding menu in the
example text.
Driver Settings (-fs): Changed from bind By
WWPN to bind by Port ID.
4.11
Save/Update Flash (-b):
4.12, 5.3.2
In interactive mode, removed secondary subti-
tles of Option ROM Update menu in the example
text.
In non-interactive mode, added new all
parameter following the bootparameter.
Save/Update NVRAM (-r): In interactive mode,
removed the secondary subtitles of the NVRAM
Update Menu in the example text.
4.11
SN0054614-00 F
Page ix
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
Notes
Page x
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Table of Contents
Product Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Linux Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Solaris Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Macintosh Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
SN0054614-00 F
Page xi
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
Windows Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Linux Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Solaris Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13
Macintosh Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15
4.1.2.1
Display (Host Topology) (Command Line Option -tp |
-topology) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4-4
Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
4.2.1.4
HBA VPD Information (Command Line Option -l and
Reserved Word “vpd”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
HBA Parameters Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
Page xii
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
HBA Port Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40
HBA Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-41
iiDMA – All HBAs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45
4.6.1
Target Persistent Bindings (Per HBA Port) (Command Line
Option -p). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
4.6.1.1
Display Target Persistent Binding (Command Line
Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
4.6.1.2
4.6.1.3
Target Persistent Bindings – Bind Target(s) (Command Line
Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47
Target Persistent Binding – Unbind Targets (Command Line
Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48
SN0054614-00 F
Page xiii
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
HBA Port Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52
Utilities Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56
4.10.1
4.10.2
4.10.3
4.10.4
4.10.5
Flash Update (Per HBA Port or All HBAs) (Command Line
Option -b). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56
Flash Save (Per HBA Port) (Command Line Option -b and
Reserved Word “save”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56
HBA Parameters Update (Per HBA Port or All HBAs) (Command
Line Option -r) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-57
HBA Parameters Save (Per HBA Port) (Command Line Option
-r and Reserved Word “save”). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-57
HBA Parameters Template (Per HBA or All HBAs) (Command
Line Option -n and OEM Name) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-57
Beacon Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
4.12.3
Diagnostics Transceiver Details – DMI (Command Line
Option -dm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
Page xiv
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-88
Exit Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-88
About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-88
-e (Boot Device View | Select | Disable) . . . . . . . . . . . . . . . . . . . . . . .
5-9
-h (Help). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15
One or All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
SN0054614-00 F
Page xv
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
-kl (Loopback Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
-l (Display LUN Info) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
-ls (Display Link Status). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28
-o (Output to a File) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33
-pa (Define Port Alias) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36
-s (Silent Mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-38
-v (Display Version) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-40
-vp (Virtual Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-40
Main Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Utility Header. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page xvi
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
A.2.10
Diagnostics Results – Read/Write Buffer Test (Command Line
Option -kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A-9
A.2.12
Display All Information for One or All HBAs (Command Line
Option -z). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
Main Tag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reboot Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B.8.2
Diagnostics Results – Loopback Test (Command Line
Option -kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13
B.8.3
Diagnostics Results – Read/Write Buffer Test (Command Line
Option -kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13
SN0054614-00 F
Page xvii
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
B.8.8
Display All Information for One or All HBAs (Command Line
Option -z). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-17
Page xviii
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
List of Figures
Figure
Page
Preparing to Install Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setup Status Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Tables
Table
Page
4-5
HBA Parameters Settings (NVRAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
Target/LUN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
Target Link Speed Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-39
Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-55
Template Supported Parameter Settings for QLA246x/QLE246x and
QLE256x HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
HBA Diagnostics Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62
4-10 HBA Port Statistics Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
4-11 Statistics/Link Status Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-81
Command Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Driver Settings Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13
HBA Statistics Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15
Data Pattern Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19
OnError Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21
Driver Versions Not Requiring a Loopback Connector. . . . . . . . . . . . . . . . . . . . . . . 5-21
Diagnostics Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26
Data Pattern (DP) Test Patterns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27
5-10 Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-29
5-11 HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32
Options Displayed by -z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
Options Displayed by -z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-17
Exit Code Descriptions – Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SN0054614-00 F
Page xix
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
Notes
Page xx
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Section 1
Introduction
1.1
Product Overview
The SANsurfer® FC HBA CLI tool provides a command line interface (CLI) that
lets you easily install, configure, and deploy QLogic® Fibre Channel (FC) host bus
adapters (HBAs). It also provides robust diagnostic and troubleshooting
capabilities and useful statistical information to optimize SAN performance. This
tool only configures HBAs on the local machine (where SANsurfer FC HBA CLI is
installed.)
SANsurfer FC HBA CLI is a simplified, condensed version of the SANsurfer FC
HBA Manager graphical user interface (GUI).
SANsurfer FC 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.
NOTE:
This guide uses interchangeably the terms HBA and adapter.
1.2
Guide Overview
This guide is intended for end users responsible for administration of QLogic FC
HBAs.
1.2.1
How this Guide is Organized
The SANsurfer FC HBA CLI User’s Guide is organized into the following sections
and appendices:
lists the supported QLogic HBAs and operating systems, lists the system
hardware and software requirements, and provides contact information for
technical support.
SN0054614-00 F
PRELIMINARY
1-1
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Guide Overview
S
SANsurfer FC HBA CLI: interactive and non-interactive. It also explains some
special terms used in this guide.
installing and uninstalling SANsurfer FC HBA CLI on Windows, Linux, Solaris, and
Macintosh.
and examples of the command line options used in interactive mode.
explanations and examples of the command line options used in non-interactive
mode.
of XML files created with the -x1command line option.
of XML files created with the -x2command line option.
occur while running SANsurfer FC HBA CLI in interactive mode. For each exit
code number, it provides the name and description.
that can occur while running SANsurfer FC HBA CLI in interactive mode. For each
error code number, it provides the name and description.
command line actions, arguments, and functions of the help commands.
Following the appendices are a glossary of terms used and an index that will help
you quickly find the information you need.
1.2.2
Documentation Conventions
This guide uses the following documentation conventions:
„
Text in bold font indicates a menu item, dialog box, tab, button, or check
box in the user interface. For example:
From the General Information Menu, type the number for Host
Topology.
„
„
Text in a sans serif font (Courier New) indicates CLI window text output.
For example:
The HBA already has the device selected as boot device.
Text in a bold sans serif font (Courier New) indicates user input (what you
type). For example:
1-2
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Guide Overview
A
# scli -z
„
„
Text in ALL CAPITALS usually indicates the name of a key that you press on
the keyboard. For example:
Type the number for Host Information and then press ENTER.
Italicized text indicates either a document reference, glossary term, or
emphasis. For example:
Attached Port means a QLogic HBA....
For a complete list, see the QLogic SAN Interoperability Guide.
„
„
Italicized text within angle brackets indicates user-defined variables. For
example:
# scli -k (<HBA Instance> | <HBA WWPN>)
Text shown in blue indicates a cross-reference hyperlink to a Web site or to
another section of this guide. Click the hyperlink to jump to that site or
section. For example:
firmware and product updates.
„
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
SANsurfer FC HBA CLI menu, you would select option 1to open the
General Information menu, 2to open the Host Topology menu, and 2
again to see the Save to Text File options. The following shows a
breadcrumbs example:
1: General Information ꢀ2: Host Topology ꢀ2: Save to Text File
SN0054614-00 F
PRELIMINARY
1-3
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Supported QLogic HBAs
S
1.3
Supported QLogic HBAs
SANsurfer FC HBA CLI is supported for the following QLogic HBAs:
QLA234x
QLA2xx
„
„
„
„
„
QLE2xx
QLE246x
QLA246x
„
QLE256x
1.4
Supported Operating Systems
SANsurfer FC HBA CLI is supported on the following operating systems:
„
Microsoft® Windows®
Windows 2000/SP4 Server and Advanced Server
Windows 2003 SP2 IA-32/IA-64/x64 Server and Enterprise Server
‰
‰
(SP2)
‰
‰
‰
Windows XP IA-32/x64 (SP1, 2)
Windows Vista® IA-32/x64
Windows 2008 Server IA-32/IA-64/x64
„
Linux®
‰
Red Hat® Enterprise Linux (RHEL) 3.0 IA-32, IA-64, and x86_64
Update 8, 9
‰
‰
‰
RHEL 4.0 IA-32, IA-64, and x86_64 Update 5, 6
RHEL 5.0 IA-32, IA-64, and x86_64 Update 0, 1
SuSE® Linux Enterprise Server (SLES) 8 IA-32, IA64, and x86_64
versions SP 3, 4
‰
‰
SLES 9 IA-32, IA64, and x86_64 versions SP 3, 4
SLES 10 IA-32, IA64, and x86_64 versions SP 0, 1
NOTE:
RHEL 3.0 and SLES 8 do not support 8Gb.
„
Solaris®
Solaris SPARC 2.8/9/10 (with latest patches)
‰
1-4
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
System Requirements
A
‰
Solaris x86 9/10 (with latest patches)
„
„
Apple® Macintosh®
‰
Mac OS® X 10.3.x (PowerPC® (PPC)), 10.4.x (PPC/Intel), and 1.5.x
(PPC/Intel)
VMware®
‰
VMware ESX Server 3.5
NOTE:
VMware does not support 8Gb.
NOTE:
Throughout this guide, the terms Windows, Linux, Solaris, and Macintosh
refer to all the respective supported operating systems unless otherwise
noted.
1.5
System Requirements
The hardware and software requirements for SANsurfer FC HBA CLI are
described in the following sections.
1.5.1
Hardware Requirements
The minimum hardware requirements are as follows:
„
„
Single- or multiprocessor server or workstation:
‰
Pentium® III with 450 MHz or greater for Windows 2000, Windows
Server 2003, Windows XP Professional, Linux, and Solaris.
‰
Windows Vista and Windows Server 2008—Use the minimum
requirements from Microsoft.
‰
‰
‰
Power Mac® G5 1.8 MHz or greater with 512 MB of memory.
FC devices, such as disks and RAID subsystems.
QLogic FC HBAs.
SANsurfer FC HBA CLI supports most FC devices. For a complete list of devices
that support failover, see the QLogic SAN Interoperability Guide, which you can
SN0054614-00 F
PRELIMINARY
1-5
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
System Requirements
S
NOTE:
Tape devices are shown as part of the configuration, but are not fully
supported by SANsurfer FC HBA CLI. Only persistent binding and LUN
masking are available.
„
256 MB physical RAM are required to run SANsurfer FC HBA CLI; running
with less memory can cause disk swapping (“paging” or “paging out”), which
severely affects performance.
„
„
Video card capable of 256 colors and a screen resolution of 800x600 pixels.
About 7 MB of disk space.
1.5.2
Software Requirements
The minimum software requirements are as follows:
„
„
„
QLogic drivers for your OS platform.
Administrative privileges to do management functions.
1.5.2.1
Unsupported Features
Depending on your system, not all SANsurfer FC HBA features are available.
1.5.2.1.1
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 port:
„
„
„
„
„
„
„
„
„
„
„
„
HBA parameters settings
HBA parameters restore default
Flash update from file
Flash save to file
HBA parameters update from file
HBA parameters save to file
HBA parameters update from templates
Target link speed
Boot device settings
Driver settings
HBA beacon
Target/LUN list
1-6
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Technical Support
A
1.5.2.1.2
Features Not Available When Running ioctl Module Driver
When running the input/output control (ioctl) module driver on a Linux OS, the
following features are not available:
„
„
„
„
„
Persistent binding
Selective LUN
HBA port statistics
Driver settings
Host topology
1.5.2.1.3
Features Not Available When Running Sysfs Inbox Driver
When running the Sysfs Inbox driver on a Linux OS, the following features are not
available:
„
„
„
„
„
„
„
Persistent binding
Selective LUN
HBA port statistics
Driver settings
Host topology
Link status
Loopback test
1.5.2.1.4
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:
„
„
„
„
„
„
„
HBA parameters settings
HBA parameters restore default
Flash update from file
Flash save to file
HBA parameters update from file
HBA parameters save to file
HBA parameters update from templates
1.6
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic HBA products. QLogic-direct customers may contact
QLogic Technical Support; others will be redirected to their authorized
maintenance provider.
SN0054614-00 F
PRELIMINARY
1-7
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Contact Information
S
and product updates.
1.6.1
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours excluding QLogic Observed Holidays.
1.6.2
Training
QLogic offers certification training for the technical professional for both the
may choose Electronic-based Training or schedule an intensive “hands-on”
Certification course.
troubleshooting QLogic SAN products. Upon demonstrating knowledge using live
Professional. The training professionals at QLogic may be reached by e-mail at
1.7
Contact Information
Support Headquarters
QLogic Corporation
4601 Dean Lakes Blvd.
Shakopee, MN 55379
USA
QLogic Web Site
Technical Support Web Site
Technical Support E-mail
Technical Training E-mail
North American Region
E-mail
+1 952-932-4040
+1 952-974-4910
Phone
Fax
1-8
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Contact Information
A
Europe, Middle East, and Africa Region
E-mail
Phone Numbers by Language
+353 1 6924960 – English
+353 1 6924961 – Français
+353 1 6924962 – Deutsch
+353 1 6924963 – Español
+353 1 6924964 – Português
+353 1 6924965 – Italiano
Asia Pacific Region
E-mail
Phone Numbers by Language
+63-2-885-6712 – English
+63-2-885-6713 – (Mandarin)
+63-2-885-6714 – (Japanese)
+63-2-885-6715 – (Korean)
Latin and South America Region
E-mail
Phone Numbers by Language
+52 55 5278 7016 – English
+52 55 5278 7017 – Español
+52 55 5278 7015 – Português
SN0054614-00 F
PRELIMINARY
1-9
Download from Www.Somanuals.com. All Manuals Search And Download.
1 – Introduction
Contact Information
S
Notes
1-10
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Section 2
Getting Started
2.1
Introduction
SANsurfer FC HBA CLI operates in two modes:
„
Interactive (menu-driven). The CLI starts, and then waits for and executes
input commands until terminated by the user. Use this mode to do multiple
„
Non-interactive (command line). The CLI starts, does the functions defined
by the list of parameters provided, and then terminates. Use this mode to run
SANsurfer FC HBA CLI from a script file or when you want to do a single
SANsurfer FC HBA CLIis not case sensitive in either mode. However, file names
in some operating systems are case sensitive; in this case, SANsurfer FC HBA
CLI is case sensitive for that specific file.
2.2
Starting Interactive Mode
To start SANsurfer FC HBA CLI in interactive mode, use one of these methods:
„
„
For Windows, click the SANsurfer FC CLI icon on the desktop.
For Linux or Solaris, open a command window and type:
scli INT
– Or –
scli
NOTE:
When starting SANsurfer FC HBA CLI from a Solaris console serial port
connection, the CLI may take a long time to come up. To resolve this issue,
specify the INTflag, as shown in the preceding bullet.
„
For Mac OS X, follow these steps:
1.
2.
Double-click the SANsurfer FC HBA CLI (SCLI) icon.
A terminal window opens. SCLI (interactive mode) scans the host for
QLogic HBAs and SAN storage.
SN0054614-00 F
PRELIMINARY
2-1
Download from Www.Somanuals.com. All Manuals Search And Download.
2 – Getting Started
Starting Interactive Mode
S
3.
4.
Run SCLI commands as required.
When finished, return to the main menu, and type the indicated
number to quit SANsurfer FC HBA CLI.
5.
Close the terminal window.
The Main Menu appears as shown in the following:
SANsurfer FC 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
6: Target Persistent Bindings
7: Selective LUNs
8: Boot Device
or 5: iiDMA Settings
9: Driver Settings
10: Utilities
11: Beacon
12: Diagnostics
13: Statistics
14: Help
15: Exit
or 14: Virtual(if available)
or 15: Help
or 16: Exit
NOTE:
The Virtual menu is available only on Windows systems running with a
driver that supports NPIV (N_Port ID Virtualization).
Depending on which menu you select, may prompt you for more input. For
example, if you select HBA Parameters, SANsurfer FC HBA CLI prompts you for
the port number that corresponds to the HBA model you want to view.
NOTES:
„ The Driver Update option under Utilities (option 10) is only available on
Windows.
„ In Solaris SPARC, the option to Save/Update BIOS is Save/Update
FCode.
2-2
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
2 – Getting Started
Starting Non-interactive Mode
A
2.3
Starting Non-interactive Mode
To start SANsurfer FC HBA CLI in non-interactive mode, type the following in a
command window:
scli <Parameters>
SANsurfer FC HBA CLI executes the command options, then terminates.
To list all of the available command line parameters and the SANsurfer FC HBA
CLI version, type the following:
scli -h
– Or –
scli -?
In Solaris SPARC, include double quotes around the view option (?) if the system
is running with a csh or tsch shell. For example:
# scli -e 0 "?"
For world wide node name (WWNN), world wide port name (WWPN), and port ID
parameter inputs, SANsurfer FC HBA CLI accepts the notation with and without
the dash (–). Hexadecimal values can be uppercase or lowercase.
The following input formats are 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 menu selection in interactive mode.
SN0054614-00 F
PRELIMINARY
2-3
Download from Www.Somanuals.com. All Manuals Search And Download.
2 – Getting Started
Starting Non-interactive Mode
S
.
Table 2-1. Non-interactive Mode Options
Interactive Menu
Interactive
Interactive
CLI
(Red Hat/SuSE
Menu
Menu
Description
Section
Option
(Windows)
Linux, Solaris
SPARC)
(Macintosh)
-a
-b
11
10
11
11
—
Flash HBA beacon
Save/update BIOS/FCodea
10
b
-c
2
2
2
Show HBA settings
Update driver
—
-d
10
12
8
—
12
8
10
12
8
-dM
-e
Transceiver details
Boot device settings
Input from a file
-f
—
9
—
9
—
9
-fg
-fs
—
View Driver Settings
Driver Settings
9
9
9
10
1
10
1
10
1
HBA Utilities
-g
Show system information
HBA Statistics
-gs
13
13
13
-h
-?
14
14
14
14
14
14
Show usage
Show usage
-ha
-i
2
2
2
HBA alias
2
2
2
Show HBA information
Loopback test
-kl
-kr
-l
12
12
4
12
12
4
12
12
4
Read/write buffer test
Show LUN list
-ls
-m
13
7
13
7
13
7
Show Link Status
Selective LUNs
-n
3
3
3
Configure HBA settings
Output to a file
-o
1
1
1
-P
6
6
6
Target persistent binding
HBA port alias
-pa
2
2
2
2-4
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
2 – Getting Started
Starting Non-interactive Mode
A
Table 2-1. Non-interactive Mode Options (Continued)
Interactive Menu
(Red Hat/SuSE
Linux, Solaris
SPARC)
Interactive
Menu
(Windows)
Interactive
Menu
(Macintosh)
CLI
Option
Description
Section
-q
-r
—
5
5
5
Target link speed
Save/update NVRAM
Refresh
—
—
—
—
1
1
1
—
—
15 (16)
15 (16)
15 (16)
Quit
—
-s
-t
-tb
-tp
-v
-x
-z
—
4
—
4
—
4
Silent mode
Show device list
Flash target beacon
Show host topology
Show version
11
1
11
1
11
1
—
1
—
1
—
1
Output in XML format
2
2
2
or all HBAs
a Windows, Linux, Solaris x86
b Solaris SPARC
Options that have a corresponding menu selection cannot be combined. That is,
only one option is allowed in a single command. If multiple options are specified in
a command, only the first one is processed. These options, however, can be
combined with one or more options that do not have a corresponding menu
selection, with the exception of -F.
For all command line options, SANsurfer FC HBA CLI shows the following when
there are errors in the command line input:
Error <error message>
SANsurfer FC HBA CLI
v1.x.x Build xx
Copyright 2003-2007 QLogic Corp.
All rights reserved.
Command Line QLogic FC Host Bus Adapters
description of command entered
Usage: <current command use usage>
SN0054614-00 F
PRELIMINARY
2-5
Download from Www.Somanuals.com. All Manuals Search And Download.
2 – Getting Started
Terminology
S
2.4
Terminology
Some of the terms used in this guide are similar and some have changed slightly
as technology changes. The following definitions apply:
HBA Port
HBA Port refers to the actual physical port on an HBA. For example, a
QLA2462 has two ports called HBA port 1 and HBA port 2.
HBA Instance, HBA Instance number, or HBA Port Instance
When you install HBA in a system with other HBAs, each HBA port gets
assigned a number by the driver or API so it knows which HBA to
communicate with. This assigned number might be called HBA Instance, HBA
instance number, or HBA Port Instance.
HBA Alias
When an alias is assigned to a physical HBA, no matter how many ports that
HBA has, the HBA Alias refers to the HBA, not one of its ports.
Port Alias
You can also assign an alias to an individual port on an HBA. This Port Alias
refers to only that port and none other.
Thus, an HBA can only have one HBA Alias, but each port on that HBA must,
have a unique Port Alias.
2-6
PRELIMINARY
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Section 3
Initial Installation
Before you run SANsurfer FC HBA CLI, ensure that the following requirements
are met:
„
„
The HBAs must be installed.
The HBA drivers must be installed.
NOTES:
Some SANsurfer FC HBA CLI features are not available when:
„ You have a Solaris system that is running with the driver distributed with
the OS installation CDs (QLC driver).
„ You have a Linux system that is running with the ioctl or sysfs (inbox)
driver.
„ You have a Linux system that is running with a VMware driver.
3.1
Downloading the Installation Package
To download the SANsurfer FC HBA CLI installation package from the QLogic
Web site, follow these steps:
1.
left).
2.
On the Drivers Downloads / Manuals page, click your HBA model.
The Resources page for the selected model appears.
3.
4.
5.
6.
Under Drivers, Management Tools and API Libraries, click the
appropriate operating system.
In the Management Tools table, go to the SANsurfer CLI … row and in the
Download column, click (Download).
The system shows the End User License Agreement box. Scroll to the
bottom and click Agree.
Click Save. Select a directory on your system and download the file.
SN0054614-00 F
3-1
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
S
3.2
Installing SANsurfer FC HBA CLI
Follow the installation instructions in the section that corresponds to your
operating system (OS):
„
„
„
„
3.2.1
Windows Installation
To install SANsurfer FC HBA CL on Windows, follow either the GUI or command
line installation steps:
„
„
3.2.1.1
Standard (GUI) Installation
To install SANsurfer FC HBA CLI on a Windows operating system, follow these
steps:
1. Locate and double-click the installer package. The Preparing to Install
installation package is loading.
Figure 3-1 Preparing to Install Dialog Box
After the install package is loaded, the Welcome dialog box appears as
3-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
A
Figure 3-2 Welcome Dialog Box
2.
Read the information, and then click Next.
The Choose Destination Location dialog box appears as shown in
Figure 3-3 Choose Destination Location 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
SN0054614-00 F
3-3
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
S
‰
To select a different location:
a.
b.
c.
Click Browse.
Select an installation location.
The Choose Destination Location dialog box reappears. Click
Next.
The Ready to Install the Program dialog box appears as shown in
Figure 3-4 Ready to Install the Program Dialog Box
4.
Read the information, and then click Install.
Figure 3-5 Setup Status Dialog Box
3-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
A
If you want to stop the installation, click Cancel.
The InstallShield Wizard Complete dialog box appears as shown in
Figure 3-6 InstallShield Wizard Complete DIalog Box
5.
6.
(Optional.) Select one of the following:
„
If you want to see more information about SANsurfer FC HBA CLI,
select the I would like to view the README file check box.
„
If you want to start SANsurfer FC HBA CLI, select the I would like to
launch SANsurfer FC CLI check box.
Click Finish.
3.2.1.2
Command Line Installation
To install SANsurfer FC HBA CLI using the command line installation, follow the
steps for either standard or silent installation:
„
„
Standard installation—See section 3.2.1.2.1
Silent installation—See section 3.2.1.2.2
3.2.1.2.1
Standard Command Line Installation
Type the following text for a standard installation of SANsurfer FC HBA CLI on a
Windows operating system, where xxindicates the version of SANsurfer FC HBA
CLI:
scli-1.x.x.xx.windows.exe
SN0054614-00 F
3-5
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
S
By default, SANsurfer FC HBA CLI is installed in the following directory:
Program files\QLogic Corporation\SANsurferCLI
If you want to change the default location, enter the directory in the command line;
for example:
scli-1.x.x-xx.windows.exe installdir="c:\sansurfercli"
3.2.1.2.2
Silent Command Line Installation
The command for a silent installation is the same as for a standard installation
(see section 3.2.1.2.1), with the addition of the command parameters listed in
Table 3-2. Windows Command Line Installation Parameters
Parameter
/r
Meaning
Record modea
Description
To run the SANsurfer FC HBA CLI installation package in
silent mode, first run scli-1.x.x-xx.windows.exewith
the /rparameter 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 alternative response
file name and location, use the /f1parameter.
/s
Silent mode
For an InstallScript MSI or InstallScript project, the command
scli-1.x.x-xx.windows.exe /sruns the installation in
silent mode, based on the responses contained in the
Setup.iss file, located in the same directory. (Response files
are created by running Setup.exe with the /roption). To
specify an alternative file name or location of the response
file, use the /f1parameter.
/f1
/f2
Specify alternative
response file namea
This parameter allows you to specify the name and location
of the response file.
The /f1parameter is available when creating a response
file (with the /roption) and when using a response file (with
the /soption).
Specify alternative log
file namea
When running an InstallScript MSI or InstallScript installation
in silent mode (using the /sparameter), the log file
Setup.log is created in the same directory and with the same
name (except for the extension) as the response file. The
/f2parameter allows you to specify an alternative log file
location and file name.
a
InstallScript and InstallScript MSI projects only.
3-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
A
To create a response file for a silent installation of SANsurfer FC HBA CLI, enter
the following:
scli-1.x.x-xx.windows.exe /r /f1"C:\Temp\install_1.iss"
To run the installation in silent mode with a log file, enter the following:
scli-1.x.x-xx.windows.exe /s /f1"C:\Temp\install_2.iss"
To run the installation in silent mode with an alternate file in a temporary directory,
enter the following:
scli-1.x.x-xx.windows.exe /s /f1"C:\Temp\install_1.iss"
/f2"C:\Temp\install_3.log"
NOTE:
After installing SANsurfer FC HBA CLI, you can create an uninstallation
script for future use by creating a response file with a different name. For
example:
scli-1.x.x-xx.windows.exe /r /f1"C:\Temp\uninstall.iss"
3.2.2
Linux Installation
To install SANsurfer FC HBA CLI on a Red Hat/SuSE Linux operating system,
follow these steps:
1.
Download the scli-x.xx.xx-xx.i386.rpm.gzfile (from the QLogic
Web site or the FC HBA Manager CD-ROM) to your local machine. In the file
name, x.xx.xxstands for the current version of SANsurfer FC HBA CLI.
2.
3.
Uncompress the file with the following command:
gunzip <file name>
Enter the following command to install the package:
rpm -iv scli-x.xx.xx-xx.i386.rpm
NOTE:
For SuSE SLES IA64, the command line is:
rpm --iv scli-x.xx.xx-xx.ia64.rpm --nodeps
The new package is installed in the following directory:
/opt/QLogic_Corporation/SANsurferCLI
SN0054614-00 F
3-7
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
S
To query for the installed SANsurfer FC HBA CLI package name, enter the
following text from the command line:
rpm -q scli
3.2.3
Solaris Installation
To install SANsurfer FC HBA CLI on Solaris, follow the steps in one of these
sections:
„
„
3.2.3.1
Solaris SPARC 8, 9, 10 Installation
Follow these steps to install SANsurfer FC HBA CLI on a Solaris SPARC 8, 9, or
10 operating system:
1. Download the scli-x.xx.xx-xx.sparc.Solaris.pkgfile (from the
QLogic Web site or the FC HBA Manager CD-ROM) to a temporary directory
on your machine. For example:
/tmp
NOTE:
In the file name, x.xx.xx-xx stands for the current version of SANsurfer
FC HBA CLI. The -xx stands for the build version.
2.
To see the available package file, type the following:
# ls
The available packages appear. For example:
# scli-x.xx.xx-xx.sparc.Solaris.pkg
3.
4.
To install SANsurfer FC HBA CLI, type the following:
# pkgadd -d scli-x.xx.xx-xx.sparc.Solaris.pkg
You are prompted to select a package. For example:
The following packages are available:
1 QLScli QLogic SANsurfer FC HBA CLI (HBA Configuration Utility)
(sparc) x.xx.xx Build xx
Select package(s) you wish to process (or 'all' to process all
packages). (default: all) [?,??,q]:
Enter 1 to proceed with the installation.
3-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
A
5.
The pkgadd program does a series of checks, and then posts a script
warning and asks whether to continue the installation. For example:
Processing package instance <QLScli> from
</space/chuynh/scli/qlogic/Solaris/pkgs/x>
QLogic SANsurfer FC 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 packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with
super-user permission during the process of installing this
package.
Do you want to continue with the installation of <QLScli>
[y,n,?]
To continue, type y, then press ENTER.
6.
Messages appear showing what files have been installed. The system
shows a final message when installation is complete. For example:
Installing QLogic SANsurfer FC CLI (HBA Configuration Utility)
as <QLScli>
## Installing part 1 of 1.
/opt/QLogic_Corporation/SANsurferCLI/adapters.properties
/opt/QLogic_Corporation/SANsurferCLI/libs/libqlsdm.so
/opt/QLogic_Corporation/SANsurferCLI/menu.properties
/opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2
2.dat
/opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2
3.dat
. . .
Installation of <QLScli> was successful.
3.2.3.2
Solaris x86 9 and 10 Installation
To install SANsurfer FC HBA CLI on a Solaris x86 9 or 10 operating system, follow
these steps:
1. Download the scli-x.xx.xx-xx.x86.Solaris.pkgfile (from the
QLogic Web site or the FC HBA Manager CD-ROM) to a temporary directory
on your machine. For example:
/tmp
SN0054614-00 F
3-9
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
S
NOTE:
In the file name, x.xx.xx-xx stands for the current version of SANsurfer
FC HBA CLI. The -xx stands for the build version.
2.
3.
To uncompress the file, type the following:
# uncompress scli-x.xx.xx-xx.x86.Solaris.pkg
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.
5.
To install SANsurfer FC HBA CLI, type the following:
# pkgadd -d scli-x.xx.xx-xx.SPARC-X86.Solaris.pkg
You are prompted to select a package. For example:
The following packages are available:
1 QLSclix QLogic SANsurfer FC HBA CLI (HBA Configuration Utility)
(i386) x.xx.xx Build xx
Select package(s) you wish to process (or 'all' to process all
packages). (default: all) [?,??,q]: q
Enter 1 to proceed the installation.
6.
Type the number that corresponds to your operating system, and then press
ENTER.
The pkgadd program does a series of checks, posts a script warning, and
asks whether to continue the installation. For example:
Processing package instance <QLSclix> from
</space/chuynh/scli/qlogic/Solaris/pkgs/x>
SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc)
1.xx.xx (Build xx Solaris 8-10)
QLogic Corporation
## Executing checkinstall script.
## Processing package information.
## Processing system information. 3 package pathnames are
already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
.
.
3-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Installing SANsurfer FC HBA CLI
A
.
[ verifying class <none>]
## Executing postinatall script.
Installation of <QLSclix> was successful.
3.2.4
Macintosh Installation
To install SANsurfer FC HBA CLI, follow either the standard GUI or command line
installation method:
„
„
3.2.4.1
Standard (GUI) Installation
Follow these steps to install SANsurfer FC HBA CLI on a Macintosh:
1.
You must have Admin privileges to install SANsurfer FC HBA CLI. To
verify/enable Admin privileges, go to System Preferences, select Account,
and then Security Tab. Make sure the Allow user to administer this
computer check box is selected.
2.
3.
Download the SCLI zipfile with Safari™ or other browser.
When the download has finished, StuffIt® expands the zipfile to a tarfile
onto the desktop.
4.
5.
6.
Double-click the SCLI tarfile icon to create the SCLI pkgfile.
Double-click the SCLI pkgfile icon.
Follow the Installer menu.
The installation directory is:
$HOME/Applications/QLogic_Corporation/SANsurferCLI
where $HOMEis Root.
7.
After the installation process has finished, you can delete the SCLI pkgand
tarfiles.
3.2.4.2
Command Line Installation
To install SANsurfer FC HBA CLI on a Macintosh, follow these steps:
1.
2.
Download the SCLI install package for Mac OS x (compressed tar file) to a
local directory.
Uncompress the file by typing the following command:
SN0054614-00 F
3-11
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Uninstalling SANsurfer FC HBA CLI
S
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/Contents/Archive.bom
./scli-x.x.x-x.pkg/Contents/Archive.pax.gz
...
...
This command extracts the compressed file to a directory named
scli-x.x.x-x.pkg.
3.
Install the package to the default directory. For example:
installer -pkg scli-x.x.x-x.pkg -target /
This command installs the product in the default Applicationsdirectory:
/var/root/Applications/QLogic_Corporation/SANsurferCLI
If this is the first time you are installing SANsurfer FC HBA CLI, the system shows
the following messages:
qlogic:~ root# installer -pkg scli-x.x.x-x.pkg -target /
installer: Package name is SANsurfer FC HBA CLI x.x.x Build x
installer: Installing onto volume mounted at /.
installer: The install was successful.
If there is a previous version of SANsurfer FC HBA CLI on the system, the installer
automatically runs an update operation. For example:
qlogic:~ root# installer -pkg scli-x.x.x-x.pkg -target /
installer: Package name is SANsurfer FC HBA CLI x.x.x Build x
installer: Upgrading volume mounted at /.
installer: The upgrade was successful.
3.3
Uninstalling SANsurfer FC HBA CLI
Refer to the following sections for the appropriate procedure to uninstall
SANsurfer FC HBA CLI from your system:
„
„
„
„
3-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Uninstalling SANsurfer FC HBA CLI
A
3.3.1
Windows Uninstall
To uninstall SANsurfer FC HBA CLI, use either the standard GUI or command line
method:
„
„
Standard (GUI) uninstall—See section 3.3.1.1
Command line uninstall—See section 3.3.1.2
3.3.1.1
Standard (GUI) Uninstall
To uninstall SANsurfer FC HBA CLI using the GUI, do the following steps:
1.
2.
3.
From the Control Panel, click Add or Remove Programs.
Highlight SANsurfer FC HBA CLI.
Click Remove. No re-boot is required.
Alternately, invoke scli-1.x.x-xx.windows.exeand select the option to
Remove all installed features.
3.3.1.2
Command Line Uninstall
To uninstall SANsurfer FC HBA CLI using the command line, type the following:
scli-1.x.x-x.windows.exe /uninst /s
If you created an uninstall script in section 3.2.1.2.2, you can uninstall SANsurfer
FC HBA CLI in silent mode by type the following:
scli-1.x.x-x.windows.exe /s /f1”C:\Temp\uninstall.iss"
3.3.2
Linux Uninstall
To uninstall SANsurfer FC HBA CLI, go to the command line and type one of the
following commands, where x.xx.xx is the current version of CLI:
rpm -e scli-x.xx.xx-xx
rpm -e scli
To query for the installed SANsurfer FC HBA CLI package name, type the
following text from the command line:
rpm -q scli
3.3.3
Solaris Uninstall
To uninstall SANsurfer FC HBA CLI, follow one of these procedures:
SN0054614-00 F
3-13
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Uninstalling SANsurfer FC HBA CLI
S
„
„
3.3.3.1
Solaris SPARC 8, 9, and 10 Uninstall
Follow these steps to uninstall SANsurfer FC HBA CLI:
1.
Type the following to remove SANsurfer FC HBA CLI:
# 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 CLI (HBA Configuration Utility)
(sparc) 1.x.x Build xx
Do you want to remove this package?
3.
Type yand press ENTER. The program shows a script warning asking
whether to continue the uninstall process. For example:
## Removing installed package instance <QLScli>
This package contains scripts which will be executed with
super-user permission during the process of removing this
package
Do you want to continue with the removal of this package
[y,n,?,q]
4.
Type yand press ENTER. The pkgrm program notifies you when the
uninstall process is complete. For example:
## Verifying package dependencies.
## Processing package information. ...
/opt/QLogic_Corporation/SANsurferCLI/adapters.properties
/opt/QLogic_Corporation/SANsurferCLI
## Executing postremove script.
scli removed.
Menu property file removed.
Adapter property file removed.
SCLI property file removed.
## Updating system information.
Removal of <QLScli> was successful.
3.3.3.2
Solaris x86 8, 9, and 10 Uninstall
Follow these steps to uninstall SANsurfer FC HBA CLI:
1.
Type the following to remove SANsurfer FC HBA CLI:
# pkgrm QLSclix
3-14
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Uninstalling SANsurfer FC HBA CLI
A
2.
3.
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:
QLSclix QLogic SANsurfer FC CLI (HBA Configuration Utility)
(x86) 1.x.x Build xx
Do you want to remove this package?
Type yand press ENTER. The program shows a script warning asking
whether to continue the uninstall process. For example:
## Removing installed package instance <QLSclix>
This package contains scripts which will be executed with
super-user permission during the process of removing this
package
Do you want to continue with the removal of this package
[y,n,?,q]
4.
Type yand press ENTER. The pkgrm program notifies you when the
uninstall process is complete. For example:
## Verifying package dependencies.
## Processing package information.
...
/opt/QLogic_Corporation <shared pathname not removed>
/opt <shared pathname not removed>
## Executing postremove script.
scli removed.
Menu property file removed.
Adapter property file removed.
SCLI property file removed.
## Updating system information.
Removal of <QLSclix> was successful.
3.3.4
Macintosh Uninstall
Uninstalling SANsurfer FC HBA CLI is not necessary for Mac OS X; the native
installer automatically updates the product whenever it detects a change in the
product version.
To manually uninstall SANsurfer FC HBA CLI, delete its folder and any references
to the SANsurfer installer package(s) in the /Library/Receiptsdirectory. For
example:
rm -rf /Library/Receipts/scli-x.x.x-x.pkg
NOTE:
You must be in the root directory or have root/admin privileges to do this
operation.
SN0054614-00 F
3-15
Download from Www.Somanuals.com. All Manuals Search And Download.
3 – Initial Installation
Uninstalling SANsurfer FC HBA CLI
S
Notes
3-16
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Section 4
Interactive Commands
This section describes the interactive mode command line options for specific
QLogic FC HBAs. The interactive mode uses a series of menus from which you
non-interactive mode operation in which you simply enter a one- or two-letter code
to perform operations on the HBA.)
To start the interactive mode, type one of the following:
[ scli ]
[ scli int](on some Solaris installations)
When you start SANsurfer FC HBA CLI in interactive mode, the 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
15: Exit
or 14: Virtual(if available)
or 15: Help
or 16: Exit
NOTE:
Selections on the Main Menu may differ, depending on your system:
„ Selection 5: may be either Target Link Speed or iiDMA Settings.
„ The Virtual menu selection is available only on Windows systems
running with a driver that supports NPIV (N_Port ID Virtualization).
SN0054614-00 F
4-1
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
Selections from the Main Menu open new menus. For example, if you click item 1
(General Information) on the main interactive menu, the system shows a new
menu, the General Information Menu. From this menu you have several choices
including 1: Host Information, 2: Host Topology, and so forth. On every menu
you can type the number for Return to Previous Menu and move to the next
higher level (parent) menu.
In the remainder of this section, you will see a “breadcrumbs” line following most
subsection headings. The breadcrumbs line shows 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 Txt File options from the main
SANsurfer FC HBA CLI menu, you would select option 1to open the General
Information menu, 2to open the Host Topology menu, and 2again to see the
Save As Txt File options. The following shows the breadcrumbs example:
1: General Information ꢀ2: Host Topology ꢀ2: Save As Txt File
4.1
General Information Menu
(Command Line Option -g)
1: General Information
This option shows you general information for the HBA.
To see the HBA General Information menu, from the Main Menu, type the
number for the General Information option and then press ENTER.
The General Information menu contains the following options:
„
„
„
„
Host Information
Host Topology
Report
Refresh
4.1.1
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, type the number for Host Information,
and then press ENTER. Host information includes the following data:
„
„
Host name
OS type
4-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
„
„
„
OS version (patches where applicable)
SDM API version
A list of HBAs including, for each HBA:
‰
HBA model and serial number (SN)
‰
‰
‰
‰
Port number
WWPN
HBA Instance number
Status (online/offline)
‰
(Repeats for each HBA)
„
Total number of QLogic HBAs detected
NOTE:
The SAN Device Management (SDM) API is a QLogic-specific library
required for SANsurfer FC HBA CLI. The version number of this library is
useful in debugging.
------------------------------------------------------------------------------
Host Name
: BRAGI
OS Type
OS Version
SDM API Uersion
: Microsoft Windows Svr 2003 Enterprise Ed. x86
: Service Pack 1 (Build 3790
: 1.28.0.50 QLSDM.DLL
------------------------------------------------------------------------------
HBA Model QLA2342 (SN C28750):
Port 1 WWPN 21-00-00-E0-8B-01-43-9B SN B05283 (HBA Instance 0) Online
Port 2 WWPN 21-01-00-E0-8B-21-43-9B SN B05283 (HBA Instance 1) Online
HBA Model QLA2300 (SN D825408):
Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 SN D83179 (HBA Instance 2) Loop down
Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 SN D83179 (HBA Instance 3) Online
HBA Model QLA2462 (SN FFC0551C34679):
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
4.1.2
Host Topology
(Command Line Option -tp | -topology)
1: General Information ꢀ2: Host Topology
SN0054614-00 F
4-3
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
This option shows you the HBA Host Topology menu.
NOTE:
Under Linux, host topology (-tp) is disabled if you are using the ioctl or
sysfs (inbox) driver.
From the General Information Menu, type the number for Host Topology, and
then press ENTER. When you select this option, the following options appear:
„
„
„
Display
Save As Txt file
Save As XML File
4.1.2.1
Display (Host Topology)
(Command Line Option -tp | -topology)
1: General Informationꢀ2: Host Topologyꢀ1: Display
The host topology option shows information about interconnect elements
(switches or HBAs) and switch ports.
NOTE:
Attached Port means a QLogic HBA, a tape or disk target device, or GBIC
connected to a physical port on a switch.
If the interconnect element is a switch:
„
Interconnect Element (switch)
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Type (Switch or HBA)
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 HBA:
4-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
„
Interconnect element (HBA)
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Type
World wide node name
World wide port name
Vendor ID
HBA Model
HBA Serial Number
HBA Alias
Port Alias
Driver Version
Firmware Version
Total Number of Devices
Host
Number of Port
Beacon Status
Port Type
Port State
„
Port Information (repeats for each port) (Every port may not use all items):
‰
Physical Port Number (Switch or HBA port number), including:
‰
‰
‰
‰
‰
Port Name (WWPN)
Port State (Online or Loop Down)
Port Type
TX Port Type
Port Module Type
‰
Attached Port (Repeats for every Target/Initiator that functions as an
Attached Port). (Not all items may appear for every port):
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Target/Initiator
Node Name
Port Name
Vendor ID
Product ID (if applicable)
Product Revision (if applicable)
Product Serial Number (if applicable)
HBA Model (if applicable)
HBA Serial Number (if applicable)
HBA 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)
SN0054614-00 F
4-5
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
Here is an example:
=================================
= InterConnect Element
=
=================================
Type
: HBA
World Wide Node Name
World Wide Port Name
Vendor Id
: 20-00-00-E0-8B-03-55-7C
: 21-00-00-E0-8B-03-55-7C
: QLogic Corporation
HBA Model
: 2200
HBA Serial Number
HBA Alias
Port Alias
: C28437
:
:
Driver Version
Firmware Version
: SCSI Miniport 8.1.5.15 (W2K IP)
: 2.02.03
Total Number of Devices : 0
Host
: BRAGI
Number of Port
Beacon status
Port Type
: 1
: Unsupported
: L_Port
: Online
Port State
=================================
= InterConnect Element
=================================
=
Type
: Switch
World Wide Name
Domain ID
: 10-00-00-C0-DD-00-6A-9F
: 4 (0x4)
Management ID
IP Address
: 0
: 10.3.10.178
Model
:
Symbolic Name
Serial Number
MAC Address
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
Port Module Type
: Electrical - EL
: GBIC
=============================
Physical Port Number : 2
=============================
4-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
Port Name
Port state
: 20-01-00-C0-DD-00-6A-9F
: Offline
Port Type
TX Port Type
: Vendor Specific/Reserved Port Type.
: Electrical - EL
Port Module Type
========================
= Attached Port
========================
Target/Initiator
Node Name
: GBIC
=
: Target
: 20-00-00-20-37-1A-6B-CF
: 21-00-00-20-37-1A-6B-CF
: SEAGATE
Port Name
Vendor Id
Product Id
: ST136403FC
Product Revision
: FF5F
Product Serial Number : LT06464600001011HGGH
Target/Initiator
Node Name
Port Name
: Target
: 20-00-00-20-37-11-FF-EF
: 21-00-00-20-37-11-FF-EF
: SEAGATE
Vendor Id
Product Id
Product Revision
: ST118273 CLAR18
: SG1D
Product Serial Number : LP60266900001919HQ1K
. . .
=============================
Physical Port Number : 8
=============================
Port Name
: 20-07-00-C0-DD-00-6A-9F
Port state
: Offline
Port Type
TX Port Type
Port Module Type
========================
: Vendor Specific/Reserved Port Type.
: Short wave laser - SN (850nm)
: GBIC
= Attached Port
=
========================
Target/Initiator
Node Name
: ISL
: 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
HBA Alias
: C28437
:
Port Alias
:
Driver Version
Firmware Version
: SCSI Miniport 8.1.5.15 (W2K IP)
: 2.02.03
Total Number of Devices: 0
Host
: BRAGI
=================================
= InterConnect Element
=
SN0054614-00 F
4-7
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
=================================
Type
: HBA
World Wide Node Name
World Wide Port Name
Vendor Id
: 20-00-00-E0-8B-85-8C-7C
: 21-00-00-E0-8B-85-8C-7C
: QLogic Corporation
HBA Model
: QLA2462
HBA Serial Number
HBA Alias
: FFC0551D59564
:
Port Alias
:
Driver Version
Firmware Version
: STOR Miniport 9.1.0.18 (w32)
: 4.00.12
Total Number of Devices : 0
Host
: BRAGI
Number of Port
Beacon status
Port Type
: 1
: Off
: Unknown
: LinkDown
Port State
Hit <RETURN> to continue:
4.1.2.2
Save As Txt File
(Command Line Option -b)
1. General Information ꢀ2: Host Topology ꢀ2: Save As Txt File
When you save the host topology to a text file, the system responds with the file
name. For example:
Topology has been successfully saved to file
BRAGI_topology_06152007_093855.txt
4.1.2.3
Save As XML File
1: General Information ꢀ2: Host Topology ꢀ3: Save As XML File
When you choose to save the host topology to an XML file, the system responds
with the Host Topology Menu with options to:
„
„
Save as XML Format 1
Save as XML Format 2
4.1.2.3.1
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:
4-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
Topology has been successfully saved to file
BRAGI_topology_06152007_093855.xml
4.1.2.3.2
Save to XML File – Format 2
(Command Line Option -x2)
1: General Information ꢀ2: Host Topology ꢀ3: Save As XML File ꢀ2: Save As XML File format 2
The system responds with the name of the XML Format 2 file; for example:
Topology has been successfully saved to file
BRAGI_topology_06152007_093855.xml
4.1.3
Generate Report
(Command Line Option -z)
1: General Information ꢀ3: Report
The Report Menu provides the option to select an individual port instance from a
list of all HBAs or to select All HBAs.
„
HBA Model
‰
‰
‰
Port Number
Port WWPN
Port Status
4.1.3.1
Generate Report (Per HBA Port)
1: General Informationꢀ3: Reportꢀ1 - n: Port Number
If you enter the number for an HBA port instance from the list, the system shows a
variety of HBA and system information including:
„
SANsurfer FC HBA CLI header
Version and build
HBA header
‰
„
‰
‰
‰
‰
‰
Host name
OS type
OS version
SDM API version
HBA Model (Serial Number)
‰
‰
‰
‰
Port number
Port WWPN
HBA instance
Status (online/offline
SN0054614-00 F
4-9
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
„
HBA General Information
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Host Name
HBA Instance
HBA Model
HBA Description
HBA ID
HBA Alias
HBA Port
Port Alias
Node Name (WWNN)
Port Name (WWPN)
Port ID
Serial Number
Driver Version
BIOS Version (Windows and Linux)
Firmware Version
Flash BIOS Version
Flash FCode Version
Flash EFI Version
Flash Firmware Version
Actual Connection Mode
Actual Data Rate
PortType (Topology)
Target Count
PCI Bus Number (Windows and Linux)
PCI Device Number (Windows and Linux)
HBA Status (online, offline)
„
„
HBA VPD Header (Vital Product Data) Information (for QLA/QLE24xx only)
‰
‰
‰
‰
‰
HBA Instance
HBA Type
Port Number
WWPN
Port ID
The 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)
4-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
„
„
HBA Parameters Settings Header (Command Line Options -c)
‰
‰
‰
‰
‰
HBA Instance
HBA Part Number
Port Number
WWPN
Port ID
HBA Parameter Settings
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Connection Options
Data Rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xx HBAs)
Frame Size
Hard Loop ID
Loop Reset Delay (in seconds)
Enable Host HBA BIOS
Enable Hard Loop ID
Enable FC Tape Support
Operation Mode
Interrupt Delay Timer
Execution Throttle
Login Retry Count
Port Down Retry Count
Enable LIP Full Login
Link Down Timeout (in seconds)
Enable Target Reset
LUNs Per Target
Enable Receive Out Of Order Frame
„
„
Driver Settings Information Header (Command Line Options -fg)
‰
‰
‰
‰
‰
HBA Instance
HBA Part Number
Port Number
WWPN
Port ID
Driver Settings (repeats for each HBA Instance)
‰
Driver Settings - Group: Persistent
‰
‰
Persistently bound Plus New targets
Persistently bound targets only
‰
Driver Settings - Group: Binding
‰
‰
Bind by WWPN
Bind by Port ID
„
Device/LUNs Information Header (Repeats for each HBA Instance)
‰
HBA Instance
SN0054614-00 F
4-11
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
‰
‰
‰
‰
HBA Part Number
Port Number
WWPN
PORT ID
„
Device/LUNs Information (Repeats for each LUN)
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Path
Target
Device ID
Product Vendor
Product ID
Product Revision
Serial number
Node name
Port Name
Port ID
Product Type
LUN count(s)
Status
„
LUN N (Repeats for each LUN)
‰
‰
‰
‰
‰
‰
‰
Product Vendor
Product ID
Product revision
LUN
Size
Type
WWULN
„
„
„
Selective LUN Information Header (repeats for each selective LUN)
‰
‰
‰
‰
‰
HBA Instance
HBA Part Number
Port Number
WWPN
Port ID
Selective LUN Information
‰
‰
‰
‰
‰
Device Vendor ID
Device Product ID
Serial Number
Device Port Name
Device Port ID
Boot Device Settings
‰
‰
Selectable Boot
Primary Boot Port Name
4-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
‰
‰
‰
‰
‰
‰
‰
Primary Boot Port Address
Alternate 1 Boot Port Name
Alternate 1 Boot Port Address
Alternate 2 Boot Port Name
Alternate 2 Boot Port Address
Alternate 3 Boot Port Name
Alternate 3 Boot Port Address
An example follows:
SANsurfer FC HBA CLI
v1.7.1 Build 9
Copyright (C) 2003-2007 QLogic Corp.
All rights reserved.
Command Line QLogic FC Host Bus Adapters
Build Type: Release
Build Date: 10/25/2007 5:18:58 PM
------------------------------------------------------------------------------
Host Name
: BRAGI
OS Type
OS Version
SDM API Version
: Microsoft Windows Server 2003 Enterprise Edition x86
: Service Pack 1 (Build 3790)
: 1.28.0.50 QLSDM.DLL
------------------------------------------------------------------------------
HBA Model 2200 (SN C28437):
Port 1 WWPN 21-00-00-E0-8B-03-55-7C (HBA instance 0) Online
Port 2 WWPN 21-01-00-E0-8B-23-55-7C (HBA instance 1) Online
HBA Model QLA2300 (SN D83179):
Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 (HBA instance 2) Online
Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 (HBA instance 3) Online
HBA 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 2007
------------------------------------------------------------------------------
HBA General Information
------------------------------------------------------------------------------
------------------------------------------------------------------------------
Host Name
HBA Instance
HBA Model
HBA Description
HBA ID
: BRAGI
: 1
: 2200
: QLA2200 /02/12/04 QLA2202FS QCP2202
: 1-2200
HBA Alias
HBA Port
:
: 2
Port Alias
Node Name
:
: 20-00-00-E0-8B-03-55-7C
SN0054614-00 F
4-13
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
Port Name
: 21-01-00-E0-8B-23-55-7C
Port ID
: 11-06-00
Serial Number
Driver Version
BIOS Version
: C28437
: SCSI Miniport 8.1.5.15 (W2K IP)
: 1.83
Firmware Version
Actual Connection Mode
Actual Data Rate
PortType (Topology)
Target Count
: 2.02.03
: Point to Point
: 1 Gbps
: NPort
: 2
PCI Bus Number
PCI Device Number
HBA Status
: 1
: 5
: Online
------------------------------------------------------------------------------
HBA VPD Information
------------------------------------------------------------------------------
Feature is not supported with selected HBA (Instance 1 - 2200)!
------------------------------------------------------------------------------
HBA Parameters Settings
------------------------------------------------------------------------------
------------------------------------------------------------------------------
HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00
------------------------------------------------------------------------------
Connection Options
Frame Size
Hard Loop ID
: 3 - Point-to-Point, Otherwise Loop
: 1024
: 0
Loop Reset Delay (seconds)
Enable Host HBA BIOS
Enable Hard Loop ID
Enable FC Tape Support
Execution Throttle
Login Retry Count
: 5
: Disabled
: Disabled
: Enabled
: 16
: 8
Enable LIP Reset
: Disabled
: 30
: Enabled
: 0
: Enabled
: 8
Port Down Retry Count
Enable LIP Full Login
Link Down Timeout (seconds)
Enable Target Reset
LUNs Per Target
------------------------------------------------------------------------------
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 persistently bound plus any new target(s) : Enable
4-14
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
A
Present targets that are persistently bound Only
--------------------------------
: Disable
Driver Settings - Group: Binding
--------------------------------
Bind by World Wide Port Name
Bind by Port ID
: Enable
: Disable
------------------------------------------------------------------------------
Devices/LUNs Information
------------------------------------------------------------------------------
------------------------------------------------------------------------------
HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00
------------------------------------------------------------------------------
Path
: 0
Target
: 0
Device ID
Product Vendor
Product ID
Product Revision
Serial Number
Node Name
Port Name
Port ID
: 0x82
: SEAGATE
: ST136403FC
: FF5F
: LT06464600001011HGGH
: 20-00-00-20-37-1A-6B-CF
: 21-00-00-20-37-1A-6B-CF
: 11-01-E4
Product Type
LUN Count(s)
Status
: Disk
: 1
: Online
------------------------------------------------------------
---------------------------------------
LUN 0
---------------------------------------
Product Vendor
Product ID
Product Revision
LUN
: SEAGATE
: ST136403FC
: FF5F
: 0
Size
: 33.92 GB
Type
: SBC-2 Direct access block device
(e.g., magnetic disk)
: 20-00-00-20-37-1A-6B-CF
WWULN
------------------------------------------------------------
------------------------------------------------------------------------------
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
Product ID
Product Revision
Serial Number
Node Name
: SEAGATE
: ST118273 CLAR18
: SG1D
: LP60266900001919HQ1K
: 20-00-00-20-37-11-FF-EF
: 21-00-00-20-37-11-FF-EF
: 11-01-E8
Port Name
Port ID
Product Type
: Disk
SN0054614-00 F
4-15
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
General Information Menu (Command Line Option -g)
S
LUN Count(s)
Status
: 1
: Online
------------------------------------------------------------
---------------------------------------
LUN 0
---------------------------------------
Product Vendor
Product ID
Product Revision
LUN
: SEAGATE
: ST118273 CLAR18
: SG1D
: 0
Size
: 16.95 GB
Type
: SBC-2 Direct access block device
(e.g., magnetic disk)
: 20-00-00-20-37-11-FF-EF
WWULN
------------------------------------------------------------
------------------------------------------------------------------------------
Target Persistent Binding Information
No target persistent binding configuration on HBA instance 1 (WWPN 21-01-00-E0-8
B-23-55-7C).
------------------------------------------------------------------------------
Selective LUNs Information
------------------------------------------------------------------------------
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: 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
: LP60266900001919HQ1K
Device Port Name : 21-00-00-20-37-11-FF-EF
Device Port ID : 11-01-E8
------------------------------------------------------------------------------
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
------------------------------------------------------------------------------
Boot Device Settings:
---------------------------------------
Selectable Boot: Disabled
---------------------------------------
4-16
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Information Menu (Command Line Option -i)
A
(Primary
----------------------------
00-00-00-00-00-00-00-00
) Boot Port Name
LUN
------
0
----------------------------
(Alternate 1) Boot Port Name
----------------------------
00-00-00-00-00-00-00-00
------
LUN
------
0
----------------------------
(Alternate 2) Boot Port Name
----------------------------
00-00-00-00-00-00-00-00
------
LUN
------
0
----------------------------
(Alternate 3) Boot Port Name
----------------------------
00-00-00-00-00-00-00-00
------
LUN
------
0
Finish in 1 second(s)...
Hit <RETURN> to continue:
4.1.3.2
Generate Report (All HBAs)
(Command Line Option -z)
1: General Information ꢀ3: Report ꢀ4_N: All HBAs
in which data repeats for every HBA.
4.1.4
Refresh
1: General Information ꢀ4: Refresh
This selection returns the option to refresh the configuration for the current host.
4.2
HBA Information Menu
(Command Line Option -i)
2: HBA Information
This command shows the HBA Information Menu that includes list of all detected
HBAs and their ports, as well as the options to view all HBAs and to return to the
previous menu.
„
HBA Model QLxnnnn
1. Port information
‰
‰
‰
‰
Port number
WWPN
Status
SN0054614-00 F
4-17
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Information Menu (Command Line Option -i)
S
‰
[additional port(s) as appropriate]
„
„
Additional HBAs (as appropriate)
All HBAs
Here is an example of a typical HBA Information Menu screen. In this example,
the host includes three HBAs with two ports each:
HBA Model 2200:
1: Port 1: WWPN: 21-00-00-E0-8B-03-55-7C Online
2: Port 2: WWPN: 21-01-00-E0-8B-23-55-7C Online
HBA Model QLA2300:
3: Port 1: WWPN: 21-00-00-E0-8B-05-CB-D8 Online
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-85-8C-7C Loop down
6: Port 2: WWPN: 21-01-00-E0-8B-A5-8C-7C Online
7: All HBAs
8: Return to Previous Menu
4.2.1
HBA General Information (per HBA Port)
2: HBA Information ꢀ1 - n: Port Number
When you select one of the HBAs by number, this option shows the HBA
Information Menu for that HBA port. The menu includes:
„
„
„
„
Information
HBA Alias
HBA Port Alias
VPD
4.2.1.1
HBA Information
(Command Line Option -i)
2: HBA Information ꢀn: Port Number ꢀ1: HBA Information
This option produces the same HBA Information Menu available from the
4.2.1.2
HBA Alias
(Command Line Option -ha)
2: HBA Information ꢀn: Port Number ꢀ2: HBA Alias
When you select this option, SANsurfer FC HBA CLI shows the following
information about the HBA:
4-18
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Information Menu (Command Line Option -i)
A
„
„
„
„
HBA Model
WWNN
Serial number
Alias
With this option you can create, modify, or delete the symbolic name or alias, for
an HBA.
From the Main Menu, follow these steps:
1.
2.
3.
Type the number for the HBA Information option and press ENTER.
Type the number for the HBA you want to configure and press ENTER.
Type the number for the HBA Alias option and press ENTER.
The HBA Alias menu appears:
N: HBA Model: QLnnnn
Port n WWPN: nn-nn-nn-nn-nn-nn-nn-nn
Serial Number: XXXXnnnnnnnnn
Port Alias: (If the HBA already has an alias, it appears; otherwise,
blank.)
4.
5.
Type the number for the HBA model and press ENTER.
Create, modify, or delete the HBA alias as follows:
a.
To create or modify an the HBA alias, type a symbolic name (maximum
100 characters) at the HBA Alias prompt and then press ENTER.
b.
To delete an existing HBA alias, leave the HBA Alias field empty and
press ENTER.
Here is an example of the HBA Alias option.
HBA Alias Menu
1: HBA Model: QLA2462
WWNN: xx-xx-xx-xx-xx-xx-xx-xx
Serial Number: FFC0519U93213
HBA Alias: 4G Dual Port HBA
2: Cancel
Note: 0 to return to the Main Menu
Enter Selection: 1
HBA Alias:
4.2.1.3
HBA Port Alias
(Command Line Option -pa)
2: HBA Information ꢀn: Port Number ꢀ3: HBA Port Alias
SN0054614-00 F
4-19
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Information Menu (Command Line Option -i)
S
The HBA Port Alias option allows you to create, modify, or delete a symbolic name
(Alias) for the specified HBA port.
Follow these steps to create, modify, or delete an HBA port alias:
1.
From the Main Menu, type the number for the HBA Information option, and
then press ENTER.
2.
Type the number for the HBA Port for which you want to change the Port
Alias, and then press ENTER.
3.
4.
Type the number for the HBA Port Alias option, and then press ENTER.
The Port Alias Menu appears. Here is an example:
Port Alias Menu
1: HBA Model: QLA2462
WWNN: xx-xx-xx-xx-xx-xx-xx-xx
Serial Number: FFC0519U93213
Port Alias: 4G Port 1
2: Cancel
Enter 0 to return to the Main Menu
Enter Selection:
If you select a port number from the Port Alias Menu, the screen prompts you to
enter a Port Alias as follows:
Port Alias: _
„
To keep the current port alias, enter the number for Cancel and press
ENTER.
„
„
To change the port alias, type a new name and press ENTER.
To delete an existing port alias, leave the field blank and press ENTER.
4.2.1.4
HBA VPD Information
(Command Line Option -l and Reserved Word “vpd”)
2: HBA Information ꢀn: Port Number ꢀ4: VPD
With QLA/QLE24xx HBAs only, if you select option 4, the Vital Product Data
(VPD) information appears:
„
HBA instance number, model, port number, HBA port name (WWPN), and
port ID
‰
‰
‰
‰
‰
‰
Product Identifier
VPD-R tag (VPD ReadOnly field) (if available)
Part Number (HBA model)
Serial Number
Misc. Information (for example, PCI and PCI-X speeds)
Manufacturing ID
4-20
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
A
‰
‰
‰
‰
EFI Driver Version
Firmware Version
BIOS Version (Windows and Linux)
FCode Version (Solaris)
If the HBA does not support VPD, the following message appears:
VPD not supported on current HBA 6!
4.2.2
HBA Information (All HBAs)
2: HBA Information ꢀn: All HBAs
Depending on how many HBAs are in the host, the number to select this option
varies. When you select that option, the All HBAs menu shows the HBA
Information and VPD (Vital Product Data) options.
„
„
Information
VPD
4.2.2.1
Information
2: HBA Information ꢀn: All HBAs ꢀ3: Information
The Information menu shows the same HBA Information available from the
2: HBA Information ꢀn: All HBAs ꢀ3: VPD
The VPD menu shows the same Vital Product Data available from the HBA
4.3
HBA Parameters Menu
3: HBA Parameters
The HBA Parameters command shows the HBA Parameters Menu, which is
similar to the HBA Information Menu. It also includes list of all detected HBAs
and their ports, as well as the options to view all HBAs and to return to the
previous menu.
„
HBA Model QLxnnnn
‰
‰
‰
‰
‰
1. Port information
Port number
WWPN
Status
[additional port(s) as appropriate]
„
Additional HBAs (as appropriate)
SN0054614-00 F
4-21
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
S
„
All HBAs
Here is an example of an HBA Information Menu screen. In this example, the
host includes three HBAs with two ports each and one HBA with a single port:
HBA Model QLA2342:
1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online
2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online
HBA Model QLA2300:
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
Enter the number to select the HBA you want to configure or All HBAs.
4.3.1
HBA Parameters (Per HBA Port)
3: HBA Parameters ꢀn: Port Instance
The HBA Instance menu has the following options:
Display HBA Parameters
Configure HBA Parameters
„
„
„
„
Restore Defaults (4Gb and 8Gb HBAs only)
Return to Previous Menu
4.3.1.1
Display HBA Parameters
(Command Line Option -c#)
3: HBA Parameters ꢀn: Port Instance ꢀ1: Display HBA Parameters
When you select this option, the following parameters appear:
Connection Options
Data Rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xx HBAs)
„
„
„
„
„
„
„
„
„
„
Frame Size
Hard Loop ID
Loop Reset Delay (seconds)
Enable Host HBA BIOS
Enable Hard Loop ID
Enable FC Tape Support
Operation Mode
Interrupt Delay Timer (100 ms)
4-22
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
A
„
„
„
„
„
„
„
„
„
Execution Throttle
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
4.3.1.2
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
HBA parameters:
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
„
Connection Options
Data Rate
Frame Size
Hard Loop ID
Loop Reset Delay (seconds)
Enable HBA Port BIOS
Enable HBA Hard Loop ID
Enable Fibre Channel Tape Support
Operation Mode
Interrupt Delay Timer
Execution Throttle
Login Retry Count
Enable LIP Reset
Port Down Retry Count
Enable LIP Full Login (QLA/QLE23xx HBAs)
Link Down Timeout (seconds)
Enable Target Reset
LUNs per Target
Enable Receive Out Of Order Frame
Commit Changes
Abort Changes
and provides values and descriptions of each.
SN0054614-00 F
4-23
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
S
Table 4-1. HBA Parameters Settings (NVRAM)
Parameter Name
ConnectionOption
Alias
CO
Value
Description
0–3
0–4
0, 1
0, 1
0, 1
0, 1
0, 1
0, 1
0, 1
0, 1
See table note 1.
See table note 2.
DataRate
DR
EB
EL
EF
HL
FL
LP
EO
TR
ET
FR
HD
ID
LT
LR
ML
EnableBIOS
See table notes 3, 4.
See table notes 3, 4.
See table note 3.
See table note 3.
See table note 3.
See table note 3.
See table notes 3, 5.
See table note 3.
EnableExtendedLogging
EnableFCTape
EnableHardLooplD
EnableLIPFullLogin
EnableLipReset
EnableReceiveOutOfOrderFrame
EnableTargetReset
ExecutionThrottle
FrameSize
1–65535
512, 1024, 2048
0–125
HardLoopID
InterruptDelayTimer
LinkDownTimeOut
LoginReTryCount
MaximumLUNsPerTarget
0–255
0–240
0–255
0, 8, 16, 32, 64,
128, 256
OperationMode
PortDownRetryCount
ResetDelay
OM
PD
RD
0, 5, 6
0–255
0–255
See table note 6.
Table Notes:
1. Connection Options:
0 = Loop Only
1 = Point-to-point Only
2 = Loop preferred, otherwise Point-to-Point
3 = Point-to-Point, otherwise Loop (QLA22xx Only)
2. Data Rate:
0 = 1 Gbs
1 = 2 Gbs
2 = Auto
3 = 4 Gbs
4 = 8 Gbs
4-24
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
A
3. Others:
0 = Disable
1 = Enable
4. Option is not available on 4Gb or latest HBAs.
5. Option is available on 4Gb or latest HBAs.
6. Operation Modes:
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.
4.3.1.2.1
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 HBA only)
Type the number for the connection type you want and press ENTER.
4.3.1.2.2
Data Rate
3: HBA Parameters ꢀN: Port Number ꢀ 2: Configure HBA Parameters ꢀn. Data Rate
This option shows the Data Rate menu. (Note that data rate configuration is not
available for all HBA port instances.) From this menu you can select:
„
„
„
„
„
Auto
1 Gbps
2 Gbps
4 Gbps
8 Gbps
NOTE:
The 1 Gbps data rate is not supported with 8G HBAs.
Type the number for the data rate you want and press ENTER.
4.3.1.2.3
Frame Size
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Frame Size
This option shows the Frame Size menu. From it you can select:
SN0054614-00 F
4-25
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
S
„
„
„
Frame Size: 512
Frame Size: 1024
Frame Size: 2048
Type the number for the frame size you want and press ENTER.
4.3.1.2.4
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 press ENTER.
4.3.1.2.5
Loop Reset Delay
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Loop Reset Delay
This option prompts you to enter a Reset Delay from 0 to 255 seconds. Type the
number you want for the loop reset delay and press ENTER.
4.3.1.2.6
Enable HBA Port BIOS
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Enable HBA Port BIOS
This option allows you to enable or disable the BIOS boot setting. When this
setting is disabled, the ROM BIOS on the HBA is disabled. If you are booting from
a FC hard disk attached to the HBA, you must enable this setting. The default is
disabled.
4.3.1.2.7
Enable HBA Hard Loop ID
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Enable HBA Hard Loop ID
This choice gives you the option to enable or disable the Hard Loop ID. Type the
number you want and press ENTER.
4.3.1.2.8
Enable Fibre Channel Tape Support
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Enable Fibre Channel Tape Support
This choice gives you the option to enable or disable Fibre-Channel Tape support.
Type the number you want and press ENTER.
4-26
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
A
4.3.1.2.9
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 DelayTimer expires
Interrupt when Interrupt Delay Timer expires or no active I/O
Type the number for the Operation Mode you want and press ENTER.
4.3.1.2.10
Interrupt Delay Timer
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Interrupt Delay Timer
This choice gives you the option to set the Interrupt Delay timer to 0 to 255
seconds.
You cannot set the Interrupt Delay timer when the Operation Mode (blue) is set to
Interrupt for Every I/O Completion.
4.3.1.2.11
Execution Throttle
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Execution throttle_
This choice gives you the option to set the Execution Throttle to a value from1 to
65535.
4.3.1.2.12
Login Retry Count
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Login Retry Count
This choice gives you the option to set the Login Retry Count to a value from 0 to
255.
4.3.1.2.13
Enable LIP Reset
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Enable LIP Reset
This choice gives you the option to Enable or Disable LIP Reset.
4.3.1.2.14
Port Down Retry Count
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Port Down Retry Count
SN0054614-00 F
4-27
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
S
This choice gives you the option to set the Port Down Retry Count to a value from
0 to 255.
4.3.1.2.15
Enable 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.
4.3.1.2.16
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.
4.3.1.2.17
Enable Target Reset
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Enable Target Reset
This choice gives you the option to Enable or Disable Target Reset.
4.3.1.2.18
LUNs per Target
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. LUNs per Target
This option shows the LUNs per Target menu. From it you can select:
„
„
„
„
„
„
„
0 LUN per Target
8 LUNs per Target
16 LUNs per Target
32 LUNs per Target
64 LUNs per Target
128 LUNs per Target
256 LUNs per Target
4.3.1.2.19
Commit Changes
3: HBA Parameters ꢀN: Port Number ꢀ2: Configure HBA Parameters ꢀn. Commit changes
Choose this option to make the changes permanent.
CAUTION!
There is undo after you commit to making changes to the HBA parameters.
4-28
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
HBA Parameters Menu
A
4.3.1.2.20
Abort Changes
3: HBA Parameters ꢀN: Port Numberꢀ2: Configure HBA Parameters ꢀn: Abort changes
Choose this option to stop without making any changes.
4.3.1.3
Restore Defaults
3: HBA Parameters ꢀn: Port Number ꢀ3: Restore Defaults
This option is for 4Gb and 8Gb HBAs only. Selecting the Restore Defaults option
causes the following warning to appear:
Warning:
Please update the HBA parameters with extreme care.
Incorrectly updating the 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
update.
Do you want to proceed with the operation?
1: Yes
2: No
If you enter 1 to proceed, the system returns a message similar to the following:
Restoring default settings on HBA instance 5 - QLA2462. Please
wait...
HBA Parameters restore completed. Changes has been saved to HBA
instance 5.
You must reboot in order for the changes to become effective.
4.3.2
HBA Parameters (All HBAs)
3: HBA Parameters ꢀn: All HBAs
When you select this option, the parameters listed in “HBA Parameters (Per HBA
Port)” on page 4-22 appear for every HBA.
SN0054614-00 F
4-29
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
S
4.4
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 HBAs
and port instances detected on the host. You have the option to select:
„
„
Each HBA port individually
All HBAs
Here is an example of the Target List Menu:
HBA Model QLA2342:
1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online
2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online
HBA Model QLA2300:
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 4-2. Target/LUN Information
Variable
<address>
Description
IP Address.
<hba instance>
<hba wwnn>
Show Version.
Show usage help text.
<lun id>
Silent mode.
<target id>
<target portid>
<target wwnn>
<target wwpn>
Specifies the output in XML format 2.
Specifies the output in XML format 1.
Specifies the output to a log file.
Specifies command line input from file.
4-30
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
A
4.4.1
Target/LUN List (Per HBA Port)
4: Target/LUN List ꢀ1 - n Target List Menu - Port n
When you select an HBA Port instance from the Target/LUN List, a list of LUNs
(disks) attached to that port instance appears. Technical information for each LUN
appears, including:
„
„
„
„
„
„
„
Vendor
Product ID
Product Revision
Serial Number
Node Name
Port Name
Port ID
Here is an example of a typical menu item:
1: Disk(Online)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Node Name
Portname
: ST318453FC
: 0006
: 3JA9TN7600007517T6P1
: 20-00-00-11-C6-2D-5B-F9
: 22-00-00-11-C6-2D-5B-F9
: 02-0A-DC
Port ID
2: Disk (Online)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Node Name
Portname
Port ID
: ST318453FC
: 0006
: 3JA9TN7600007523T6P1
: 20-00-00-11-C6-2D-5B-FA
: 22-00-00-11-C6-2D-5B-FA
: 02-0A-DE
And so on.
You can select any LUN and view additional information by entering its number at
the prompt and then pressing ENTER.
4.4.1.1
Per Target/LUN
4: Target/LUN List ꢀ1 - n Target List Menu Port n ꢀ1 - n: Target
When you enter the number for an individual target, the LUN list for that target
appears. It includes a list of all LUNs on that target and the following information
for each LUN:
SN0054614-00 F
4-31
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
S
„
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
Port Name
Port ID
: ST318453FC
: 22-00-00-11-C6-2D-5B-F9
: 02-0A-DC
And so on.
M: All LUN(s)
N: Return to Previous Menu
4.4.1.2
Per Target/All LUNs
4: Target/LUN List ꢀ1 - n Target List Menu Port n ꢀ1 - n: Target ꢀ1 - n: LUN (Number)
When you select a particular LUN from the LUN list, the following information for
that LUN appears:
„
„
„
„
„
„
„
„
Product Vendor
Product ID
Product Revision
LUN
Size
Type
WWULN
OS LUN Name (on Solaris and Linux)
Here is an example of the LUN information.
Product Vendor
Product ID
Product Revision
LUN
: SEAGATE
: ST318453FC
: 0006
: 0
Size
: SBC-2 Direct Access block device
(e.g. magnetic disk)
: 20-00-00-11-C6-2D-5A-3F
WWULN
------------------------------------------------------------------
Hit <Return> to continue:
4-32
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
A
4.4.1.3
All Targets
4: Target/LUN List ꢀ1 - n Target List Menu Port n ꢀ1 - n: Target ꢀm: All LUNs
When you select a particular LUN from the LUN list, the following information for
all LUNs appears:
„
„
„
„
„
„
„
„
Product Vendor
Product ID
Product Revision
LUN
Size
Type
WWULN
OS LUN Name (on Solaris and Linux)
(Repeats for each LUN)
Here is an example of the LUN information.
Product Vendor
Product ID
Product Revision
LUN
: SEAGATE
: ST318453FC
: 0006
: 0
Size
: SBC-2 Direct Access block device
(e.g. magnetic disk)
: 20-00-00-11-C6-2D-5A-3F
WWULN
------------------------------------------------------------------
Hit <Return> to continue:
And so on. Repeats for each LUN.
4.4.2
Target/LUN List (All HBAs)
4: Target/LUN List ꢀ N: All HBAs
This choice shows the Target List Menu for All HBAs:
Individual Target
Individual LUN
„
„
„
„
All Target(s)
All LUN(s)
4.4.2.1
Individual Target
4: Target/LUN List ꢀN: All HBAs ꢀ 1: Individual Target
SN0054614-00 F
4-33
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
S
This choice shows the Target List Menu for All HBAs. Information for each
individual target includes:
„
(Target type) on QLAxxxx (HBA Instance n)
‰
‰
‰
‰
‰
‰
Vendor
Product ID
Product Revision
Serial Number
Port Name
Port ID
„
Repeats for each target
Here is an example of the Target List Menu for All HBAs:
1: Disk 0 on QLA2462 (HBA Instance 0)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
Port ID
: ST336607FC
: 0006
: 3JA9TN7600007517T6P1
: 22-00-00-11-C6-2D-5B-F9
: 02-0A-DC
1: Disk 1 on QLA2462 (HBA Instance 0)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
Port ID
: ST336607FC
: 0006
: 3JA9TN7600007517FK7W
: 22-00-00-11-C6-2D-5A-B8
: 02-0A-EO
And so on.
4.4.2.2
Individual LUN
4: Target/LUN List ꢀn: Port Number ꢀ 1: Individual LUN ꢀ 1 - n: Target
When you select an individual target, the following target information appears:
„
„
„
„
„
„
„
„
„
„
Path
Target
Device ID
Product Vendor
Product ID
Product Revision
Node Name
Port Name
Product Type
LUN Count(s)
4-34
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
A
„
Status
Here is an example of the Target information:
Path
: 0
Target
: 3
Device ID
Product Vendor
Product ID
Product Revision
Serial Number
Node Name
Port Name
Port ID
: 0x87
: SEAGATE
: ST336607FC
: 0006
: 3JA9TN7600007517T6P1
: 20-00-00-11-C6-2D-5B-F9
: 22-00-00-11-C6-2D-5B-F9
: 02-0A-DC
Product Type
LUN Count(s)
Status
: Disk
: 1
: Online
4.4.2.3
All Targets
4: Target/LUN List ꢀn: Port Number ꢀ1: Individual LUNs
When you select this option, SANsurfer FC HBA CLI shows the LUN List Menu
containing:
„
„
„
„
„
„
Product Vendor
Product ID
Port Name
Port ID
LUN ID
OS LUN Name (on Solaris and Linux)
NOTE:
„ In the Solaris OS, the QLA HBA driver supports a maximum of 256
LUNs.
„ In the Solaris OS, the QLC HBA driver supports a maximum of 16K
LUNs.
Here is an example of the LUN information:
Product Vendor
Product ID
Product Revision
LUN
: SEAGATE
: ST336607FC
: 0006
: 0
Size
: 34.18 GB
Type
: SBC-2 Direct access block device
(e.g., magnetic disk)
SN0054614-00 F
4-35
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
S
WWULN
: 20-00-00-0C-50-68-1E-9A
------------------------------------------------
Hit (RETURN) to continue:
4.4.2.4
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
Here is an example of the All Targets option.
Note: 0 to return to Main Menu
Enter Selection: 3
------------------------------------------------------------------
HBA Instance 5: QLA2300 Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 PortID 11-05-EF
------------------------------------------------------------------
Path
: 0
Target
: 0
Device ID
Product Vendor
Product ID
Product Revision
Serial Number
Node Name
Port Name
Port ID
: 0x85
: SEAGATE
: ST136403FC
: FF5F
: LT06464600001011HGGH
: 20-00-00-20-37-1A-6B-CF
: 21-00-00-20-37-1A-6B-CF
: 11-01-E4
Product Type
LUN Count(s)
Status
: Disk
: 1
: Online
---------------------------------------------------------------
And so forth.
4-36
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target/LUN List Menu (Command Line Options -t and -l)
A
4.4.2.5
All LUN(s)
4: Target/LUN List ꢀn: Port Number ꢀ3: All LUN(s)
When you select this option, SANsurfer FC HBA CLI shows the following
information about all LUNs for all HBA Port Instances:
„
„
„
„
„
„
„
„
Product Vendor
Product ID
Product Revision
LUN
Size (in GB or MB)
Type (for example, magnetic disk)
WWULN (world-wide unique LUN name)
OS LUN Name (on Solaris and Linux)
NOTE:
„ In the Solaris OS, the QLA HBA driver supports a maximum of 256
LUNs.
„ In the Solaris OS, the QLC HBA driver supports a maximum of 16K
LUNs.
Here is an example of the All LUNs information:
-------------------------------------------------------------
HBA Instance 0: QLA2462 Port 1 WWPN 21-00-00-E0-8B-1F-9D-F0 Port
ID 02-00-00
-------------------------------------------------------------
Target WWPN (22-00-00-04-CF-9C-24-CA)
-------------------------------------------------------------
Product Vendor
Product ID
Product Revision
LUN
: SEAGATE
: ST318203FC
: 0006
: 0
Size
: 34.18 GB
Type
: SBC-2 Direct access block device
(e.g., magnetic disk)
: 20-00-00-20-37-38-73-BC
WWULN
Press <Enter> to continue:
Target information repeats for each target.
Here is an example of the All LUNs information for Linux:
Product Vendor
Product ID
Product Revision
: HITACHI
: HUS103073FLF210
: FA16
SN0054614-00 F
4-37
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
S
LUN
: 0
Size
Type
: 68.37 GB
: SBC-2 Direct access block device
(e.g., magnetic disk)
: 20-00-00-00-87-72-85-B2
: /dev/sda
WWULN
OS LUN Name
Here is an example of the All LUNs information on Solaris with a QLA driver:
Product Vendor
Product ID
Product Revision
LUN
: SUN
: StorEdge 3510
: 415F
: 15
Size
: 4.88 GB
Type
: SBC-2 Direct access block device
(e.g., magnetic disk)
WWULN
: 60-0C-0F-F0-00-00-00-00-09-8B-68-37-E0-B1-
9B-04
OS LUN Name
: /dev/rdsk/c1t0d0s15
4.5
Target Link Speed or iiDMA Settings Menu
(Command Line Option -q)
5: Target Link Speed or 5: iiDMA Settings
NOTE:
Depending on your system, the SANsurfer FC HBA CLI Main Menu may
show either the Target Link Speed option or the iiDMA Settings option.
This option shows the Target Link Speed Menu or iiDMA Menu that includes a
list of all HBAs and port instances detected, including the options to select:
„
„
Each HBA port instance, individually
All HBAs
Here is an example of the Target Link Speed Menu or iiDMA Settings Menu:
HBA Model QLA2342:
1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online
2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online
HBA Model QLA2300:
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
4-38
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
A
8. All HBAs
9. Return to Previous Menu
Table 4-3. Target Link Speed Settings
Target Link Speed Settings
Description
<address>
IP Address.
<hba instance>
<hba wwnn>
HBA number (HBA instance number).
HBA World Wide Port Name, format
xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx.
<lun id>
Logical Unit Number (0–255),
Target Link Speed (iiDMA) - (1, 2, or 4 Gbs).
Target ID.
<speed>
<target id>
<target portid>
Target World Wide Port Name, format xx-xx-xx
or xxxxxx.
<target wwnn>
<target wwpn>
-targets | -t
Target World Wide Node Name, format
xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx.
Target World Wide Port Name, format
xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx.
All targets.
4.5.1
Configuring the iiDMA Settings
Use the Intelligent Interleave Factor Selection (iiDMA) menu to select the
intelligent interleave factor settings per HBA type and device.
To configure iiDMA settings:
1.
2.
From the SANsurfer FC HBA CLI main menu, select iiDMA Settings.
Select the HBA that you want to apply the Intelligent Interleave factor
update.
3.
Select one of the following options:
‰
Basic Configuration if you want to apply the Intelligent Interleave
factor update to all devices attached to this adapter.
‰
Advanced Configuration if you want to select an apply different
Intelligent Interleave factor update to each device attached to this
adapter.
SN0054614-00 F
4-39
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
S
4.
To use Basic Configuration:
a.
b.
Select the HBA.
Select the intelligent interleave factor 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:
iiDMA settings have been saved to selected target(s)
on HBA instance n.
‰
To exit iiDMA Settings without making any changes, select No.
5.
To use Advanced Configuration:
a.
b.
Select the HBA.
From the device list, select a device (disk) that is currently attached to
this HBA.
c.
From the intelligent interleave factor speed list, select the intelligent
interleave factor (1 Gbps, 2 Gbps, 4 Gbps, or 8 Gbps) that you want
to set for this device.
d.
e.
Repeat the previous step for additional devices.
Choose one of the following options:
‰
‰
To proceed, select Select the Apply changes to selected
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.
4.5.2
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 section
4.4.1.1. It includes a list of all targets attached to the selected port instance and
specific information about each target, including:
„
Target Type (for example, Disk)
‰
‰
Product Vendor
Product ID
4-40
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
A
‰
‰
‰
‰
‰
Product Revision
Serial Number
Port Name
Port ID
Max Target Link Rate
„
„
Next Target Type (for example, Disk)
Apply Changes to Selected Targets
Here is an example of the Target Link Speed Menu for all HBA Instances:
Target Link Speed Menu
HBA Instance 0 (QLA2463 Port 1) : Online
Desc: QLA2462 PCI-X 2.0 to 4Gb PC Dual Channel
1: Disk
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
Port ID
: ST318453FC
: DF12
: 3EV0NYSG000072496DYD
: 22-00-00-04-CF-9C-24-CA
: 02-00-E1
Max Target Link Rate : 4 Gbps
2: Disk
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
: ST318453FC
: 00006
: 3JA9AYSG000072496FBJ
: 22-00-00-0C-50-68-1E-9A
: 11-0A-E2
Port ID
Max Target Link Rate : 4 Gbps
m: Disk
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
: ST318453FC
: 0006
: 3JA9TQE0000724966ZK
: 22-00-00-11-C6-2D-5A-3F
: 02-0A-E4
Port ID
Max Target Link Rate : 4 Gbps
n: Apply Changes to Selected Target(s)
4.5.3
HBA Port
5: iiDMA Settings ꢀ1 - n: HBA Port n
If you select a port for HBA model QLA2462, the following information appears:
SN0054614-00 F
4-41
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
S
iiDMA Menu
HBA Instance 3 (QLA2462 Port 2) : Online
WWPN: 21-01-00-E0-8B-A5-8C-7C
Desc: QLA2462 PCI-X 2.0 to 4Gb FC Dual Channel
1: Disk
Vendor
: SEAGATE
: ST136403FC
: FF5F
: LT06464600001011HGGH
: 21-00-00-20-37-1A-6B-CF
: 11-01-E4
Product ID
Product Rev
Serial Number
Port Name
Port ID
Intelligent Interleave Factor: 4 Gbps
2: Disk
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
: ST118273 CLAR18
: SG1D
: LP60266900001919HQ1K
: 21-00-00-20-37-11-FF-EF
: 11-01-E8
Port ID
Intelligent Interleave Factor: 4 Gbps
3: Apply Changes to selected Target(s)
4: Return to Previous Menu
Note: 0 to return to Main Menu
Enter Selection:
4.5.3.1
Advanced Configuration
5: Target Link Speed ꢀn: Port Number ꢀ2: Advanced Configuration
When you select a Port Instance from the Target Link Menu, the Target Link
Speed Menu (Advanced) appears. It includes the link speed options. The options
vary according to the HBA in use. For example:
„
„
„
„
1 Gbps
2 Gbps
4Gbps
8 Gbps
Type the number for the link speed you want for the HBA Port Instance selected
and then press ENTER.
The same menu reappears, allowing you to set the link speed for every port
instance you want.
4-42
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
A
When you have set the speed for all the links you want, type the number for Apply
changes to Selected Target(s) and then press ENTER.
4.5.4
Target Link Speed – All HBAs
5: Target Link Speed ꢀ2: All HBAs
When you select this option, the Target Link Speed Menu for All HBAs appears. It
offers two options:
„
„
Basic configuration
Advanced Configuration
4.5.4.1
Target Link Speed – All HBAs – Basic Configuration
5: Target Link Speed ꢀ2: All HBAs ꢀ1: Basic Configuration
When you select this option, the Target Link Speed Menu (Basic) for All HBAs
appears. It offers the link speed options. The options vary according to the HBA in
use. For example:
„
„
„
„
1 Gbps
2 Gbps
4Gbps
8 Gbps
Respond Yes to the Proceed? prompt to apply the change to all Port Instances
on all HBAs.
4.5.4.2
Target Link Speed – All HBAs – Advanced Configuration
5: Target Link Speed ꢀ2: All HBAs ꢀ1: Advanced Configuration
This option displays the Target Link Speed Menu (Advanced) for All HBAs.
This menu lists all targets on all HBAs and shows information about each target:
„
Target Type, Target number, HBA model, and Instance
‰
‰
‰
‰
‰
‰
‰
Product vendor
Product ID
Product revision
Serial Number
Port Name
Port ID
Max Target Link Rate
„
Next Target Type, Target number, HBA model and Instance
SN0054614-00 F
4-43
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Link Speed or iiDMA Settings Menu (Command Line Option -q)
S
„
Apply Changes to Selected Targets
Here is an example of the Target Link Speed Menu (Advanced) for All HBAs:
Target Link Speed Menu (Advanced)
All HBAs
1: Disk 0 on QLA2462 (HBA Instance 0)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
Port ID
: ST318453FC
: DF12
: 3EV0NYSG000072496DYD
: 22-00-00-04-CF-9C-24-CA
: 02-00-E1
Max Target Link Rate : 4 Gbps
2: Disk 1 on QLA2462 (HBA Instance 0)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
Port ID
: ST318453FC
: 00006
: 3JA9AYSG000072496FBJ
: 22-00-00-0C-50-68-1E-9A
: 11-0A-E2
Max Target Link Rate : 4 Gbps
...
m: Disk 2 on QLA2462 (HBA Instance 1)
Vendor
: SEAGATE
Product ID
Product Rev
Serial Number
Port Name
Port ID
: ST318453FC
: 00006
: 3AJA9ALAG0000724966ZK
: 22-00-00-11-C6-2D-5A-3F
: 11-0A-E2
Max Target Link Rate : 4 Gbps
...
n: Disk
Vendor
: SEAGATE
Product ID
: ST318453FC
Product Rev
Serial Number
Port Name
: 0006
: 3JA9TQE0000724966ZK
: 22-00-00-11-C6-2D-5A-3F
: 02-0A-E4
Port ID
Max Target Link Rate : 4 Gbps
p: Apply Changes to Selected Target(s)
4.5.4.2.1
Target Link Speed – All HBAs – Advanced Configuration
5: Target Link Speed ꢀ2: All HBAs ꢀ1: Advanced Configuration ꢀ1 - n: Link speed
4-44
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Persistent Bindings Menu (Command Line Option -p)
A
When you select an HBA to set its link speed, the Target Link Speed Menu
(Advanced) menu for a particular HBA instance appears. It shows the link speed
options you can choose from. The options vary according to the HBA in use. For
example:
„
„
„
„
1 Gbps
2 Gbps
4Gbps
8 Gbps
When you set a Link Speed option for a particular (target) device the Target Link
Speed Menu (Advanced) for All HBAs reappears, allowing you to set the link
speed for another HBA Instance.
When you have set the link speed for all the instances you want to, type the
number for Apply changes to Selected Target(s) and press ENTER.
The system returns a message indicating the changes have been saved. For
example:
New iiDMA setting has been saved to seleted target(s) on HBA
instance 0.
4.5.4.3
iiDMA Settings – Disk
5: iiDMA Settings ꢀ1 - n: HBA Port n ꢀn: Disk n
When you select a specific disk on the HBA port, the following options are
available on the iiDMA Menu (Advanced):
„
„
„
1 Gps
2 Gps
4 Gps
4.5.5
iiDMA – All HBAs
5: iiDMA Settings ꢀn: All HBAs
When you select All HBAs to configure, the options for Basic Configuration and
4.6
Target Persistent Bindings Menu
(Command Line Option -p)
6: Target Persistent Bindings
SN0054614-00 F
4-45
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Persistent Bindings Menu (Command Line Option -p)
S
When you select this option, SANsurfer FC HBA CLI shows the Target
you can select an individual HBA port or All HBAs.
The following sections describe how to view, set, and delete the HBA’s target
persistent binding in interactive and non-interactive modes.
NOTES:
„ In a Solaris OS, QLA/QLE24xx and QEM2462 HBAs with a QLA driver
allow up to 2048 targets with target IDs in the range of 0–2047.
„ In a Solaris OS, QLA/QLE23xx HBAs with a QLA driver allow up to
256 targets with target IDs in the range of 0–2047.
„ Under Solaris, this feature is disabled if you are using the driver from the
OS installation CDs (QLC driver). Under Linux, this feature is disabled if
you are using the ioctl or sysfs (inbox) driver.
Whether you select a particular HBA Port Instance or All HBAs, the Target
Persistent Bindings Menu appears.
4.6.1
Target Persistent Bindings (Per HBA Port)
(Command Line Option -p)
6: Target Persistent Bindings ꢀ1 - n: Target Persistent Bindings HBA Instance n
When you select an HBA Instance to view or change its binding, this menu the
Target Persistent Bindings Menu for a particular HBA instance appears. It
shows the binding options you can choose from:
„
„
„
Display Configuration
Bind Target(s)
Unbind Target(s)
Type the number for the option you want and press ENTER.
4.6.1.1
Display Target Persistent Binding
(Command Line Option -p)
6: Target Persistent Binding ꢀ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)
Device type (Disk, for example)
4-46
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Persistent Bindings Menu (Command Line Option -p)
A
„
„
„
„
Target information (model name and number, for example)
Port Name
Port ID
Target ID
4.6.1.2
Target Persistent Bindings – Bind Target(s)
(Command Line Option -p)
6: Target Persistent Bindings ꢀ1 - n: Target Persistent Bindings HBA Instance n ꢀ2: Bind Target(s)
When you select the Bind Targets option, the Target Persistent Binding Menu
for HBA Instance n appears. This menu lists all targets on the selected HBA
Instance and shows information about each target:
„
Target Type
‰
‰
‰
‰
‰
‰
Product Vendor
Product ID
Port Name
Port ID
Bind
Target ID
„
„
Next Target (repeats)
All Targets
Here is an example of the Target Persistent Binding Menu for HBA Instance n:
Target Persistent binding Menu
HBA Instance 0
1: Disk
Vendor
: SEAGATE
Product ID
Port Name
Port ID
Bind
: ST318453FC
: 22-00-00-04-CF-9C-24-CA
: 02-00-E1
: No
:
Target ID
2: Disk
Vendor
: SEAGATE
Product ID
Port Name
Port ID
Bind
: ST318453FC
: 22-00-00-0C-50-68-1E-9A
: 11-0A-E2
: No
:
Target ID
...
m: Disk 2 on QLA2462 (HBA Instance 1)
Vendor : SEAGATE
SN0054614-00 F
4-47
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Target Persistent Bindings Menu (Command Line Option -p)
S
Product ID
Port Name
Port ID
: ST318453FC
: 22-00-00-11-C6-2D-5A-3F
: 11-0A-E2
Bind
Target ID
: No
:
...
n: Disk
Vendor
: SEAGATE
Product ID
: ST318453FC
Port Name
Port ID
Bind
: 22-00-00-11-C6-2D-5A-3F
: 02-0A-E4
: No
:
Target ID
p: All Target(s)
4.6.1.2.1
Target Persistent Binding - FC Port Configuration
(Command Line Option -p)
6: Target Persistent Binding ꢀ1 - n: Target Persistent Binding ꢀ2: Bind Target(s) ꢀ1-n: Port configuration
When you select this menu, you are prompted to enter a Target ID. The Target
Persistent Binding - FC Port configuration Menu appears and lists these
options:
„
„
„
Select More
Commit Changes
Cancel
Type the number for the option you want and press ENTER.
4.6.1.3
Target Persistent Binding – Unbind Targets
(Command Line Option -p)
6: Target Persistent Binding ꢀ1 - n: Target Persistent Binding HBA Instance n ꢀ3: Unbind Target(s)
4.6.2
Target Persistent Binding (All HBAs)
6: Target Persistent Binding ꢀp: All HBAs
When you select this option, SANsurfer FC HBA CLI shows the following options:
„
„
„
Display Configuration
Bind Target(s)
Unbind Target(s)
4-48
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Selective LUNs Menu (Command Line Option -m)
A
4.6.2.1
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)
Device type (Disk, for example)
Target information (model name and number, for example)
Port Name
Port ID
Target ID
4.6.2.2
Target Persistent Binding – Bind Targets
6: Target Persistent Binding ꢀp: All HBAs ꢀ2: Bind Targets
-p).
4.6.2.3
Target Persistent Binding – Unbind Targets
6: Target Persistent Binding ꢀp: All HBAs ꢀ3: Unbind Targets
-p).
4.7
Selective LUNs Menu
(Command Line Option -m)
7: Selective LUNs
When you select this option, SANsurfer FC HBA CLI shows the Selective LUNs
4.7.1
Selective LUNs (Per HBA Port)
7: Selective LUNs ꢀ1: - m: HBA Port Instance
When you select this option, SANsurfer FC HBA CLI shows the following options
for the HBA:
„
„
Display LUN Configuration
Manual Configure LUNs
SN0054614-00 F
4-49
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Selective LUNs Menu (Command Line Option -m)
S
„
Auto Configure LUNs
If this option 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)!
4.7.2
Selective LUNs (All HBAs)
7: Selective LUNs ꢀ1: All HBAs
When you select this option, SANsurfer FC HBA CLI shows the following options
for all HBAs:
„
„
„
Display LUN Configuration
Manual Configure LUNs
Auto Configure LUNs
4.7.2.1
Display LUN Configuration
7: Selective LUNs ꢀ1-m: Port Number ꢀ1: Display LUN Configuration
When you select the Display LUN Configuration menu, you can choose to show
either:
„
„
Details View
General View
The detailed view shows:
Selective LUN Menu (Display)
HBA Instance 5 (QLA2300 Port 2) : Online
WWPN: 21-01-00-E0-8B-25-CB-D8
Desc: QLA2302 VA-CPQ (PCI to FC dual channel) HP Appliance
1: Disk
Vendor
: SEAGATE
Product ID
Port Name
Port ID
Bind
: ST136403FC
: 21-00-00-20-37-1A-6B-CF
: 11-01-E4
: Yes
: 0
Target ID
2: Disk
Vendor
: SEAGATE
Product ID
Port Name
Port ID
Bind
: ST118273 CLAR18
: 21-00-00-20-37-11-FF-EF
: 11-01-E8
: Yes
: 1
Target ID
4-50
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Boot Device Menu (Command Line Option -e)
A
3: Return to Previous Menu
The general view shows:
------------------------------------------------------------------------------
HBA Instance 5: QLA2300 Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 PortID 11-05-EF
------------------------------------------------------------------------------
Enable Type
Target/LUN Info
Port Name
LUN ID
------ -------- ----------------------- ----------------------- ------
Yes
Yes
Disk SEAGATE ST136403FC
Disk SEAGATE ST118273 CLAR18 21-00-00-20-37-11-FF-EF 0
21-00-00-20-37-1A-6B-CF 0
4.7.2.2
Manual Configure LUNs
7: Selective LUNs ꢀ1-m: Port Number ꢀ2: Manual Configure LUNs
When you select this option, SANsurfer FC HBA CLI lists the disks on the
selected HBA port and shows the current configuration of each. Select the
number for the disk you want to configure and 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 configure additional LUNs or
2: Commit Changes to confirm your configuration changes.
4.7.2.3
Auto Configure LUNs
7: Selective LUNs ꢀ1-m: Port Number ꢀ3: Auto Configure LUNs
When you select this option, SANsurfer FC HBA CLI provides the options 1:
Enable to enable all targets and all LUN(s), or 2: Disable to disable all targets and
all LUN(s). When you select either option, the changes are saved immediately
and you are prompted to reboot:
Configuration saved on HBA instance 5 (WWPN
21-01-00-E0-8B-25-CB-D8). LUN persistent data saved successfully.
Please reboot the system for the saved configuration to become
effective.
4.8
Boot Device Menu
(Command Line Option -e)
8: Boot Device
When you select this option, SANsurfer FC HBA CLI shows the standard HBA
port or All HBAs.
SN0054614-00 F
4-51
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Boot Device Menu (Command Line Option -e)
S
4.8.1
HBA Port Instance
8: Boot Device ꢀ1 - m: HBA Port Instance
When you select this option, SANsurfer FC HBA CLI shows the Boot Device
Settings menu for HBA Instance m. You can choose to:
„
„
Display Boot Device(s)
Configure Boot Device(s)
4.8.1.1
Boot Device(s) (Per HBA Port)
8: Boot Device ꢀn: Port Number ꢀ1: Display Boot Device(s)
When you select this option, SANsurfer FC HBA CLI shows the following
information about the boot devices for this HBA Instance:
„
„
„
„
„
„
„
„
„
„
„
HBA Instance Number
HBA Model Number (QLAxxxx)
Port Number (on that HBA)
WWPN
Port ID
Boot Device Settings
Selectable Boot (Enabled/Disabled)
Primary Boot Port Name (WWPN) and LUN
Alternate 1 Boot Port Name and LUN
Alternate 2 Boot Port Name and LUN
Alternate 3 Boot Port Name and LUN
For example:
------------------------------------------------------------------------------
HBA Instance 0: 2200 Port 1 WWPN 21-00-00-E0-8B-03-55-7C PortID 00-00-EF
------------------------------------------------------------------------------
Boot Device Settings:
---------------------------------------
Selectable Boot: Disabled
---------------------------------------
(Primary
----------------------------
00-00-00-00-00-00-00-00
) Boot Port Name
LUN
------
0
----------------------------
(Alternate 1) Boot Port Name
----------------------------
00-00-00-00-00-00-00-00
------
LUN
------
0
----------------------------
(Alternate 2) Boot Port Name
----------------------------
------
LUN
------
4-52
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Boot Device Menu (Command Line Option -e)
A
00-00-00-00-00-00-00-00
0
------
LUN
------
0
----------------------------
(Alternate 3) Boot Port Name
----------------------------
00-00-00-00-00-00-00-00
4.8.1.2
Configure Boot Device(s)
8: Boot Device ꢀn: Port Number ꢀ2: Configure Boot Device(s)
When you select this option, SANsurfer FC HBA CLI shows the Boot Device
Settings menu for HBA Instance m, including the HBA 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
4.8.1.2.1
Boot Device Settings
8: Boot Device ꢀn: Port Number ꢀ2: Configure Boot Device ꢀ2: Boot Device Settings
When you select this option, SANsurfer FC HBA CLI shows the Boot Device
Settings menu with information about each one including:
„
Device type (for example, Disk)
‰
‰
Order (Primary, secondary, and so forth)
Boot Port Name (WWPN)
„
BIOS Boot Default
4.8.1.2.2
LUN List Menu
8: Boot Device ꢀn: Port Number ꢀ2: Configure Boot Device ꢀ2: Boot Device Settings ꢀ1: LUN List Menu
When you select this option, SANsurfer FC HBA CLI shows the LUN List Menu
which includes a list of LUNs on the selected device. You can select any of the
lUNs as the boot device:
„
„
LUN: 0
LUN: 1
And so on.
SN0054614-00 F
4-53
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Driver Settings Menu (Command Line Option -fg)
S
4.8.1.2.3
Save Configuration
8: Boot Device ꢀn: Port Number ꢀ2: Config.Boot Device ꢀ2: Device Settings ꢀ1: LUN List ꢀ1: Save Configuration
When you select this option, the CLI shows the Save Configuration menu:
„
„
Proceed
Cancel
4.8.2
Boot Device(s) (All HBAs)
8: Boot Device ꢀ1: All HBAs
When you select this option, SANsurfer FC HBA CLI shows information about all
boot devices for all HBAs. For details, see “Boot Device(s) (Per HBA Port)” on
„
„
„
Product vendor
Product ID
Product revision
4.9
Driver Settings Menu
(Command Line Option -fg)
9: Driver Settings
When you select this option, SANsurfer FC HBA CLI shows the Driver Settings
Menu that lists the ports on each HBA. Select the number corresponding to the
port that you want, and then press ENTER to view the Target: Display Options
and Target: Binding Options.
4-54
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Driver Settings Menu (Command Line Option -fg)
A
NOTE:
Options on the Driver Settings menu differ according to the driver type:
failover, non-failover, Windows, Solaris, or Macintosh:
„ Present persistently bound target(s) plus any new target(s) with
driver default (option available for all drivers)
„ Present persistently bound target(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
The current settings for the Present persistently bound target(s)... and Bind
by... are indicated by the word Current in parentheses after the selection. To
change these settings, select the menu number corresponding to the other option.
NOTE:
If you select a QLA22xx HBA, all QLA22xx HBAs on the host will use the
same settings. If you select a 23xx HBA, all 2G/4G HBAs on the host will
also use the same settings.
To save your changes, select Commit Changes.
Table 4-4. Driver Settings
Parameter Name
<param name>
Alias
Value
Description
<param alias> <param value>
PersistentOnly
PO
PN
0,1
0,1
Present persistently bound
target(s) only.
Persistent-
PlusNew
Present persistently bound
target(s) plus any new tar-
get(s) with driver default.
NewOnlya
BindWWPN
NO
BW
0, 1
0,1
Present targets with driver
default.
Bind devices by WWPNs.
SN0054614-00 F
4-55
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Utilities Menu
S
Table 4-4. Driver Settings (Continued)
Parameter Name
<param name>
Alias
Value
Description
<param alias> <param value>
BindPortID
BP
0,1
Bind devices by Port IDs.
a Driver Parameter NewOnly(NO) is supported only with the failover driver.
4.10
Utilities Menu
10: Utilities
When you select this option, SANsurfer FC HBA CLI shows the following utilities
options:
„
„
„
„
„
„
„
Flash Update
Flash Save
HBA Parameters Update
HBA Parameters Save
HBA Parameters Templates
Driver Update (Windows only)
Driver Rescan (Solaris with QLA driver only)
4.10.1
Flash Update (Per HBA Port or All HBAs)
(Command Line Option -b)
10: Utilities ꢀ1: Flash Update
When you select Flash Update, you are prompted to select either one of your
HBA port instances or All HBAs to update. SANsurfer FC HBA CLI then provides
the following update options and prompts you to enter a file name for the flash
update file:
„
„
„
„
Update Entire Image
Update Boot Code Only
Update FW Only
Flash Update
4.10.2
Flash Save (Per HBA Port)
(Command Line Option -b and Reserved Word “save”)
10: Utilities ꢀ2: Flash Save
When you select this option, SANsurfer FC HBA CLI opens the Flash Save
Menu, where you select an HBA port and then enter a file name to save.
4-56
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Utilities Menu
A
4.10.3
HBA Parameters Update (Per HBA Port or All HBAs)
(Command Line Option -r)
10: Utilities ꢀ3: HBA Parameters Update
When you select HBA Parameters Update, you are prompted to select either one
of your HBA port instances or All HBAs to update. SANsurfer FC HBA CLI then
displays the following warning message:
Warning:
Please update the HBA parameters with extreme care.
Incorrectly updating the 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 update.
Do you want to proceed with the operation?
1: Yes
2: No
Enter Selection:
If you select 1: Yes, you are prompted to enter the name of a file from which to
update the HBA parameters.
4.10.4
HBA Parameters Save (Per HBA Port)
(Command Line Option -r and Reserved Word “save”)
10: Utilities ꢀ4: HBA Parameters Save
When you select the HBA Parameters Save option, SANsurfer FC HBA CLI
prompts you to select an HBA. You then enter a file name to save the parameters
for that HBA.
4.10.5
HBA Parameters Template (Per HBA or All HBAs)
(Command Line Option -n and OEM Name)
10: Utilities ꢀ5: HBA Parameters Template
SN0054614-00 F
4-57
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Utilities Menu
S
When you select the HBA Parameters Template option, SANsurfer FC HBA CLI
prompts you to select an HBA port (or All HBAs), and then offers some or all of
the following template types:
„
„
„
„
„
„
EMC (EMC-specific settings)
HP (HP-specific settings)
HPQ (HP-specific settings – 2Gb HP HBAs)
IBM (IBM-specific settings)
QLGC (QLogic-specific settings)
SUN (SUN-specific settings)
Select one of the templates to apply it immediately to the HBA port instance (or All
HBAs.) The following is returned:
Updating HBA Parameters on HBA instance n - QLA2nnn. Please
wait...
HBA Parameters update complete. Changes have been saved and
applied to the HBA instance n.
4.10.5.1
Using HBA Parameter Templates
Use templates to set OEM-specific storage qualified HBA parameters to a
pre-determined value without using a specific DAT/DEFfile for each HBA type
that you might be using.
NOTE:
Settings that are effected by the template apply only to the ISP
2300/2310/23x2 2Gb HBAs and the ISP2422/2432 4Gb HBAs.
The following ISP2422/2432 parameters are subject to the template feature:
„
Execution Throttle specifies the maximum number of commands executing
on any one port. When a port’s execution throttle is reached, no new
commands are executed until the current command finishes executing
„
Descending Loop ID Search specifies in what order the firmware assigns
the AL_PA (ArbitratedLoop_PhysicalAddress). The firmware searches all
the nodes in a loop topology and assigns the AL_PA in a descending order if
you select 0, ascending order if you select 1.
„
„
Maximum LUNs Per Target specifies the maximum number of LUNs per
target. Multiple LUN support is typically for RAID boxes that use LUNs to
map drives.
Port Down Retry Count specifies the number of times SANsurfer FC HBA
CLI retries a command to a port returning port down status.
4-58
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Utilities Menu
A
„
Link Down Timeout specifies the time the driver waits for the link to come
up after link down before returning the I/Os. This is analogous to the Port
Down Retry Count setting, which is used when the port is down.
The following tables list the parameter settings supported by templates for the
specified HBAs.
Table 4-5. Template Supported Parameter Settings for QLA246x/QLE246x
and QLE256x HBAs
Setting
QLogic
HP
IBM
SUN
Execution Throttle
65535
0
65535
0
65535
0
65535
0
Descending Loop ID
Search
Maximum LUNs Per Target
Port Down Retry Count
Link Down Timeout
128
30
128
16
8
256
30
128
30
30
30
30
Table 4-6. Template Supported Parameter Settings for QLA23xx HBAs
(ISP2312)
Setting
QLogic
EMC
HP
HPQ
IBM
SUN
Execution Throttle
16
0
256
1
16
0
16
0
256
0
16
0
Descending Loop
ID Search
Maximum LUNs
Per Target
128
30
256
45
128
16
8
128
16
8
256
30
8
30
0
Port Down Retry
Count
Link Down Timeout
30
45
30
SN0054614-00 F
4-59
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Utilities Menu
S
Table 4-7. Template Supported Parameter Settings for QLA23xx HBAs
(ISP2300/2310)
Setting
QLogic
EMC
IBM
SUN
Execution Throttle
16
0
256
1
256
0
16
0
Descending Loop ID
Search
Maximum LUNs Per Target
Port Down Retry Count
Link Down Timeout
128
30
256
45
0
8
30
0
30
30
30
45
Table 4-8. Template Supported Parameter Settings for QLA23xx HBAs
(ISP2322)
Setting
Execution Throttle
QLogic
EMC
16
0
256
1
Descending Loop ID Search
Maximum LUNs Per Target
Port Down Retry Count
Link Down Timeout
128
30
30
256
45
45
4.10.6
Driver Update
(Command Line Option -d)
10: Utilities ꢀ6: Driver Update
The Driver Update option is available on Windows systems only. When you
select Driver Update from the Utilities menu, SANsurfer FC HBA CLI prompts
you to select an HBA port, and then enter a file name (INF, ZIP, or EXE) with
which to update the driver for that port.
4.10.7
Driver Rescan
(Command Line Option -rs)
10: Utilities ꢀ6: Driver Rescan
The Driver Rescan option is available only on Solaris systems with the QLA
driver. When you select Driver Rescan from the Utilities menu, SANsurfer FC
HBA CLI prompts you to select an HBA port to rescan.
4-60
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Beacon Menu
A
4.11
Beacon Menu
11: Beacon
When you select the Beacon option, SANsurfer FC HBA CLI shows the Beacon
Menu containing these options:
„
„
Locate HBA
Locate Target(s)
4.11.1
Locate HBA – HBA Beacon
(Command Line Option -a)
11: Beacon ꢀ1: Locate HBA
When you select this option, SANsurfer FC HBA CLI shows the HBA Beacon
Menu that lists all HBA ports. Select any port and press ENTER to toggle the
Beacon LED for that port:
4.11.2
Locate Target(s) – Target Beacon
(Command Line Option -tb)
11: Beacon ꢀ2: Locate Target(s)
When you select this option, SANsurfer FC HBA CLI shows the Target Beacon
Menu that lists all HBA ports. Select any port and press ENTER to view the disk
details of that port, including the current beacon status:
HBA Instance 1 (2200 Port 2) : Online
WWPN: 21-01-00-E0-8B-23-55-7C
Desc: QLA2200 /02/12/04 QLA2202FS QCP2202
1: Disk
Vendor
: SEAGATE
Product ID
Port Name
Port ID
Beacon
: ST136403FC
: 21-00-00-20-37-1A-6B-CF
: 11-01-E4
: No
: No
2: Disk
Vendor
: SEAGATE
Product ID
Port Name
Port ID
Beacon
: ST118273 CLAR18
: 21-00-00-20-37-11-FF-EF
: 11-01-E8
3: Beacon Selected Target(s)
4: Return to Previous Menu
SN0054614-00 F
4-61
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
You can select a disk number to blink the LED on that target. The blinking asterisk
(*) below the Device Port Nameline shows that the target beacon is active.
------------------------------------------------------------------------------
HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00
------------------------------------------------------------------------------
Target Beacon
--------------------------------------------------
Hit <RETURN> to abort
--------------------------------------------------
Device Port Name
Beacon Status
------------------------ -------------
21-00-00-20-37-11-FF-EF
On - Active
*
4.11.2.1
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 HBA CLI
shows a list of the targets associated with the HBA. You can select any target to
toggle the Beacon LED for that target:
4.12
Diagnostics Menu
(Command Line Options -kl, -kr, and -dm)
12: Diagnostics
When you select this option from the Main Menu, SANsurfer FC HBA CLI shows
Diagnostics Menu with the standard list of HBA ports. Select the port you want to
run diagnostic tests on, type its number, and then press ENTER.
NOTE:
–exclude | –ex ignores this device in a read/write buffer test.
Table 4-9. HBA Diagnostics Configuration Settings
Parameter Name Alias <param
Value <param value>
Description
<param name>
alias>
DataPattern
DP
00–FF
CRPAT
CSPAT
See table note 1
See table note 1
See table note 1
4-62
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
Table 4-9. HBA Diagnostics Configuration Settings (Continued)
Parameter Name Alias <param
Value <param value>
Description
<param name>
alias>
CJTPAT
See table note 1
See table note 2
DataSize
DS
TC
8, 16, 32, 64, 128, 256,
512, 1024, 2048
TestCount
0–65535 (Loopback)
0–10000 (R/W Buffer)
1–65535 (Loopback)
1–10000 (R/W Buffer)
0
See table note 3
See table note 3
See table note 4
See table note 4
Ignore
TestIncrement
OnError
TI
TI
OE
1
Stop
2 Loop on error
See table note 5
Table Notes:
1. DataPattern is the test pattern in hexadecimal format.
Hex Binary
00 00000000
55 01010101
5A 01011010
A5 10100101
AA 10101010
FF 11111111
User Defined Pattern (Hex).
Random Pattern.
CRPAT - Loopback test only.
CSPAT - Loopback test only.
CJTPAT - Loopback test only.
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 data size is 128 bytes.
3. TestCount:
0: Test continuously
1–Max: Total number of tests that will be executed.
4. TestIncrement must be less than the number of test count specified.
5. OnError specifies the action if an error occurs during any given pass.
4.12.1
Diagnostics Loopback Test
(Command Line Option -kl)
12: Diagnostics ꢀn: Port Number
When you select an HBA port from the Diagnostics menu, SANsurfer FC HBA
CLI shows the list of diagnostic tests you can run for that port, including:
SN0054614-00 F
4-63
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
„
„
„
Loopback Test
Read/Write Buffer Test
Transceiver Details (available on 4Gb and 8Gb only)
Test results for loopback and read/write buffer tests may include these test results:
„
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
4.12.1.1
Configure Loopback Test Parameters
12: Diagnostics ꢀn: Port Number ꢀ1: Loopback Test
When you select the Loopback Test option, SANsurfer FC HBA CLI shows the
Loopback Test Menu containing the following options:
„
„
„
„
Display Test Parameters
Reset Test Parameters
Configure Test Parameters
Start Diagnostics Test
Diagnostic tests interrupt normal HBA operations. At the completion of the testing,
the HBA’s state before the tests are restored. Note the following:
„
„
„
Run these tests when no other activities are required of the HBA.
Tests read and write to sensitive areas on the HBA.
Disruption of some diagnostic tests may require a complete update of the
HBA's critical memory areas.
NOTE:
Although SANsurfer FC CLI protects against normal operation interruption
and testing disruption, it is your responsibility to ensure that the diagnostics
are run without causing interruptions to other processes and disruptions to
the actual testing process.
4-64
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
The loopback test is external to the HBA. If the HBA port is in loop mode, you can
run the loopback test with a loopback connector. If the HBA port is in point-to-point
mode and attached to a switch, an echo test is run instead (no loopback
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 HBA. More
specifically, the loopback test transmits and receives (loopback) the specified data
and checks for the frame CRC, disparity, and length errors.
NOTE:
Under Solaris, this feature is disabled if you are using the driver from the OS
installation CDs (QLC driver).
To prepare for a loopback test, follow these steps:
1.
In interactive mode, type the number for the Configure HBA Settings
option, and then press ENTER.
2.
From the Connections Options menu (interactive mode) or the -n
command (non-interactive mode), do one of the following:
„
If the HBA port is not connected to the fabric through a point-to-point
connection (F-port) and is not connected to a switch, change the
setting to loop only, if not currently set to this option.
– Or –
„
If the HBA port is connected to the fabric through a point-to-point
connection (F-port) and is connected to a switch, change the setting to
point-to-point only, if not currently set to this option.
After completing the loopback test, change the connection option back to its
original value.
3.
Attach a loopback connector to the FC connector on the HBA port, unless
your system meets the criteria in section 4.17.1.2.6 (in this case, an echo
test is done).
The loopback connector must be appropriate for the type of FC HBA
connector. Be sure to select the appropriate HBA connector for testing.
To install a loopback connector, do the following:
a.
b.
Disconnect the cable from the appropriate HBA connector.
Install the loopback connector on the HBA connector.
4.
Follow the steps in either section 4.17.1.1 (interactive mode) or
section 4.17.1.2.6 (non-interactive mode).
SN0054614-00 F
4-65
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
After completing the loopback test, do the following steps to prepare for normal
HBA operations:
1.
2.
Remove the loopback connector from the HBA connector.
Reconnect the cable that you disconnected before installing the loopback
connector.
3.
From the Connections Options menu (interactive mode) or the -N
command (non-interactive mode), change the setting back to its previous
setting.
4.12.1.2
Run Loopback 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-18-EE PortID 01-0F-00
------------------------------------------------------------------------------
------------------
Test Configuration
------------------
Data Pattern
Data Size (Bytes)
: Random
: 512
Number of test(s)(1-65535) : 65535
Test Increment(1-65535)
On Error
Test Continuous
: 1
: Ignore
: OFF
------------------------------------------------------------------------
----------------------------------
Diagnostics - Loopback Test Result
----------------------------------
Hit <RETURN> to abort
---------------------------------------------
HBA Test Data Pattern
--- ----------------------- ----------- --------- --------- -----------
4 BB-54-01-BD-AC-24-DD-80 Success 0 |
Status
CRC
Disparity FrameLength
0
0
Finished 6376 iterations in 1 second(s)...
4.12.2
Diagnostics Read/Write Buffer Test
12: Diagnostics ꢀn: Port Number ꢀ2: Read/Write Buffer Test
When you select this option, SANsurfer FC HBA CLI shows the Read/Write
Buffer Test Menu containing the following options:
4-66
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
„
„
„
„
Display Test Parameters
Reset Test Parameters
Configure Test Parameters
Start Diagnostics Test
The read/write buffer test sends specified data through the SCSI Write Buffer
command to a target device (disk). It then reads the data back through the SCSI
Read Buffer command and compares the data for errors. The test also compares
the link status of the target before and after the read/write buffer test. If errors
occur, the test indicates a broken or unreliable link between the HBA port and the
target.
NOTE:
„ Under Solaris, this feature is disabled if you are using the driver from the
OS installation CDs (QLC driver).
„ Some targets may not support read/write buffer commands. Check with
your hardware vendors or manufacturer.
4.12.2.1
Configure Read/Write Test Parameters
To prepare for a read/write buffer test, follow these steps:
1.
The read/write buffer test must be run on a disk device. Before running the
read/write buffer test, verify that the HBA 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 press ENTER.
To run a loopback test or a read/write buffer test:
1.
2.
Select the number for the Diagnostics option, and then press ENTER.
From the Diagnostics Tests Menu, type the number that corresponds to
the test you want to run, and then press ENTER:
„
„
1 = loopback test
2 = read/write buffer test
3.
The Diagnostics Menu appears. Type the number that corresponds to the
HBA port you want to test, and then press ENTER.
SN0054614-00 F
4-67
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
4.
The Configure Diagnostic Loopback Test Parameters or Configure
Diagnostic Read/Write Buffer Test Parameters submenu appears. Select
one of the following options:
1.
2.
3.
4.
Show Test Configuration. Type 1to show the current parameter
values.
Restore Test Configuration to Default. Type 2to return all
parameters to their default values.
Customize Test Configuration. Type 3to customize any or all of the
Run Diagnostic Test. Type 4to run the loopback or read/write buffer
test with the current parameter values. To see these values, type 1
(Show Test Configuration).
5.
Return to the Diagnostics Test Menu. Type 5to go back to the
Diagnostics Test Menu.
6.
If you selected Customize Test Configuration in Step 4, the Diagnostic
Test Configuration Menu appears. See sections 4.17.1.2.1 through
4.17.1.2.5 for a description of the parameters and their values. For each
parameter you want to change, follow these steps:
a.
b.
c.
Type the number associated with the parameter you want to change.
Enter the parameter value.
To return to the previous menu, type 7from the Read/Write area, or
type 7from the Loopback area.
7.
8.
Type the number to run the loopback or read/write buffer test.
The following warning message appears:
Warning: The Diagnostic Loopback and Read/Write Buffer tests
require that the HBA has no outstanding input and output
operations. Please make sure there is no active I/O before
starting the test(s).
Do you want to do the test(s)?
1. Yes
2. No
Type 1 to proceed or 2 to cancel the operation.
Here is an example of using the Diagnostics option to run a loopback test.
From the Main Menu (link)
Enter Selection: 13
SANsurfer FC HBA CLI
v1.x.x Build x
4-68
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
Diagnostics Menu
1: Loopback Test
2: Read/Write Buffer Test
3: Transceiver details
Note: 0 to return to Main Menu
Enter Selection: 1
SANsurfer FC HBA CLI
v1.x.x Build x
Diagnostics Menu
HBA Model QLA2300/2310:
1: Port 1: WWPN: xx-xx-xx-xx-xx-xx-xx-xx Loop down
HBA Model QEM2462:
2: Port 1: WWPN: xx-xx-xx-xx-xx-xx-xx-xx Online
3: Port 2: WWPN: xx-xx-xx-xx-xx-xx-xx-xx Online
HBA Model QLA210:
4: Port 1: WWPN: xx-xx-xx-xx-xx-xx-xx-xx Online
Note: 0 to return to Main Menu
Enter Selection: 2
SANsurfer FC HBA CLI
v1.x.x Build x
Configure Loopback Test Parameters
1: Show Test Configuration
2: Restore Test Configuration to Default
3: Customize Test Configuration
4: Run Diagnostic Test
5: Return to Diagnostics Test Menu
Note: 0 to return to Main Menu
Enter Selection: 1
--------------------------------------------------------------------
HBA 1: QEM2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 02-0E-00
------------------
Test Configuration
------------------
Data Pattern
: Random
: 512
: 500
: 1
: Ignore
Data Size (Bytes)
Number of test(s)(1-65535)
Test Increment(1-65535)
On Error
SN0054614-00 F
4-69
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
Test Continuous
: OFF
--------------------------------------------------------------
Press <Enter> to continue:
SANsurfer FC HBA CLI
v1.x.x Build x
Configure Loopback Test Parameters
1: Show Test Configuration
2: Restore Test Configuration to Default
3: Customize Test Configuration
4: Run Diagnostic Test
5: Return to Diagnostics Test Menu
Note: 0 to return to Main Menu
Enter Selection: 3
SANsurfer FC HBA CLI
v1.x.x Build x
Diagnostic Test Configuration Menu
1: Data Pattern
2: Data Size
3: Number of Test(s) (1-65535)
4: Test Increment(s) (1-65535)
5: On Error Policy
6: Enable/Disable Test Continuously
7: Return to Previous Menu
Note: 0 to return to Main Menu
Enter Selection: 7
SANsurfer FC HBA CLI
v1.x.x Build x
Configure Loopback Test Parameters
1: Show Test Configuration
2: Restore Test Configuration to Default
3: Customize Test Configuration
4: Run Diagnostic Test
5: Return to Diagnostics Test Menu
Note: 0 to return to Main Menu
Enter Selection: 4
SANsurfer FC HBA CLI
4-70
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
v1.x.x Build x
Warning: The Diagnostic Loopback and Read/Write Buffer Tests require that the
HBA has no outstanding input and output operations. Please make sure there is
no active I/O before starting the test(s).
Do you want to proceed with the test(s)?
1: Yes
2: No
Note: 0 to return to Main Menu
Enter Selection: 1
-------------------------------------------------------------------
HBA 1: QEM2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 02-0E-00
------------------
Test Configuration
------------------
Data Pattern
: Random
: 512
: 500
: 1
: Ignore
: OFF
Data Size (Bytes)
Number of test(s)(1-65535)
Test Increment(1-65535)
On Error
Test Continuous
--------------------------------------------------------------
Diagnostics - Loopback Test Result
----------------------------------
Note: Press <Enter> to stop the test any time
---------------------------------------------
HBA Test Data Pattern
Status CRC Disparity FrameLength Active
--- ----------------------- ------ ---- --------- ----------- ------
1
B4-31-0E-AA-AD-CF-D5-B0 Success 0
0
0
\
4.12.2.2
Run Read/Write Buffer Test
When you select Start Diagnostics Test for the read/write buffer test, the
following is returned (example):
------------------------------------------------------------------------------
HBA Instance 4: QLE2562 Port 2 WWPN 21-01-00-1B-32-36-18-EE PortID 01-0F-00
------------------------------------------------------------------------------
------------------
Test Configuration
------------------
Data Pattern
Data Size (Bytes)
: Random
: 128
Number of test(s)(1-10000) : 10000
Test Increment(1-10000)
: 1
SN0054614-00 F
4-71
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
On Error
Test Continuous
: Ignore
: OFF
------------------------------------------------------------------------
Diagnostics - Read/Write Buffer Test Result
------------------------------------------------------------
Hit <RETURN> to abort
---------------------------------------------
Iter No Data Pattern
Status
------- ----------------------- ---------------------------
263 5B-57-4B-E5-29-D2-6A-1E Success
4.12.3
Diagnostics Transceiver Details – DMI
(Command Line Option -dm)
12: Diagnostics ꢀn: Port Number ꢀ3: Transceiver Details
The Transceiver Details options is displayed only for 4Gb and 8Gb. When you
select this option, SANsurfer FC HBA CLI shows the Transceiver Details Menu
containing the following options:
„
„
General
Details
Select either General or Details and press ENTER to retrieve the transceiver
information for this port instance.
4.12.3.1
Transceiver Details – General
Select the General option on the Transceiver Details menu to view general
information for the selected HBA port. The following shows an example:
------------------------------------------------------------------------------
HBA Instance 4: QLE2562 Port 2 WWPN 21-01-00-1B-32-36-18-EE PortID 01-0F-00
------------------------------------------------------------------------------
------------------------------------------------------------------------------
Media Information
------------------------------------------------------------------------------
Vendor: Intel Corp.
Type: 800-M6-SN-I
Part Number: TXN31118D100000
Speed: 200 MBytes/Sec, 400 MBytes/Sec, 800 MBytes/Sec
Revision:
Serial Number: AZ8P72890H23
------------------------------------------------------------------------------
4-72
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
Temperature Voltage
(C) (V)
-------------- -------
Tx Bias
(mA)
-------
5.86
Normal
9.00
Tx Power
(mW)
--------
0.498
Normal
0.676
Rx Power
(mW)
--------
1.174
Normal
4.000
Value
34.17
Normal
95.00
3.33
Normal
3.63
Status
High Alarm
High Warning
Low Warning
Low Alarm
85.00
-5.00
-10.00
3.56
3.04
2.97
8.50
2.00
2.00
0.646
0.186
0.100
2.832
0.200
0.100
4.12.3.2
Transceiver Details – Details
Select the Details option on the Transceiver Details menu to view detailed
information for the selected HBA port. The following shows an example:
------------------------------------------------------------------------------
HBA Instance 4: QLE2562 Port 2 WWPN 21-01-00-1B-32-36-18-EE PortID 01-0F-00
------------------------------------------------------------------------------
Optical Transceiver Digital Diagnostic Data:
Address A0
Identifier: SFP
Ext. Identifier: GBIC/SFP defined by serial ID only
Connector: LC
Transceiver Data
Compliance: 0x00 0x00 0x00 0x00
FC Link Length: Intermediate Distance (I)
FC Transmitter Tech: Shortwave Laser w/o OFC (SN)
FC Transmission Media: Multi-mode 50m (M5), Multi-mode 62.5m (M6)
FC Speed: 200 MBytes/Sec, 400 MBytes/Sec, 800 MBytes/Sec
Encoding: 8B10B
BR, Nominal: 0x55
Length (9um) - km: 0x00
Length (9um): 0x00
Length (50um): 0x05
Length (62.5um): 0x02
Length (Copper): 0x00
Vendor name: Intel Corp.
Vendor OUI: 0x00 0x02 0xb3
Vendor PN: TXN31118D100000
Vendor Rev:
Wave Length: 0x0352
CC_BASE: 0xc1
Options:-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: 0x1
SN0054614-00 F
4-73
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
S
BR, max: 0x00
BR, min: 0x00
Vendor SN: AZ8P72890H23
Date code: 070709
Diag Monitoring Type:-Address change required: 0x0
-Power Measurement: 0x1
-Externally Calibrated: 0x0
-Internally Calibrated: 0x1
-Digital diag monitoring: 0x1
-Legacy diagnostic: 0x0
Enhanced Options:-Soft RATE_SELECT ctrl & monitoring: 0x0
-Soft RX_LOS monitoring: 0x1
-Soft TX_FAULT monitoring: 0x1
-Soft TX_DISABLE ctrl & monitoring: 0x0
-Alarm/warning flags: 0x1
SFF-8472 Compliance: TBD
CC_EXT: 0x26
Vendor Specific: 0xff 0xff 0xff 0xff 0xff 0xff 0xff 0xff
0xff 0xff 0xff 0xff 0xff 0xff 0xff 0xff
0xff 0xff 0xff 0xff 0xff 0xff 0xff 0xff
0xff 0xff 0xff 0xff 0xff 0xff 0xff 0xff
Address A2
Temp High Alarm: 0x5f00
Temp Low Alarm: 0xf601
Temp High Warning: 0x5500
Temp Low Warning: 0xfb01
Voltage High Alarm: 0x8dcc
Voltage Low Alarm: 0x7404
Voltage High Warning: 0x8b10
Voltage Low Warning: 0x76c0
Bias High Alarm: 0x1194
Bias Low Alarm: 0x03e8
Bias High Warning: 0x109a
Bias Low Warning: 0x03e8
TX Signal Power High Alarm: 0x1a68
TX Signal Power Low Alarm: 0x03e8
TX Signal Power High Warning: 0x1938
TX Signal Power Low Warning: 0x0746
RX Signal Power High Alarm: 0x2710
RX Signal Power Low Alarm: 0x00fb
RX Signal Power High Warning: 0x1ba7
RX Signal Power Low Warning: 0x01f5
Rx_PWR(4): 0x00000000
Rx_PWR(3): 0x00000000
Rx_PWR(2): 0x00000000
Rx_PWR(1): 0x00000000
Rx_PWR(0): 0x00000000
Tx_I(Slope): 0x0000
4-74
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Diagnostics Menu (Command Line Options -kl, -kr, and -dm)
A
Tx_I(Offset): 0x0000
Tx_PWR(Slope): 0x0000
Tx_PWR(Offset): 0x0000
T(Slope): 0x0000
T(Offset): 0x0000
V(Slope): 0x0000
V(Offset): 0x0000
Checksum: 0x63
Temperature MSB: 0x22
Temperature LSB: 0x2c
Vcc MSB: 0x82
Vcc LSB: 0x21
TX Bias MSB: 0x0b
TX Bias LSB: 0x76
TX Power MSB: 0x13
TX Power LSB: 0x77
RX Power MSB: 0x0b
RX Power LSB: 0x7b
Reserved MSB: 0x00
Reserved LSB: 0x00
Reserved MSB: 0x00
Reserved LSB: 0x00
Status/Control Bits:-Data_Ready_Bar: 0x0
-LOS: 0x0
-TX Fault: 0x0
-Soft RX Rate Select: 0x0
-RX Rate Select State: 0x0
-Soft TX Disable: 0x0
-TX Disable State: 0x0
-TX Signal Power Low Alarm: 0x0
-TX Signal Power High Alarm: 0x0
-TX Bias Low Alarm: 0x0
-TX Bias High Alarm: 0x0
-Vcc Low Alarm: 0x0
-Vcc High Alarm: 0x0
-Temp Low Alarm: 0x0
-Temp High Alarm: 0x0
-RX Signal Power Low Alarm: 0x0
-RX Signal Power High Alarm: 0x0
-TX Signal Power Low Warning: 0x0
-TX Signal Power High Warning: 0x0
-TX Bias Low Warning: 0x0
-TX Bias High Warning: 0x0
-Vcc Low Warning: 0x0
-Vcc High Warning: 0x0
-Temp Low Warning: 0x0
-Temp High Warning: 0x0
-Reserved Warning: 0x0
-Reserved Warning: 0x0
SN0054614-00 F
4-75
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
S
-Reserved Warning: 0x0
-Reserved Warning: 0x0
-Reserved Warning: 0x0
-Reserved Warning: 0x0
-RX Power Low Warning: 0x0
-RX Power High Warning: 0x0
Vendor Specific: 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
4.13
Statistics Menu
(Command Line Options -gs and -ls)
13: Statistics
The Statistics option allows you to view and change HBA and link statistics.
When you select this option, SANsurfer FC HBA CLI shows the Statistics Menu
containing:
„
„
HBA Statistics
Link Status
NOTE:
„ Under Solaris, HBA statistics are disabled if you are using the driver from
the OS installation CDs (QLC driver). Under Linux, this feature is
disabled if you are using the ioctl or sysfs (inbox) driver.
„ Under Solaris, link statistics are disabled if you are using the driver from
the OS installation CDs (QLC driver).
4.13.1
HBA Statistics – Monitoring
(Command Line Option -gs)
13: Statistics ꢀ1: HBA Statistics
When you select this option, SANsurfer FC HBA CLI shows the HBA Statistics
Menu including the following options:
„
„
Configuration
Show HBA Statistics
4.13.1.1
Configuration
13: Statistics ꢀ1: HBA Statistics ꢀ1: Configuration
4-76
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
A
To change the HBA statistics:
1.
2.
3.
From the Main Menu, type the number for the Statistics option, and then
press ENTER.
From the Statistics Menu, type the number for the HBA Statistics option,
and then press ENTER.
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
---------------------------------------
AutoPoll (AP): 10
SetRate (SR): 5
LogToFile (LF): null.csv
5.
To restore the HBA defaults, select Restore Default and then press ENTER.
The following message appears:
Resetting to default settings..., done.
6.
7.
To change the polling, select Auto Poll and then press ENTER. Then select
either Auto Poll or Manual Poll and press ENTER to enable that selection.
To change the sampling rate, select Set Rate and then press ENTER. You
are prompted to enter a rate value between 5 and 30 seconds; the current
rate is shown in parentheses. Type a new rate and then press ENTER to
update the sampling rate.
8.
To save the HBA statistics 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.
SN0054614-00 F
4-77
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
S
Table 4-10. HBA Port Statistics Options
Parameter Name
Alias
Value
Description
AutoPoll
AP
0
Turn on automatic updates of the HBA
port statistics.
1–256
5–30
Turn on automatic updates of the HBA
port statistics at a specified interval.
SetRate
SR
LF
Set the polling interval during automatic
update (seconds).
LogToFile
Log File Export the statistics to a file (CSV format).
Name
4.13.1.1.1
Current Settings
13: Statistics ꢀ1: HBA Statistics ꢀ1: Configuration ꢀ1: Current Settings
The system displays the current settings for:
„
„
„
AutoPoll (AP)
SetRate (SR)
LogToFile (LF)
4.13.1.1.2
Restore Defaults
13: Statistics ꢀ1: HBA Statistics ꢀ1: Configuration ꢀ2: Restore Default
The system restores the default settings and returns a message:
Resetting to default settings..., done.
4.13.1.1.3
Auto Poll
13: Statistics ꢀ1: HBA Statistics ꢀ1: Configuration ꢀ3: Auto Poll
SANsurfer FC HBA CLI displays two polling options:
AutoPoll
Manual Poll
„
„
If you select the Auto Poll option, the system enables Auto Poll and returns a
message:
Auto Poll enabled.
4-78
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
A
If you select the Manual Poll option, the system prompts you to enter a value for
Manual Poll iteration:
Manual Poll iteration (1-256)
Enter a value from 1 to 256 and press ENTER. The system updates the Manual
Poll iteration value and returns the following message:
Manual Poll updated.
4.13.1.1.4
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 press ENTER. The system updates the sampling
rate and returns a message:
Sampling rate updated.
4.13.1.1.5
Log to File
13: Statistics ꢀ1: HBA Statistics ꢀ1: Configuration ꢀ5: Log To file
When you select the Log to File option, the system prompts you to enter a file
name or press RETURN to cancel.
If you press the ENTER key, the HBA Statistics Settings Menu reappears.
If you enter a file name, for example, MyFile, the system saves the log to that file
and returns a message:
Save to file option enabled (MyFile.csv).
The file name extension .csvindicates a Comma Separated Value file type.
4.13.1.2
Show HBA Statistics
13: Statistics ꢀ1: HBA Statistics ꢀ1: Show HBA Statistics
To view the HBA port statistics:
1.
2.
From the Main Menu, type the number for the Statistics option, and then
press ENTER.
From the Statistics Menu, type the number for the HBA Statistics option,
and then press ENTER.
SN0054614-00 F
4-79
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
S
3.
4.
From the HBA Statistics Menu, type the number for the Show HBA
Statistics option, and then press ENTER.
The Statistics Menu appears and prompts you to select an HBA port. Type
the number for the port, and then press ENTER.
The HBA 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
4.13.2
Link Status
(Command Line Option -ls)
13: Statistics ꢀ2: Link Status
The following sections describe how to view and change the HBA’s link status.
NOTE:
Under Solaris, link status is disabled if you are using drivers from the OS
installation CDs (QLC driver).
From the Main Menu, select Statistics and then select Link Status. When you
select the Link Status option, SANsurfer FC HBA CLI shows the following
options:
„
„
Configuration
Show Link Status
4.13.2.1
Configuration
13: Statistics ꢀ2: Link Status ꢀ1: Configuration
When you select the Configuration option, the Link Status Settings Menu
appears and allows you to view and configure the following:
„
„
Current Settings
Restore Default
4-80
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
A
„
„
„
Auto Poll
Set Rate
Log to file
Table 4-11. Statistics/Link Status Options
Parameter Name
Alias
Value
Description
AutoPoll
AP
0
Update the link statistics automati-
cally.
1–256
5–30
Update the link statistics up to a speci-
fied interval.
SetRate
SR
LF
Set the Statistics Sampling Rate (sec-
onds).
LogToFile
Log File Name Export the link statistics to a file (CSV
format).
4.13.2.1.1
Current Settings
13: Statistics ꢀ2: Link Status ꢀ1: Configuration ꢀ1: Current Settings
Select the Current Settings option to have the system display the current link
status settings for:
„
„
„
AutoPoll (AP)
SetRate (SR)
LogToFile (LF)
4.13.2.1.2
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:
Resetting to default settings..., done.
4.13.2.1.3
Auto Poll Menu
13: Statistics ꢀ2: Link Status ꢀ1: Configuration ꢀ3: Auto Poll
SANsurfer FC HBA CLI displays two polling options:
SN0054614-00 F
4-81
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Statistics Menu (Command Line Options -gs and -ls)
S
„
„
Auto Poll
Manual Poll
If you select the Auto Poll option, the system enables Auto Poll and returns a
message:
Auto Poll enabled.
If you select the Manual Poll option, the system prompts you to enter a value for
Manual Poll iteration:
Manual Poll iteration (1-256)
Enter a value from 1 to 256 and press ENTER. The system updates the Manual
Poll iteration value and returns the following message:
Manual Poll updated.
4.13.2.1.4
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 to 30 and press ENTER. The system updates the sampling
rate and returns a message:
Sampling rate updated.
4.13.2.1.5
Log to File
13: Statistics ꢀ2: Link Status ꢀ1: Configuration ꢀ5: Log to File
When you select the Log to File option, the system prompts you to enter a file
name or press RETURN to cancel.
If you press the ENTER key, the Link Status Settings Menu reappears.
If you enter a file name, for example, MyFile, the system saves the log to that file
and returns a message:
Save to file option enabled (MyFile.csv).
The file name extension .csvindicates a Comma Separated Value file type.
4.13.2.2
Show Link Status
13: Statistics ꢀ2: Link Status ꢀ2: Show Link Status
4-82
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Virtual Menu (Command Line Option -vp)
A
The Show Link Status option shows a menu of port numbers from which you can
select the port for which you want the link status.
To view the link status:
1.
2.
Type the number for the Statistics option, and then press ENTER.
The Statistics Menu appears. Type the number for the Link Status option,
and then press ENTER.
3.
4.
The Link Status Menu appears. Type the number for the Show Link Status
option, and then press ENTER.
You are prompted to select an HBA port. Type the number for the port, and
then press ENTER. The HBA link status for that port appears.
--------------------------------------
Link Status
--------------------------------------
The following keys are in use during test:
<R> | <r> - Reset Current
<C> | <c> - Refresh Current
<T> | <t> - Refresh Total
<RETURN> - Abort Test
---------------------------------------------------------------
Port Name Link Failure Sync Loss Signal Loss Invalid CRC
---------------------------------------------------------------
Port(WWPN) 0
Disk(WWPN) 0
Disk(WWPN) 0
Disk(WWPN) 0
Disk(WWPN) 0
Disk(WWPN) 0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
Press <Enter> to continue:
4.14
Virtual Menu
(Command Line Option -vp)
14: Virtual Menu
NOTE:
The option to use N_Port ID Virtualization (NPIV) only appears on the Main
Menu if the HBAs and system support it. NPIV requires a Windows system
running with a driver that supports NPIV.
SN0054614-00 F
4-83
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Virtual Menu (Command Line Option -vp)
S
QLogic's SANsurfer FC HBA CLI for Windows works in conjunction with QLogic's
N_Port ID Virtualization (NPIV)-capable Windows driver. NPIV is an ANSI T11
standard that describes how multiple unique fabric addresses (N_Port IDs) can
share a single FC HBA physical port (N_Port) in SAN fabric topology. NPIV allows
a physical HBA port to obtain N_Port IDs. The SANsurfer FC HBA CLI refers to
these N_Port IDs as “virtual ports” (VPorts).
QLogic 4Gb FC HBAs (QLx24xx) support the NPIV standard. Using NPIV requires
software tools or applications to create, delete, manage, deploy, and migrate
virtual ports. Microsoft’s Windows Virtual Server 2005 R2, along with Windows
Server 2003, provides a virtualization platform that can run guest operating
systems in an x86 environment. Use the QLogic NPIV-capable Windows driver
with QLogic’s SANsurfer FC HBA CLI to create, delete, and manage virtual ports.
You can deploy and migrate virtual ports in conjunction with virtual machines
(VMs) in your 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 Virtualization Technologies for Windows Environments
Microsoft System Center Virtual Machine Manager
The Virtual Menu options allow you to view, create, and delete virtual HBA ports.
To see a complete list of NPIV options, add the flag -hto the vpcommand. For
example:
scli -vp -h
When you select the Virtual Menu option from the main menu, the Virtual Menu
appears.
„
HBA Model
‰
‰
‰
Port Number
WWPN
Status (Online/Loop down)
„
(Additional HBAs)
(Additional Ports)
‰
Virtual port options include the following:
„ <vport wwpn>is the World Wide Port Name of a virtual port.
„ <vport hex>is a single hex digit that will be part of the virtual port’s
WWPN (Second byte). (0-4 is reserved for physical HBA port. Note that this
feature is supported only with NPIV-enabled driver.
4-84
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Virtual Menu (Command Line Option -vp)
A
4.14.1
Virtual Menu for HBA 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 HBA, the following SANsurfer FC HBA CLI features are not
available:
„
„
„
„
„
„
„
„
„
„
„
„
HBA Parameters Display
HBA Parameters Settings
HBA Parameters Restore Default
Flash Update from file
Flash Save to file
HBA Parameters Update from file
HBA Parameters Save to file
HBA Parameters Templates
Driver Update
Target Link Speed
Boot Device Settings
Driver Settings
In addition, the following notes apply:
„
The maximum number of virtual HBAs that can be created of a physical HBA
is 15.
„
„
VPort means Virtual Port in all the displays.
In command line mode, you must use the WWPN instead of HBA instance
number to select a virtual port.
„
After you create or delete a virtual HBA, you should refresh the configuration
to see the changes.
4.14.1.1
List Virtual Port(s)
14: Virtual ꢀ1: Virtual Menu ꢀ3: List Virtual Ports
When you select this option, the menu of virtual ports on this physical HBA port
appears showing:
SN0054614-00 F
4-85
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Virtual Menu (Command Line Option -vp)
S
„
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-00-7B-E0-8B-14-5A-CF Online
1: VPort 2: WWPN: 21-00-67-E0-8B-14-5A-CF Online
4: Return to Previous Menu
4.14.1.2
Delete Virtual Port(s)
14: Virtual ꢀ1: Virtual Menu ꢀ3: Delete a Virtual Port
To delete a virtual port, select a virtual port number from the Delete a Virtual Port
menu. To see the change, you must manually refresh the virtual port
configuration.
4.14.1.3
Create Virtual Port(s)
14: Virtual ꢀ1: Virtual Menu ꢀ3: Create a Virtual Port
When you select this option, the Create Virtual Port Menu for this HBA Instance
appears showing:
„
„
HBA Instance n
‰
‰
‰
HBA Model Port Number
Status
Description
Followed by the menu:
‰
‰
Auto Generate
User Generate
Here is an example:
Create Virtual Port Menu
HBA Instance 4 (QLA2462 Port 1) : Online
Desc: QLA2462 PCI-X 2.0 to 4Gb FD Dual Channel
1: Auto Generate
2: User Generate
3: Return to Previous Menu
4-86
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Help Menu (Command Line Option -h)
A
4.14.1.3.1
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 HBA
physical port and reports the WWPN of the virtual port. For example:
Virtual Port 21-00-25-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. Note that the second hexadecimal digit changes on the newly
created virtual port.
4.14.1.3.2
User Generate
14: Virtual ꢀ1: Virtual Menu ꢀ3: Create a Virtual Port ꢀ2: User Generate
When you select this option, you are prompted to enter a hex digit for the new
virtual port WWPN. This new hex number is assigned to the second field of the
physical HBA port WWPN.
Enter Hex Pattern (xx) :
Type two hexadecimal digits. The system creates the new Virtual Port, for
example:
(Create Virtual Port Menu)
Enter Selection: 2
Enter Hex Pattern <xx>: EF
The system returns:
Virtual Port 21-00-EF-8B-14-5A-CF created successfully on HBA
instance 4.
Note that the entered hex digits, EF, now appear in byte 2 of the new Virtual Port
WWPN.
To see the change to the virtual ports, you must manually refresh the
configuration.
4.15
Help Menu
(Command Line Option -h)
14 (or 15): Help
When you enter this option the Help Menu appears with the following options:
„
„
Contents
Exit Codes
SN0054614-00 F
4-87
Download from Www.Somanuals.com. All Manuals Search And Download.
4 – Interactive Commands
Help Menu (Command Line Option -h)
S
„
About
Type the number for the option you want and press ENTER.
4.15.1
Contents
14 (or 15): Help ꢀ1: Contents
When you select the Contents option, SANsurfer FC HBA CLI shows the entire
Help menu. You can see the help menu options rearranged into alphabetical order
4.15.2
Exit Codes
14 (or 15): Help ꢀ2: Exit Codes
When you select the Exit Codes option, SANsurfer FC HBA CLI shows the entire
4.15.3
About
14 (or 15): Help ꢀ3: About
When you select the About option, SANsurfer FC HBA CLI shows the following
information about this tool:
„
„
„
„
„
„
„
Product name
Version and Build number
Copyright information
All rights reserved
Full Name
Build Type
Build Date
4-88
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Section 5
Non-interactive Commands
5.1
Introduction
This section contains the information in the help (to view help, enter the command
-h), plus additional explanation and examples. Each command line option is
listed, followed by a command description and examples of the command in use
and typical responses from the system.
5.2
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:
5.2.1
Host Information
(Command Line Option -g)
The command format to show host information is:
# scli -g
When you enter this option, the following information about the local machine
appears:
„
„
„
„
„
Host Name
OS type
OS version (patches where applicable)
SAN target management (SDM) API version
List of HBAs: HBA model, port number, WWPN, serial number (SN), HBA
number (HBA 0–n), and status (online/offline)
„
Total number of QLogic FC HBAs detected
SN0054614-00 F
5-1
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Display System Information (Command Line Options -g, -z, and -tp)
S
NOTE:
The failover and SAN device management APIs are QLogic-specific libraries
required for SANsurfer FC HBA CLI. The versions of these libraries are
useful for debugging purposes.
5.2.2
Host Configuration
(Command Line Option -z)
The command line option -zshows all of the HBA’s information in a single
command. The command format is:
# scli -z
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 HBA, type the following command:
# scli -z (<HBA Instance> | <HBA WWPN>)
Where:
HBA Instance
HBA WWPN
= HBA number (use -g command to find)
= World wide port name of the HBA
To show the information for all HBAs, type:
# scli -z all
5-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Display System Information (Command Line Options -g, -z, and -tp)
A
5.2.3
Host Topology
(Command Line Option -tp)
NOTE:
Under Linux, host topology (-tp) is disabled if you are using the ioctl or
sysfs (inbox) driver.
The command format for Host Topology is:
# scli -tp
When you select this option, the SANsurfer FC HBA CLI tool shows the
„
Interconnect Element (switch or HBA)
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Type (Switch or HBA)
World wide name
Domain ID
Management ID
IP address
Model
Symbolic name
Serial number
MAC address
Firmware version
Port count
Beacon status
„
Interconnect element (HBA):
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Type
World wide node name
World wide port name
Vendor ID
HBA Model
HBA Serial Number
HBA Alias
Port Alias
Driver Version
Firmware Version
Total Number of Devices
Host
Number of Port
Beacon status
Port Type
SN0054614-00 F
5-3
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Display System Information (Command Line Options -g, -z, and -tp)
S
‰
Port State
„
Port Information
‰
Physical Port Number (switch port number), including:
‰
‰
‰
‰
Port state
Port type
TX port type
Port module type
‰
Attached Port (QLogic HBA, tape device, or disk device connected to
the switch physical port), including:
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
‰
Target/initiator
Node name
Port name
Vendor ID
Product ID (if applicable)
Product revision (if applicable)
Product serial number (if applicable)
HBA model (if applicable)
HBA serial number (if applicable)
HBA alias (if applicable)
Port alias (if applicable)
Driver version
Firmware version
Total number of devices (if applicable)
Host (if applicable)
5.2.4
Host Configuration
Use these options to show the information for one or all of the HBA ports in the
system. The -zoption shows the combination of the commands listed in
.
Table 5-1. Options Shown by -z
CLI
-c
Description
See Section
Show HBA settings
Configure boot device
View driver settings
-e
-fg
-g
Show system information
5-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Table 5-1. Options Shown by -z (Continued)
CLI
-i
Description
See Section
Show HBA information (VPD information for QLA/QLE24xx
only)
-l
-m
-p
-t
Show LUN list
Configure selective LUNs
Configure target persistent binding
Show target list
5.3
Command Summary
The command format for non-interactive mode is:
# scli -(Cmd) (<HBA Instance> | <HBA WWPN>) (view | ?)
Where:
HBA Instance = HBA port instance (use -g command to find)
HBA WWPN = HBA World wide port name
You can combine the commands -o, -sand -xwith other options. However, they
must be at the beginning or at the end of the command line. Use these commands
as follows:
# scli -l -o
# scli -i all -s -o output.txt
# scli -i all -x -o output.xml
You cannot combine the command -fwith any other options:
example:
# scli -f command.txt
In addition, the following general rules for commands apply:
„
Only one command line option per input file is valid.
SN0054614-00 F
5-5
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
„
You can use either the hyphen (-) character or the forward slash (/)
character. For example, both of these commands are valid:
scli -g
scli /g
.
Table 5-2. Command Variables
Variable
Definition
HBA numbera
Format
<HBA Instance> or
<Instance number>
<HBA WWPN>
HBA world wide port name xx-xx-xx-xx-xx-xx-xx-xx or
xxxxxxxxxxxxxx
Symbolic HBAb name
HBA Alias
<Alias>
<Target WWNN>
Target world wide node
name
xx-xx-xx-xx-xx-xx-xx-xx or
xxxxxxxxxxxxxx
<Target WWPN>
Target world wide port
name
xx-xx-xx-xx-xx-xx-xx-xx or
xxxxxxxxxxxxxx
<Target Port ID>
<Target ID>
<LUN ID>
Target port ID
Target ID
xx-xx-xx or xxxxxx
Logical unit number
IP Address
(0–255)
<Address>
xxx.xxx.xxx.xxx
1.2 or 4 GHz
(speed)
Target link speed
a You can use the -g command to find HBA numbers.
b You assign the symbolic name. It is limited to 100 characters in length.
5.3.1
-a
(View or Toggle Beacon Status)
Use the -acommand to either view (1) or change (2) the status of a beacon.
NOTES:
to this command.
„ The -afeature is not supported on QLA22xx HBAs.
5-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
To view the HBA port’s LED Beacon state, type:
# scli -a (<HBA Instance> | <HBA WWPN>)(view | ?)
When the HBA’s LED is flashing, the following message appears:
HBA Port x - LED Flashing is ON.
When the HBA’s LED is not flashing, the following message appears:
HBA Port x - LED Flashing is OFF.
In Solaris SPARC, include double quotes around the question mark (?) if the
system is running with a csh or tsch shell. For example:
# scli -a <HBA> "?"
To start or stop flashing the HBA’s LED beacon, type:
# scli -a (<HBA Instance> | <HBA WWPN>)
SANsurfer FC HBA CLI toggles the LED’s state. If the LED is flashing, the flashing
stops. If the LED is not flashing, the flashing begins.
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 <HBA Instance> or <HBA WWPN> must match the command input
parameter.
5.3.2
-b
(Save or Update the Flash BIOS or Fcode)
Use the -bcommand to:
„
„
Update the BIOS or Fcode from a file (1).
Save the BIOS or Fcode to a file (2).
To update one or all HBA’s Flash with new BIOS or FCode, type:
# scli -b (all | <HBA Instance> | <HBA WWPN>) [(<-rg> <fw | boot>|
all)] <BIOS/FCode File Name>
Where:
all = All HBAs of the same type in the system are updated with the
new BIOS/FCode
SN0054614-00 F
5-7
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name
a
-rg =
Flash region update mode (4GB HBAs only ):
fw = Update firmware only
boot = Update bootcode only (BIOS/FCode/EFI image)
all = Update all regions (BIOS/FCode/EFI) depending on
the Flash image.
BIOS/FCode File = Name or path of file continuing update BIOS/FCode
Name
aRegion update only supported on QLA/QLE/QMC246x HBAs.
To save the BIOS/FCode to a file, type:
# scli -b (<HBA Instance> | <HBA WWPN>) SAVE <BIOS/FCode File Name>
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
BIOS/FCode File = File name or a path to a file in which to save BIOS/FCode
Name
5.3.3
-c
(Show Parameter Settings)
Use the -ccommand to show the parameter settings for all HBAs in the system:
# scli -c [ <all> ]
To show the parameter settings for a specific HBA, type:
# scli -c (<HBA Instance> | <HBA WWPN>)
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
5.3.4
-d
(Update Device Driver)
Use the -dcommand to update the HBA’s device driver:
scli -d <File Name>
5-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Where:
File Name = Absolute or full path name of the setup INF file or the com-
pressed driver file in ZIP or EXE format. The binary image of
the device driver must reside in the same absolute or full path
location. For example:
scli -d c:\temp\ql2300\qlxxx.inf
5.3.5
-dm
(Display Diagnostics Monitoring Info)
This option allows you to show general or detailed Digital Diagnostic Monitoring
Interface for optical transceivers.
NOTES:
„ This option is supported only for QLA/QLE/QEM24xx (4GB) HBAs.
„ Under Solaris, this option is disabled if you are using Linux inbox drivers
(SLES 10.0/RHEL 5.0 or latest).
To show Transceiver monitoring general information, type:
# scli -dm (<HBA Instance> | <HBA WWPN> | <all>)general | gen
To show Transceiver monitoring detailed information, type:
# scli -dm (<HBA Instance> | <HBA WWPN> | all)details | det
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
all = All HBAs in the system
5.3.6
-e
(Boot Device View | Select | Disable)
Use the -ecommand to:
„
„
„
„
„
Show the current boot-device selection for all HBAs (1).
Show the current boot-device selection for a specific HBA (2).
Set a target device as the boot device for an HBA (3).
Selectable boot—The OS boots from the first target the BIOS finds (4).
Delete the boot device from an HBA (5).
SN0054614-00 F
5-9
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
In these commands:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
Target WWNN = World wide node name of the target
Target WWPN = World wide port name of the target
Target ID = ID to which the target is bound
LUN ID = ID of the LUN
To view the current boot device selection on all HBAs:
# scli -e (view | ?)
To view the current boot device selection for a specific HBA:
# 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 HBA’s currently selected boot device is shown in the
following format:
<HBA Number> <HBA WWPN> <Target WWNN> <Target WWPN> <LUN ID>
Solaris shows each HBA’s currently selected boot device in the following format:
<HBA Number> <HBA WWPN> <Target WWNN> <Target WWPN> <Target
ID> <LUN ID>
If the system does not have an HBA with a boot device selected, the following
message appears:
There is no boot device selected for any HBA in the system.
Following is an example of the Boot Device option when viewing the boot device
for a single HBA. In this example, no boot device is configured (selectable boot is
disabled; the boot port name is all zeroes).
-------------------------------------------------------------
HBA 1: QLA2340 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 00-00-00
-------------------------------------------------------------
Boot Device Settings:
--------------------------------------
Selectable Boot: Disabled
--------------------------------------
(Primary) Boot Port Name LUN
----------------------- ----------------------- ------
00-00-00-00-00-00-00-00 00-00-00-00-00-00-00-00
Press <Enter> to continue:
0
5-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
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 particular target as the boot device for a specific HBA, type the following
command:
# scli -e (<HBA Instance> | <HBA WWPN>) <Target WWNN> <Target
WWPN> <Target ID> <LUN ID>
NOTE:
Because x86 Solaris does not require the Target ID, the Solaris command is:
# scli -e (<HBA Instance> | <HBA WWPN>) <Target WWNN> <Target
WWPN> <LUN ID>
SANsurfer FC HBA CLI checks all parameters to verify that the HBA, targets, and
LUNs are valid.
If you select an HBA with no target or a target with no LUN, SANsurfer FC HBA
CLI shows an error message and aborts.
In Solaris SPARC, setting the target ID to the target of the boot-selected LUN is
persistently bound, its boot device entry must have the same target ID.
For all operating systems, if the HBA already has boot devices defined and they
are different from the ones in the command parameter or menu selection, you are
prompted to confirm the boot device selection:
The HBA already has a boot device(s) selected. Do you want to
replace it with the new one?
For all operating systems, if the HBA already has boot devices selected and they
are the same as the ones in the command 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 HBA, type:
# scli -e (<HBA Instance> | <HBA WWPN>) disable
SN0054614-00 F
5-11
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
5.3.7
-ei
(List SANsurfer FC HBA CLI Error Codes)
This command lists the SANsurfer FC HBA CLI error codes as shown in
5.3.8
-f
(Input Parameter Options from a Text File)
NOTE:
The -foption is valid only in non-interactive mode, and cannot be combined
with any other options. Only one command line parameter per file is valid.
This option is used when it is run as a script file.
To input parameter options to SANsurfer FC HBA CLI through a text file, type -f,
followed by the file name. For example:
# scli -f command.txt
The text file must be formatted as follows:
„
„
„
The file must contain a single line.
The file must contain only parameters.
The file cannot contain another -foption.
The following example shows how to set the connection option of a HBA to default
(loop preferred, otherwise point-to-point) and the data rate to auto through a
command file that is invoked by the -foption:
1.
Create a text file (for example, sethba0.txt) and enter the following
command in the text file:
-n 0 co 2 dr 2
2.
3.
Save and close the file.
Issue the sclicommand with the -foption (input from command file):
# scli -f sethba0.txt
# scli -f <File Name>
SANsurfer FC HBA CLI specifies command line input from file.
5-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
5.3.9
-fg
(Show Driver Settings)
NOTE:
The -fgoption is valid only in non-interactive mode.
To show the driver settings, type:
# scli -fg (<HBA Instance> | <HBA WWPN>) (view | ?)
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
5.3.10
-fs
(Configure Driver Settings)
Type the following command to configure the driver settings:
# scli -fs (<HBA Instance> | <HBA WWPN>) {(<Parameter Name> |
<Parameter Alias>) <Param Value>}
Where:
HBA Instance = HBA instance number of an HBA port (use -gcom-
mand to find)
HBA WWPN = World wide port name of the HBA
Parameter Name = Name of the parameters
Parameter Alias = Alias of the parameters
Parameter Value = New value of the parameters
The pairs <Parameter Name> <Parameter Value> and <Parameter Alias>
<Parameter Value> can be repeated to set multiple parameters in a single
command.
Table 5-3. Driver Settings Parameters
Valuea
<param
value>
Alias
<param
alias>
Parameter Name
<param name>
Description
Persistently bound target(s) only
PersistentOnly
PO
0, 1
SN0054614-00 F
5-13
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
Table 5-3. Driver Settings Parameters (Continued)
Valuea
<param
value>
Alias
<param
alias>
Parameter Name
<param name>
Description
Present persistently bound tar-
get(s) plus any new target(s) with
driver default
PersistentPlusNew PN
0, 1
NewOnlyb
NO
Present targets with driver default
Bind devices by WWPN
0, 1
0, 1
0, 1
BindWWPN
BW
BP
Bind devices by port ID
BindPortID
Table Notes
a 0 = Disabled, 1 = Enabled
b Driver parameter NewOnly (NO)is supported only with the failover driver. If you select a QLA22xx HBA, all
QLA22xx HBAs on the host will use the same settings. If you select a 23xx HBA, all 2G/4G HBAs on the host will
also use the same settings.
The following restrictions apply:
„
„
„
Under Solaris, the driver configuration feature is disabled if you are using the
driver from the OS installation CDs (QLC driver).
Under Linux, this feature is disabled if you are using the ioctl or sysfs (inbox)
driver.
Under Macintosh, the BindWWPNand BindPortIDparameters are not
changeable; Mac supports only the BindWWPNparameter.
5.3.11
-g
(Display System Information)
To view system information, type:
# scli -g
5.3.12
-gs
(Show HBA Statistics)
To view the HBA statistics, type:
# scli -gs (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>]
5-14
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
Parameter Name = Name of the parameter (see table 4-7)
Parameter Alias = Alias of the parameter (see table 4-7)
Parameter Value = New value of the parameter (see table 4-7)
Table 5-4. HBA Statistics Parameters
Description
Name
Alias
Value
0–256a
Sets how often statistics are
retrieved
AutoPoll
AP
Set the polling interval when
retrieving statistics (seconds)
PollRate
SR
LF
5–30
Saves the HBA’s statistics to
a CVS log file
LogToFile
Log file name
Table Notes
When the AutoPoll parameter is 0, statistics are retrieved automatically until the user aborts
the operation. When the AutoPoll parameter is in the range of 1–256, statistics are retrieved
for the number of cycles specified by this value.
Under Solaris, this feature is disabled if you are using the driver from the OS
installation CDs (QLC driver). Under Linux, this feature is disabled if you are using
the ioctl or sysfs (inbox) driver.
5.3.13
-h
(Help)
Type the following text to view the help file:
# scli (-h | ?)
Type the following text to view help information for an individual command:
# scli <Command Line Parameter> (-h | ?)
For example, typing scli -l -hshows:
SANsurfer FC HBA CLI
v1.x.x Build x
Copyright 2003-2007 QLogic Corp.
All rights reserved.
SN0054614-00 F
5-15
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
Command Line QLogic FC Host Bus Adapters
scli -l (<hba no> | <hba wwpn>)
- shows LUN information for all HBAs.
scli -l (<hba no> | <hba wwpn>) (<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
NOTE:
To view the current version information for SANsurfer FC HBA CLI, use the
5.3.14
-ha
(Set | Delete HBA Alias)
With this command you can view, set or delete the alias of a specific HBA.
To view the alias of a specified HBA, type:
# scli -ha (<HBA Instance> | <HBA WWPN>) view | ?
To set an alias for a specified HBA, type:
# scli -ha (<HBA Instance> | <HBA WWPN>) <Alias>
To delete an alias of a specified HBA, type:
# scli -ha (<HBA Instance> | <HBA WWPN>) delete
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
Alias = Symbolic HBA name. (100 characters, maximum)
To set an alias for the selected HBA:
# scli -ha (<HBA Instance> | <HBA WWPN>) <Alias>
To delete the current alias of the selected HBA:
# scli -ha (<HBA Instance> | <HBA WWPN>) delete
To view the current alias of the selected HBA:
# scli -ha (<HBA Instance> | <HBA WWPN>) view | ?
5-16
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
5.3.15
-i
(Display HBA General Information or VPD Information for One or All HBAs)
To show general HBA information or VPD information for all HBA ports in the
system, type the following command:
# scli -i [ <all> ] [ <VPD> ]
Where:
all = All HBAs in the system
VPD = Vital Product Data
To show general or VPD information for a specific HBA, type:
# scli -I (<HBA Instance> | <HBA WWPN>) [ VPD ]
To show VPD (QLA/QLE24xx only) for all HBA ports in the system, type:
# scli -i VPD
# scli -i all VPD
Where:
all = VPD information for all HBAs in the system
5.3.16
-kl
(Loopback Test)
Use the -klcommand to perform the loopback test.
To do a loopback test with the default parameters, type:
# scli -kl (<HBA Instance> | <HBA WWPN>)
To do a loopback test with customized parameters, type:
# scli -kl (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>]
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
-ex or -exclude Target = World wide port name of the target device to be
WWPN excluded from the read/write test
SN0054614-00 F
5-17
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
Parameter Name = One of the following:
„
„
„
„
„
Parameter Alias = One of the following:
„
„
„
„
„
Parameter Value = Value for selected parameter
line examples and test results for a read/write buffer test.
5.3.16.1
DataPattern (DP)
For the loopback test, the data pattern is either:
DP <Parameter Value>
DataPattern <Parameter Value>
The data pattern must be in a two-character hexadecimal pattern in the range
of 00–FF. The hexadecimal letters can be uppercase or lowercase. The default
pattern is random, for example:
# scli -kl(<HBA Instance> | <HBA WWPN>) DP Random
To enter a customized value (in the range of 00–FF), type:
# scli -kl (<HBA Instance> | <HBA WWPN>) DP <Parameter Value>
In addition to a hex pattern, you can enter a compliant random data pattern
(CRPAT), jitter tolerance pattern (CJTPAT), or supply noise test sequence
(CSPAT) for a loopback test. For example:
# scli -kl (<HBA Instance> | <HBA WWPN>) DP CJTPAT
5-18
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Table 5-5. Data Pattern Values
Hex
Binary
00h
00000000
01010101
01011010
10100101
10101010
11111111
55h
5Ah
A5h
AAh
FFh
Random
Customized (00–FF)
CRPAT (loopback test only)
CJTPAT (loopback test only)
CSPAT (loopback test only)
Table Notes
Complaint random data pattern in a valid FC frame, as defined by the ANSI doc-
ument Methodologies for Jitter and Signal Quality Specification - MJSQ Annex A
- Test bit sequences.
Complaint jitter tolerance pattern in an FC frame, as defined by the ASIC docu-
ment listed above.
Supply noise test sequence in a valid FC frame, as defined by the ASIC docu-
ment listed above.
5.3.16.2
DataSize (DS)
For the loopback test, the data size is either:
DS <Parameter Value>
DataSize <Parameter Value>
The valid data sizes are as follows:
„
„
„
Read/write buffer test. The data size can be 8, 16, 32, 64, or 128 bytes.
The default value is 128 bytes.
Echo test. The data size can be 8, 16, 32, 64, 128, 256, 512, 1024, or 2048.
The default size is 512.
Loopback test (Windows, Solaris, and Macintosh systems). The data
size can be 8, 16, 32, 64, 128, 256, 512, 1024, or 2048. The default value is
512 bytes.
SN0054614-00 F
5-19
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
„
Loopback test (Linux systems). The data size can be 8, 16, 32, 64, 128,
256, 512, 1024, 2048, 4096, 8192, 16384, 32768, or 65535. The default
value is 512 bytes.
5.3.16.3
TestCount (TC)
The number of loopback tests is either:
TC <Parameter Value>
TestCount <Parameter 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 the test runs continuously (it stops when
you press ENTER). The default number of tests run is 500.
5.3.16.4
Test Increment (TI)
The Test Increment for the loopback test is either of the following:
TI <Parameter Value>
Test Increment <Parameter Value>
For a read/write buffer test, the test increment must be in the range of 1–10000.
For a loopback test, the test increment must be in the range of 1–65535.
automatically set to one of the following:
„
„
„
12 (Windows)
25 (Solaris)
2 (Linux and Macintosh)
The default test increment is 1. The test increment cannot be larger than the
5.3.16.5
OnError (OE)
For the loopback test, OnError is either:
OE <Parameter Value>
OnError <Parameter Value>
values.
5-20
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Table 5-6. OnError Values
Value
Description
0
1
2
The error is ignored. This is the default value.
The test stops on error.
On error, the data pattern and test repeat until the error is cleared.
5.3.16.6
Run a Loopback Test
The loopback test sends and receives messages, through a loopback or through
an echo command, to the switch.
NOTE:
The loopback test is disabled if you are using the drivers from the OS
installation.
NOTES:
Run an echo test instead of a loopback test under the following conditions:
„ You have a QLA23xx, QLA24xx, QLE23xx, or QLE24xx HBA that is
connected to the fabric through a point-to-point connection (F-port).
„ The HBA is connected to a switch.
connector.
.
Table 5-7. Driver Versions Not Requiring a Loopback Connector
Operating System
Driver Version
Windows XP, Windows 2000, or Windows Server 2003 with SCSI 9.0.0.12
miniport driver
Windows Server 2003 with STORport miniport driver
Solaris SPARC
9.0.0.12
4.12
Table Notes
All subsequent versions also apply.
To do a loopback test using the current parameters, type:
SN0054614-00 F
5-21
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
# scli --kl (<HBA Instance> | <HBA WWPN>)
To do a loopback test with custom parameters, type:
# scli --kl (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>]
The following examples do 500 loopback tests with a test increment of 10, a data
pattern of FFh, and a data size of 8 bytes. The test stops if an error occurs.
# scli -kl <HBA WWPN> DP FF DS 8 TC 500 TI 10 OE 1
# scli -kl <HBA Instance> DP FF DS 8 TC 500 TI 10 OE 1
You do not have to set each parameter for the loopback test. If you do not specify
a parameter in the command 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 -kl <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 -kl <HBA WWPN> DS 16 OE 2
An example of a successful loopback test follows:
------------------
Test Configuration
------------------
Data Pattern
= Random
= 512
Data Size (Bytes)
Number of test(s) (0-65535) = N/A
Test Increment (1-65535)
On Error
Test Continuous
= 125
= Ignore
= 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
/
The test results are described in the following paragraphs.
Status – Test result. The possible values are:
„
‰
Success – The test passed.
5-22
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
‰
‰
‰
Error – CRC, disparity, or frame length errors occurred.
Failed – An error occurred when attempting to issue a command.
Loop down – The loop is down.
„
„
„
CRC – Number of CRC errors.
Disparity – Number of disparity errors.
Frame Length – Number of frame length errors.
-kl (<HBA Instance> | <HBA WWPN>) [{(<Parameter Name> |
<Parameter Alias>) <Parameter Value>}]
5.3.17
-kl
(Run HBA Diagnostics Loopback Test)
NOTE:
Under Solaris, this feature is disabled if you are using the driver from the OS
installation CDs (QLC driver).
The <Parameter Name>, <Parameter Alias>, and <Parameter Value> options are
The system shows the following information after a loopback test completes:
„
„
„
„
Test status
CRC error
Disparity error
Frame length error
5.3.18
-kr
(Run Read/Write Buffer Test)
Use the -krcommand to do read/write buffer test. (To run the loopback test, use
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>] (<Parameter Name> | <Parameter Alias>)
<Parameter Value>
SN0054614-00 F
5-23
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
-EX or -EXCLUDE = World wide port name of the target device that is
Target WWPN
excluded from the read/write test
Parameter Name = One of the following:
„
„
„
„
„
Parameter Alias = One of the following:
„
„
„
„
„
Parameter Value = Value for selected parameter
line examples and test results for a read/write buffer test.
5.3.18.1
Run a Read/Write Buffer Test
This test runs on all devices or on the devices you select on the HBA you select.
This test sends the SCSI Write Buffer command to the target devices and uses
the SCSI Read Buffer command to read the returned data and do a data
comparison.
NOTE:
All devices attached to the HBA must support SCSI Read/Write Buffer
commands.
To do a read/write buffer test using the current parameters, type:
5-24
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
# scli -kr (<HBA Instance> | <HBA WWPN>)
To exclude a device or devices on the selected HBA port, type:
# scli -kr (<HBA Instance>|<HBA WWPN>) [(-EX | -EXCLUDE)
<Target WWPN>] [(<Parameter Name> | <Parameter Alias>)
<Parameter Value>]
Sections 6.17.0.0.1 through 6.17.0.0.5 describe the parameters and their default
values.
The following examples do 500 read/write buffer tests with a test increment of 10,
a data pattern of FFh, and a data size of 8 bytes. The test stops if an error occurs.
# scli -kr <HBA Instance> DP FF DS 8 TC 500 TI 10 OE 1
# scli -kr <HBA WWPN> DP FF DS 8 TC 500 TI 10 OE 1
You do not have to set each parameter for the read/write buffer test. If you do not
specify a parameter in the command 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 test follows:
HBA 1: QEM2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 02-0E-00
------------------
Test Configuration
------------------
Data Pattern
Data Size (Bytes)
: Random
: 512
Number of test(s) (0-65535) : 500
Test Increment (1-65535)
On Error
Test Continuous
: 1
: Ignore
: OFF
------------------------------------------------------------------------------
Diagnostics - Loopback Test Result
---------------------------------------------
Note: Press <Enter> to stop the test any time
---------------------------------------------
HBA Test Data Pattern
------------------------------------------------------------------------------
B4-31-0E-AA-AD-CF-D5-B0 Success 0
Status
CRC Disparity FrameLength Active
1
0
0
\
-kr (<HBA Instance> | <HBA WWPN>) [{(-EX | -EXCLUDE) <Target WWPN>}]
[(<Parameter Name>| <Parameter Alias>) <Parameter Value>
SN0054614-00 F
5-25
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
5.3.18.2
Run HBA Diagnostics Read-write Buffer Test
The {(-ex | exclude) <Target WWPN>}parameters specify a device that
will be excluded from the read/write buffer test.
The system shows the following information after a read/write buffer test
completes:
„
„
„
„
„
„
Loop ID/status
Data miscompare
Link failure
Loss of sync
Loss of signal
Invalid CRC
Value> options.
Table 5-8. Diagnostics Parameters
Name
Alias
Value
Description
Test pattern in hex formata
Customized (00–FF)
Random pattern
CRPATb
DataPattern DP
00, 55, 5A, A5, AA, FF
—
—
Loopback test only
Loopback test only
Loopback test only
CJTPATc
CSPATd
DataSizee
DS
8, 16, 32, 64, 128, 256,
512, 1024, 2048
Actual data transferred
during any given pass of
the test
TestCountf
TC
0–65535
0–10,000
Loopback test only
Read/write buffer test only
TestIncre- TI
mentg
1–65535
1–10,000
Loopback test only
Read/write buffer test only
OnError
OE
0–2
0 = ignore
1 = stop
2 = loop on error
Table Notes
a Valid two-character case-insensitive hexadecimal patterns.
5-26
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
b Complaint 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.
c Complaint jitter tolerance pattern in a FC frame, as defined by the ASIC document listed above.
d 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 Windows, Solaris, and Macintosh systems, the maximum
size is 2048; the default size is 512. For a loopback test on Linux OSs, the maximum size is 65535; the default
size is 512.
f
0=test continuously. 1–10,000 and 1–65535=total number of tests that will be executed.
g
Must be less than the TestCount value.
Table 5-9. Data Pattern (DP) Test Patterns
Hex
Binary
00
55
5A
A5
AA
FF
00000000
01010101
01011010
10100101
10101010
11111111
If the read/write buffer test fails, the system shows the following information:
„
„
Loop/port ID (the loop ID of the HBA when operating in loop mode).
Status:
‰
‰
‰
Success – The test passed.
Error – A data miscompare or link status firmware error occurred.
Failed – A link status error, SCSI write buffer error, or SCSI read buffer
error occurred.
‰
‰
Unknown – The target was not present.
Unsupported – The device does not support this test.
„
Data Miscompare. The possible values are:
‰
‰
‰
‰
‰
0 (no data miscompares)
Device not present
Get link status failed
Read buffer failed
R/W buffer not supported
SN0054614-00 F
5-27
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
‰
Write buffer failed
„
„
„
„
Link Failure – Number of link failures
Loss of sync – Number of sync loss errors
Loss of signal – Number of signal loss errors
Invalid CRC – Number of invalid CRCs
5.3.19
-l
(Display LUN Info)
This command shows LUN information for:
„
„
„
All HBAs
A specific target
A specific LUN on a specific target
To show the LUN information for all target devices for a specific HBA Instance,
type:
# scli -l (<HBA Instance> | <HBA WWPN>)
To show the LUN information for a specific device for a specific HBA 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 HBA port instance, type:
# scli -l (<HBA Instance> | <HBA WWPN>) (<Target Port ID> |
<Target WWPN>) <LUN ID>
Where:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
Target Port ID = Port ID of the target
Target WWPN = World wide port name of the target
LUN ID = ID of the LUN
5.3.20
-ls
(Display Link Status)
To view the link status, type:
# scli -ls (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>]
5-28
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
Table 5-10. Link Status Parameters
Description
Name
Alias
Value
0–256a cycles
5–30 seconds
Log file name
Sets link-status retrieval period
AutoPoll AP
Sets link-status retrieval polling interval PollRate SR
Save link status to CVS log file LogToFile LF
a When the AutoPoll parameter is 0, the link status is retrieved 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.
5.3.21
-m
(View, Enable, or Disable LUNs)
NOTES:
„ If the current driver setting is Bind by Port ID, this option is not available.
„ Under Solaris, if you use the driver from the OS installation CDs (QLC
driver), this feature is disabled.
„ Under Linux, if you use the ioctl or sysfs (inbox) driver, this feature is
disabled.
„ Under Solaris, the QLA HBA driver supports a maximum of 256 LUNs.
„ Under Solaris, the QLC HBA driver supports a maximum of 16K LUNs.
„ You must persistently bind the targets before configuring selective LUNs,
(link).
Use the -mcommand to:
„
„
„
„
View all selective LUNs for all HBA ports (1)
View an HBA’s selective LUN list (2)
View the current selective state of a LUN on a specific target (3)
Enable (select) a LUN on a specific target on a specific HBA (4)
SN0054614-00 F
5-29
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
„
„
„
„
„
Disable (deselect) a LUN on a specific target on a specific HBA (5)
Enable all LUNs on a specific target on a specific HBA (6)
Disable (deselect) all LUNs on a specific target on a specific HBA (7)
Enable (select) all LUNs of all targets on a specific HBA (8)
Disable (deselect) all LUNs of all targets on a specific HBA (9)
For these commands:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
Target WWNN = World wide node name of the target
Target WWPN = World wide port name of the target
LUN ID = ID of the LUN
To view all selective LUNs for all HBA ports, type:
# scli -m all (view | ?)
To view an HBA’s selective 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 HBA CLI shows the HBA’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>) (<Target WWNN> <Target
WWPN> <LUN ID>) (view | ?)
If the input represents a valid LUN, SANsurfer FC HBA CLI shows that LUN’s
current state as selected or deselected for that HBA.
To enable (select) a LUN on a specific target on a specific HBA, type:
# scli -m (<HBA Instance> | <HBA WWPN>) {<Target WWNN> <Target
WWPN> <LUN ID> ( 1 | enable | select )}
NOTE:
You can repeat the sequence <Target WWNN> <Target WWPN> <LUN ID>
1 to select multiple LUNs in the same command.
To disable (deselect) a LUN on a specific target on a specific HBA, type:
5-30
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
# scli -m (<HBA Instance> | <HBA WWPN>) {<Target WWNN> <Target
WWPN> <LUN ID> (0 | disable | deselect)}
NOTE:
To select multiple LUNs in the same command, repeat the following
sequence:
<Target WWNN> <Target WWPN> <LUN ID> 0
To enable (select) all LUNs for a specific target on a specific HBA, type:
# scli -m (<HBA Instance> | <HBA WWPN>) select | enable
<Target WWNN> <Target WWPN>
To disable (deselect) all LUNs for a specific target on a specific HBA, type:
# scli -m (<HBA Instance> | <HBA WWPN>) deselect | disable
<Target WWNN> <Target WWPN>
To enable (select) all LUNs of all targets on a specific HBA:
# scli -m (<HBA Instance> | <HBA WWPN>) select all
To disable (deselect) all LUNs of all targets on a specific HBA:
# scli -m (<HBA Instance> | <HBA WWPN>) deselect all
5.3.22
-n
(Set Selected HBA Parameter)
To set a specific parameter on a specific HBA, type:
# scli -n (<HBA Instance> | <HBA WWPN>) { (<Parameter Name> |
<Parameter Alias>) <Parameter Value> }
To restore the default BIOS (4G HBAs only), type:
# scli -n (<HBA Instance> | <HBA WWPN>) default
Where:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
Parameter Name = Name of the parameters
Parameter Alias = Alias of the parameters
Parameter Value = New value of the parameters
The pairs <Parameter Name> <Parameter Value> and <Parameter Alias>
<Parameter Value> can be repeated to set multiple parameters with a single
command.
SN0054614-00 F
5-31
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
.
Table 5-11. HBA Parameters
Description
Connection options
Data rate
Name
ConnectionOption
DataRate
Alias
Value
See table note, belowa
See table note, belowb
1=Enable, 0=Disable
1=Enable, 0=Disable
CO
DR
EB
EnableBIOSc
Enable BIOS
Enable extended logging EnableExtendedLog- EL
gingd
Enable FC tape
Enable hard loop ID
Enable LIP full login
Enable LIP reset
Enable target reset
Execution throttle
Frame size
EnableFCTape
EF
HL
1=Enable, 0=Disable
1=Enable, 0=Disable
1=Enable, 0=Disable
1=Enable, 0=Disable
1=Enable, 0=Disable
1–65535
EnableHardLoopID
EnableLIPFullLogin FL
EnableLipReset
EnableTargetReset
ExecutionThrottle
FrameSize
LP
TR
ET
FR
HD
ID
512, 1024, 2048
0–125
Hard loop ID
HardLoopID
Interrupt delay timer
InterruptDelay-
Timer
0–255
Login retry count
Link down timeout
LoginRetryCount
LinkDownTimeOut
LR
LT
0–255
0–240
Maximum LUNs per tar- MaximumLUNsPerTar- ML
0, 8, 16, 32, 64, 128,
256
get
get
See table note, belowe
Operation mode
Port down retry count
OperationMode
OM
PortDownRetryCount PD
ResetDelay RD
0–255
0-255
Reset Delay
Table Notes:
a Connection Options:
0 – Loop only
1 – Point-to-point only
2 – Loop preferred, otherwise point-to-point
3 – Point-to-point preferred, otherwise loop (QLA22xx HBAs only)
5-32
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
b
Data Rate (QLA23xx/QLA24xx/QLE23xx/QLE24xx HBAs):
0 – 1 Gbs
1 – 2Gbs
2 – Auto
3 – 4 Gbs
c
EnableBIOS option not available on 4Gb HBA.
d
EnableExtendedLogging option not available on PPC64 or SPARC.
e Operation mode (QLA/QLE23xx and QLA/QLE24xx HBAs):
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:
See the HBA Manager Index Adapter setting for QLA200/210 parameters.
5.3.23
-o
(Output to a File)
NOTES:
„ The -ooption is valid only in non-interactive mode.
„ This option can be used with all non-interactive mode options that have
must be the first or last command in the command line.
„ If the file already exists, new data are appended to the current file.
To output result and status messages into a file, type -o, followed by the file
name. For example, to save LUN information to a file named systemLUNinfo:
# scli -l -o systemLUNinfo
Where the file name is systemLUNinfo, all messages are located in the directory
indicated for the system platform:
Windows:
Linux:
syslog.log in the current directory
/var/log/messages
Macintosh:
Solaris:
/var/log/system.log
/var/adm/messages
SN0054614-00 F
5-33
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
5.3.24
-p
(Display Persistent Target Binding Info)
With this command you can:
„
„
„
„
„
Show binding information for one or on all HBAs (1)
Bind a specific target to a selected HBA (2)
Bind all targets on a specific HBA or on all HBAs (3)
Unbind a specific target (4)
Unbind all targets on a specific HBA or on all HBAs (5)
NOTES:
„ Under Solaris, if you use the driver from the OS installation CDs (QLC
driver), these features are disabled.
„ Under Linux, if you use the ioctl or sysfs (inbox) driver these features are
disabled.
To show target persistent binding information for a specific HBA port, type:
# scli -p (<HBA Instance> | <HBA WWPN>) (view | ?)
To show persistent binding information for all HBAs, type:
# scli -p all (view | ?)
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
NOTE:
In Solaris SPARC using a csh or tsch shell, include double quotes around
the question mark (?). For example:
# scli -p <HBA> "?"
The following example is a typical SANsurfer FC HBA CLI screen showing all
targets currently bound to an HBA:
--------------------------------------------------------------------------
HBA 0: QLA2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 11-06-EF
--------------------------------------------------------------------------
Bind Type Device Node Name
---- ---- ----------------
Device Port Name
----------------
Port ID ID
------- --
No
Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1
Yes Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E2 0
5-34
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Yes Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E4 1
Yes Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E8 2
Press <Enter> to continue:
To bind a selected target to a specific HBA, type:
# scli -p (<HBA Instance> | <HBA WWPN>) (<Target WWNN> <Target
WWPN> <Target Port ID> <Target ID>)
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWNN = Word wide node name of the HBA
HBA WWPN = World wide port name of the HBA
Target WWNN = World wide node name of the target
Target WWPN = World wide port name of the target
Target Port ID = Port ID of the target
Target ID = ID to which the target is bound
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 HBA or to bind all targets on all HBAs, type:
# scli -p (<HBA Instance> | <HBA WWPN> | all) bind all
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
To unbind a specific target, type:
# scli -p (<HBA Instance> | <HBA WWPN>) (remove <target WWNN>
| unbind <target WWNN>)
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
Target WWNN = World wide node name of the target
To unbind all targets on a specific HBA port or on all HBA ports, type:
# scli -p (<HBA Instance> | <HBA WWPN> | all) (remove all |
unbind all)
SN0054614-00 F
5-35
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
5.3.25
-pa
(Define Port Alias)
With this command you can:
„
„
„
Define the port alias for a specific HBA port (1)
Delete the port alias from a specific HBA port (2)
View the port alias for a specific HBA port (3)
To define a port alias for the specified HBA, type:
# scli -pa (<HBA Instance> | <HBA WWPN>) <alias>
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
Alias = Symbolic name you assign to the HBA port
To delete a port alias for the specified HBA port, type:
# scli -pa (<HBA Instance> | <HBA WWPN>) delete
To view a port alias for the specified HBA port, type:
# scli -pa (<HBA Instance> | <HBA WWPN>) view | ?
5.3.26
-q
(View or Set Target Link Speed)
NOTE:
The -qoption is supported only on 4GB HBAs.
Type the following command to view the link speed of all Targets attached to one
HBA or all HBA’s:
# scli -q (<HBA Instance> | <HBA WWPN> | <all>) [-targets | -t ]
5-36
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Where:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
all = Reports link speed for all targets on all HBAs in the system
-targets = All Targets
-t all targets
To view the link speed of a specific Target attached to an HBA, type the following
command:
# scli -q (<HBA Instance> | <HBA WWPN> | <Target WWPN>
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
Target WWPN = World wide port name of the Target
Type the following command to set the link speed of all Targets attached to one
HBA or all HBA’s to the designated speed:
# scli -q (<HBA Instance> | <HBA WWPN> | <all>) <-targets | -t
><speed>
Where:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
all = Reports link speed for all targets on all HBAs in the system
-targets = All Targets
-t all targets
speed link speed (
To set the link speed of selected Target(s) attached to one HBA to the designated
speed, type the following command:
# scli -q (<HBA Instance> | <HBA WWPN> | <all>) <Target
WWPN><speed>
Where:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
all = Reports link speed for all targets on all HBAs in the system
Target WWPN = World wide port name of the Target
speed link speed (
SN0054614-00 F
5-37
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
5.3.27
-r
(Update HBA Parameters)
To update the HBA Parameters, type:
# scli -r (<HBA Instance> | <HBA WWPN> | all) <File Name>
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
all = All HBA ports in the system are updated with the new HBA
parameters
HBA Parameters File = File name or a path to a file that contains the updated HBA
Name parameters
To save the HBA parameters to a file, type:
# scli -r (<HBA Instance> | <HBA WWPN>) save <File Name>
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
HBA Parameters File = File name or a path to a file to save the HBA parameters
Name
5.3.28
-s
(Silent Mode)
NOTES:
„ The -soption is valid only in non-interactive mode.
„ You can use this option with all non-interactive mode options that have a
be the first or last command in the command line.
In non-interactive mode, the system shows result and status messages generated
by SANsurfer FC HBA CLI (by default) unless suppressed by silent mode. You
saved in a file and does not appear on screen. For example:
# scli -I all -s -o output.txt
5-38
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
5.3.29
-t
(Display Target Information)
To show the target information for all HBAs in the system, type:
# scli -t [ <all> ]
To show the target information for a specific HBA, type:
# scli -t (<HBA Instance> | <HBA WWPN>)
To show specific target information for a specific target on an HBA, type:
# scli -t (<HBA Instance> | <HBA WWPN>) (<Target WWPN> |
<Target Port ID>)
Where:
HBA Instance = HBA number (use -g command to find)
HBA WWPN = World wide port name of the HBA
Target WWPN = World wide port name of the target
Target Port ID = Port ID of the target
To show the target information on all HBAs, type:
-t [<all>]
To show the target information on a specific HBA, type:
-t (<HBA Instance> | <HBA WWPN>)
To show the target information for a specific target on a specific HBA, type:
-t (<HBA Instance> | <HBA WWPN>) (<Target WWPN> | <Target Port
ID>)
iiDMA (Intelligent Interleave Factor) settings include:
„ —targets | –tapplies to all targets.
„ <speed>indicates the supported intelligent interleave factor: 1, 2, 4, or 8
Gbps.
5.3.30
-tb
(Target Beacon On/Off)
To start or stop flashing a target’s LED, type:
# scli -tb (<HBA Instance> | <HBA WWPN>) (<Target WWPN>) (<0 |
ON> | <1 | PRESET>)
SN0054614-00 F
5-39
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
NOTES:
„ The <0 | ON>option flashes the LED until interrupted. The <1 |
PRESET>option flashes the LED 12 times.
„ This feature is supported only on JBOD devices.
5.3.31
-tp
(Display Host Topology)
Use the -tpoption 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.
5.3.32
-v
(Display Version)
NOTE:
This option is valid only in non-interactive mode.
To show the version number of the SANsurfer FC HBA CLI tool, type:
# scli -v
The system shows the following information:
SANsurfer FC HBA CLI
v1.x.x Build x
Copyright 2003-2007 QLogic Corp.
All rights reserved.
Command Line QLogic FC Host Bus Adapters.
Build Type: Release
Build Date: xx/xx/xxxx xx:xx:xx AM
5.3.33
-vp
(Virtual Port)
To list all virtual ports on a physical HBA port, type:
# scli -vp (<HBA Instance> : <HBA WWPN>) list all
5-40
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
A
Where:
HBA Instance = HBA number (use -gcommand to find)
HBA WWPN = World wide port name of the HBA
vport WWPN = World wide port name of the virtual port
vport hex = World wide port name of the virtual port with the two
hex digits in byte three supplied by the user
To list a specific virtual port on a physical HBA port, type:
# scli -vp (<HBA Instance> : <HBA WWPN>) list <vport wwpn>
To create a virtual port with an automatic WWPN, type:
# scli -vp (<HBA Instance> : <HBA WWPN>) create auto
To create a virtual port with a specific WWPN, type:
# scli -vp (<HBA Instance> : <HBA WWPN>) create <vport hex>
When prompted, enter two hexadecimal digits. The system checks these digits to
be sure they are unique and, if they are, puts them into byte 3 of the WWPN.
To delete all virtual ports on a physical HBA port, type:
# scli -vp (<HBA Instance> : <HBA WWPN>) delete all
To delete a particular virtual port on a physical HBA port, type:
# scli -vp (<HBA Instance> : <HBA WWPN>) delete <vport wwpn>
5.3.34
-x
(Output in XML Format 1)
NOTE:
This option is valid only in non-interactive mode.
You can use this option with all non-interactive mode options that have a
first or last command in the command line.
When you use this option, the system shows all result and status messages in
file with XML output so that it can be parsed by an XML-compliant utility. For
example to show HBA general information and output it to an XML file named
output.xml:
# scli -i all -x -o output.xml
SN0054614-00 F
5-41
Download from Www.Somanuals.com. All Manuals Search And Download.
5 – Non-interactive Commands
Command Summary
S
5.3.35
-x2
(Output in XML Format 2)
NOTE:
This option is valid only in non-interactive mode.
You can use this option with all non-interactive mode options that have a
first or last command in the command line.
When you use this option, the system shows all result and status messages in
text file with XML output so that it can be parsed by an XML-compliant utility. For
example, to show HBA general information and output it to an XML file named
output.xml:
# scli -i all -x2 -o output.xml
5.3.36
-z
(Display All HBA information for One or All HBAs)
To show all information for one specific HBA or for all HBAs in the system, type:
# scli -z (<HBA Instance> | <HBA WWPN>) | <all>)
5-42
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Appendix A
XML Format 1
A.1
Introduction
NOTE:
XML files created using the -x1command line option do not match standard
output. They are designed for backward compatibility with customized
legacy scripts. For new scripts, we strongly recommend using the -x2
command line option, which generates standard output XML files (see
format 1. This section defines the XML format 1 output, which consists of the
following parts:
„
„
„
„
„
Main tag
Utility header
Status message
Error message
Reboot message
A.1.1
Main Tag
When SANsurfer FC HBA CLI is in XML mode, all outputs are within the main tag:
<QLogic>
...
</QLogic>
A.1.2
Utility Header
The following header information is displayed after the main tag:
<AppName> SANsurfer Command Line Utility </AppName>
<AppVersion> X.YY.ZZ Build XX</AppVersion>
SN0054614-00 F
A-1
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
A.1.3
Status Message
Before the closing main tag </QLogic>, SANsurfer FC HBA CLI displays
returning status from the execution of the command line parameters and the error
messages.
Successful execution of the command line parameters returns the following
status:
<Status> 0 </Status>
When the execution of the command line parameters fails, the status value of
non-zero is displayed, followed by an error message that provides additional
details:
<Status> 1 </Status>
<ErrorMsg> Details of the failure </ErrorMsg>
A.1.4
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
displayed:
<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 displayed:
<Reboot> 0 </Reboot>
A.1.5
Error Message
Before the closing main tag </QLogic>, but following the Status message
SANsurfer FC HBA CLI displays error information if the status is non-zero
(indicating a failure).
<ErrorMsg> Details of the failure </ErrorMsg>
A.2
XML Format 1 Tags for Each Option
The following sections describe the XML format 1 for each command line option.
In these sections, the term number refers to the adapter number displayed with
the HBA general information (command line option -I).
A-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
A.2.1
Display System Information
(Command Line Option -g)
The XML format 1 for system information output is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<Host>
<Name> Host Name </Name>
<OSType> OS Type </OSType>
<OSVersion> OS Version (and patches) </OSVersion>
<HBA Port="value" WWNN="value" WWPN="value" />
<NumOfHBA> Number of QLogic FC HBA(s) </NumOfHBA>
</Host>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The parameter <HBA…/>repeats for each HBA in the system.
A.2.2
Display Adapter Settings
(Command Line Option -c)
The XML Format 1 for adapter settings information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA 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"
EnableLipReset="value"
SN0054614-00 F
A-3
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
PortDownRetryCount="value"
EnableLipFulllogin="value"
LinkDownTimeout="value"
EnableTargetReset="value"
LUNsPerTarget="value" />
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
For clarity, each parameter is listed on a separate line; however, multiple
parameters can be on the same line.
For multiple adapters, repeat the above sequence with the ID number
(ID Number="value") of the next adapter.
A.2.3
Display HBA Information
(Command Line Option -i)
NOTE:
4G HBAs include VPD information as an option to the -Icommand.
The XML Format 1 for adapter general information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<GeneralInfo 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"
A-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
PortType="value"
Status="value"
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
Here is the information for the 4G HBAs:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC CLI</AppName>
<AppVersion>vn.nn.nn Build n.nn</AppVersion>
<HBA>
<GeneralInfo Port="value"
Model="value"
HBAID="value"
HBAALias=""
HBAPort=""
PortAlias=""
WWNN="value"
WWPN="value"
PortID="value"
SerialNumber="value"
DriverVersion="value"
BIOSVersion="value"
FirmwareVersion="value"
OptionROMBIOSVersion="value"
OptionROMCodeVersion="value"
OptionROMEFIVersion="value"
OptionROMFirmwareVersion="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 VPD information:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC CLI</AppName>
<AppVersion>vn.nn.nn Build n.nn</AppVersion>
<HBA>
<HBA Port="value" WWNN="value" WWPN="value" />
SN0054614-00 F
A-5
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
<VPD>
<VPDProductIdentifier="value"
VPD-RTAG=""
PartNumber="value"
SerialNumber="value"
MiscInformation="value"
ManufacturingID="value"
EFIDriverVersion="value"
FirmwareVersion="value"
BIOSVersion="value"
FCodeVersion="value"
AssetTag="value" />
</VPD>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A.2.4
Display Device List
(Command Line Option -t)
The XML Format 1 for adapter device information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBAPort="value" WWNN="value" WWPN="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"
DeviceStatus="value" />
</Target>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The <Target>…</Target>sequence is repeated for each HBA target.
A-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
A.2.5
Display LUN List
(Command Line Option -l)
The XML Format 1 for the adapter LUN list information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBAPort="value" WWNN="value" WWPN="value" />
<Target>
<WWNN> Target WWNN </WWNN>
<WWPN> Target WWPN </WWPN>
<LUN ID="value"
WWULN="value"
Vendor ="value"
Product ="value"
Revision ="value"
Size="value">
Type="value" />
</Target>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The <LUN … />sequence is repeated for each LUN attached to the target. The
LUN list is listed under the target, not the adapter.
The <Target>...</Target>sequence is repeated for each LUN attached to
the target.
A.2.6
Target Persistent Binding
(Command Line Option -p)
The XML Format 1 for the adapter target persistent binding information is as
follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC 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>
SN0054614-00 F
A-7
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The <TargetBinding … /> sequence is repeated for each target bound to the
adapter.
A.2.7
Selective LUNs
(Command Line Option -m)
The XML Format 1 for the selective LUNs information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="value" WWNN="value" WWPN="value" />
<Target>
<WWNN> Target WWNN </WWNN>
<WWPN> Target WWPN </WWPN>
<EnabledLUN ID="value" LUNWWNN="value" LUNWWPN="value"/>
</Target>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The <HBA> … </HBA> sequence repeats for each HBA.
The <Target> … </Target> sequence repeats for each Target.
The <EnabledLUN… /> sequence repeats for each enabled LUN under the
target.
A.2.8
Boot Device
(Command Line Option -e)
The XML Format 1 for the boot device information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC 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>
A-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
<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 present.
A.2.9
Diagnostics Results –Loopback Test
(Command Line Option -kl)
The XML Format 1 for the loopback test results is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="value" WWNN="value" WWPN="value" />
<Loop ID="value"
CRCError="value"
DisparityError="value"
FrameLengthError="value"
Result="value"/>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A.2.10
Diagnostics Results – Read/Write Buffer Test
(Command Line Option -kr)
The XML Format 1 for the read/write buffer test results is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="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> 0 </Status>
<Reboot> 0 </Reboot>
SN0054614-00 F
A-9
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
</QLogic>
The <Target>sequence is repeated for each device attached to the adapter.
A.2.11
View Driver Settings
(Command Line Option -fg)
The XML Format 1 for the current driver settings information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="value" WWNN="value" WWPN="value" />
<DriverSettings>
<Info PersistentPlusNew="value"
PersistentOnly="value"
BindbyWWPN="value"
BindbyPortID="value" />
/DriverSettings>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A.2.12
Display All Information for One or All HBAs
(Command Line Option -z)
The XML Format 1 for all adapter information is more complicated than its
non-XML counterpart because the tags cannot be repeated. In non-XML mode,
option is displayed in its standard output format. If each option displays its own
XML output, the resulting display would have multiple duplicate tags.
Table A-1. Options Displayed by -z
Non-interactive
Description
Section
Option
-g
-I
Display HBA information
Display HBA settings
Display device list
-c
-t
-L
Display LUN list
A-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
Table A-1. Options Displayed by -z (Continued)
Non-interactive
Option
Description
Section
-p
Target persistent binding
Selective LUNs
-m
-E
Boot device
The XML Format 1 for all adapter information is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<Host>
<Name> Host Name </Name>
<OSType> OS Type </OSType>
<OSVersion> OS Version (and patches where applicable)
</OSVersion>
<HBA Port="value" WWNN="value" WWPN="value" />
<NumOfHBA> Number of QLogic Fibre Channel HBA(s) detected
</NumOfHBA>
</Host> <HBA>
<HBA PortNumber="value" WWNN="value" WWPN="value" />
<GeneralInfo Port ="value"
Model="value"
HBAID="value"
HBAAlias="value"
MHBAPort="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" />
<VPD>
<VPD Product Identifier=""/>
</VPD>
SN0054614-00 F
A-11
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
<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"
EnableLipReset="value"
PortDownRetryCount="value"
EnableLipFulllogin="value"
LinkDownTimeout="value"
EnableTargetReset="value"
LUNsPerTarget="value" />
<Target>
<WWNN> Target WWNN </WWNN>
<WWPN> Target WWPN </WWPN>
<Info Path= "value"
Vendor ="value"
ProductID= "value"
Revision= "value"
SerialNumber= "value"
DeviceID= "value"
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"
PersistentOnly="value"
BindbyWWPN="value"
A-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
BindbyPortID="value" />
</DriverSettings>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
NOTES:
„ The <HBA>…</HBA>sequence is repeated for each HBA.
„ The <Target>…</Target>sequence is repeated for each target.
„ The <LUN… />parameter is repeated for each LUN.
„ The <EnabledLUN ID.… /> parameter is repeated for each enabled
LUN.
„ The <TargetBinding…/>parameter is repeated for each target
persistent binding entry.
„ The <BootDevice…/>parameter is repeated for each boot device
selection entry.
A.2.13
Link Statistics
(Command Line Option -ls)
The XML Format 1 for the link statistics option is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="value" WWPN="value" WWNN="value" />
<LinkStatus PortName="value"
LinkFailure="value"
SyncLoss="value"
SignalLoss="value"
InvalidCRC="value"
TimeStamp="value" />
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A.2.14
HBA Statistics
(Command Line Option -gs)
The XML Format 1 for the HBA statistics option is as follows:
SN0054614-00 F
A-13
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="value" WWPN="value" WWNN="value" />
<Statistics LoopID="value"
PortError="value"
DeviceError="value"
Reset="value"
IOCount="value"
IOPS="value"
BPS="value"
TimeStamp="value" />
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A.2.15
HBA Alias
(Command Line Option -ha)
The XML Format 1 for the HBA alias option is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC 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>
A.2.16
HBA Port Alias
(Command Line Option -pa)
The XML Format 1 for the HBA port alias option is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
A-14
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
<HBA Port="value" WWNN="value" WWPN="value" />
<PortAlias>
<Alias Name="value" />
</PortAlias>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A.2.17
SFF DMI
(Command Line Option -dm)
The XML Format 1 for SFF DMI (general information) is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<HBA>
<HBA Port="value" WWNN="value" WWPN="value" />
<MediaInformation>
<Vendor>"value"</Vendor>
<Type>"value"</Type>
<PartNumber>"value"</PartNumber>
<Speed>"value"</Speed>
<Revision>"value"</Revision>
<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>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<LowAlarm>"value"</LowAlarm>
</Voltage>
<TxBias>
SN0054614-00 F
A-15
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
<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"</LowWarning>
<LowAlarm>"value"</LowAlarm>
</TxPower>
<RxPower>
<MeasuredRxPowerUnit>(mW)</MeasuredRxPowerUnit>
<Value>"value"</Value>
<Status>"value"</Status>
<HighAlarm>"value"</HighAlarm>
<HighWarning>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<LowAlarm>"value"</LowAlarm>
</RxPower>
</Diagnostics>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The XML Format 1 for SFF DMI (detailed information) is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC 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>
<Connector>"value"</Connector>
<TransceiverData>
<Compliance> "value" </Compliance>
<FCLinkLength>"value" </FCLinkLength>
A-16
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
<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" </Length-50um>
<Length-62.5um> "value" </Length-62.5um>
<Length-Copper> "value" </Length-Copper>
<VendorName>"value"</VendorName>
<VendorOUI> "value" </VendorOUI>
<VendorPN>"value" </VendorPN>
<VendorRev>"value" </VendorRev>
<WaveLength>"value" </WaveLength>
<CC_BASE> "value" </CC_BASE>
<Options>
<SignalLossAsDefinedInSFPMSA> "value"
</SignalLossAsDefinedInSFPMSA>
<SignalLossInvertedFromSFPMSA>"value"
</SignalLossInvertedFromSFPMSA>
<TX_Fault_SignalImplemented> "value"
</TX_Fault_SignalImplemented>
<TX_DisableImplementedAndDisablesSerialOP>
"value"</TX_DisableImplementedAndDisablesSerialOP>
<RATE_SelectImplemented> "value"
</RATE_SelectImplemented>
</Options>
<BR-Max> "value" </BR-Max>
<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>
<SoftRateSelectCtrlAndMonitoring> "value"
</SoftRateSelectCtrlAndMonitoring>
<SoftRXLOSMonitoring> "value"</SoftRXLOSMonitoring>
<SoftTXFaultMonitoring> "value" </SoftTXFaultMonitoring>
<SoftTXDisableCtrlAndMonitoring> "value"
</SoftTXDisableCtrlAndMonitoring>
<Alarm-WarningFlags> "value" </Alarm-WarningFlags>
SN0054614-00 F
A-17
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
</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" </TempLowWarning>
<VoltageHighAlarm>"value"</VoltageHighAlarm>
<VoltageLowAlarm>"value"</VoltageLowAlarm>
<VoltageHighWarning>"value"</VoltageHighWarning>
<VoltageLowWarning>"value" </VoltageLowWarning>
<BiasHighAlarm>"value"</BiasHighAlarm>
<BiasLowAlarm>"value" </BiasLowAlarm>
<BiasHighWarning>"value" </BiasHighWarning>
<BiasLowWarning>"value" </BiasLowWarning>
<TXPowerHighAlarm>"value" </TXPowerHighAlarm>
<TXPowerLowAlarm>"value" </TXPowerLowAlarm>
<TXPowerHighWarning>"value"</TXPowerHighWarning>
<TXPowerLowWarning>"value"</TXPowerLowWarning>
<RXPowerHighAlarm>"value" </RXPowerHighAlarm>
<RXPowerLowAlarm>"value" </RXPowerLowAlarm>
<RXPowerHighWarning>"value"</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>
<Temperature_MSB> "value" </Temperature_MSB>
<Temperature_LSB> "value" </Temperature_LSB>
<Vcc_MSB> "value"</Vcc_MSB>
<Vcc_LSB> "value"</Vcc_LSB>
<TX_Bias_MSB> "value" </TX_Bias_MSB>
<TX_Bias_LSB> "value" </TX_Bias_LSB>
<TX_Power_MSB>"value" </TX_Power_MSB>
<TX_Power_LSB> "value" </TX_Power_LSB>
<RX_Power_MSB> "value" </RX_Power_MSB>
<RX_Power_LSB> "value" </RX_Power_LSB>
A-18
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
<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>
<SoftTXDisable> "value"</SoftTXDisable>
<TXDisableState> "value" </TXDisableState>
</StatusControlBits>
<TXPowerLowAlarm>"value" </TXPowerLowAlarm>
<TXPowerHighAlarm> "value" </TXPowerHighAlarm>
<TXBiasLowAlarm> "value" </TXBiasLowAlarm>
<TXBiasHighAlarm> "value" </TXBiasHighAlarm>
<VccLowAlarm> "value" </VccLowAlarm>
<VccHighAlarm> "value" </VccHighAlarm>
<TempLowAlarm> "value" </TempLowAlarm>
<TempHighAlarm> "value" </TempHighAlarm>
<RXPowerLowAlarm> "value" </RXPowerLowAlarm>
<RXPowerHighAlarm>"value" </RXPowerHighAlarm>
<TXPowerLowWarning> "value" </TXPowerLowWarning>
<TXPowerHighWarning> "value" </TXPowerHighWarning>
<TXBiasLowWarning> "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" </ReservedWarning>
<ReservedWarning> "value" </ReservedWarning>
<RXPowerLowWarning> "value" </RXPowerLowWarning>
<RXPowerLowWarning> "value" </RXPowerLowWarning>
<VendorSpecific> "value" </VendorSpecific>
</Address_A2>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
SN0054614-00 F
A-19
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
A.2.18
Host Topology
(Command Line Option -tp)
The XML Format 1 for an HBA type interconnect element is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<InterConnectElement Type="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"/>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The XML Format 1 for a switch type interconnect element is as follows:
<InterConnectElement Type="Switch">
<Switch WWPN="value" DomainID="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="value"
Alias="value"
PortAlias="value"
A-20
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
A
DriverVersion="value"
FirmwareVersion="value"
TotalNumberOfDevices="value"
Host="value"/>
</AttachedPort>
</PhysicalPort>
...
...
<PhysicalPort Number="value">
<Port WWPN="value" State="value" Type="value"
TXPortType="value" ModuleType="value"/>
<AttachedPort Type="Initiator">
<HBA PortName="value"
Host="DataUnavailable"/>
</AttachedPort>
</PhysicalPort>
...
...
</PhysicalPort>
<PhysicalPort Number="value">
<Port WWPN="value" State="value" Type="value"
TXPortType="value" ModuleType="value"/>
</PhysicalPort>
...
...
<PhysicalPort Number="value">
<Port WWPN="20-0A-00-C0-DD-00-B9-09"
<Port WWPN="value" State="value" Type="value"
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>
SN0054614-00 F
A-21
Download from Www.Somanuals.com. All Manuals Search And Download.
A – XML Format 1
XML Format 1 Tags for Each Option
S
</InterConnectElement>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
A-22
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Appendix B
XML Format 2
B.1
Introduction
NOTE:
XML files created using the -x2command line option match standard
output. They do not match the X1 files which are designed for backward
compatibility with customized legacy scripts. If you are developing new
scripts, we strongly recommend using the -x2command line option which
Format 2. This section defines the XML2 output format, which consists of the
following parts:
„
„
„
„
Main tag
Utility header
Status message
XML2 message (one for each option)
B.2
Main Tag
When SANsurfer FC HBA CLI is in XML2 mode, all outputs are between the main
tags:
<QLogic>
...
</QLogic>
B.3
Utility Header
The following header information is displayed after the main tag:
<AppName> SANsurfer FC HBA CLI </AppName>
<AppVersion> X.YY.ZZ Build XX</AppVersion>
<AppXMLVersion> X.YY </AppXMLVersion>
SN0054614-00 F
B-1
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Status Message
S
B.4
Status Message
Before the closing main tag </QLogic>, SANsurfer FC HBA CLI displays any
returning status from the execution of the command line parameters and the error
messages.
When the execution of the command line parameters is successful, the following
status is displayed:
<Status> 0 </Status>
When the execution of the command line parameters fails, the following status is
displayed, followed by an error message that provides additional details:
<Status> 1 </Status>
B.5
Error Message
When the execution of the command line parameters is fails an Error message
appears between the Status and Reboot tags. d the system must be restarted for
the change to take effect, the following message is displayed:
<ErrorMsg> "Details of the failure "</ErrorMsg>
B.6
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
displayed:
<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 displayed:
<Reboot> 0 </Reboot>
B.7
XML2 Tags for Each Option
The following sections describe the XML Format 2 for each command line option.
In these sections, the term number refers to the adapter number displayed with
the HBA general information (command line option -I).
B.7.1
Display Adapter Settings
(Command Line Option -c)
The command format is:
B-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
A
scli -c 0 -x2
The XML Format 2 for adapter settings information is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<Param
ConnectionOption="value"
DataRate="value"
FrameSize="value"
HardLoopId="value"
LoopResetDelay="value"
EnableHostAdapterBIOS="value"
EnableHardLoopId="value"
FibreChannelTapeSupport="value"
OperationMode="value"
IntDelayTimer="value"
ExecutionThrottle="value"
LoginRetryCount="value"
EnableLipReset="value"
PortDownRetryCount="value"
EnableLipFulllogin="value"
LinkDownTimeout="value"
EnableTargetReset="value"
LUNsPerTarget="value" />
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <HBA> …</HBA>sequence repeats for each HBA
Each parameter is listed on a separate line for clarity; however, multiple
parameters can be on the same line.
For multiple adapters, repeat the above sequence with the ID number
(ID Number="value")of the next adapter.
B.7.2
SFF DMI
(Command Line Option -dm)
The XML Format 2 for SFF DMI (general information) is as follows:
SN0054614-00 F
B-3
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
S
# 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 HBA CLI</AppName>
<AppVersion>vn.n.nn Build nn</AppVersion
<AppXmlVersion>n.nn</AppXmlVersion>
<HBA>
<HBA Instance="value" HBA Model="value" WWNN="value"
WWPN="value" />
<MediaInformation>
<Vendor>"value"</Vendor>
<Type>"value"</Type>
<PartNumber>"value"</PartNumber>
<Speed>"value"</Speed>
<Revision>"value"</Revision>
<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>(V)</MeasuredVoltage>
<Value>"value"</Value>
<Status>"value"</Status>
<HighAlarm>"value"</HighAlarm>
<HighWarning>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<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>
B-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
A
<MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit>
<Value>"value"</Value>
<Status>"value"</Status>
<HighAlarm>"value"</HighAlarm>
<HighWarning>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<LowAlarm>"value"</LowAlarm>
</TxPower>
<RxPower>
<MeasuredRxPowerUnit>(mW)</MeasuredRxPowerUnit>
<Value>"value"</Value>
<Status>"value"</Status>
<HighAlarm>"value"</HighAlarm>
<HighWarning>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<LowAlarm>"value"</LowAlarm>
</RxPower>
</Diagnostics>
</HBA>
The XML Format 2 for SFF DMI (general information) is as follows:
# scli -dm (<HBA Instance> | <HBA WWPN> | all) (details | det) -x2
The XML Format 2 for SFF DMI (detailed information) is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<OpticalTransceiverDigitalDiagnosticData></OpticalTransceiverDigit
alDiagnosticData>
<Address_A0>
<Identifier>"value" </Identifier>
<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>
SN0054614-00 F
B-5
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
S
<Length-9um> "value" </Length-9um>
<Length-50um> "value" </Length-50um>
<Length-62.5um> "value" </Length-62.5um>
<Length-Copper> "value" </Length-Copper>
<VendorName>"value"</VendorName>
<VendorOUI> "value" </VendorOUI>
<VendorPN>"value" </VendorPN>
<VendorRev>"value" </VendorRev>
<WaveLength>"value" </WaveLength>
<CC_BASE> "value" </CC_BASE>
<Options>
<SignalLossAsDefinedInSFPMSA> "value"
</SignalLossAsDefinedInSFPMSA>
<SignalLossInvertedFromSFPMSA>"value"
</SignalLossInvertedFromSFPMSA>
<TX_Fault_SignalImplemented> "value"
</TX_Fault_SignalImplemented>
<TX_DisableImplementedAndDisablesSerialOP>
"value"</TX_DisableImplementedAndDisablesSerialOP>
<RATE_SelectImplemented> "value" </RATE_SelectImplemented>
</Options>
<BR-Max> "value" </BR-Max>
<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>
<SoftRateSelectCtrlAndMonitoring> "value"
</SoftRateSelectCtrlAndMonitoring>
<SoftRXLOSMonitoring> "value"</SoftRXLOSMonitoring>
<SoftTXFaultMonitoring> "value" </SoftTXFaultMonitoring>
<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>
B-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
A
<TempHighWarning>"value"</TempHighWarning>
<TempLowWarning>"value" </TempLowWarning>
<VoltageHighAlarm>"value"</VoltageHighAlarm>
<VoltageLowAlarm>"value"</VoltageLowAlarm>
<VoltageHighWarning>"value"</VoltageHighWarning>
<VoltageLowWarning>"value" </VoltageLowWarning>
<BiasHighAlarm>"value"</BiasHighAlarm>
<BiasLowAlarm>"value" </BiasLowAlarm>
<BiasHighWarning>"value" </BiasHighWarning>
<BiasLowWarning>"value" </BiasLowWarning>
<TXPowerHighAlarm>"value" </TXPowerHighAlarm>
<TXPowerLowAlarm>"value" </TXPowerLowAlarm>
<TXPowerHighWarning>"value"</TXPowerHighWarning>
<TXPowerLowWarning>"value"</TXPowerLowWarning>
<RXPowerHighAlarm>"value" </RXPowerHighAlarm>
<RXPowerLowAlarm>"value" </RXPowerLowAlarm>
<RXPowerHighWarning>"value"</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_Slope>"value"</Tx_PWR_Slope>
<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>
<Temperature_MSB> "value" </Temperature_MSB>
<Temperature_LSB> "value" </Temperature_LSB>
<Vcc_MSB> "value"</Vcc_MSB>
<Vcc_LSB> "value"</Vcc_LSB>
<TX_Bias_MSB> "value" </TX_Bias_MSB>
<TX_Bias_LSB> "value" </TX_Bias_LSB>
<TX_Power_MSB>"value" </TX_Power_MSB>
<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>
SN0054614-00 F
B-7
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
S
<TXFault> "value" </TXFault>
<SoftRXRateSelect> "value" </SoftRXRateSelect>
<RXRateSelectState> "value" </RXRateSelectState>
<SoftTXDisable> "value"</SoftTXDisable>
<TXDisableState> "value" </TXDisableState>
</StatusControlBits>
<TXPowerLowAlarm>"value" </TXPowerLowAlarm>
<TXPowerHighAlarm> "value" </TXPowerHighAlarm>
<TXBiasLowAlarm> "value" </TXBiasLowAlarm>
<TXBiasHighAlarm> "value" </TXBiasHighAlarm>
<VccLowAlarm> "value" </VccLowAlarm>
<VccHighAlarm> "value" </VccHighAlarm>
<TempLowAlarm> "value" </TempLowAlarm>
<TempHighAlarm> "value" </TempHighAlarm>
<RXPowerLowAlarm> "value" </RXPowerLowAlarm>
<RXPowerHighAlarm>"value" </RXPowerHighAlarm>
<TXPowerLowWarning> "value" </TXPowerLowWarning>
<TXPowerHighWarning> "value" </TXPowerHighWarning>
<TXBiasLowWarning> "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" </ReservedWarning>
<ReservedWarning> "value" </ReservedWarning>
<RXPowerLowWarning> "value" </RXPowerLowWarning>
<RXPowerLowWarning> "value" </RXPowerLowWarning>
<VendorSpecific> "value" </VendorSpecific>
</Address_A2>
</HBA>
<Status> n </Status>
<?ErrorMsg> "message" </ErrorMsg?>
<Reboot> n /Reboot>
</QLogic>
B.7.3
Boot Device
(Command Line Option -e)
The command format for all HBAs is:
-e (view | ?) -x2
The command format for a single HBAs is:
B-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
XML2 Tags for Each Option
A
-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 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="value" />
<BootDevice TargetWWPN="value" LUNID="value"/>
</BootDeviceInfo>
</HBA>
<HBA>
<HBA Instance="value" HBAModel="value" HBAPort="value"
WWNN="value" WWPN="value" />
<BootDeviceInfo>
<BootParam EnableSelectableBoot="0" />
<BootDevice TargetWWPN="value" LUNID="value"
EnableSelectableBoot="0"/>
</BootDeviceInfo>
</HBA>
<Status> n </Status>
<?ErrorMsg> "message" </ErrorMsg?>
<Reboot> n /Reboot>
</QLogic>
The <HBA> …</HBA>sequence repeats for each HBA.
NOTE:
If Enable Selectable Boot is set to 1 in the Boot Param Enable Selectable
Boot tag, it does not appear in the Boot Device Target WWPN tag:
<BootParam EnableSelectableBoot="1" />
<BootDevice TargetWWPN="value" LUNID="value"
However, if Enable Selectable Boot is set to 0 in the Boot Param Enable
Selectable Boot tag, it appears in the Boot Device Target WWPN tag:
<BootParam EnableSelectableBoot="0" />
<BootDevice TargetWWPN="value" LUNID="value"
EnableSelectableBoot="0"/>
SN0054614-00 F
B-9
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
B.7.4
View Driver Settings
(Command Line Option -fg)
The command format is:
scli -fg (<HBA Instance> | <HBA WWPN>) (VIEW | ?) -x2
The XML Format 2 for the current driver settings information is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<DriverSettings>
<Info PersistentPlusNew="value"
PersistentOnly="value"
BindbyWWPN="value"
BindbyPortID="value" />
</DriverSettings>
</HBA>
<Status> n </Status>
<?ErrorMsg> "message" </ErrorMsg?>
<Reboot> n /Reboot>
</QLogic>
B.8
Display System Information
(Command Line Option -g)
The command format is:
scli -g -x2
The XML Format 2 for system information output is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC HBA CLISANsurfer FC HBA CLI</AppName>
<AppVersion>vn.n.nn Build nn</AppVersion
<AppXmlVersion>n.nn</AppXmlVersion>
<Host>
<Name> Host Name </Name>
<OSType> OS Type </OSType>
<OSVersion> OS Version <Build="value"</OSVersion>
<SDMAPIVersion>n.nn.nn.nn</SDMAPIVersion>
B-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
<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 HBA in the system.
B.8.1
Display HBA Information
(Command Line Option -I)
The command format is:
scli -i (<HBA Instance> | <HBA WWPN> | all) -x2
Another version of the command displays all information or VPD information:
scli -i [all] [vpd] -x2
The XML Format 2 for adapter general information is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.n.nn Build nn</AppVersion
<AppXmlVersion>n.nn</AppXmlVersion>
<HBA>
<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"
FirmwareVersion="value"
PCIbus="value"
PCIDevice="value"
ActualConnectionMode="value"
ActualDataRate="value"
TargetCount="value"
PortType="value"
Status="value"
SN0054614-00 F
B-11
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The XML Format 2 for 4G HBAs is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC 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"
OptionROMBIOSVersion="value"
OptionROMCodeVersion="value"
OptionROMEFIVersion="value"
OptionROMFirmwareVersion="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 CLI</AppName>
<AppVersion>vn.nn.nn Build n.nn</AppVersion>
<HBA>
<HBAInstance="value" HBAModel="value"HBAPort="value"
WWNN="value" WWPN="value" />
B-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
<VPD>
<VPD ProductIdentifier="value"
PartNumber="value"
SerialNumber="value"
MiscInformation="value"
ManufacturingID="value"
EFIDriverVersion="value"
FirmwareVersion="value"
BIOSVersion="value"
FCodeVersion="value"
</VPD>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
B.8.2
Diagnostics Results – Loopback Test
(Command Line Option -kl)
The command format is:
scli -kl (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>] -x2
The XML Format 2 for the loopback test results is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<Loop ID="value"
CRCError="value"
DisparityError="value"
FrameLengthError="value"
Result="Success"/>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
B.8.3
Diagnostics Results – Read/Write Buffer Test
(Command Line Option -kr)
The command format is:
SN0054614-00 F
B-13
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
scli -kr (<HBA Instance> | <HBA WWPN>) [(-EX | -EXCLUDE)
<Target WWPN>] (<Parameter Name> | <Parameter Alias>)
<Parameter Value> -x2
The XML Format 2 for the read/write buffer test results is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<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.
B.8.4
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 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" />
<Target>
<WWNN>value</WWNN>
<WWPN>value</WWPN>
<LUN ID="value"
WWULN="value"
B-14
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
Vendor="value"
Product="value"
Revision="value"
Size="value"
Type="value" />
</Target>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <Target>sequence repeats for each LUN attached to the target. The LUN
list is listed under the target, not under the adapter.
B.8.5
Selective LUNs
(Command Line Option -m)
The command format is:
scli -m all (view | ?) -x2
The XML Format 2 for the selective LUNs information is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<Target>
<WWNN> Target WWNN </WWNN>
<WWPN> Target WWPN </WWPN>
<EnabledLUN ID="value" LUNWWNN="value" LUNWWPN="value"/>
</Target>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <Target> … </Target> sequence repeats for each enabled LUN on the
target.
B.8.6
Target Persistent Binding
(Command Line Option -p)
The command format is:
SN0054614-00 F
B-15
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
scli -p (<HBA Instance> | <HBA WWPN> | all) (view | ?) -x2
The XML Format 2 for the adapter target persistent binding information is as
follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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 HBA.
The <Target binding … /> sequence repeats for each bound target.
B.8.7
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="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<Target>
<WWNN> Target WWNN </WWNN>
<WWPN> Target WWPN </WWPN>
<Info Path="value"
ID="value"
Vendor="value"
ProcuctID="value"
Revision="value"
SerialNumber="value"
B-16
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
DeviceID= "value"
PortID= "value"
LunCount= "value"
Type= "value"
DeviceStatus= "value" />
</Target>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <Target>…</Target>sequence repeats for each target.
The <HBA>…</HBA>sequence repeats for each HBA.
B.8.8
Display All Information for One or All HBAs
(Command Line Option -z)
The XML Format 2 for all adapter information is more complicated than its
non-XML counterpart because the tags cannot be repeated. In non-XML mode,
option is displayed in its standard output format. If each option displays its own
XML2 output, the resulting display would have multiple duplicate tags.
Table B-1. Options Displayed by -z
Non-interactive
Setting
Section
Option
-g
-c
-I
-t
-L
-P
-m
-E
Display HBA settings
Display HBA information
Display device list
Display LUN list
Target persistent binding
Selective LUNs
Boot device
The command format is:
scli -z (<HBA Instance> | <HBA WWPN> | all) -x2
The XML Format 2 for all adapter information is as follows:
<?xml version="value" encoding="value"?>
SN0054614-00 F
B-17
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.n.nn Build nn</AppVersion
<AppXmlVersion>n.nn</AppXmlVersion>
<Host>
<Name> Host Name </Name>
<OSType> OS Type </OSType>
<OSVersion> OS Version (BUILD) (patches)</OSVersion>
<SDMAPIVersion> SDMAPI version </SDMAPIVersion>
<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"
FirmwareVersion="value"
PCIBus="value"
PCIDevice="value"
ActualConnectionMode="value"
ActualDataRate="value"
TargetCount="value"
PortType="value"
Status="value" />
<Param ConnectionOption="value"
<VPD>
<VPD ProductIdentifier=""/>
</VPD>
<Param
ConnectionOption="value"
DataRate="value"
FrameSize="value"
HardLoopID="value"
LoopResetDelay="value"
EnableHostAdapterBIOS="value"
EnableHardLoopId="value"
FibreChannelTapeSupport="value"
B-18
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
OperationMode="value"
IntDelayTimer="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"
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" />
> <BootDeviceInfo>
<BootParam EnableSelectableBoot="value" />
<BootDevice TargetWWPN="value" LUNID="value" />
> </BootDeviceInfo> <DriverSettings>
<Info PersistentPlusNew="value"
PersistentOnly="value"
BindbyWWPN="value"
BindbyPortID="value" />
</DriverSettings>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
SN0054614-00 F
B-19
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
NOTES:
„ The <HBA>…</HBA>sequence repeats for each HBA.
„ The <DriverSettings…/>sequence repeats for each HBA.
„ The <VPD Product Identifier…/>sequence repeats for each
HBA.
„ The <Target>…</Target>sequence repeats for each target.
„ The <LUN… />sequence repeats for each LUN.
„ The <EnabledLUN ID.… />sequence repeats for each enabled LUN.
„ The <TargetBinding…/>sequence repeats for each target persistent
binding entry.
„ The <BootDevice…/>sequence repeats for each boot device selection
entry.
B.8.9
Link Statistics
(Command Line Option -ls)
The command format is:
scli -ls (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>] -x2
The XML Format 2 for the link statistics option is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<LinkStatus PortName="value"
LinkFailure="value"
SyncLoss="value"
SignalLoss="value"
InvalidCRC="value"
TimeStamp="value"/>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <HBA>…</HBA>sequence repeats for each HBA.
B-20
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
The <LinkStatus…/>parameter repeats for each link.
B.8.10
HBA Statistics
(Command Line Option -gs)
The command format is:
scli -gs (<HBA Instance> | <HBA WWPN>) [(<Parameter Name> |
<Parameter Alias>) <Parameter Value>] -x2
The XML Format 2 for the HBA statistics option is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC 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" />
<Statistics LoopID="value"
PortError="value"
DeviceError="value"
Reset="value"
IOCount="value"
IOPS="value"
BPS="value"
TimeStamp="value" />
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <Statistics.../>sequence repeats for each HBA.
B.8.11
View HBA Alias
(Command Line Option -ha)
The command format is:
scli -ha (<HBA Instance> | <HBA WWPN>) view | ? -x2
The XML Format 2 for the HBA alias option is as follows:
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.n.nn Build nn</AppVersion
<AppXmlVersion>n.nn</AppXmlVersion>
<HBA>
SN0054614-00 F
B-21
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
<HBA Instance="value" HBAModel="value" HBAPort="value"
WWNN="value" WWPN="value" />
<HBAAlias>
<AliasName="value" />
</HBAAlias>
</HBA>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
B.8.12
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 HBA port alias option is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.nn.nn Build nn</AppVersion>
<AppXmlVersion>2.0</AppXmlVersion>
<HBA>
<HBA Instance="value" HBAModel="value" HBAPort="value"
WWNN="value" WWPN="value" />
<PortAlias>
<Alias Name="value" />
</PortAlias>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
The XML Format 2 for SFF DMI (detailed information) is as follows:
<?xml version="1.0" encoding="ISO-8859-1"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>v1.7.0 Build 15</AppVersion>
<AppXmlVersion>2.0</AppXmlVersion>
<HBA>
<HBA Instance="value" HBAModel="value" HBAPort="value"
WWNN="value" WWPN="value" />
<MediaInformation>
<Vendor>"value"</Vendor>
<Type>"value"</Type>
<PartNumber>"value"</PartNumber>
B-22
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
<Speed>"value"</Speed>
<Revision>"value"</Revision>
<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>(V)</MeasuredVoltage>
<Value>"value"</Value>
<Status>"value"</Status>
<HighAlarm>"value"</HighAlarm>
<HighWarning>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<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"</LowWarning>
<LowAlarm>"value"</LowAlarm>
</TxPower>
<RxPower>
<MeasuredRxPowerUnit>(mW)</MeasuredRxPowerUnit>
<Value>"value"</Value>
<Status>"value"</Status>
<HighAlarm>"value"</HighAlarm>
<HighWarning>"value"</HighWarning>
<LowWarning>"value"</LowWarning>
<LowAlarm>"value"</LowAlarm>
SN0054614-00 F
B-23
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
</RxPower>
</Diagnostics>
</HBA>
<Status> 0 </Status>
<Reboot> 0 </Reboot>
</QLogic>
B.8.13
Host Topology
(Command Line Option -tp)
The command format is:
scli -tp -x2
The XML Format 2 for an HBA type interconnect element is as follows (this
example shows a switch):
<?xml version="value" encoding="value"?>
<QLogic>
<AppName>SANsurfer FC HBA CLI</AppName>
<AppVersion>vn.n.nn Build nn</AppVersion
<AppXmlVersion>n.nn</AppXmlVersion>
<InterConnectElement Type="Switch">
<SwitchWWPN="value"
DomainID="value"
ManagementID="value"
IPAddress="value"
Model="value"
SymbolicName="value"
SerialNumber="value"
MACAddress="value"
FirmwareVersion="value"
PortCount="value"
BeaconStatus="value"
<PhysicalPortInformation>
<PhysicalPortNumber="value">
<Port WWPN="value"
State="value"
Type="value"
TXPortType="value"
ModuleType="value"
<AttachedPort Type="value">
<HBANodeName="value"
PortName="value"
VendorID="value"
Model="value"
SerialNumber="value"
Alias="value"
B-24
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
A
PortAlias="value"
DriverVersion="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"/>
</InterconnectElement>
<Status> n </Status>
<Reboot> n /Reboot>
</QLogic>
The <InterconnectElement>…</InterconnectElement>sequence
repeats for each interconnect element.
SN0054614-00 F
B-25
Download from Www.Somanuals.com. All Manuals Search And Download.
B – XML Format 2
Display System Information (Command Line Option -g)
S
Notes
B-26
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Appendix C
Interactive Exit Codes
To list the exit codes while running SANsurfer FC HBA CLI in interactive mode:
1.
2.
From the Main Menu, select the Help option and then press ENTER.
On the Help Menu, select Exit Codes and then press ENTER.
The CLI lists the exit code numbers, names, and descriptions as shown in
NOTE:
at the time this document was written, you should check for the latest exit
codes in the file, Fcscli-exicodes.txt, located in the SANsurfer FC
HBA CLI installation directory.
Table C-1. Exit Code Descriptions – Interactive Mode
Return
Code
Name
Description
0
1
SUCCESS
Command executed with no error
Failed to open file
ERROR_OPEN_FILE
2
ERROR_READ_FILE
Failed to read file
3
ERROR_WRITE_FILE
Failed to write to a file
4
ERROR_CLOSE_FILE
Failed to close a file
5
ERROR_INCORRECT_FILE
ERROR_INCORRECT_FILE_SIZE
ERROR_UNSUPPORTED_HBA
ERROR_NO_HBA
Selected file is incorrect
File size is incorrect
6
7
HBA is unsupported
8
Unable to open the HBA handle
HBA is unknown to SANsurfer FC HBA CLI
HBA has invalid SSDID/SSVID
9
ERROR_UNKNOWN_HBA
ERROR_INVALID_SSID
ERROR_MISMATCH_SSID
10
11
The specified flash/NVRAM file does not
have the SSDID/SSVID that match with the
HBA
SN0054614-00 F
C-1
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
S
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
ERROR_MISMATCH_CHECKSUM
ERROR_CORRUPTED_FILE
File checksum does not match
File appears to be corrupted
File checksum returns error
File has invalid data
ERROR_FILE_CHKSUM_ERROR
ERROR_FILE_INVALID_DATA
ERROR_FLASH_UPDATE_IGNORE
Reserved
HBA does not need to be updated
Not used
Reserved
Not used
ERROR_FLASH_UPDATE_UNSUPPORTED
ERROR_FLASH_OPTION_DISABLED_HBA
ERROR_FLASH_OPTION_DISABLED_OS
ERROR_FLASH_HEADER_SIGNATURE
ERROR_FLASH_DATA_SIGNATURE
Reserved
Flash update is not supported with this HBA
Flash update is disabled with this HBA
Flash update is disabled with this OS
Flash file has invalid header signature
Flash file has invalid data signature
Internal used
ERROR_FLASH_CSUM_ERROR
ERROR_FLASH_NO_FW_REGION_VALID
ERROR_FLASH_INVALID_FW_FILE
Reserved
Flash file checksum test failed
HBA does not have valid firmware region
Firmware file does not match with HBA
Internal used
ERROR_FLASH_CSUM_MISMATCH
ERROR_INCORRECT_RISC_CODE_FILE
ERROR_INCORRECT_BOOT_CODE_FILE
ERROR_INCORRECT_FULL_IMAGE_FILE
Flash file has checksum mismatched.
Incorrect RISC image
Incorrect BIOS/FCode boot image
Incorrect 1M Flash image
ERROR_CORRUPTED_FLASH_IMAGE_FILE Flash image file is corrupted
ERROR_FLASH_UPDATE_FAILURE
Failed to update flash
ERROR_FLASH_GET_REGION_FAILURE
Failed to read flash update region from HBA
ERROR_FLASH_UPDATE_NO_VALID_
REGION
Failed to validate flash update region read
from HBA
C-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
A
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
37
ERROR_FLASH_UPDATE_NO_REGION_
LAYOUT
HBA does not have flash update region lay-
out
38
39
40
41
Reserved
Not used
Reserved
Not used
ERROR_DIAGNOSTICS_PARAM_ERROR
ERROR_DIAGNOSTICS_LOOP_DOWN
Diagnostics test returns invalid parameters
Unable to run diagnostics because the loop is
down
42
43
ERROR_DIAGNOSTICS_FAILURE
Diagnostics test failed with errors
ERROR_DIAGNOSTICS_DATA_ MISCOM-
PARE
Diagnostics test failed with data miscompare
44
45
46
47
48
ERROR_DIAGNOSTICS_UNKNOWN_
STATUS
Unknown diagnostics test status
ERROR_DIAGNOSTICS_NO_AVAIL_
TARGET
Unable to run R/W buffer test because there
are no attached devices
ERROR_DIAGNOSTICS_NOT_FOUND_
TARGET
Unable to run R/W buffer test because the
excluded device is not available
ERROR_DIAGNOSTICS_MAX_FRAME_
SETTING
Unable to run diagnostics because of the
HBA current frame size setting
ERROR_INVALID_DIAGNOSTICS_
SETTINGS
Invalid diagnostics test parameter settings
49
50
51
52
Reserved
Not used
ERROR_FC_LINK_UNKNOWN_STATUS
ERROR_RESET_LINK_STATUS
ERROR_INVALIDE_STATISTICS_PARAMS
Error getting FC link status
Unable to reset HBA link status
Invalid link status/statistics parameter set-
tings
53
54
55
56
57
Reserved
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
Not used
SN0054614-00 F
C-3
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
S
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
58
59
60
61
62
Reserved
Reserved
Not used
Not used
ERROR_INVALID_PARAM_SETTINGS
ERROR_PARAM_UNSUPPORTED_HBA
ERROR_PARAM_UNSUPPORTED_DRIVER
Invalid HBA parameter value/key
Specified HBA parameters is not supported
Unable to update HBA parameters - Driver
unsupported
63
ERROR_RESTORE_NVRAM_DEFAULT
Failed to restore HBA parameters to default
settings
64
65
66
67
68
69
70
71
72
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_SAVE_HBA_FLASH_TO_FILE
ERROR_READ_HBA_FLASH_HBA
ERROR_NO_SPACE_LEFT
Failed to save HBA flash image to a file
Failed to read HBA flash
Command failed because no space left on
the drive
73
74
75
76
77
78
79
80
81
82
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_INVALID_SERIAL_NO
ERROR_GET_NVRAM_DATA
ERROR_UPDATE_NVRAM_DATA
Invalid HBA serial number
Unable to read NVRAM from HBA
Failed to update HBA parameters
C-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
A
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
83
84
ERROR_PRESERVE_NVRAM_DATA
Failed to preserve HBA parameters
ERROR_MISSING_NVRAM_TEMPLATE_
FILE
Unable to find the NVRAM template for the
HBA
85
ERROR_INVALID_NVRAM_PROG_OPTION
Specified key/value to program NVRAM are
invalid
86
87
88
89
90
Reserved
Not used
Not used
Not used
Not used
Reserved
Reserved
Reserved
ERROR_READING_BOOT_DEVICE
Failed to read boot device settings of the
HBA
91
92
93
94
ERROR_SAVING_BOOT_DEVICE
Failed to save boot device settings to the
HBA
ERROR_BOOT_CONFIG_DISABLED_
DRIVER
Boot device settings is disabled with running
driver
ERROR_BOOT_TARGET_NO_LUN
ERROR_TARGET_NO_DIRECT_ACCESS
ERROR_INVALID_BOOT_SETTINGS
Boot device settings aborted because boot
target has no LUN
Boot device settings failed because the boot
target is not a direct access device
95
96
Boot device parameters is invalid/incorrect
Unsupported boot device settings
ERROR_UNSUPPORTED_BOOT_
SETTINGS
97
98
Reserved
Not used
Reserved
Not used
99
Reserved
Not used
100
101
ERROR_INVALID_DRIVER_PARAM
ERROR_READ_DRIVER_PARAM
Driver parameter settings is invalid
Failed to read current driver settings of the
HBA
102
103
ERROR_DRIVER_PARAM_NOT_FOUND
Reserved
Unknown driver parameter settings
Not used
SN0054614-00 F
C-5
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
S
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
104
105
106
107
108
109
110
111
112
113
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
Not used
Not used
ERROR_DUPLICATE_TARGET_ID
ERROR_INVALID_TARGET_ID
ERROR_MISMATCH_TARGET_ID
ERROR_READ_FROM_DRIVER
Target has duplicate ID
Target has invalid ID
Target has mismatch ID
Failed to read persistent binding data from
driver database
114
ERROR_READ_FROM_PERSISTENT_
STORAGE
Failed to read persistent binding data from
persistent database
115
116
ERROR_MEMORY_ALLOC_FAILURE
ERROR_TARGET_ENTRY_NOT_FOUND
Unable to allocate memory
Unable to find the binding entry of the speci-
fied target
117
ERROR_DELETE_TARGET_PERSISTENT_
ENTRY
Failed to delete target persistent binding
118
119
120
121
122
123
ERROR_LUN_NOT_FOUND
The specified LUN ID not available
HBA does not have attached devices
Option is not available with running driver
Option is not available with HBA
ERROR_NO_DEVICE_FOUND
ERROR_OPTION_UNSUPPORTED_DRV
ERROR_OPTION_UNSUPPORTED_HBA
ERROR_OPTION_UNSUPPORTED_OS
Option is not available on this OS platform
ERROR_OPTION_DISABLED_GUI_CONFIG Target persistent binding is not allowed
because of existing configuration saved by
the SANsurfer manager
124
125
ERROR_OPTION_DISABLED_DRV
Target persistent binding is disabled because
of current driver
ERROR_UPDATE_LUN_DATA_PERSIST_
BINDING
Failed to update LUN data during persistent
binding configuration
C-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
A
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
126
127
128
129
130
131
132
133
134
135
136
ERROR_FAILOVER_DRIVER_LOADED
Reserved
Feature is not support with failover driver
Not used
Reserved
Not used
Reserved
Not used
ERROR_INVALID_HBA_WWID
ERROR_INVALID_HBA_PID
ERROR_INVALID_TARGET_WWID
ERROR_INVALID_LUN_ID
ERROR_MISSING_INPUT
ERROR_INVALID_INPUT
ERROR_CMD_UNSUPPORTED
HBA WWPN/WWNN specified is invalid
HBA instance specified is invalid
Target WWPN/WWNN specified is invalid
LUN ID specified is invalid
Incomplete command line option
Invalid command line option
Specified command line option is unsup-
ported
137
138
139
140
141
142
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_UNKNOWN_FILE_FORMAT
ERROR_READ_DRV_VER_SYS_FILE
ERROR_INIT_SECURITY_DESCRIPTOR
Unable to determine file format
Failed to read driver version from sys file
Failed to init security descriptor during driver
update
143
ERROR_SET_SECURITY_DESCRIPTOR
Failed to set security descriptor during driver
update
144
145
ERROR_FAIL_UPDATE_DRIVER
Failed to update driver
ERROR_HARDWARE_ID_NO_MATCH
HBA hardware ID does not match with the
driver config file
146
147
148
149
ERROR_DRIVER_UPDATE_UNSUPPORTED Driver update is not allowed with this HBA
ERROR_NO_DRV_INF_FILE
ERROR_CREATE_TEMP_DIR
ERROR_OPEN_ZIP_FILE
Driver inf file is missing in the driver package
Failed to create temporary directory
Failed to open zip file
SN0054614-00 F
C-7
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
S
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
Failed to close zip file
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
ERROR_CLOSE_ZIP_FILE
ERROR_READ_ZIP_FILE
ERROR_EXTRACT_ZIP_FILE
ERROR_CORRUPTED_ZIP_FILE
ERROR_CREATE_ZIP_FILE
ERROR_MISSING_DRV_FILE
ERROR_EMPTY_FOLDER
ERROR_GET_REGISTRY_KEY
ERROR_SET_REGISTRY_KEY
ERROR_STORPORT_NOT_SUPPORTED
ERROR_INVALID_VPD_DATA
Reserved
Failed to read zip file
Failed to extract zip file
The zip file appears to be corrupted
Failed to create zip file
Driver sys file is missing in the driver package
Driver folder is empty
Failed to get a registry key
Failed to set a registry key
Operation failed with Stor miniport driver
HBA has invalid VPD data
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Blocked
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
IBM Reserved
IBM Reserved
Blocked
IBM Reserved
Blocked
IBM Reserved
Blocked
IBM Reserved
Blocked
IBM Reserved
Blocked
C-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
A
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
IBM Reserved
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Not used
Not used
Not used
Not used
Not used
Not used
Not used
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
ERROR_SAVE_SEL_LUN_CONFIG
Failed to save selective LUN configuration
Reserved
Reserved
Reserved
Not used
Not used
Not used
SN0054614-00 F
C-9
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
S
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
Not used
Not used
ERROR_MISSING_IP_ADDRESS
ERROR_MISSING_NETMASK_ADDRESS
ERROR_MISSING_GATEWAY_ADDRESS
ERROR_INVALID_IP_ADDRESS
ERROR_INVALID_NET_MASK
ERROR_GET_SWITCH_INFO
ERROR_SET_SWITCH_IP_ADDRESS
ERROR_INVALID_SWITCH_INPUT
ERROR_INVALID_ADMIN_ACCOUNT
ERROR_INVALID_ADMIN_PASSWORD
ERROR_INVALID_OPTION
Reserved
IP address is required
Netmask address is required
Gateway address is required
Invalid IP address
Invalid netmask address
Failed to get switch information
Failed to set switch IP address
Invalid switch parameters settings
Admin account is required
Admin password is incorrect
Switch input is invalid
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_GET_TARGET_IIDMA_SETTINGS
Failed to read target link speed
C-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
A
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
231
232
ERROR_SAVE_TARGET_IIDMA_SETTINGS
Failed to set target link speed
ERROR_SET_TARGET_IIDMA_
UNSUPPORTED
Target link speed option is not supported with
current HBA
233
ERROR_INVALID_IIDMA_SETTINGS
Selected target link speed rate not supported
with current HBA
234
235
236
237
238
239
240
Reserved
Not used
Not used
Not used
Not used
Not used
Not used
Reserved
Reserved
Reserved
Reserved
Reserved
ERROR_NO_TARGET_SELECTED
Unable to run target beacon because no
device is selected
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
ERROR_GET_BEACON_STATE
ERROR_SET_BEACON_STATE
ERROR_BEACON_UNSUPPORTED
ERROR_INVALID_BEACON_PARAMETERS
Reserved
Unable to get the beacon status
Unable to set the beacon status
Beacon operation is unsupported
Beacon settings is invalid
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_GET_HBA_ALIAS
ERROR_UPDATE_HBA_ALIAS
ERROR_GET_PORT_ALIAS
ERROR_UPDATE_PORT_ALIAS
Reserved
Failed to retrieve HBA alias of the HBA
Failed to update HBA alias of the HBA
Failed to retried port alias of the HBA
Failed to update port alias of the HBA
Not used
Reserved
Not used
SN0054614-00 F
C-11
Download from Www.Somanuals.com. All Manuals Search And Download.
C – Interactive Exit Codes
S
Table C-1. Exit Code Descriptions – Interactive Mode (Continued)
Return
Code
Name
Description
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
280
281
282
283
284
285
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
ERROR_DRIVER_RESCAN
Reserved
Driver rescan operation failed (Solaris)
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_ADAPTER_PROP_MISSING
ERROR_CREATE_VIRTUAL_PORT
ERROR_DELETE_VIRTUAL_PORT
ERROR_INVALID_VIRTUAL_PORT_WWN
ERROR_VIRTUAL_PORT_NOT_FOUND
ERROR_NO_VIRTUAL_PORT_EXIST
ERROR_DELETE_ALL_VIRTUAL_PORTS
Adapter property file is missing
Failed to create a virtual port of the HBA
Failed to delete a virtual port of the HBA
Virtual port WWPN is invalid
Unable to find the specific virtual port
This HBA does not have any virtual ports
Failed to delete all virtual ports of the HBA
C-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Appendix D
Non-interactive Error Codes
To list the SANsurfer FC HBA CLI non-interactive error codes from the command
line, type:
scli -ei
Table D-1. Error Code Descriptions – Non-interactive Mode
Code
Name
Description
0
1
2
3
4
5
6
7
8
9
SUCCESS
Command executed with no error
Failed to open file
ERROR_OPEN_FlLE
ERROR_READ_FILE
ERROR_WRITE_FILE
ERROR_CLOSE_FILE
Failed to read file
Failed to write to a file
Failed to close a file
ERROR_INCORRECT_FILE
ERROR_INCORRECT_FILE_SIZE
ERROR_UNSUPPORTED_HBA
ERROR_NO_HBA
Selected file is incorrect
File size is incorrect
HBA is unsupported
Unable to open the HBA handle
ERROR_UNKNOWN_HBA
HBA is unknown to SANsurfer FC
HBA CLI
10
11
ERROR_INVALID_SSID
HBA has invalid SSDID/SSVID
ERROR_MISMATCH_SSID
The specified flash/NVRAM file does
not have the SSDID/SSVID that match
HBA
12
13
14
15
16
17
ERROR_MISMATCH_CHECKSUM
ERROR_CORRUPTED_FILE
ERROR_FILE_CHKSUM_ERROR
ERROR_FILE_INVALID_DATA
ERROR_FLASH_UPDATE_IGNORE
Reserved
File checksum does not match
File appears to be corrupted
File checksum returns error
File has invalid data
HBA does not need to be updated
Not used
SN0054614-00 F
D-1
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
S
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
18
19
Reserved
Not used
ERROR_FLASH_UPDATE_UNSUPPORTED
Flash update is not supported with this
HBA
20
21
22
23
24
25
26
ERROR_FLASH_OPTION_DISABLED_HBA
ERROR_FLASH_OPTION_DISABLED_OS
ERROR_FLASH_HEADER_SIGNATURE
ERROR_FLASH_DATA_SIGNATURE
Reserved
Flash update is disabled with this HBA
Flash update is disabled with this OS
Flash file has invalid header signature
Flash file has invalid data signature
Internal used
ERROR_FLASH_CSUM_ERROR
ERROR_FLASH_NO_FW_REGION_VALID
Flash file checksum test failed
HBA does not have valid firmware
region
27
28
29
30
31
32
33
34
35
ERROR_FLASH_INVALID_FW_FILE
Reserved
Firmware file does not match with HBA
Internal used
ERROR_FLASH_CSUM_MISMATCH
ERROR_INCORRECT_RISC_CODE_FILE
ERROR_INCORRECT_BOOT_CODE_FILE
ERROR_INCORRECT_FULL_IMAGE_FILE
ERROR_CORRUPTED_FLASH_IMAGE_FILE
ERROR_FLASH_UPDATE_FAILURE
ERROR_FLASH_GET_REGION_FAILURE
Flash file has checksum mismatched
Incorrect RISC image
Incorrect BIOS/FCode boot image
Incorrect 1M Flash image
Flash image file is corrupted
Failed to update flash
Failed to read flash update region from
HBA
36
37
ERROR_FLASH_UPDATE_NO_VALID_REGION
ERROR_FLASH_UPDATE_NO_REGION_LAYOUT
Failed to validate flash update region
read from HBA
HBA does not have flash update
region layout
38
39
40
Reserved
Not used
Not used
Reserved
ERROR_DIAGNOSTICS_PARAM_ERROR
Diagnostics test returns invalid param-
eters
D-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
A
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
41
ERROR_DIAGNOSTICS_LOOP_DOWN
Unable to run diagnostics because the
loop is down
42
43
ERROR_DIAGNOSTICS_FAILURE
Diagnostics test failed with errors
ERROR_DIAGNOSTICS_DATA_MISCOMPARE
Diagnostics test failed with data mis-
compare
44
45
ERROR_DIAGNOSTICS_UNKNOWN_STATUS
ERROR_DIAGNOSTICS_NO_AVAIL_TARGET
Unknown diagnostic test status
Unable to run R/W buffer test because
there are no attached devices
46
47
48
ERROR_DIAGNOSTICS_NOT_FOUND_TARGET
ERROR_DIAGNOSTICS_MAX_FRAME_SETTING
ERROR_INVALID_DIAGNOSTICS_SETTINGS
Unable to run R/W buffer test because
the excluded device is not available
Unable to run diagnostics because of
the HBA current frame size setting
Invalid diagnostics test parameter set-
tings
49
50
51
52
Reserved
Not used
ERROR_FC_LINK_UNKNOWN_STATUS
ERROR_RESET_LINK_STATUS
ERROR_INVALIDE_STATISTICS_PARAMS
Error getting FC link status
Unable to reset HBA link status
Invalid link status/statistics parameter
settings
53
54
55
56
57
58
59
60
61
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_INVALID_PARAM_SETTINGS
ERROR_PARAM_UNSUPPORTED_HBA
Invalid HBA parameter value/key
Specified HBA parameter is not sup-
ported
62
ERROR_PARAM_UNSUPPORTED_DRIVER
Unable to update HBA parameters –
Driver unsupported
SN0054614-00 F
D-3
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
S
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
63
ERROR_RESTORE_NVRAM_DEFAULT
Failed to restore HBA parameters to
default settings
64
65
66
67
68
69
70
Reserved
Not used
Not used
Not used
Not used
Not used
Not used
Reserved
Reserved
Reserved
Reserved
Reserved
ERROR_SAVE_HBA_FLASH_TO_FILE
Failed to save HBA flash image to a
file
71
72
ERROR_READ_HBA_FLASH_HBA
ERROR_NO_SPACE_LEFT
Failed to read HBA flash
Command failed because no space
left on the drive
73
74
75
76
77
78
79
80
81
82
83
84
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_INVALID_SERIAL_NO
ERROR_GET_NVRAM_DATA
ERROR_UPDATE_NVRAM_DATA
ERROR_PRESERVE_NVRAM_DATA
ERROR_MISSING_NVRAM_TEMPLATE_FILE
Invalid HBA serial number
Unable to read NVRAM from HBA
Failed to update HBA parameters
Failed to preserve HBA parameters
Unable to find the NVRAM template
for the HBA
85
86
ERROR_INVALID_HBA
Parameters_PROG_OPTION
Specified key/value to program
NVRAM are invalid
Reserved
Not used
D-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
A
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
87
88
89
90
Reserved
Not used
Not used
Not used
Reserved
Reserved
ERROR_READING_BOOT_DEVICE
Failed to read boot device settings of
the HBA
91
92
93
94
ERROR_SAVING_BOOT_DEVICE
Failed to save boot device settings to
the HBA
ERROR_BOOT_CONFIG_DISABLED_DRIVER
ERROR_BOOT_TARGET_NO_LUN
ERROR_TARGET_NO_DIRECT_ACCESS
Boot device settings is disabled with
running driver
Boot device setting aborted because
the boot target has no LUN
Boot device settings failed because
the boot target not a direct access
device
95
ERROR_INVALID_BOOT_SETTINGS
Boot device parameters is
invalid/incorrect
96
97
ERROR_UNSUPPORTED_BOOT_SETTINGS
Reserved
Unsupported boot device settings
Not used
98
Reserved
Not used
99
Reserved
Not used
100
101
ERROR_INVALID_DRIVER_PARAM
ERROR_READ_DRIVER_PARAM
Driver parameter settings is invalid
Failed to read current driver settings of
the HBA
102
103
104
105
106
107
108
ERROR_DRIVER_PARAM_NOT_FOUND
Unknown driver parameter settings
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
Not used
Not used
SN0054614-00 F
D-5
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
S
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
109
110
111
112
113
Reserved
Not used
ERROR_DUPLICATE_TARGET_ID
ERROR_INVALID_TARGET_ID
ERROR_MISMATCH_TARGET_ID
ERROR_READ_FROM_DRIVER
Target has duplicate ID
Target has invalid ID
Target has mismatch ID
Failed to read persistent binding data
from driver database
114
ERROR_READ_FROM_PERSISTENT_STORAGE
Failed to read persistent binding data
from persistent database
115
116
ERROR_MEMORY_ALLOC_FAILURE
ERROR_TARGET_ENTRY_NOT_FOUND
Unable to allocate memory
Unable to find the binding entry of the
specified target
117
ERROR_DELETE_TARGET_PERSISTENT_ENTRY
Failed to delete target persistent bind-
ing
118
119
120
ERROR_LUN_NOT_FOUND
The specified LUN ID not available
HBA does not have attached devices
ERROR_NO_DEVICE_FOUND
ERROR_OPTION_UNSUPPORTED_DRV
Option is not available with running
driver
121
122
ERROR_OPTION_UNSUPPORTED_HBA
ERROR_OPTION_UNSUPPORTED_OS
Option is not available with HBA
Option is not available on this OS plat-
form
123
ERROR_OPTION_DISABLED_GUI_CONFIG
Target persistent binding is not
allowed because of existing configura-
tion saved by the SANsurfer manager
124
125
126
ERROR_OPTION_DISABLED_DRV
Target persistent binding is disabled
because of current driver
ERROR_UPDATE_LUN_DATA_PERSIST_BINDING
ERROR_FAILOVER_DRIVER_LOADED
Failed to update LUN data during per-
sistent binding configuration
Feature is not supported with failover
driver
127
128
129
Reserved
Reserved
Reserved
Not used
Not used
Not used
D-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
A
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
130
ERROR_INUALID_HBA_WWID
HBA WWPN/WWNN specified is
invalid
131
132
ERROR_INVALID_HBA_PID
HBA instance specified is invalid
ERROR_INUALID_TARGET_WWID
Target WWPN/WWNN specified is
invalid
133
134
135
136
ERROR_INUALID_LUN_ID
ERROR_MISSING_INPUT
ERROR_INVALID_INPUT
ERROR_CMD_UNSUPPORTED
LUN ID specified is invalid
Incomplete command line option
Invalid command line option
Specified command line option is
unsupported
137
138
139
140
141
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_UNKNOWN_FILE_FORMAT
ERROR_READ_DRV_VER_SYS_FILE
Unable to determine file format
Failed to read driver version from sys
file
142
143
ERROR_INIT_SECURITY_DESCRIPTOR
ERROR_SET_SECURITY_DESCRIPTOR
Failed to init security descriptor during
driver update
Failed to set security descriptor during
driver update
144
145
ERROR_FAIL_UPDATE_DRIVER
Failed to update driver
ERROR_HARDWARE_ID_NO_MATCH
HBA hardware ID does not match with
the driver config file
146
147
ERROR_DRIVER_UPDATE_UNSUPPORTED
ERROR_NO_DRV_INF_FILE
Driver update is not allowed with this
HBA
Driver inf file is missing in the driver
package
148
149
150
151
ERROR_CREATE_TEMP_DIR
ERROR_OPEN_ZIP_FILE
ERROR_CLOSE_ZIP_FILE
ERROR_READ_ZIP_FILE
Failed to create temporary directory
Failed to open zip file
Failed to close zip file
Failed to read zip file
SN0054614-00 F
D-7
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
S
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
152
153
154
155
ERROR_EXTRACT_ZIP_FILE
ERROR_CORRUPTED_ZIP_FILE
ERROR_CREATE_ZIP_FILE
ERROR_MISSING_DRV_FILE
Failed to extract zip file
The zip file appears to be corrupted
Failed to create zip file
Driver sys file is missing in the driver
package
156
157
158
159
ERROR_EMPTY_FOLDER
Driver folder is empty
ERROR_GET_REGISTRY_KEY
ERROR_SET_REGISTRY_KEY
ERROR_STORPORT_NOT_SUPPORTED
Failed to get a registry key
Failed to set a registry key
Operation failed with Stor miniport
driver
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
ERROR_INVALID_VPD_DATA
Reserved
HBA had invalid VPD data
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Not used
Blocked
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
D-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
A
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
IBM Reserved
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Blocked
Not used
Not used
Not used
Not used
Not used
Not used
Not used
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
IBM Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
ERROR_SAVE_SEL_LUN_CONFIG
Failed to save selective LUN configu-
ration
201
202
203
204
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
SN0054614-00 F
D-9
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
S
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
Reserved
Reserved
Reserved
Reserved
Reserved
Not used
Not used
Not used
Not used
Not used
ERROR_MISSING_IP_ADDRESS
ERROR_MISSING_NETMASK_ADDRESS
ERROR_MISSING_GATEWAY_ADDRESS
ERROR_INVALID_IP_ADDRESS
ERROR_INVALID_NET_MASK
ERROR_GET_SWITCH_INFO
ERROR_SET_SWITCH_IP_ADDRESS
ERROR_INVALID_SWITCH_INPUT
ERROR_INVALID_ADMIN_ACCOUNT
ERROR_INVALID_ADMIN_PASSWORD
ERROR_INVALID_OPTION
Reserved
IP address is required
Netmask address is required
Gateway address is required
Invalid IP address
Invalid netmask address
Failed to get switch information
Failed to set switch IP address
Invalid switch parameters settings
Admin account is required
Admin password is incorrect
Switch input is invalid
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_GET_TARGET_IIDMA_SETTINGS
ERROR_SAVE_TARGET_IIDMA_SETTINGS
Failed to read target link speed
Failed to set target link speed
D-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
A
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
232
233
ERROR_SET_TARGET_IIDMA_UNSUPPORTED
ERROR_INVALID_IIDMA_SETTINGS
Target link speed operation is unsup-
ported with current HBA
Selected target link speed rate not
supported with current HBA
234
235
236
237
238
239
240
Reserved
Not used
Not used
Not used
Not used
Not used
Not used
Reserved
Reserved
Reserved
Reserved
Reserved
ERROR_NO_TARGET_SELECTED
Unable to run target beacon because
no device is selected
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
ERROR_GET_BEACON_STATE
ERROR_SET_BEACON_STATE
ERROR_BEACON_UNSUPPORTED
ERROR_INVALID_BEACON_PARAMETERS
Reserved
Unable to get the beacon status
Unable to set the beacon status
Beacon operation is unsupported
Beacon settings is invalid
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_GET_HBA_ALIAS
ERROR_UPDATE_HBA_ALIAS
ERROR_GET_PORT_ALIAS
ERROR_UPDATE_PORT_ALIAS
Reserved
Failed to retrieve HBA alias of the HBA
Failed to update HBA alias of the HBA
Failed to retried port alias of the HBA
Failed to update port alias of the HBA
Not used
Reserved
Not used
Reserved
Not used
SN0054614-00 F
D-11
Download from Www.Somanuals.com. All Manuals Search And Download.
D – Non-interactive Error Codes
S
Table D-1. Error Code Descriptions – Non-interactive Mode (Continued)
Code
Name
Description
257
258
259
260
261
262
263
264
265
266
267
268
269
270
280
Reserved
Reserved
Reserved
Not used
Not used
Not used
ERROR_DRIVER_RESCAN
Driver rescan operation failed (Solaris)
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
Reserved
Not used
ERROR_ADAPTER_PROP_MISSING
ERROR_CREATE_VIRTUAL_PORT
Adapter property file is missing
Failed to create a virtual port of the
HBA
281
ERROR_DELETE_VIRTUAL_PORT
Failed to delete a virtual port of the
HBA
282
283
284
ERROR_INVALID_VIRTUAL_PORT_WWN
ERROR_VIRTUAL_PORT_NOT_FOUND
ERROR_NO_VIRTUAL_PORT_EXIST
Virtual port WWPN is invalid
Unable to find the specific virtual port
This HBA does not have any virtual
ports
285
ERROR_DELETE_ALL_VIRTUAL_PORTS
Failed to delete all virtual ports of the
HBA
D-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Appendix E
Help Commands
only one command line option per input file is valid. The hyphen (-) and slash (/)
characters are equivalent. That is, scli -gand scli /gare both valid
commands.
<hba instance>
<hba wwpn>
HBA instance number of an HBA port.
World Wide Port Name of an HBA port.
(xx-xx-xx-xx-xx-xx-xx-xxor xxxxxxxxxxxxxx).
<target wwnn>
<target wwpn>
World Wide Node Name of a target device.
(xx-xx-xx-xx-xx-xx-xx-xxor xxxxxxxxxxxxxx).
World Wide Port Name of a target device.
(xx-xx-xx-xx-xx-xx-xx-xxor xxxxxxxxxxxxxx).
<target portid>
<target id>
<lun id>
Port ID of a target device. (xx-xx-xxor xxxxxx).
ID of a target device.
Logical Unit Number of a LUN.
IP address.
<address>
Table E-1. Help Commands
Command
Line
Action
Arguments
Function
—
[ int ]
Starts interactive mode.
–a
( <hba instance> | <hba wwpn> ) Flashes the HBA port LED to locate it in the
host. This feature is not supported on
QLA22xx series HBAs.
–a
( <hba instance> | <hba wwpn> )
( view | ?)
Displays the current LED state on an HBA
port.
SN0054614-00 F
E-1
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
S
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–b
( <all> | <hba instance> | <hba
Updates the HBA boot code from a file, where:
wwpn> ) [ ( <–rg> <fw | boot|
all> ) ] <file name>
„ <–rg>Specifies Option ROM region
update mode.
„ <all>Updates the flash from a full image
file (1MB image file).
„ <fw>Updates the firmware image only
from a firmware file.
„ <boot>Updates the boot code
(BIOS/Fcode/EFI) image only from a boot
code file.
„ <file name>Flash image file name.
Note: Region update is not available on 2Gb
HBAs. Flash update is not supported on 2Gb
HBAs in Macintosh. If selected multiple HBAs,
only HBAs that are compatible with the pro-
vided flash image will be updated.
–b
–c
–c
–d
( <hba instance> | <hba wwpn> )
save <file name>
Saves the HBA boot code to a file.
( <hba instance> | <hba wwpn> ) Views the HBA Parameters settings of an HBA
port.
[ <all> ]
Views the HBA Parameters settings of all
HBAs.
<file name >
Performs a driver update to the HBAs. <file
name>is the full path of the driver file in
inf/zipor exeformat.
–dm
( <hba instance> | <hba wwpn> |
<all> ) general | gen | details
| det
Runs a transceiver (SFF/SFP) diagnostics on
an HBA port and displays the result in general
or detail view. This feature is supported only
with 4Gb HBA or latest. This feature is not
available with inbox driver (SLES 10.0 / RHEL
5.0 or latest).
–e
–e
( <hba instance> | <hba wwpn> )
( enable | 0 0 0 )
Selectable Boot: Configure the operating sys-
tem to boot from the first target the BIOS finds.
( <hba instance> | <hba wwpn> )
( enable | 0 0 0 )
Selectable Boot: Configure the operating sys-
tem to boot from the first target the BIOS finds.
E-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
A
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–e
–e
–e
( <hba instance> | <hba wwpn> )
( view | ? )
Shows the current boot device information on
an HBA port.
( <hba instance> | <hba wwpn> )
( view | ? )
Shows the current boot device information on
an HBA port.
( <hba instance> | <hba wwpn> )
disable [ prim | alt1 | alt2 |
alt3 ]
Clears the selected current boot device set-
tings on an HBA port (prim/alt1/alt2or
alt3Boot Port Name). Configures all LUNs of
all devices attached to an HBA port (Disable).
–e
–e
( <hba instance> | <hba wwpn> )
disable [ prim | alt1 | alt2 |
alt3 ]
Clears the selected current boot device set-
tings on an HBA port (prim/alt1/alt2or
alt3Boot Port Name).
( <hba instance> | <hba wwpn>
<target wwnn> <target wwpn>
<lun id> [ prim | alt1 | alt2 |
alt3]
Configures the operating system to boot from
a specific target:
„ prim: Primary Boot Port Name
„ alt1: Alternate 1 Boot Port Name
„ alt2: Alternate 2 Boot Port Name
„ alt3: Alternate 3 Boot Port Name
–e
( <hba instance> | <hba wwpn>
<target wwnn> <target wwpn>
<lun id> [ prim | alt1 | alt2 |
alt3]
Configures the operating system to boot from
a specific target:
„ prim: Primary Boot Port Name
„ alt1: Alternate 1 Boot Port Name
„ alt2: Alternate 2 Boot Port Name
„ alt3: Alternate 3 Boot Port Name
–e
–e
( view | ? )
( view | ? )
Shows the current boot device information on
all HBAs.
Shows the current boot device information on
all HBAs.
–ei
–f
–
Lists the exit codes.
<file name>
Executes from a command input file. Option
–fcannot be combined with any other options.
–fg
( <hba instance> | <hba wwpn> )
( view | ? )
Shows the current driver settings.
SN0054614-00 F
E-3
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
S
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–fs
( <hba instance> | <hba wwpn> )
Configures the driver settings.
{ ( <param name> | <param
alias> ) <param value> }
–gs
( <hba instance> | <hba wwpn> )
{ ( <param name> | <param
alias> ) <param value> }
Shows the current statistics on an HBA port.
–h | –? –
Lists all the command options and syntax.
Option –hcan be combined with a command
line option to display the usage of that individ-
ual command.
–ha
–ha
–ha
–i
( <hba instance> | <hba wwpn> )
<alias>
Sets an alias to an HBA.
( <hba instance> | <hba wwpn> )
delete
Deletes the current alias of an HBA.
Displays the current alias of an HBA.
( <hba instance> | <hba wwpn> )
view | ?
( <hba instance> | <hba wwpn> )
[ vpd ]
Views the general or VPD information of an
HBA port.
–i
[ <all> ] [ vpd ]
Views the general or VPD information of all
HBAs.
–kl
( <hba instance> | <hba wwpn> )
[ { ( <param name> | <param
alias> ) <param value> } ]
Runs a diagnostics loopback test on an HBA
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 HBA port.
–l
–l
( <hba instance> | <hba wwpn> ) Displays the information about LUNs attached
to an HBA port.
( <hba instance> | <hba wwpn> )
( <target wwpn> | <target
portid> )
Displays the information about LUNs of a tar-
get device attached to an HBA port.
–l
( <hba instance> | <hba wwpn> )
( <target wwpn> | <target
portid> ) <lun id>
Displays the information about a specific LUN
of a target device attached to an HBA port.
E-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
A
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–ls
( <hba instance> | <hba wwpn> )
{ ( <param name> | <param
alias> ) <param value> }
Shows the current link status on an HBA port.
–m
–m
( <hba instance> | <hba wwpn> )
( view | ? )
Views selective LUN information of all devices
attached to an HBA port.
( <hba instance> | <hba wwpn> )
<target wwnn> <target wwpn>
<lun id> ( view | ? )
Views selective LUN information of a single
device attached to an HBA port.
–m
( <hba instance> | <hba wwpn> )
select | enable <target wwnn>
<target wwpn>
Configures all LUNs of a device attached to an
HBA port (Enable).
–m
–m
( <hba instance> | <hba wwpn> )
select all
Configures all LUNs of all devices attached to
an HBA port (Enable).
( <hba instance> | <hba wwpn> )
unselect | disable <target
wwnn> <target wwpn>
Configures all LUNs of all devices attached to
an HBA port (Disable).
–m
–m
( <hba instance> | <hba wwpn> )
unselect all
Configures all LUNs of all devices attached to
an HBA port (Disable).
( <hba instance> | <hba wwpn>)
{ <target wwnn> <target wwpn>
<lun id> (0 | 1 | enable | |
select | unselect ) }
Configures individual LUN of a device attached
to an HBA port.
–n
( <hba instance> | <hba wwpn> )
{ ( <param name> | <param
alias> ) <param value> }
Modifies the HBA Parameters of an HBA port.
–n
–n
( <hba instance> | <hba wwpn> |
<all> ) <OEM name>
Sets the HBA Parameters of an HBA port with
a pre-defined OEM default templates.
( <hba instance> | <hba wwpn> |
<all> ) default
Restores the HBA Parameters of an HBA port
to factory default settings (4Gb HBAs or lat-
est).
–o
<file name>
Writes the output to a named file. This option
can be combined with other options. However,
this option must be at the beginning or at the
end of the command line.
SN0054614-00 F
E-5
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
S
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–p
( <hba instance> | <hba wwpn> )
{ <target wwnn> <target wwpn>
<target portid> <target id> }
Binds the selected device(s) attached to an
HBA port.
–p
( <hba instance> | <hba wwpn> )
remove <target wwnn> | unbind
<target wwnn>
Unbinds a specific device attached to an HBA
port.
–p
( <hba instance> | <hba wwpn> |
<all> ) ( view | ? )
Displays the current persistent binding config-
uration on an HBA port or all HBAs.
–p
( <hba instance> | <hba wwpn> |
<all> ) bind all
Binds all device(s) attached to an HBA port or
all HBAs.
–p
( <hba instance> | <hba wwpn> |
Unbinds all device(s) attached to an HBA port
<all> ) remove all | unbind all or all HBAs.
–pa
–pa
–pa
–q
( <hba instance> | <hba wwpn> )
<alias>
Sets an alias to an HBA port.
( <hba instance> | <hba wwpn> )
delete
Deletes the current alias of an HBA port.
Displays the current alias of an HBA port.
( <hba instance> | <hba wwpn> )
view | ?
( <hba instance> | <hba wwpn> )
{ <target wwpn> <speed> }
Modifies the iiDMA settings of selected tar-
get(s) on an HBA port. This feature is sup-
ported only on 4Gb or latest HBAs.
–q
–q
( <hba instance> | <hba wwpn> )
<target wwpn>
Displays the current iiDMA settings of a spe-
cific target on an HBA port.
( <hba instance> | <hba wwpn> |
<all> ) ( –targets | –t )
<speed>
Modifies the iiDMA settings of all targets on an
HBA port or all HBAs.
–q
–r
–r
( <hba instance> | <hba wwpn> |
<all> ) [ –targets | –t ]
Displays the current iiDMA settings of all tar-
gets on an HBA port or all HBAs.
( <hba instance> | <hba wwpn> )
save <file name>
Saves the current HBA parameters of an HBA
port to a file.
( <hba instance> | <hba wwpn> |
<all> ) <file name>
Updates the HBA parameters of an HBA port
or all HBAs from a file.
E-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
A
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–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
–t
( <hba instance> | <hba wwpn> ) Displays the information about devices (disks
or tapes) attached to an HBA port.
( <hba instance> | <hba wwpn> )
( <target wwpn> | <target
portid> )
Displays the information about a device (disk
or tape) attached to an HBA port.
–t
[ <all> ]
Displays the information about devices (disks
or tapes) attached to all HBAs.
–tb
( <hba instance> | <hba wwpn>
){ ( <target wwpn> ) } <beacon
mode>
Locates a specific device or multiple devices in
a JBOD. This feature is supported only by
devices within a JBOD.
–tp |
—
Displays the current topology (Host view).
–topol-
ogy ]
–v
—
Shows the current version.
–vp
( <hba instance> | <hba wwpn> )
create <vport hex>.
Creates a virtual port with your own WWPN.
–vp
–vp
–vp
–vp
–vp
( <hba instance> | <hba wwpn> )
create auto
Creates a virtual port with default WWPN (auto
generate).
( <hba instance> | <hba wwpn> )
delete <vport wwpn>
Deletes a virtual port on a physical HBA port.
( <hba instance> | <hba wwpn> )
delete all
Deletes all virtual port(s) on a physical HBA
port.
( <hba instance> | <hba wwpn> )
list <vport wwpn>
Lists a specific virtual port on a physical HBA
port.
( <hba instance> | <hba wwpn> )
list all
Lists all virtual ports on a physical HBA port.
SN0054614-00 F
E-7
Download from Www.Somanuals.com. All Manuals Search And Download.
E – Help Commands
S
Table E-1. Help Commands (Continued)
Command
Line
Action
Arguments
Function
–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. Option –x2
can be used to generate a new-style format
that is matched with standard text output (XML
format 2). This option can be combined with
other options; however, this option must be at
the beginning or at the end of the command
line.
–z
( <hba instance> | <hba wwpn> |
<all> )
Creates a summary report of individual HBA or
all HBAs in the current host.
E-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
Glossary
adapter
See HBA.
for the HBA and initializing and testing the
HBA's ISP.
boot device
AL_PA
Arbitrated Loop_Physical Address. A
The device, usually a the hard disk, that
contains the operating system the BIOS
uses to boot from when the computer is
started.
low-level address on the FC loop.
arbitrated loop
A circular (ring) topology (versus
point-to-point) where two or more ports
can be interconnected, but only two ports
can communicate at a time. All communi-
cation passes through all ports connected
to the loop.
cache
A temporary high-speed storage (memory)
area where recently used or frequently
accessed data is stored for rapid access,
thus increasing the efficiency of processor
operations.
BIOS
Cache contents duplicate recently-used
values stored on disk or elsewhere. Cache
is quick to access relative to the original
data which either takes more time due to
slow disc-access time, or is slow to
compute. Once data is stored in the cache,
future use can be made by accessing the
cached copy rather than re-finding or
recomputing the original data, so that the
average access time is lower.
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 HBA at startup.
boot code
The program that initializes a system or an
HBA.
Boot code is the first program to run when
a system or a devices within a system,
such as an HBAs. FCode, BIOS, and EFI
(enhanced firmware interface) are all
forms of boot code for specific
„ L1 cache—Primary (smallest) cache
on the same chip as the processor.
„ L2 cache—Secondary (larger) cache.
Either on the processor chip or
external to the processor.
hardware/operating system environments.
CSV file
A comma separated values (CSV) file
Boot code for QLogic FC HBAs is required
if the computer system is booting from a
storage device (disk drive) attached to the
HBA. The primary function of the boot
code is communication with the external
boot device before the operating system is
up and running. There are also secondary
functions that can be performed by the
boot code, including managing the setup
device
A target, typically a disk drive. Hardware
such as a disk drive, tape drive, printer, or
keyboard that is installed in or connected
to a system. In FC, a target device.
SN0054614-00 F
Glossary-1
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
driver
The software that interfaces between the
QLA200/QLA2xxx HBAs, disks, tapes,
network HBAs, and frame buffers.
file system and a physical data storage
device or network media.
„ Miniport Driver. The lowest driver level
and device specific. This level is
usually supplied by the manufacturer
as a companion to a physical device.
The level structure for Windows XP
Professional/2000/Windows Server 2003
drivers is as follows:
„ Monolithic Driver. This level combines
the functions of different driver levels in
the same driver to increase perfor-
mance.
„ Class Driver. The highest driver level.
There is a separate class for disk,
Ethernet, and so forth. This level
handles all generic aspects of opera-
tions for that class.
„ Adjunct Driver. This level works along
side a driver at the same level to
increase performance.
„ Port Driver. The middle driver level,
which handles aspects of the operation
specific to the port type; for example,
there is a port driver for SCSI.
In NetWare, the required drivers include:
„ Host Adapter Module (HAM). HAM is
the driver component associated with
the host adapter hardware. It provides
the functionality to route requests to
the bus where a specified device is
attached.
In Red Hat/SuSE Linux, the driver layers
include:
„ SCSI Upper Layer. This is the device
management layer. It handles
device-dependent tasks for devices,
such as disks and tapes.
„ Custom Device Module (CDM). The
drive component associated with
storage devices. It provides the
functionality to build device-specific
commands from I/O messages
received from NetWare’s Media
Manager.
„ SCSI Middle Layer. This is the SCSI
traffic handling layer. It directs requests
between the kernel and the SCSI.
„ SCSI Lower Layer. This is the SCSI
HBA driver. It communications directly
to the SCSI HBA.
E_Port (Expansion Port)
The structure for Solaris SPARC drivers
includes:
A port in an FC switch that connects to
another FC switch or bridge device by an
inter-switch link. E_ports are used to link
FC switches to form a multi-switch fabric.
„ Nexus Drivers. Nexus drivers provide
bus mapping and translation services
to subordinate nexus and leaf devices.
These include drivers for PCI-to-PCI
bridges, PCMCIA adapters, and SCSI
HBAs.
echo diagnostic test
Transmits a received signal back to the
sender to verify the integrity of the device.
„ Leaf Drivers. Leaf drivers provide the
traditional character and block driver
interfaces for reading and writing data
to storage and communication
devices. These include drivers for
peripheral devices, including
Glossary-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
F_Port
Flash
The “Fabric” port in a FC fabric switch
provides a point-to-point link attachment to
Nonvolatile memory holding the boot code.
At times, Flash and boot code are used
a single N_Port. F_Ports are intermediate
ports in virtual point-to-point links between
end ports, for example N_Port to F_Port to
F_Port to N_Port using a single FC fabric
switch.
Flash BIOS
A flash PROM contains the BIOS code for
the HBA.
fabric
G_Port (Generic Port)
A fabric consists of cross-connected FC
devices and switches.
A port that can operate as either an E_Port
or an F_Port. A G_Port can determine
operating mode at switch port initialization,
F_Port when an N_Port attachment is
determined, E_Port when an E_Port
attachment is determined. See E_Port
fabric switch
Also, Switched Fabric. A fabric switch
connects multiple devices from indepen-
dent FC-arbitrated loops (FC-ALs) and
point-to-point topologies into a fabric using
FC switches.
Fast!UTIL
QLogic Fast!UTIL FC HBA BIOS utility.
HBA (host bus adapter)
The board that interfaces between the
host system and the target devices. HBA
is synonymous with adapter, host adapter,
and adapter board.
FCode
A type of boot code for Sun's SPARC
host bus adapter (HBA)
F_Port (Fabric Port)
The board that interfaces between the
host system and device. Also called: HBA,
adapter, host adapter, and adapter board.
A port in a fabric where an N_Port can
attach.
FL_Port (Fabric Loop Port)
HBA alias
In an FC, the fabric switch is capable of FC
Arbitrated Loop operations and is
A user-defined name for an HBA.
HBA port
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 example NL_Port to
FL_Port to F_Port to N_Port through a
single FC fabric switch.
A port on the HBA board.
HBA port alias
A user-defined name for an HBA port.
HBA port beacon
An LED on the HBA. Flashing it enables
you to locate the HBA.
SN0054614-00 F
Glossary-3
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
IOCB
I/O control block. An IOCB is a command
loop ID
structure in QLogic ISP architecture.
LUN
Logical Unit Number, a subdivision of a
ioctl (input/output control)
A system call in Unix/Linux systems.
Allows an application to control or commu-
nicate with a device driver outside usual
read/write operations.
SCSI target. It is the small integer handle
that differentiates an individual disk drive
or partition (volume) within a common
SCSI target device such as a disk array.
Technically, a LUN can be a single
JBOD (Just a Bunch of Disks)
physical disk drive, multiple physical disk
drives, or a portion (volume) of a single
physical disk drive. However, LUNs are
typically not entire disk drives but rather
virtual partitions (volumes) of a RAID set.
L_Port (Loop Port)
Does arbitrated loop functions and proto-
cols. NL_Ports and FL_Ports are
examples of loop-capable ports. See
Using LUNs, the FC host can address
multiple peripheral devices that may share
a common controller.
LUN masking
A software feature that assigns LUNs to
specific servers or hides LUNs from
specific servers for maximum access and
availability control.
LIP (Loop Initialization Process)
The initialization 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
transmission on the loop is suspended
during a LIP.
media
Physical-layer information carriers. FC
supports several different physical media:
copper, multimode optical, and
single-mode optical. All FC protocols are
supported on all media.
load balancing
A software feature that improves system
performance by balancing device access
between multiple HBAs for maximum
resource efficiency. Available in Windows
2000/Windows Server 2003, Novell
NetWare, and Red Hat/SuSE Linux.
NPIV
N_Port ID Virtualization.
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, detec-
tion, 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_Port to
F_Port to N_Port using a single FC fabric
loopback
Diagnostic tool that routes transmit data
through a loopback connector back to the
same HBA.
Glossary-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
N_Port ID Virtualization
power is removed. NVRAM settings are
called HBA Parameters in this guide.
The ability for a single physical FC end
point (N_Port) to support multiple, uniquely
addressable, logical end points. With
NPIV, a host FC adapter is shared in such
a way that each virtual adapter is assigned
to a virtual server and is separately identifi-
able within the fabric. Connectivity and
access privileges within the fabric are
controlled by identification of each virtual
adapter and, hence, the virtual server
using each virtual adapter.
network adapter
A chip that provides network capabilities. A
computer may include a network adapter
on its system board, or on an adapter card.
Also a NIC (network interface card or
controller).
ONC (Open Network Computing)
A remote procedure call developed by Sun
Microsystems.
NL_Port (Node Loop Port)
path
A port capable of arbitrated loop functions
and protocols. An NL_Port connects
through an arbitrated loop to other
A path to a device is a combination of a
HBA 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 HBA (initiator) and the target.
NL_Port and at most a single FL_Port.
NL_Ports handle creation, detection, and
flow of message units to and from the
connected systems. NL_Ports are end
ports in virtual point-to-point links through
a fabric, for example NL_Port to F_Port to
F_Port to N_Port using a single FC fabric
switch. In the absence of a fabric switch
FL_Port, NL_Ports can communicate with
other NL_Ports in virtual point-to-point
links through a FC_AL open loop circuit
often through FC_AL (Arbitrated Loop)
hub or loop switch devices. See: E_Port
Since a path is a combination of an HBA
and a target port, it is distinct from another
path if it is accessed through a different
HBA and/or it is accessing a different
target port. Consequently, when switching
from one path to another, the driver might
be selecting a different HBA (initiator), a
different target port, or both.
This is important to the driver when
selecting the proper method of failover
notification. It can make a difference to the
target device, which might have to take
different actions when receiving retries of
the request from another initiator or on a
different port.
NIC
Network Interface Controller.
NVRAM (Non-Volatile Random Access
Memory)
point-to-point
Also FC-P2P. Two FC nodes directly
connected (not in a loop).
A type of memory that retains data even
when power is removed. Holds configura-
tion settings. You can configure NVRAM
settings manually or restore them from a
file. These settings are retained when
port
Access points in a device where a link
attaches. There are four types of ports, as
follows:
SN0054614-00 F
Glossary-5
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
„
„
„
„
N_Port (Node Port)—an FC port that
supports point-to-point topology.
target
The storage-device endpoint of a SCSI
session. Initiators request data from
NL_Port (Node Loop Port)—an FC
port that supports loop topology.
targets. Targets are typically disk-drives,
tape-drives, or other media devices.
Typically a SCSI peripheral device is the
target but an HBA may, in some cases, be
a target. A target can contain many LUNs.
F_Port (Fabric Port)—a port in a fabric
where an N_Port can attach.
FL_Port (Fabric Loop Port)—a port in
a fabric where an NL_Port can attach.
A target is a device that responds to a
requested by an initiator (the host system).
Peripherals are targets, but for some
commands (for example, a SCSI COPY
command), the peripheral may act as an
initiator
port instance
The number of the port in the system.
Each HBA may have one or multiple ports,
identified with regard to the HBA as port 0,
port 1 and so forth. to avoid confusion
when dealing with a system containing
numerous ports, each port is assigned a
port instance number when the system
boots up. So Port 0 on an HBA might have
a port instance number of, for example, 8 if
it is the eighth port discovered by the
system.
target binding
The process in which the HBA driver binds
a target ID using a target’s world wide port
name (WWPN) or port ID. This enables
the target ID to always connect to the
WWPN or port ID across reboots regard-
less of SAN reconfigurations.
SAN (Storage Area Network)
Multiple storage units (disk drives) and
servers connected by networking topology.
SCSI (Small Computer System Interface)
A high-speed interface used to connect
devices, such as hard drives, CD drives,
printers, and scanners, to a computer. The
SCSI can connect many devices using a
single controller. Each device is accessed
by an individual identification number on
the SCSI controller bus.
Glossary-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
commands
configuring
connection
count
current settings
Custom Device Module (CDM), definition
D
data
Index-2
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
default
documentation
driver
device
diagnostics
running loopback or read/write buffer
disable
displaying
E
E_Port (Expansion Port), definition
enable
SN0054614-00 F
Index-3
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
error codes
frame
error message
G
G_Port (Generic Port), definition
generating
F
guide
FCode
.txt 4-8
.xml 4-8
H
HBA
complete information
Flash
Flash BIOS
Index-4
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
HBA (continued)
host
host
Host Adapter Module (HAM), definition
Host Adapter Module (HAM), NetWare
port
statistics
I
information
input/output control (ioctl), definition
installation
SN0054614-00 F
Index-5
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
installation (continued)
LED
instance
link
Linux
See also non-interactive mode
ioctl (input/output control), definition
operating systems supported by SANsurfer
ioctl module driver, features unavailable
LIP
J
LIP (Loop Initialization Process), definition
listing
JBOD (Just a Bunch of Disks), definition
locating
K
Logical Unit Number (LUN), definition
L
Index-6
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
loop
main tag
Loop Initialization Process (LIP), definition
Microsoft System Center Virtual Machine CLI
mode
LUNs
N
N_Port IO Virtualization, definition
Network Interface Controller (NIC), definition
non-interactive mode
M
Macintosh
operating systems supported by SANsurfer
See also interactive mode
SN0054614-00 F
Index-7
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
non-interactive mode (continued)
Non-volatile Random Access Memory
NPIV (N_Port ID Virtualization)
point to point
point-to-point
O
Open Network Computing (ONC), definition
operating systems supported by SANsurfer
OS
port
output
output messages
P
parameters
port alias
Index-8
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
Q
S
QLogic
SAN (Storage Area Network), definition
SANsurfer FC HBA CLI
saving
R
reboot message
saving as
report
SCSI
restoring
SN0054614-00 F
Index-9
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
show
T
target
Small Computer System Interface (SCSI),
Solaris
operating systems supported by SANsurfer
statistics
status message
Storage Area Network (SAN), definition
template
template supported parameter settings
system
requirements
Index-10
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
A
test
updating
utility header
.txt 4-8
topology
V
version
viewing
U
uninstall
SN0054614-00 F
Index-11
Download from Www.Somanuals.com. All Manuals Search And Download.
SANsurfer FC HBA CLI User’s Guide
Command Line Interface for QLogic Fibre Channel Host Bus Adapters
S
W
Windows
operating systems supported by SANsurfer
X
XML
Z
-z
Index-12
SN0054614-00 F
Download from Www.Somanuals.com. All Manuals Search And Download.
|