Warning: mysql_fetch_array() expects parameter 1 to be resource, boolean given in /home/newdedyk/domains/bkmanuals.com/public_html/includes/pages/manual_inc.php on line 26
Q-Logic FC HBA CLI manuale d’uso - BKManuals

Q-Logic FC HBA CLI manuale d’uso

1
2
3
4
5
6
7
8
9
10
11
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
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
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
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
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280

Vai alla pagina of

Un buon manuale d’uso

Le regole impongono al rivenditore l'obbligo di fornire all'acquirente, insieme alle merci, il manuale d’uso Q-Logic FC HBA CLI. La mancanza del manuale d’uso o le informazioni errate fornite al consumatore sono la base di una denuncia in caso di inosservanza del dispositivo con il contratto. Secondo la legge, l’inclusione del manuale d’uso in una forma diversa da quella cartacea è permessa, che viene spesso utilizzato recentemente, includendo una forma grafica o elettronica Q-Logic FC HBA CLI o video didattici per gli utenti. La condizione è il suo carattere leggibile e comprensibile.

Che cosa è il manuale d’uso?

La parola deriva dal latino "instructio", cioè organizzare. Così, il manuale d’uso Q-Logic FC HBA CLI descrive le fasi del procedimento. Lo scopo del manuale d’uso è istruire, facilitare lo avviamento, l'uso di attrezzature o l’esecuzione di determinate azioni. Il manuale è una raccolta di informazioni sull'oggetto/servizio, un suggerimento.

Purtroppo, pochi utenti prendono il tempo di leggere il manuale d’uso, e un buono manuale non solo permette di conoscere una serie di funzionalità aggiuntive del dispositivo acquistato, ma anche evitare la maggioranza dei guasti.

Quindi cosa dovrebbe contenere il manuale perfetto?

Innanzitutto, il manuale d’uso Q-Logic FC HBA CLI dovrebbe contenere:
- informazioni sui dati tecnici del dispositivo Q-Logic FC HBA CLI
- nome del fabbricante e anno di fabbricazione Q-Logic FC HBA CLI
- istruzioni per l'uso, la regolazione e la manutenzione delle attrezzature Q-Logic FC HBA CLI
- segnaletica di sicurezza e certificati che confermano la conformità con le norme pertinenti

Perché non leggiamo i manuali d’uso?

Generalmente questo è dovuto alla mancanza di tempo e certezza per quanto riguarda la funzionalità specifica delle attrezzature acquistate. Purtroppo, la connessione e l’avvio Q-Logic FC HBA CLI non sono sufficienti. Questo manuale contiene una serie di linee guida per funzionalità specifiche, la sicurezza, metodi di manutenzione (anche i mezzi che dovrebbero essere usati), eventuali difetti Q-Logic FC HBA CLI e modi per risolvere i problemi più comuni durante l'uso. Infine, il manuale contiene le coordinate del servizio Q-Logic in assenza dell'efficacia delle soluzioni proposte. Attualmente, i manuali d’uso sotto forma di animazioni interessanti e video didattici che sono migliori che la brochure suscitano un interesse considerevole. Questo tipo di manuale permette all'utente di visualizzare tutto il video didattico senza saltare le specifiche e complicate descrizioni tecniche Q-Logic FC HBA CLI, come nel caso della versione cartacea.

Perché leggere il manuale d’uso?

Prima di tutto, contiene la risposta sulla struttura, le possibilità del dispositivo Q-Logic FC HBA CLI, l'uso di vari accessori ed una serie di informazioni per sfruttare totalmente tutte le caratteristiche e servizi.

Dopo l'acquisto di successo di attrezzature/dispositivo, prendere un momento per familiarizzare con tutte le parti del manuale d'uso Q-Logic FC HBA CLI. Attualmente, sono preparati con cura e tradotti per essere comprensibili non solo per gli utenti, ma per svolgere la loro funzione di base di informazioni e di aiuto.

Sommario del manuale d’uso

  • Pagina 1

    Simplify R SN0054614-00 F Page i SANsurfer FC HBA CLI User ’ s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adapters[...]

  • Pagina 2

    Page ii SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters © 2004–2008 QLogic Corporation. All Rights Reserved Worldwide. First Published: March 2004 QLogic Corporation, 26650 Aliso Viejo Parkway , Al iso V iejo, CA 92656, (800) 662-4471 or (94 9 ) 389- 6000 Information fu rni[...]

  • Pagina 3

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page iii A Changed HBA No . to HBA Instance .A l l Changed SFF DMI to HBA transceiver details .A l l Updated supported QLogic HBA list. Section 1.3 Updated supported oper ating system list. Section 1.4 All non-interactive informat[...]

  • Pagina 4

    Page iv SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Changed bullet s describing interactive and non-interactive modes. Section 2.2 , Section 2.3 Clarified the note about st arting SANsurfer FC HBA CLI on a Solaris console seri al po rt . Section 2.2 Added Macintosh column [...]

  • Pagina 5

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page v A Expanded Save/Update Flash section to list which OSs and HBAs save/update fla sh, BIOS, or the option ROM image. Section 4.10 Added desc ription and pr eparation instruc tions for loopback and r ead/write buf fer tests. A[...]

  • Pagina 6

    Page vi SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Configure HBA Settings (-n): a dded option to restore the BIOS (QLA/QLE/QEM24 xx HBAs). 4.7.1 , Section 5.3.22 Selective LUNs (command line option -m): adde d ALL option to command line to view all selective LUNs for all [...]

  • Pagina 7

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page vii A Revision D Changes: Operating systems supported: Windows 2003 Server ™ and Enterpr ise Server: added x64; removed IEM64T an d AMD64. Added Windows ® XP . Red Hat™ Linux ® AS: added x86_64; removed IEM64T and AMD64[...]

  • Pagina 8

    Page viii SN0054614-00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters The following options and commands were ch anged in Rev . D: Interactive mode commands : Ch anged instructions and the example text to new port sorting and num- bering scheme. No chan ge to command function. Non-interac[...]

  • Pagina 9

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs SN0054614-00 F Page ix A Display LUN List (-l): In interactive mode, added t arget type to infor- mation displayed. Removed a sset tag and en d tag from list of VPD information. In example text, changed the first two option names of the Selectiv[...]

  • Pagina 10

    Page x SN0054614- 00 F S SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Notes[...]

  • Pagina 11

    SN0054614-00 F Page xi T able of Content s Section 1 Introduction 1.1 Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2 Guide Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1.2.1 How this Guide is Organized . . . . . . . . . . [...]

  • Pagina 12

    Page xii SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S 3.3 Uninstalling SANsu rfer FC HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 3.3.1 Windows Uninst all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 3.3.1.[...]

  • Pagina 13

    SN0054614-00 F Page xiii SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A 4.4 T arget/LUN List Menu (Comma nd Line Options -t and -l) . . . . . . . . . . . . . . 4-30 4.4.1 T arget/LUN List (Per HBA Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 4.4.1.1 Per T arget/LU[...]

  • Pagina 14

    Page xiv SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S 4.8 Boot Device Menu (Command Line Op tion -e) . . . . . . . . . . . . . . . . . . . . . . 4-51 4.8.1 HBA Port Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-52 4.8.1.1 Boot De[...]

  • Pagina 15

    SN0054614-00 F Page xv SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A 4.13.2 Link S tatus (Command Line Option -ls) . . . . . . . . . . . . . . . . . . . . . . . . 4-80 4.13.2.1 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-80 4.13.2.2 Show L[...]

  • Pagina 16

    Page xvi SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S 5.3.16 -kl (Loopback T est) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17 5.3.16.1 DataPattern (DP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18 5.3.16[...]

  • Pagina 17

    SN0054614-00 F Page xvii SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A A.2.3 Display HBA Information (Command Line Option -i) . . . . . . . . . . . . . . A-4 A.2.4 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . A-6 A.2.5 Display LUN List (Command Line Opt[...]

  • Pagina 18

    Page xviii SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S B.8.7 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . B-16 B.8.8 Display All Information for One or All HBAs (Command Line Option -z) . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Pagina 19

    SN0054614-00 F Page xix SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A List of Figures Figure Page 3-1 Preparing to I nstall Dialo g Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2 3-2 W elcome Dialog Box . . . . . . . . . . . . . . . . . . . . . .[...]

  • Pagina 20

    Page xx SN0054614-00 F SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters S Notes[...]

  • Pagina 21

    SN0054614-00 F PRELIMINARY 1-1 Section 1 Introduction 1.1 Product Overview The SANsurfer ® FC HBA CLI tool provides a command line interface (CLI) that lets you easily inst all, c onfigure, and deploy QLogic ® Fibre Channel (FC) host bus adapters (HBAs). It also provides robust diagnostic and tro ubleshooting capabilities an d useful statistica l[...]

  • Pagina 22

    1 – Introduction Guide Overview 1-2 PRELIMINARY SN0054614-00 F S Section 2 Getting St arted : This section describes the two modes used in SANsurfer FC HBA CLI: interactive and non-interactive . It also explains some special terms used in this guide. Section 3 Initial Inst allation : This section provides step-by-step instructions for installing [...]

  • Pagina 23

    1 – Introduction Guide Overview SN0054614-00 F PRELIMINARY 1-3 A # scli -z  T ext in ALL CAPIT ALS usually indicates the name of a key that you press on the keyboard. For example: T ype the number for Host Information and then press ENTER.  Italicized text indicates either a document reference, glossary t erm, or emphasis. For example: Atta[...]

  • Pagina 24

    1 – Introduction Supported QLo gic HBAs 1-4 PRELIMINARY SN0054614-00 F S 1.3 Supported QLogic HBAs SANsurfer FC HBA CLI is supported for the followin g QLogic HBAs:  QLA234 x  QLA2 xx  QLE2 xx  QLE246 x  QLA246 x  QLE256 x 1.4 Supported Operating Systems SANsurfer FC HBA CLI is supported on the fo llowing operating systems:  [...]

  • Pagina 25

    1 – Introduction System Requirements SN0054614-00 F PRELIMINARY 1-5 A  Solaris x86 9/10 (with latest p atches)  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 1.5 System Requirement s The hardware and sof tware requirement s for SANsurfer FC [...]

  • Pagina 26

    1 – Introduction System Requirement s 1-6 PRELIMINARY SN0054614-00 F S  256 MB physical RAM are required to run SANsurfer FC HBA CLI; running with less memory can caus e disk swapping (“p aging” or “p aging out”), which severely affects performance.  Video car d capable of 256 colors and a screen resolution of 800x 600 pixels.  A[...]

  • Pagina 27

    1 – Introduction T echnical Support SN0054614-00 F PRELIMINARY 1-7 A 1.5.2.1.2 Features Not A vailable Wh en Running ioctl Module Driver When running the input/out put control (ioctl) module driver on a Linux OS, the following features are not available:  Persistent binding  Selective LUN  HBA port statistics  Driver settings  Host[...]

  • Pagina 28

    1 – Introduction Contact Information 1-8 PRELIMINARY SN0054614-00 F S Visit the QLogic support Web site at: support.qlog ic.com for the latest firmware and product updates. 1.6.1 A vailability QLogic T echnical Support for product s under warranty is available during local standard working hours exclud ing QLogic Observed Holidays. 1.6.2 Tr a i n[...]

  • Pagina 29

    1 – Introduction Contact Information SN0054614-00 F PRELIMINARY 1-9 A Europe, Middle East, and Africa Region E-mail emeasupport@qlogic.com Phone Numbers by Languag e +353 1 6924960 – English +353 1 6924961 – Fran çais +353 1 6924962 – Deut sch +353 1 6924963 – Esp añol +353 1 6924964 – Port uguês +353 1 6924965 – It aliano Asia Pac[...]

  • Pagina 30

    1 – Introduction Contact Information 1-10 PRELIMINARY SN0054614-00 F S Notes[...]

  • Pagina 31

    SN0054614-00 F PRELIMINARY 2-1 Section 2 Getting S t arted 2.1 Introduction SANsurfer FC HBA CLI operates in two mo des:  Interactive (menu-drive n). The CLI st arts, and then waits for and executes input commands until terminated by the user . Use this mode to do multiple operations. Section 4 Interactive Commands covers this interface.  Non[...]

  • Pagina 32

    2 – Getting S tarted S tarting Interactive Mode 2-2 PRELIMINARY SN0054614-00 F S 3. Run SCLI commands as required. 4. When finished, return to th e main menu, and type the indicated number to quit SANsurfer FC HBA CLI. 5. Close the terminal window . The Main Menu appears as sh own in the following: SANsurfer FC HBA CLI v1. x.x Build xx Main Menu [...]

  • Pagina 33

    2 – Getting S tarted S tarting Non-in teractive Mode SN0054614-00 F PRELIMINARY 2-3 A 2.3 S t arting Non-interactive Mode T o start SANsurfer FC HBA CLI in non-in teractive mode, type the f ollowing in a command window: scli < Parameters > SANsurfer FC HBA CLI executes the command options, t hen terminates. T o list all of the available com[...]

  • Pagina 34

    2 – Getting S tarted S tarting Non-inte ractive Mode 2-4 PRELIMINARY SN0054614-00 F S . T able 2-1. Non-interactive Mode Options CLI Option Interactive Menu (Windows) Interactive Me nu (Red Hat/SuSE Linux, Solaris SP ARC) Interactive Menu (Macinto sh) Description Section -a 1 1 1 1 1 1 Flash HBA beacon 5.3.1 -b 10 10 — Save/update BIOS/F Code a[...]

  • Pagina 35

    2 – Getting S tarted S tarting Non-in teractive Mode SN0054614-00 F PRELIMINARY 2-5 A 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 proc essed. These options, however , can be combined with one or m[...]

  • Pagina 36

    2 – Getting S tarted Te r m i n o l o g y 2-6 PRELIMINARY SN0054614-00 F S 2.4 T erminology Some of the terms used in this guide are similar and some ha ve changed slightly as technology changes. The following definitions apply: HBA Port HBA Port refers to the actual physical port on a n HBA. For example, a QLA2462 has two port s called HBA port [...]

  • Pagina 37

    SN0054614-00 F 3-1 Section 3 Initial Inst allation Before you run SANsurfer FC HBA CLI, ensu re that the following requirements are met:  The HBAs must be installed.  The HBA drivers must be installed . 3.1 Downloading the Inst allation Package T o download the SANsurfer FC HBA CLI installation package fro m the QLogic Web site, fo llow these[...]

  • Pagina 38

    3 – Initial Installation Installing SANsurfer FC HBA CLI 3-2 SN0054614-00 F S 3.2 Inst alling SANsurfer FC HBA CLI Follow the installa tion instructions in the section that corresponds to your operating system (OS):  Windows—See section 3.2.1 .  Linux—See section 3.2.2 .  Solaris—See section 3.2.3 .  Macintosh—See sectio n 3.2[...]

  • Pagina 39

    3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-3 A Figure 3-2 Welcome Dialog Box 2. Read the information, and then click Next . The Choose Destination Location d ialog box appears as shown in Figure 3-3 . Figure 3-3 Choose Destinat ion Location Dialog Box 3. In the Choose Destination Location dia log box, do one of the [...]

  • Pagina 40

    3 – Initial Installation Installing SANsurfer FC HBA CLI 3-4 SN0054614-00 F S  T o select a different location: a. Click Browse . b. Select an insta llation location. c. The Choose Destination Location dialog box reappears. Click Next . The Ready to Inst all the Program dialog box appears as shown in Figure 3-4 . Figure 3-4 Ready to Inst all t[...]

  • Pagina 41

    3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-5 A If you want to stop the installation, click Cancel . The Inst allShield Wizard Complete dialog box appears as shown in Figure 3-6 . Figure 3-6 InstallShield Wi zard Compl ete DIalog Box 5. (Optional.) Select one of the fo llowing:  If you want to see more informat io[...]

  • Pagina 42

    3 – Initial Installation Installing SANsurfer FC HBA CLI 3-6 SN0054614-00 F S By default, SANsurfer FC HBA CLI is inst alled in the following directory: Program filesQLogic CorporationSANsurferCLI 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:[...]

  • Pagina 43

    3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-7 A T o create a response file for a silent installa tion of SANsurfer FC HBA CLI, enter the following: scli-1. x . x - xx .windows.exe /r /f1"C:Tempinstall_1.iss" T o run the installation in silent mode with a log file, enter the following: scli-1. x . x - xx .[...]

  • Pagina 44

    3 – Initial Installation Installing SANsurfer FC HBA CLI 3-8 SN0054614-00 F S T o query for the installed SANsurfer FC HBA CLI p ackage name, enter the following text from the command line: rpm -q scli 3.2.3 Solaris Inst allation T o install SANsurfer FC HBA CLI on Solaris, follow the step s in one of these sections:  Solaris SP ARC 8, 9, 10?[...]

  • Pagina 45

    3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-9 A 5. The pkgadd program does a se ries of checks, and then posts a script warning and asks whether to continue the in stallation. For example: Processing package instance <QLScli> from </space/chuynh/scli/qlogic/Solaris/pkgs/x> QLogic SANsurfer FC CLI (HBA Con[...]

  • Pagina 46

    3 – Initial Installation Installing SANsurfer FC HBA CLI 3-10 SN0054614-00 F S 2. T o uncompress the file, type the following: # uncompress scli- x.xx.xx-xx .x86.Solaris.pkg 3. T o see the available package file, type the following: # ls The available p ackages appear . For example: # scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg 4. T o install SANsurfer[...]

  • Pagina 47

    3 – Initial Installation Installing SANsurfer FC HBA CLI SN0054614-00 F 3-1 1 A . [ verifying class <none>] ## Executing postinatall script. Installation of <QLSclix> was successful. 3.2.4 Macintosh Inst allation T o install SANsurfer FC HBA CLI, follow either the standard GUI or command line installation met hod:  S tandard (GUI) [...]

  • Pagina 48

    3 – Initial Installation Uninstalling SANsurfer FC HBA CLI 3-12 SN0054614-00 F 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[...]

  • Pagina 49

    3 – Initial Installation Uninstalling SANsurfer FC HBA CLI SN0054614-00 F 3-13 A 3.3.1 Windows Uninst all T o uninstall SANsurfer FC HBA CLI, use either the st andard GUI or command lin e method:  S tandard (GUI) uninst all—See section 3.3.1.1  Command line uninst all—See section 3.3.1.2 3.3.1.1 S t andard (GUI) Uninstall T o uninstall [...]

  • Pagina 50

    3 – Initial Installation Uninstalling SANsurfer FC HBA CLI 3-14 SN0054614-00 F S  Solaris SP ARC 8, 9, 10—See sectio n 3.3.3.1 .  Solaris x86 8, 9, 10—See sectio n 3.3.3.2 . 3.3.3.1 Solaris SP ARC 8, 9, and 10 Uninstall Follow these steps t o uninstall SANsurfer FC HBA CLI: 1. T ype the following to remove SANsurfer FC HBA CLI: # pkgrm [...]

  • Pagina 51

    3 – Initial Installation Uninstalling SANsurfer FC HBA CLI SN0054614-00 F 3-15 A 2. The program shows the package na me and a script warning asking whether to continue the uninst all 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 r[...]

  • Pagina 52

    3 – Initial Installation Uninstalling SANsurfer FC HBA CLI 3-16 SN0054614-00 F S Notes[...]

  • Pagina 53

    SN0054614-00 F 4-1 Section 4 Interactive Commands This section describes the interactive mode command line optio ns for specific QLogic FC HBAs. The interactive mode us es a serie s of menus from which you select the option you want and enter the n umber for that option. (See Section 5 for non-interactive mode opera tion in which you simply enter a[...]

  • Pagina 54

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-2 SN0054614-00 F 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 ha ve several choices includ ing 1: Ho[...]

  • Pagina 55

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-3 A  OS version (patches where a pplicable)  SDM API version  A list of HBAs including, for each HBA:  HBA model and serial numb er (SN)  Port number  WWPN  HBA Instance number  S tatus (online/of fline)  (Repeats for ea ch [...]

  • Pagina 56

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-4 SN0054614-00 F S This option shows you the HBA Host T opology menu. From the General Information Men u , type the number for Host Topology , and then press ENTER. When you select this optio n, the following options appear:  Display  Save As Txt file  Save As[...]

  • Pagina 57

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-5 A  Interconnect element (HBA)  Ty p e  World wide nod e name  World wide port name  V endor ID  HBA Model  HBA Serial Number  HBA Alias  Port Alias  Driver V ersion  Firmware V ersion  T otal Number of Devices [...]

  • Pagina 58

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-6 SN0054614-00 F S Here is an example: ================================= = InterConnect Element = ================================= Type : HBA World Wide Node Name : 20-00-00-E0-8B-03-55-7C World Wide Port Name : 21-00-00-E0-8B-03-55-7C Vendor Id : QLogic Corporation H[...]

  • Pagina 59

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-7 A Port Name : 20-01-00-C0-DD-00-6A-9F Port state : Offline Port Type : Vendor Specific/Reserved Port Type. TX Port Type : Electrical - EL Port Module Type : GBIC ======================== = Attached Port = ======================== Target/Initiator : [...]

  • Pagina 60

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-8 SN0054614-00 F S ================================= Type : HBA World Wide Node Name : 20-00-00-E0-8B-85-8C-7C World Wide Port Name : 21-00-00-E0-8B-85-8C-7C Vendor Id : QLogic Corporation HBA Model : QLA2462 HBA Serial Number : FFC0551D59564 HBA Alias : Port Alias : D[...]

  • Pagina 61

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-9 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 T opology  3: Save As XML File  2: Save As XML File form at [...]

  • Pagina 62

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-10 SN0054614-00 F S  HBA General Information  Host Name  HBA Instance  HBA Model  HBA Description  HBA ID  HBA Alias  HBA Port  Port Alias  N ode Name (WWNN)  P ort Name (WWPN)  Port ID  Serial Number  Driver V ersion  BIOS [...]

  • Pagina 63

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-1 1 A  HBA Parameters Settings Header (Command Line Optio ns -c)  HBA Instance  HBA Part Number  Port Number  WWPN  Port ID  HBA Parameter Settings  Connection Options  Data Rate (QLA23 xx , QLA24 xx , QLE23 xx , and QLE24 x[...]

  • Pagina 64

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-12 SN0054614-00 F S  HBA Part Number  Port Number  WWPN  PORT ID  Device/LUNs Information (Repeat s for each LUN)  Path  T arget  Device ID  Product V endor  Product ID  Product Revision  Serial number  Node name  Port Name [...]

  • Pagina 65

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-13 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: S[...]

  • Pagina 66

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-14 SN0054614-00 F S Port Name : 2 1-01-00-E0-8B-23-55-7C Port ID : 1 1-06-00 Serial Number : C 28437 Driver Version : S CSI Miniport 8.1.5.15 (W2K IP) BIOS Version : 1 .83 Firmware Version : 2 .02.03 Actual Connection Mode : P oint to Point Actual Data Rate : 1 Gbps Po[...]

  • Pagina 67

    4 – Interactive Com m a nd s General Information Menu (Com mand Line Option -g) SN0054614-00 F 4-15 A Present targets that are persistentl y bound Only : Disable -------------------------------- Driver Settings - Group: Binding -------------------------------- Bind by World Wide Port Name : Enable Bind by Port ID : Disable -----------------------[...]

  • Pagina 68

    4 – Interactive Comma nds General Information Menu (Command Lin e Option -g) 4-16 SN0054614-00 F S LUN Count(s) : 1 Status : O nline ------------------------------------ ------------------------ ------------------------------------ --- LUN 0 ------------------------------------ --- Product Vendor : S EAGATE Product ID : S T118273 CLAR18 Product R[...]

  • Pagina 69

    4 – Interactive Com m a nd s HBA Information Menu ( Co mmand Line Option -i) SN0054614-00 F 4-17 A (Primary ) Boot Port Name LUN ---------------------------- --- --- 00-00-00-00-00-00-00-00 0 ---------------------------- --- --- (Alternate 1) Boot Port Name LUN ---------------------------- --- --- 00-00-00-00-00-00-00-00 0 -----------------------[...]

  • Pagina 70

    4 – Interactive Comma nds HBA Information Menu (Command Line Option -i) 4-18 SN0054614-00 F 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[...]

  • Pagina 71

    4 – Interactive Com m a nd s HBA Information Menu ( Co mmand Line Option -i) SN0054614-00 F 4-19 A  HBA Model  WWNN  Serial number  Alias With this option you can create, modify , or delete the symbolic name o r alias , for an HBA. From the Main Menu, follow these step s: 1. T ype the number for the HBA Information option and press EN[...]

  • Pagina 72

    4 – Interactive Comma nds HBA Information Menu (Command Line Option -i) 4-20 SN0054614-00 F S The HBA Port Alias option allows you to cr eate, modify , or delete a symbolic name (Alias) for the specified HBA port. Follow these steps t o create, modify , or delete an HBA port alias: 1. From the Main Menu, type the number for the HBA Informati on o[...]

  • Pagina 73

    4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-21 A  EFI Driver V ersion  Firmware V ersion  BIOS V ersion (Windows and Linux)  FCode V ersion (Solaris) If the HBA does not support VPD, the following messag e appears: VPD not supported on current HBA 6! 4.2.2 HBA Information (All HBAs) 2: HBA Information  n: All[...]

  • Pagina 74

    4 – Interactive Comma nds HBA Parameters Menu 4-22 SN0054614-00 F S  All HBAs Here is an example of an HBA Information Menu screen. In this example, the host includes three HBAs with two port s 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[...]

  • Pagina 75

    4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-23 A  Execution Throttle  Login Retry Count  Enable LIP Reset  Port Down Retry Count  Enable LIP Full Login  Link Down T imeout (seconds)  Enable T arget Reset  LUNs Per T arget  Enable Receive Out Of Order Frame 4.3.1.2 Configure HBA Parameters (Command[...]

  • Pagina 76

    4 – Interactive Comma nds HBA Parameters Menu 4-24 SN0054614-00 F S T able 4-1. HBA Parameters Settings (NVRAM) Parameter Name Alias V alue Description ConnectionOption CO 0–3 See table n ote 1. DataRate DR 0–4 See table n ote 2. EnableBIOS EB 0, 1 See table notes 3, 4. EnableExtendedLogging EL 0, 1 See table notes 3, 4. EnableFCTape EF 0, 1 [...]

  • Pagina 77

    4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-25 A 4.3.1.2.1 Connection Options 3: HBA Parameters  1: Port Number  2: Configure HBA Parameters  n. Connectio n Options From this menu, you can conf igure the connection o ptions:  0–Loop Only  1–Point to Point Only  2–Loop Preferred, Otherwise Point-to-Po[...]

  • Pagina 78

    4 – Interactive Comma nds HBA Parameters Menu 4-26 SN0054614-00 F S  Frame Size: 512  Frame Size: 1024  Frame Size: 2048 T ype 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 yo u to enter a valid Ha[...]

  • Pagina 79

    4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-27 A 4.3.1.2.9 Operation Mode 3: HBA Parameters  N: Port Number  2: Conf igure 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 DelayT imer expires [...]

  • Pagina 80

    4 – Interactive Comma nds HBA Parameters Menu 4-28 SN0054614-00 F S This choice gives you the option to set the Port Down Retry Count to a va lue 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 LI[...]

  • Pagina 81

    4 – Interactive Com m a nd s HBA Parameters Men u SN0054614-00 F 4-29 A 4.3.1.2.20 Abort Changes 3: HBA Parameters  N: Por t Number  2: Configure HBA Parameters  n: Abort chan ges Choose this option to stop with out making any changes. 4.3.1.3 Restore Default s 3: HBA Parameters  n: Port Number  3: Rest ore Default s This option is[...]

  • Pagina 82

    4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-30 SN0054614-00 F S 4.4 T arget/LUN List Menu (Command Line Op tions -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. Y ou have the option to select:  Each HB[...]

  • Pagina 83

    4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-31 A 4.4.1 T arget/LUN List (Per HBA Port) 4: Target/LUN List  1 - n T arget List Menu - Port n When you select an HBA Port in stance from the T arget/LUN List, a list of LUNs (disks) attached to that port instance appears. T echnical informati[...]

  • Pagina 84

    4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-32 SN0054614-00 F S  LUN Number  V endor  Product ID  Port Name  Port ID  All LUN(s) Here is an example of the LUN List Menu : 1: LUN 0 Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5B-F9 Port ID : 02-0A-DC And so on. M:[...]

  • Pagina 85

    4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-33 A 4.4.1.3 All T argets 4: Target/LUN List  1 - n T arget List Menu Port n  1 - n: T arget  m: All LUNs When you select a particular LUN from th e LUN list, the following information for all LUNs appears:  Product V endor  Product[...]

  • Pagina 86

    4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-34 SN0054614-00 F S This choice shows the Target List Menu for All HBAs . Inf ormation for each individual target includes:  (T arget type) on QLAxxxx (HBA Instance n)  V endor  Product ID  Product Revision  Serial Number  Port Name  Port ID [...]

  • Pagina 87

    4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-35 A  St a t u s Here is an example of the T arget information: Path : 0 Target : 3 Device ID : 0x87 Product Vendor : SEAGATE Product ID : ST336607FC Product Revision : 0006 Serial Number : 3JA9TN7600007517T6P1 Node Name : 20-00-00-11-C6-2D-5B-[...]

  • Pagina 88

    4 – Interactive Comma nds T arget /LUN List Menu (Command Line Option s -t and -l) 4-36 SN0054614-00 F S WWULN : 20-00-00-0C-50-68-1E-9A ------------------------------------------------ Hit (RETURN) to continue: 4.4.2.4 All T arget(s) 4: Target/LUN List  n: Port Number  3: All T arget(s) This choice shows informatio n for all t a rgets conn[...]

  • Pagina 89

    4 – Interactive Com m a nd s T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 F 4-37 A 4.4.2.5 All LUN(s) 4: Target/LUN List  n: Port Number  3: All LUN(s) When you select this option, SANsurf er FC HBA CLI shows the following information about all LUNs for all HBA Port Inst ances:  Product V endor  Product ID  P[...]

  • Pagina 90

    4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-38 SN0054614-00 F S LUN : 0 Size : 68.37 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 20-00-00-00-87-72-85-B2 OS LUN Name : /dev/sda Here is an example of the All LUNs in fo rmation on Solaris with a QLA driver: Product Ve[...]

  • Pagina 91

    4 – Interactive Com m a nd s T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 F 4-39 A 8. All HBAs 9. Return to Previous Menu T able 4-3 lists the target link speed settin gs and descriptions. 4.5.1 Configuring the iiDMA Settings Use the Intelligent Interleave Fact or Selection (iiDMA) menu to select the intelligen[...]

  • Pagina 92

    4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-40 SN0054614-00 F S 4. T o use Basic Configuration : a. Select the HBA. b. Select the intelligent interleave fact or from the intelligent interlea ve factor speed list ( 1 Gbps , 2 Gbps , 4 Gbps , or 8 Gbp s ) to all attached devices. c. Choose one o[...]

  • Pagina 93

    4 – Interactive Com m a nd s T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 F 4-41 A  Product Revision  Serial Number  Port Name  Port ID  Max T arget Link Rate  Next T arget T ype (for example, Disk)  Apply Changes to Selected T argets Here is an example of the Target Link Speed Menu for all[...]

  • Pagina 94

    4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-42 SN0054614-00 F 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 Product ID : ST136403FC Product Rev : FF5F Serial Number : LT06464600001011H[...]

  • Pagina 95

    4 – Interactive Com m a nd s T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 F 4-43 A When you have set the speed for all the links you want, type the number for Apply changes to Selected T arget(s) and then press ENTER. 4.5.4 T arget Link Speed – All HBAs 5: Target Link Speed  2: All HBAs When you select thi[...]

  • Pagina 96

    4 – Interactive Comma nds T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 4-44 SN0054614-00 F S  Apply Changes to Selected T argets Here is an example of the T arget 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 : ST31[...]

  • Pagina 97

    4 – Interactive Com m a nd s T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 F 4-45 A When you select an HBA to set it s link speed, the T arget Link S peed Menu (Advanced) menu for a p articular HBA instance appears. It shows the lin k speed options you can choose f rom. The options vary according to the HBA in use. For ex[...]

  • Pagina 98

    4 – Interactive Comma nds T arget Persistent Bindin gs Menu ( Command Line Option -p) 4-46 SN0054614-00 F S When you select this option, SANsurf er FC HBA CLI shows the Target Persistent Binding menu listing st andard HBA port instances (see 4.5 .2 ), where you can select an individual HBA port or All HBAs . The following sections describe how to[...]

  • Pagina 99

    4 – Interactive Com m a nd s T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 F 4-47 A  T arget information (model name and number , for example)  Port Name  Port ID  T arget ID 4.6.1.2 T arget Persistent Bindin gs – Bind T arget(s) (Command Line Option -p) 6: Target Persistent Bindings  1 - n: T arget Persi[...]

  • Pagina 100

    4 – Interactive Comma nds T arget Persistent Bindin gs Menu ( Command Line Option -p) 4-48 SN0054614-00 F S Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5A-3F Port ID : 11-0A-E2 Bind : No Target ID : ... n: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5A-3F Port ID : 02-0A-E4 Bind : No Target ID : p: All Ta[...]

  • Pagina 101

    4 – Interactive Com m a nd s Selective LUN s Menu (Co mmand Line O ption -m) SN0054614-00 F 4-49 A 4.6.2.1 Display T arget Persistent Binding 6: Target Persistent Binding  p: All HBAs  1: Display Configuratio n When you select the Display Configuration option, the following informatio n appears. (Or , the message, No target persistent bindi[...]

  • Pagina 102

    4 – Interactive Comma nds Selective LUNs Menu ( Command Line Option -m) 4-50 SN0054614-00 F 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 ?[...]

  • Pagina 103

    4 – Interactive Com m a nd s Boot Device Menu (Command Line Option -e) SN0054614-00 F 4-51 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 -------------------------------------------------[...]

  • Pagina 104

    4 – Interactive Comma nds Boot Device M enu (Comma nd Line Option -e) 4-52 SN0054614-00 F S 4.8.1 HBA Port Inst ance 8: Boot Device  1 - m: HBA Port Instance When you select this option, SANsurf er FC HBA CLI shows the Boot Device Settings menu for HBA Instance m. Y ou can choose to:  Display Boot Device(s)  Configure Boot Device(s) 4.8.[...]

  • Pagina 105

    4 – Interactive Com m a nd s Boot Device Menu (Command Line Option -e) SN0054614-00 F 4-53 A 00-00-00-00-00-00-00-00 0 ---------------------------- ------ (Alternate 3) Boot Port Name LUN ---------------------------- ------ 00-00-00-00-00-00-00-00 0 4.8.1.2 Configure Boot Device(s) 8: Boot Device  n: Port Nu mber  2: Conf igure Boot Device([...]

  • Pagina 106

    4 – Interactive Comma nds Driver Settings Menu (Command Line Option -fg) 4-54 SN0054614-00 F S 4.8.1.2.3 Save Configuration 8: Boot Device  n: Port Nu mber  2: Config.Boot Device  2: Device Settings  1: LUN List  1: Save Configuratio n When you select this option, th e CLI shows the Save Configuration menu:  Proceed  Cancel 4[...]

  • Pagina 107

    4 – Interactive Com m a nd s Driver Settings Menu ( Command Line Option -fg) SN0054614-00 F 4-55 A The current settings for t he Present persistently bound target(s)... and Bind by... are indicated by the word Current in p a rentheses after the selection. T o change these settings, select the menu number corresponding to the other option. T o sav[...]

  • Pagina 108

    4 – Interactive Comma nds Utilities Menu 4-56 SN0054614-00 F S 4.10 Utilities Menu 10: Utilities When you select this option, SANsurf er FC HBA CLI shows the following utilities options:  Flash Update  Flash Save  HBA Parameters Update  HBA Parameters Save  HBA Parameters T e mplates  Driver Update (Windows only)  Driver Resc[...]

  • Pagina 109

    4 – Interactive Com m a nd s Utilities Menu SN0054614-00 F 4-57 A 4.10.3 HBA Parameters Up date (Per HBA Port or All HBAs) (Command Line Option -r) 10: Utilities  3: HBA Parameters Up date When you select HBA Parameters Update , you are prompted to select either one of your HBA port insta nces or All HBAs to update. SANsurfer FC HBA CLI then d[...]

  • Pagina 110

    4 – Interactive Comma nds Utilities Menu 4-58 SN0054614-00 F S When you select the HBA Parameters Template option, SANsurfer FC HBA CLI prompts you to select an HBA port (or All HBAs ), and the n offe rs some or all of the following template types:  EMC (EMC-specific settings)  HP (HP-specific settings)  HPQ (HP-specific settings – 2Gb[...]

  • Pagina 111

    4 – Interactive Com m a nd s Utilities Menu SN0054614-00 F 4-59 A  Link Down T imeout specifies the time the driver waits for the link to come up after link do wn before returning the I/Os. This is an alogous to the Port Down Retry Count setting, which is used when the port is d own. The following tab les list the paramete r settings supported[...]

  • Pagina 112

    4 – Interactive Comma nds Utilities Menu 4-60 SN0054614-00 F S 4.10.6 Driver Up date (Command Line Option -d) 10: Utilities  6: Driver Update The Driver Update op tion is available on Windows systems only . When you select Driver Update from the Utilities menu, SANsurfer FC HBA CLI prompt s you to select an HBA port, and then e nter a file nam[...]

  • Pagina 113

    4 – Interactive Com m a nd s Beacon Menu SN0054614-00 F 4-61 A 4.1 1 Beacon Menu 11: Beacon When you select the Beacon option, SANsurfer FC HBA CLI sho w s the Beacon Menu containing these o ptions:  Locate HBA  Locate T arget(s) 4.1 1.1 Locate HBA – HBA Beacon (Command Line Option -a) 11: Beacon  1: Locate HBA When you select this opt[...]

  • Pagina 114

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-62 SN0054614-00 F S Y ou can select a disk number to blink the LED on that target. The blinkin g asterisk ( * ) below the Device Port Name line shows that the t arget beacon is active. ---------------------------------------------------------------------------[...]

  • Pagina 115

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-63 A 4.12.1 Diagnostics Loopback T est (Command Line Option -kl) 12: Diagnostics  n: Port Nu mber When you select an HBA port fro m the Diagnostics menu, SANsurfe r FC HBA CLI shows the list of diagnostic t est s you can run for that p[...]

  • Pagina 116

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-64 SN0054614-00 F S  Loopback T est  Read/Write Buffer T est  T ransceiver Details (ava ilable on 4Gb and 8Gb only) T est results for loopback and read/write buffer test s may include these test result s:  Loopback test result s:  T est S tatus [...]

  • Pagina 117

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-65 A The loopback test is external to th e HBA. If the HBA port is in loop mode, you can run the loopback test with a lo opback connector . If the HBA port is in point-to-point mode and attached to a switch, an echo test is run instead (n[...]

  • Pagina 118

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-66 SN0054614-00 F S After completing the loopba ck test, do the following step s to prepare for normal HBA operations: 1. Remove the loopback connector from th e HBA connector . 2. Reconnect the cable that you disconnected before installing the loopback connec[...]

  • Pagina 119

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-67 A  Display T est Parameters  Reset T est Parameters  Configure T est Parameters  S tart Diagnostics T est The read/write buf fer test sends specified data through the SCSI Write Buf fer command to a target d evice (disk). I[...]

  • Pagina 120

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-68 SN0054614-00 F S 4. The Configure Diagnostic Loopback T est Parameters or Configure Diagnostic Read/W rite Buffer T est Parameters submenu appears. Select one of the following options: 1. Show Test Configuration. T ype 1 to show the current parameter values[...]

  • Pagina 121

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-69 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 [...]

  • Pagina 122

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-70 SN0054614-00 F 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 Confi[...]

  • Pagina 123

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-71 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 p[...]

  • Pagina 124

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-72 SN0054614-00 F S On Error : Ignore Test Continuous : OFF ------------------------------------------------------------------------ Diagnostics - Read/Write Buffer Test Result ------------------------------------------------------------ Hit <RETURN> to [...]

  • Pagina 125

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-73 A Temperature Voltage Tx Bias Tx Power Rx Power (C) (V) (mA) (mW) (mW) -------------- ------- ------- -------- -------- Value 34.17 3.33 5.86 0.498 1.174 Status Normal Normal Normal Normal Normal High Alarm 95.00 3.63 9.00 0.676 4.000 [...]

  • Pagina 126

    4 – Interactive Comma nds Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 4-74 SN0054614-00 F 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 d[...]

  • Pagina 127

    4 – Interactive Com m a nd s Diagnostics M enu (Comm and Line O ptions -kl, -k r , and -dm ) SN0054614-00 F 4-75 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 MS[...]

  • Pagina 128

    4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-76 SN0054614-00 F 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 S t atistics Menu (Command Line Options[...]

  • Pagina 129

    4 – Interactive Com m a nd s S tatistics Menu (Comm and Line Options -gs and -ls) SN0054614-00 F 4-77 A T o change the HBA statistics: 1. From the Main Menu , type the nu mber for the St atistics option, and then press ENTER. 2. From the Statistics Menu , type the number for the HBA S tatistics option, and then press ENTER. 3. From the HBA Statis[...]

  • Pagina 130

    4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-78 SN0054614-00 F S 4.13.1.1.1 Current Settings 13: Statistics  1: HBA Statistics  1 : Configuration  1: Cu rrent Settings The system displays the current settings for:  AutoPoll (AP)  SetRate (SR)  LogT oFile (LF) 4.13.1.1.2 Restore Default s 13: St[...]

  • Pagina 131

    4 – Interactive Com m a nd s S tatistics Menu (Comm and Line Options -gs and -ls) SN0054614-00 F 4-79 A If you select the Manual Poll op tion, the system prompt s you to enter a value for Manual Poll iteration: Manual Poll iteration (1-256) Enter a value from 1 to 256 and press EN TER. Th e system updates the Manual Poll iteration value and retur[...]

  • Pagina 132

    4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-80 SN0054614-00 F S 3. From the HBA Statistics Menu , type the number for the Show HBA St atistics option, and then press ENTER. 4. The Statistics Menu app ears and promp t s you to select an HBA port. T ype the number for the port, and then pre ss ENTER. The HBA stat[...]

  • Pagina 133

    4 – Interactive Com m a nd s S tatistics Menu (Comm and Line Options -gs and -ls) SN0054614-00 F 4-81 A  Auto Poll  Set Rate  Log to file T able 4-1 1 shows the statistics and link status o ptions. 4.13.2.1.1 Current Settings 13: Statistics  2: Link Status  1: Configura tion  1: Current Settings Select the Current Settings optio[...]

  • Pagina 134

    4 – Interactive Comma nds S tatistics Menu (Command Line Options -gs and -ls) 4-82 SN0054614-00 F S  Auto Poll  Manual Poll If you select the Auto Poll option, the system enables Auto Po ll and returns a message: Auto Poll enabled. If you select the Manual Poll op tion, the system prompt s you to enter a value for Manual Poll iteration: Man[...]

  • Pagina 135

    4 – Interactive Com m a nd s Virtual Menu (Com mand Line Option - vp) SN0054614-00 F 4-83 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 st atus. T o view the link status: 1. T ype the number for the St atistics option, and then press ENTER. 2. The Statistics Menu appea rs[...]

  • Pagina 136

    4 – Interactive Comma nds Virtual Menu (Com mand Line Option -vp ) 4-84 SN0054614-00 F S QLogic's SANsurfer FC HBA CLI for Wind ows works in conjunc tion with QLogic's N_Port ID V irtualization (NPIV)-capable Windows driver . NPIV is an ANSI T1 1 standard that describes how multiple unique fabric addresses (N_Port IDs) can share a singl[...]

  • Pagina 137

    4 – Interactive Com m a nd s Virtual Menu (Com mand Line Option - vp) SN0054614-00 F 4-85 A 4.14.1 V irtual Menu for HBA Inst ance 14: Virtual  1: Virtual Menu When you select this option, th e Virtual Port Menu appears with the following options:  List Virtual Port s  Delete a Vi rtual port  Create a Vir tual port Enter the number fo[...]

  • Pagina 138

    4 – Interactive Comma nds Virtual Menu (Com mand Line Option -vp ) 4-86 SN0054614-00 F S  List Virtual Port s including for each:  Instance Nu mber  Virtual Port Number  WWPN  S tatus (Online o r 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-6[...]

  • Pagina 139

    4 – Interactive Com m a nd s Help Menu (Command Line Option -h) SN0054614-00 F 4-87 A 4.14.1.3.1 Auto Generate 14: Virtual  1: Virtual Menu  3: Create a V irtual Port  1: Auto Generate When you select this option, th e system creates a Virt ual Port on this HBA physical port and report s the WWPN of the virtual port. For example: Virtual[...]

  • Pagina 140

    4 – Interactive Comma nds Help Menu (Comm and Line Option -h) 4-88 SN0054614-00 F S  About T ype the number for the option you want and press ENTER. 4.15.1 Content s 14 (or 15): Help  1: Contents When you select the Contents option, SANsurfer FC HBA CLI shows the entire Help menu. Y ou can see the help menu options rearranged into alphabeti[...]

  • Pagina 141

    SN0054614-00 F 5-1 Section 5 Non-interactive Commands 5.1 Introduction This section cont ains the information in the help (to view he lp, enter the command -h ), plus additional explanation and ex amples. Each command line option is listed, followed by a command description a nd examples of the command in u se and typical responses from the system.[...]

  • Pagina 142

    5 – Non-interactive Commands Display System Information (Command Line Options -g , -z, and -tp) 5-2 SN0054614-00 F S 5.2.2 Host Configuration (Command Line Option -z) The command line option -z shows all of the HBA ’s information in a single command. The command format is: # scli -z The SANsurfer FC HBA CLI tool s hows the information in sectio[...]

  • Pagina 143

    5 – Non-interactive Commands Display System Information (Comm and Line Options -g, -z, and -tp) SN0054614-00 F 5-3 A 5.2.3 Host T opology (Command Line Option -tp) The command format for Host T opology is: # scli -tp When you select this option, th e SANsurfer FC HBA CLI tool shows the information in section 5.2.2 , as well as the following addit[...]

  • Pagina 144

    5 – Non-interactive Commands Display System Information (Command Line Options -g , -z, and -tp) 5-4 SN0054614-00 F S  Port S tate  Port Information  Physical Port Number (switch port number), including:  Port state  Port type  TX port type  Port module type  Attached Port (QLogic HBA, t ape device, or disk device connected[...]

  • Pagina 145

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-5 A 5.3 Command Summary The command format for non-interactive mode is: # scli -(Cmd) (< HBA Instance > | < HBA WWPN >) (view | ?) Where: Y ou can combine the commands -o , -s an d -x with other options. However , they must be at the beginning or at the end of the command l[...]

  • Pagina 146

    5 – Non-interactive Commands Command Summary 5-6 SN0054614-00 F S  Y ou can use either the hyphen (-) c haracter or the forward slash (/) character . For example, both of these commands are valid: scli -g scli /g T able 5-2 defines the command variables. . 5.3.1 -a (View or T oggle Beacon St atus) Use the -a command to either view (1) or chang[...]

  • Pagina 147

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-7 A T o view the HBA port’s LED Beacon st ate, 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 appea[...]

  • Pagina 148

    5 – Non-interactive Commands Command Summary 5-8 SN0054614-00 F S T o save the BIOS/FCode to a file, type: # scli -b (< HBA Instance > | < HBA WWPN >) SAVE < BIOS/FCode File Name > Where: 5.3.3 -c (Show Parameter Settings) Use the -c command to show the p arameter settings for all HBAs in the system: # scli -c [ <all> ] T [...]

  • Pagina 149

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-9 A Where: 5.3.5 -dm (Display Diagnostics Monitoring Info) This option allows you to show general o r detailed Digital Diagnost ic Monitoring Interface for optica l transceivers. T o show Tr ansceiver monitoring general information, type: # scli -dm (< HBA Instance > | < HBA W[...]

  • Pagina 150

    5 – Non-interactive Commands Command Summary 5-10 SN0054614-00 F S In these commands: T o view the current boot device selection on all HBAs: # scli -e (view | ?) T o view the current boot device selection for a specific HBA: # scli -e (< HBA Instance > | < HBA WWPN >) (view | ?) In Solaris SP ARC, if the system is runni ng with a csh[...]

  • Pagina 151

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-1 1 A T o cause the OS to boot from the first t arget it finds with a LUN, select a boot port name of 00-00-…00 (select able boot); this applies only if the boot BIOS is enabled. T o set a particular target as the b oot device for a specific HBA, type the following command: # scli -e[...]

  • Pagina 152

    5 – Non-interactive Commands Command Summary 5-12 SN0054614-00 F S 5.3.7 -ei (List SANsurfer FC HBA CLI Erro r Codes) This command lists the SANsu rfer FC HBA CLI error codes as shown in Appendix D . 5.3.8 -f (Input Parameter Options from a T ext File) T o input parameter options to SANsurfer FC HBA CLI throug h a text file, type -f , followed by[...]

  • Pagina 153

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-13 A 5.3.9 -fg (Show Driver Settings) T o show the driver settings, type: # scli -fg (< HBA Instance > | < HBA WWPN >) (view | ?) Where: 5.3.10 -fs (Configure Dri ver Settings) T ype the following command to configure the driver settings: # scli -fs (< HBA Instance > [...]

  • Pagina 154

    5 – Non-interactive Commands Command Summary 5-14 SN0054614-00 F S The following restrictions apply:  Under Solaris, the driver configuration feature is disabled if you are using the driver from the OS inst allation CDs (QLC driver).  Under Linux, this feature is d isabled if you are using the ioctl or sysfs (inbox) driver .  Under Macin[...]

  • Pagina 155

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-15 A Where: T able 5-4 lists the HBA statistics p arameter names, aliases, and values. Under Solaris, this feature is d isabled if you are using the driver from the OS installation CDs (QL C driver). Under Linux, this feature is disabled if you are using the ioctl or sysfs (inbox) driv[...]

  • Pagina 156

    5 – Non-interactive Commands Command Summary 5-16 SN0054614-00 F 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>[...]

  • Pagina 157

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-17 A 5.3.15 -i (Display HBA General Information or VP D Information for One or All HBAs) T o show general HBA information or VPD information for all HBA port s in the system, type the following comma nd: # scli -i [ <all> ] [ <VPD> ] Where: T o show general or VPD informati[...]

  • Pagina 158

    5 – Non-interactive Commands Command Summary 5-18 SN0054614-00 F S Sections 5.3.16.1 through 5.3.16.5 describ e how to change the default parameters for both of th ese test s. Section 5.3.16.6 cont ains command line examples and test result s for a loopback test. Section 5.3.18.1 cont ains command line examples and test result s for a read/write [...]

  • Pagina 159

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-19 A 5.3.16.2 Dat aSize (DS) For the loopback test, the dat a 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. ?[...]

  • Pagina 160

    5 – Non-interactive Commands Command Summary 5-20 SN0054614-00 F S  Loopback test (Linux systems). The data size can b e 8, 16, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8 192, 16384, 32768, or 65535. The default value is 512 bytes. 5.3.16.3 T estCount (TC) The number of loopback test s is either: TC < Parameter Value > TestCount < Par[...]

  • Pagina 161

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-21 A 5.3.16.6 Run a Loopback T est The loopback test sends and receives messages, through a loopback or th rough an echo command, to the switch. T able 5-7 lists the operating system driver ve rsions that do not require a loopback connector . . T o do a loopback test using the current [...]

  • Pagina 162

    5 – Non-interactive Commands Command Summary 5-22 SN0054614-00 F S # scli - -kl (< HBA Instance > | < HBA WWPN >) T o do a loopback test with custom parameters, type: # scli - -kl (< HBA Instance > | < HBA WWPN >) [(< Parameter Name > | < Parameter Alias >) < Parameter Value >] Section 5.3.16 describes th[...]

  • Pagina 163

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-23 A  Error – CRC, disparity , or frame length errors occurred.  Failed – An error occurred when attempt i ng to issue a command.  Loop down – The loop is down.  CRC – Number of CRC errors.  Disp arity – Number of disparity errors.  Frame Length – Number o[...]

  • Pagina 164

    5 – Non-interactive Commands Command Summary 5-24 SN0054614-00 F S Where: Sections 5.3.16.1 through 5.3.16.5 describ e how to change the default parameters for both of th ese test s. Section 5.3.16.6 cont ains command line examples and test result s for a loopback test. Section 5.3.18.1 cont ains command line examples and test result s for a read[...]

  • Pagina 165

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-25 A # scli -kr (< HBA Instance > | < HBA WWPN >) T o 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 >) < Param[...]

  • Pagina 166

    5 – Non-interactive Commands Command Summary 5-26 SN0054614-00 F S 5.3.18.2 Run HBA Diagnostics Read-write Buffer T est The {(-ex | exclude) < Target WWPN >} parameters specify a de vice that will be excluded from the read/write buf fer test. The system shows the following information af ter a read/write buffer test completes:  Loop ID/s[...]

  • Pagina 167

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-27 A If the read/write buf fer test fails, the system shows the following information :  Loop/port ID (the loop ID of the HBA when operating in loop mode).  Stat us :  Success – The test p assed.  Error – A data miscomp are or link status firmware error occurred.  Fa[...]

  • Pagina 168

    5 – Non-interactive Commands Command Summary 5-28 SN0054614-00 F S  Write bu ffer failed  Link Failure – Numbe r 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[...]

  • Pagina 169

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-29 A Where: T able 5-10 defines the link status p arameter names, aliases, and values. 5.3.21 -m (View , En able, or Disable LUNs) Use the -m command to:  View all selective L UNs for all HBA ports (1)  View an HBA ’s selective LUN list (2)  View the current selective state [...]

  • Pagina 170

    5 – Non-interactive Commands Command Summary 5-30 SN0054614-00 F S  Disable (deselect) a LUN on a specific t arget on a specific HBA (5)  Enable all LUNs on a specific t arget on a specific HBA (6)  Disable (deselect) all LUNs on a specific t arget on a specific HBA (7)  Enable (select) all LUNs of all ta rgets on a sp ecific HBA (8) [...]

  • Pagina 171

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-31 A # scli -m (< HBA Instance > | < HBA WWPN >) {< Target WWNN > < Target WWPN > < LUN ID > (0 | disable | deselect)} T o enable (select) all LUNs for a specific target on a specific HBA, type: # scli -m (< HBA Instance > | < HBA WWPN >) selec[...]

  • Pagina 172

    5 – Non-interactive Commands Command Summary 5-32 SN0054614-00 F S T able 5-1 1 lists the HBA parameter names and aliases. . T able 5-1 1. HBA Parameters Description Name Ali as V alue Connection options ConnectionOption CO See table note, below a a Connection Options: 0 – Loop only 1 – Point-to-point only 2 – Loop preferred, otherwise poin[...]

  • Pagina 173

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-33 A 5.3.23 -o (Output to a File) T o 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 t[...]

  • Pagina 174

    5 – Non-interactive Commands Command Summary 5-34 SN0054614-00 F S 5.3.24 -p (Display Persistent T a rget 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 target s on a specific HBA or on all HBAs (3)  Unbind a specific target (4) [...]

  • Pagina 175

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-35 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: T o bind a selected target to a specific HBA, type: # sc[...]

  • Pagina 176

    5 – Non-interactive Commands Command Summary 5-36 SN0054614-00 F S Where: 5.3.25 -p a (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 po rt (2)  View the po rt alias for a specific HBA port (3) T o define a port alias for the specified HBA, type:[...]

  • Pagina 177

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-37 A Where: T o view the link speed of a specific T arget attached to an HBA, type the following command: # scli -q (< HBA Instance > | < HBA WWPN > | < Target WWPN > Where: T ype the following command to set the link speed of all T argets attached to one HBA or all H[...]

  • Pagina 178

    5 – Non-interactive Commands Command Summary 5-38 SN0054614-00 F S 5.3.27 -r (Up date HBA Parameters) T o update the HBA Parameters, type: # scli -r (< HBA Instance > | < HBA WWPN > | all) < File Name > Where: T o save the HBA parameters to a file, typ e: # scli -r (< HBA Instance > | < HBA WWPN >) save < File Nam[...]

  • Pagina 179

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-39 A 5.3.29 -t (Display T arget Information) T o show the target information for all HBAs in the system, type: # scli -t [ <all> ] T o show the target information for a spe cific HBA, type: # scli -t (< HBA Instance > | < HBA WWPN >) T o show specific target informati[...]

  • Pagina 180

    5 – Non-interactive Commands Command Summary 5-40 SN0054614-00 F S 5.3.31 -tp (Display Host T opology) Use the -tp option to show the topology configurat ion of the host: # scli -tp | topology Under Linux, this feature is disabled if yo u are using the ioctl or sysfs (inbox) driver . Section 5.2.3 covers this command. 5.3.32 -v (Display V ersion)[...]

  • Pagina 181

    5 – Non-interactive Commands Command Summary SN0054614-00 F 5-41 A Where: T o list a specific virtual por t on a physical HBA port, type: # scli -vp (< HBA Instance > : < HBA WWPN >) list <vport wwpn> T o create a virtual port with an automatic WWPN, type: # scli -vp (< HBA Instance > : < HBA WWPN >) create auto T o [...]

  • Pagina 182

    5 – Non-interactive Commands Command Summary 5-42 SN0054614-00 F S 5.3.35 -x2 (Output in XML Format 2) Y ou can use this option with all no n-interactive mode options th at have a corresponding interactive mode option (see T able 5-1 ). This option must be the first or last command in the command line. When you use this option, the system shows a[...]

  • Pagina 183

    SN0054614-00 F A-1 Appendix A XML Format 1 A.1 Introduction The -x1 command line option (see se ction 5.3.34 ) displays all output in XML format 1. This section defines the XML fo rmat 1 ou tput, which consists of the following part s:  Main tag  Utility header  S tatus message  Error message  Reboot message A.1.1 Main T ag When SANs[...]

  • Pagina 184

    A – XML Format 1 XML Format 1 T ags for Each Option A-2 SN0054614-00 F S A.1.3 S t atus Message Before the closing main t ag </QLogic> , SANsurfer FC HBA CLI displays returning st atus from the execution of the command line p arameters and the error messages. Successful execution of the command li ne pa rameters returns the following status[...]

  • Pagina 185

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-3 A A.2.1 Display System Information (Command Line Option -g) The XML format 1 for system information outpu t is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>[...]

  • Pagina 186

    A – XML Format 1 XML Format 1 T ags for Each Option A-4 SN0054614-00 F S PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" /> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic>[...]

  • Pagina 187

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-5 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> &l[...]

  • Pagina 188

    A – XML Format 1 XML Format 1 T ags for Each Option A-6 SN0054614-00 F S <VPD> <VPDProductIdentifier="value" VPD-RTAG="" PartNumber="value" SerialNumber="value" MiscInformation="value" ManufacturingID="value" EFIDriverVersion="value" FirmwareVersion="value" B[...]

  • Pagina 189

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-7 A A.2.5 Display LUN List (Command Line Option -l) The XML Format 1 for the adap ter LUN list information is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn[...]

  • Pagina 190

    A – XML Format 1 XML Format 1 T ags for Each Option A-8 SN0054614-00 F S <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> The <TargetBinding … /> sequence is repeated for each t arget bound to the adapter . A.2.7 Selective LUNs (Command Line Option -m) The XML Format 1 for the selective LUNs information is[...]

  • Pagina 191

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-9 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 Result s – Loopback T est (Command Line Optio[...]

  • Pagina 192

    A – XML Format 1 XML Format 1 T ags for Each Option A-10 SN0054614-00 F S </QLogic> The <Target> sequence is repeated fo r each device att ached to the adapter . A.2.1 1 V iew Driver Settings (Command Line Option -fg) The XML Format 1 for the curre nt driver settings information is as follows: <?xml version="1.0" encoding[...]

  • Pagina 193

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-1 1 A 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[...]

  • Pagina 194

    A – XML Format 1 XML Format 1 T ags for Each Option A-12 SN0054614-00 F S <Param ConnectionOption="value" DataRate="value" FrameSize="value" HardLoopID="value" LoopResetDelay="value" EnableHostAdapterBIOS="value" EnableHardLoopId="value" FibreChannelTapeSupport="value&q[...]

  • Pagina 195

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-13 A BindbyPortID="value" /> </DriverSettings> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> A.2.13 Link St atistics (Command Line Option -ls ) The XML Format 1 for the lin k st atistics option is as follows: &l[...]

  • Pagina 196

    A – XML Format 1 XML Format 1 T ags for Each Option A-14 SN0054614-00 F 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[...]

  • Pagina 197

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-15 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 (Comm[...]

  • Pagina 198

    A – XML Format 1 XML Format 1 T ags for Each Option A-16 SN0054614-00 F S <MeasuredTxBiasUnit>(mA)</MeasuredTxBiasUnit> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning[...]

  • Pagina 199

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-17 A <FCTransmitterTech>"value"</FCTransmitterTech> <FCTransmissionMedia>"value"</FCTransmissionMedia> <FCSpeed>"value"</FCSpeed> </TransceiverData> <Encoding>"value"</Encoding> <BR-[...]

  • Pagina 200

    A – XML Format 1 XML Format 1 T ags for Each Option A-18 SN0054614-00 F S </EnhancedOptions> <SFF-8472-Compliance>"value"</SFF-8472-Compliance> <CC_EXT> 0x7d </CC_EXT> <VendorSpecific> "value" </VendorSpecific> </Address_A0> <Address_A2> <TempHighAlarm>"value&quo[...]

  • Pagina 201

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-19 A <Reserved_MSB> "value" </Reserved_MSB> <Reserved_LSB> "value" </Reserved_LSB> <Reserved_MSB> "value" </Reserved_MSB> <Reserved_LSB> "value" </Reserved_LSB> <StatusControlBits> <[...]

  • Pagina 202

    A – XML Format 1 XML Format 1 T ags for Each Option A-20 SN0054614-00 F S A.2.18 Host T opology (Command Line Option -tp) The XML Format 1 for an HBA type interconnect elemen t is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>v[...]

  • Pagina 203

    A – XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 F A-21 A DriverVersion="value" FirmwareVersion="value" TotalNumberOfDevices="value" Host="value"/> </AttachedPort> </PhysicalPort> ... ... <PhysicalPort Number="value"> <Port WWPN="value" State="[...]

  • Pagina 204

    A – XML Format 1 XML Format 1 T ags for Each Option A-22 SN0054614-00 F S </InterConnectElement> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic>[...]

  • Pagina 205

    SN0054614-00 F B-1 Appendix B XML Format 2 B.1 Introduction The -x2 command line option (see se ction 5.3.35 ) displays all output in XML Format 2. This section defines the XML2 output format, which consist s of the following part s:  Main tag  Utility header  S tatus message  XML2 message (one for each option) B.2 Main T ag When SANsur[...]

  • Pagina 206

    B – XML Format 2 S tatus Message B-2 SN0054614-00 F S B.4 S t atus Message Before the closing main t ag </QLogic> , SANsurfer FC HBA CLI displays any returning st atus from the execution of the command line p arameters and the error messages. When the execution of the comma nd line pa rameters is successful, the following status is displaye[...]

  • Pagina 207

    B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-3 A scli -c 0 -x2 The XML Format 2 for adapter settings informatio n is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC HBA CLI</AppName> <AppVersion>vn.n.nn Build nn</AppVersion <AppXmlVersion&g[...]

  • Pagina 208

    B – XML Format 2 XML2 T ags for Each Optio n B-4 SN0054614-00 F 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</AppNam[...]

  • Pagina 209

    B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-5 A <MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning>&qu[...]

  • Pagina 210

    B – XML Format 2 XML2 T ags for Each Optio n B-6 SN0054614-00 F 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"</[...]

  • Pagina 211

    B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-7 A <TempHighWarning>"value"</TempHighWarning> <TempLowWarning>"value" </TempLowWarning> <VoltageHighAlarm>"value"</VoltageHighAlarm> <VoltageLowAlarm>"value"</VoltageLowAlarm> <VoltageHighWarning[...]

  • Pagina 212

    B – XML Format 2 XML2 T ags for Each Optio n B-8 SN0054614-00 F S <TXFault> "value" </TXFault> <SoftRXRateSelect> "value" </SoftRXRateSelect> <RXRateSelectState> "value" </RXRateSelectState> <SoftTXDisable> "value"</SoftTXDisable> <TXDisableState> "[...]

  • Pagina 213

    B – XML Format 2 XML2 T ags for Each Option SN0054614-00 F B-9 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.[...]

  • Pagina 214

    B – XML Format 2 Display System Information (Command Line Option -g) B-10 SN0054614-00 F S B.7.4 V iew Driver Settings (Command Line Option -fg) The command format is: scli -fg (< HBA Instance > | < HBA WWPN >) (VIEW | ?) -x2 The XML Format 2 for the curre nt driver settings information is as follows: <?xml version="value"[...]

  • Pagina 215

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-1 1 A <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <NumOfHBA>n</NumOfHBA> </Host> <Status> n </Status> <?ErrorMsg> "message&qu[...]

  • Pagina 216

    B – XML Format 2 Display System Information (Command Line Option -g) B-12 SN0054614-00 F 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&l[...]

  • Pagina 217

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-13 A <VPD> <VPD ProductIdentifier="value" PartNumber="value" SerialNumber="value" MiscInformation="value" ManufacturingID="value" EFIDriverVersion="value" FirmwareVersion="value" BIOS[...]

  • Pagina 218

    B – XML Format 2 Display System Information (Command Line Option -g) B-14 SN0054614-00 F 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 buf fer test results is as follows: <[...]

  • Pagina 219

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-15 A Vendor="value" Product="value" Revision="value" Size="value" Type="value" /> </Target> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target> s[...]

  • Pagina 220

    B – XML Format 2 Display System Information (Command Line Option -g) B-16 SN0054614-00 F S scli -p (< HBA Instance > | < HBA WWPN > | all) (view | ?) -x2 The XML Format 2 for the adap ter target persistent binding information is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName&g[...]

  • Pagina 221

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-17 A DeviceID= "value" PortID= "value" LunCount= "value" Type= "value" DeviceStatus= "value" /> </Target> </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The &l[...]

  • Pagina 222

    B – XML Format 2 Display System Information (Command Line Option -g) B-18 SN0054614-00 F 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> <[...]

  • Pagina 223

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-19 A OperationMode="value" IntDelayTimer="value" ExecutionThrottle="value" LoginRetryCount="value" EnableLipReset="value" PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout=[...]

  • Pagina 224

    B – XML Format 2 Display System Information (Command Line Option -g) B-20 SN0054614-00 F S B.8.9 Link St atistics (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 lin k st atistics[...]

  • Pagina 225

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-21 A The <LinkStatus…/> p arameter repeat s for each link. B.8.10 HBA S t atistics (Command Line Option -gs) The command format is: scli -gs (< HBA Instance > | < HBA WWPN >) [(< Parameter Name > | < Parameter Alias >) < Parame[...]

  • Pagina 226

    B – XML Format 2 Display System Information (Command Line Option -g) B-22 SN0054614-00 F S <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <HBAAlias> <AliasName="value" /> </HBAAlias> </HBA> <Status> n </Status>[...]

  • Pagina 227

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-23 A <Speed>"value"</Speed> <Revision>"value"</Revision> <SerialNumber>"value" </SerialNumber> </MediaInformation> <Diagnostics> <Temperature> <MeasuredTemperature>(C)</[...]

  • Pagina 228

    B – XML Format 2 Display System Information (Command Line Option -g) B-24 SN0054614-00 F S </RxPower> </Diagnostics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> B.8.13 Host T opology (Command Line Option -tp) The command format is: scli -tp -x2 The XML Format 2 for an HBA type inte rc[...]

  • Pagina 229

    B – XML Format 2 Display System Information (Command Line Option -g) SN0054614-00 F B-25 A PortAlias="value" DriverVersion="value" FirmwareVersion="value" Host="value"/> </AttachPort> </PhysicalPort> ... </PhysicalPortInformation> </InterconnectElements> <InterconnectElementTyp[...]

  • Pagina 230

    B – XML Format 2 Display System Information (Command Line Option -g) B-26 SN0054614-00 F S Notes[...]

  • Pagina 231

    SN0054614-00 F C-1 Appendix C Interactive Exit Codes T o list the exit codes while running SANsurfer FC HBA CLI in interactive mode: 1. From the Main Menu , select t he Help option and then press ENTER. 2. On the Help Menu , select Exit Codes and then press ENTER. The CLI lists th e exit code numbers, names, and de scriptions as shown in T able C -[...]

  • Pagina 232

    C – Interactive Exit Codes C-2 SN0054614-00 F S 12 ERROR_MISMA TCH_CHECKS UM File checksum does not match 13 ERROR_CORRUPTED_FILE File appears to be corrupted 14 ERROR_FILE_CHKSUM_ERROR File checksum returns error 15 ERROR_FILE_INV ALID_DA T A File has invalid data 16 ERROR_FLASH_UPDA TE_IGNORE HBA does not need to be updated 17 Reserved Not used[...]

  • Pagina 233

    C – Interactive Exit Codes SN0054614-00 F C-3 A 37 ERROR_FLASH_UPD A TE_NO_REGION_ LA YOUT HBA does not have flash update region lay- out 38 Reserved Not used 39 Reserved Not used 40 ERROR_DIAGNOSTICS_P ARAM_ ERROR Diagnos tics test re turns invalid parameters 41 ERROR_DIAGNOSTICS_LOOP_DOWN Unable to run diagnostics because the loop is down 42 ER[...]

  • Pagina 234

    C – Interactive Exit Codes C-4 SN0054614-00 F S 58 Reserved Not used 59 Reserved Not used 60 ERROR_INV ALID_P ARAM_SETTINGS Inv alid H BA parameter value/key 61 ERROR_P ARAM_UNSUPP ORTED_HBA S pecified HB A parameters is not supported 62 ERROR_P ARAM_UNSUPP ORTED_DRIVER Unable to update HBA parameters - Driver unsupported 63 ERROR_RESTORE_NVRAM_D[...]

  • Pagina 235

    C – Interactive Exit Codes SN0054614-00 F C-5 A 83 ERROR_PRESERVE_NVRAM_DA T A Failed to preserve HBA parameters 84 ERROR_MISSING_NVRAM_TEMPLA TE_ FILE Unable to find the NVRAM template for the HBA 85 ERROR_INV ALID_NVRAM_PROG _OPTION S pe cified key/va lue to program NVRAM are invalid 86 Reserved Not used 87 Reserved Not used 88 Reserved Not use[...]

  • Pagina 236

    C – Interactive Exit Codes C-6 SN0054614-00 F S 104 Reserved Not used 105 Reserved Not used 106 Reserved Not used 107 Reserved Not used 108 Reserved Not used 109 Reserved Not used 1 10 ERROR_DUPLICA TE_T ARGET_ID T arget has duplicate ID 1 1 1 ERROR_INV ALID_T ARGET_I D T arget has invalid ID 1 12 ERROR_MISM A TCH_T ARGET_ID T arget has mismatch [...]

  • Pagina 237

    C – Interactive Exit Codes SN0054614-00 F C-7 A 126 ERROR_F AILOVER_DRIVER_LOADED Feature is not support with failover driver 127 Reserved Not used 128 Reserved Not used 129 Reserved Not used 130 ERROR_INV ALID_HBA_WWID HBA WWPN/WWNN specified is invalid 131 ERROR_INV ALID_HBA _PID HBA in stance specified is invalid 132 ERROR_INV ALID_T ARGET_WWI[...]

  • Pagina 238

    C – Interactive Exit Codes C-8 SN0054614-00 F S 150 ERROR_CLOSE_ZIP_FILE Failed to close zip file 151 ERROR_READ_ZIP_FILE Fa iled to read zip file 152 ERROR_EXTRACT_ZIP_FILE Fa iled to extract zip file 153 ERROR_CORRUPTED_ZIP_FILE The zip file appears to be corrupted 154 ERROR_CREA TE_ZIP_FILE Fa iled to create zip file 155 ERROR_MISSING_DRV_FILE[...]

  • Pagina 239

    C – Interactive Exit Codes SN0054614-00 F C-9 A 177 IBM Reserved Blocked 178 IBM Reserved Blocked 179 IBM Reserved Blocked 180 IBM Reserved Blocked 181 IBM Reserved Blocked 182 IBM Reserved Blocked 183 IBM Reserved Blocked 184 IBM Reserved Blocked 185 IBM Reserved Blocked 186 IBM Reserved Blocked 187 IBM Reserved Blocked 188 IBM Reserved Blocked [...]

  • Pagina 240

    C – Interactive Exit Codes C-10 SN0054614-00 F S 204 Reserved Not used 205 Reserved Not used 206 Reserved Not used 207 Reserved Not used 208 Reserved Not used 209 Reserved Not used 210 ERROR_MISSING_IP_ADDRESS IP address is required 21 1 ERROR_MISSING_NETMASK_ADDRESS Netmask address is required 212 ERROR_MISSING_GA TEWA Y_ADDRESS Gateway addres s[...]

  • Pagina 241

    C – Interactive Exit Codes SN0054614-00 F C-1 1 A 231 ERROR_SA VE_T ARGET_IIDMA_SETTING S Failed to set target link speed 232 ERROR_SET_T ARGET_IIDMA_ UNSUPPORTED T arget link speed option is not supported with current HBA 233 ERROR_INV ALID_IIDMA_SETT INGS Selected t arget link spe ed rate not sup ported with current HBA 234 Reserved Not used 23[...]

  • Pagina 242

    C – Interactive Exit Codes C-12 SN0054614-00 F S 256 Reserved Not used 257 Reserved Not used 258 Reserved Not used 259 Reserved Not used 260 ERROR_DRIVER_RESCAN Driver resc an op eration faile d (Solaris) 261 Reserved Not used 262 Reserved Not used 263 Reserved Not used 264 Reserved Not used 265 Reserved Not used 266 Reserved Not used 267 Reserve[...]

  • Pagina 243

    SN0054614-00 F D-1 Appendix D Non-interactive Error Codes T o list the SANsurfer FC HBA CLI non-interactive error codes from the comma nd line, type: scli -ei (T o see the interactive exit codes, see Appendix C .) T able D-1. Error Code Descriptions – Non-interactive Mode Code Name Description 0 SUCCESS Command exec ut ed with no error 1 ERROR_OP[...]

  • Pagina 244

    D – Non-interactive Erro r Codes D-2 SN0054614-00 F S 18 Re served Not used 19 ERROR_FLASH_UPDA TE_UNSUPPORTED Flash update is not supported with this HBA 20 ERROR_FLASH_OPTION_DISABLED_HBA Flash update is disabl ed with this HBA 21 ERROR_FLASH_OPTION_DISABLED_OS Flash update is disabl ed with this OS 22 ERROR_FLASH_HEADER_SIGNA TURE Flash file h[...]

  • Pagina 245

    D – Non-interactive Error Codes SN0054614-00 F D-3 A 41 ERROR_DIAGNOSTICS_LOOP_DOWN Unable to run diagnostics because the loop is down 42 ERROR_DIAGNOSTICS_F AILURE Di agnostics test failed with errors 43 ERROR_DIAGNOSTICS_DA T A _MISCOMP ARE Diagnostics test failed with data mis- comp are 44 ERROR_DIAGNOSTICS_UN KNOWN_ST A TUS Unknown diagnostic[...]

  • Pagina 246

    D – Non-interactive Erro r Codes D-4 SN0054614-00 F S 63 ERROR_RESTORE_NVRAM_DEF AU L T Faile d to restore HBA p arameters to default settings 64 Re se rv ed Not used 65 Re se rv ed Not used 66 Re se rv ed Not used 67 Re se rv ed Not used 68 Re se rv ed Not used 69 Re se rv ed Not used 70 ERROR_SA VE_HBA_FLASH_TO_FILE Faile d to save HBA flash im[...]

  • Pagina 247

    D – Non-interactive Error Codes SN0054614-00 F D-5 A 87 Re se rv ed Not used 88 Re se rv ed Not used 89 Re se rv ed Not used 90 ERROR_READING_BOOT_D EVICE Failed to read boot device settings of the HBA 91 ERROR_SA VING_BOOT_DEVI CE Failed to sa ve boot device sett ings to the HBA 92 ERROR_BOOT_CONFIG_DISABLED _DRIVER Boot device se ttings is disa[...]

  • Pagina 248

    D – Non-interactive Erro r Codes D-6 SN0054614-00 F S 109 Reserved Not u sed 1 10 ERROR_DUPLICA TE_T ARGET_ ID T arget has duplicate ID 1 1 1 ERROR_INV ALID_T ARGET_ID T arget has invalid ID 1 12 ERROR_MISMA TCH_T ARGET_ID T arget has mismatch ID 1 13 ERROR_READ_FR OM_DRIVER Failed to read persistent binding dat a from driver database 1 14 ERROR_[...]

  • Pagina 249

    D – Non-interactive Error Codes SN0054614-00 F D-7 A 130 ERROR_INUALID_HBA_WWID HBA WWPN/WWNN specified is invalid 131 ERROR_INV ALID_HBA_PID HBA instance specified is invalid 132 ERROR_INUALID_T ARGET_WWID T arget WWPN/WWNN specified is invalid 133 ERROR_INUALID_LUN_ID LUN ID specified is invalid 134 ERROR_MISSING_INPUT Inco mplete command line [...]

  • Pagina 250

    D – Non-interactive Erro r Codes D-8 SN0054614-00 F S 152 ERROR_EXTRACT_ZIP_FILE F ailed to extract zip file 153 ERROR_CORRUP TED_ZIP_FILE The zip file appears to be corrupted 154 ERROR_CREA TE_ZIP_FILE Failed to create zip file 155 ERROR_MISSING _DRV_FILE Driver sys file is missing in the driv er package 156 ERROR_EMPTY_FOLDER Driver folder is e[...]

  • Pagina 251

    D – Non-interactive Error Codes SN0054614-00 F D-9 A 178 IBM Reserved Blocked 179 IBM Reserved Blocked 180 IBM Reserved Blocked 181 IBM Reserved Blocked 182 IBM Reserved Blocked 183 IBM Reserved Blocked 184 IBM Reserved Blocked 185 IBM Reserved Blocked 186 IBM Reserved Blocked 187 IBM Reserved Blocked 188 IBM Reserved Blocked 189 IBM Reserved Blo[...]

  • Pagina 252

    D – Non-interactive Erro r Codes D-10 SN0054614-00 F S 205 Reserved Not u sed 206 Reserved Not u sed 207 Reserved Not u sed 208 Reserved Not u sed 209 Reserved Not u sed 210 ERROR_MISSING_I P_ADDRESS IP ad dress is required 21 1 ERROR_MISSING_NETMASK_ADDRESS Netmask address is required 212 ERROR_MISSING_GA TEW A Y_ADDRESS Gateway address is requi[...]

  • Pagina 253

    D – Non-interactive Error Codes SN0054614-00 F D-1 1 A 232 ERROR_SET_T ARGET_IIDMA_U NSUPPORTED T arget link spe ed operation i s unsup- ported with current HBA 233 ERROR_INV ALID_IIDMA_SETTINGS Sel ected targ et link speed rate not supported with curre nt HBA 234 Reserved Not u sed 235 Reserved Not u sed 236 Reserved Not u sed 237 Reserved Not u[...]

  • Pagina 254

    D – Non-interactive Erro r Codes D-12 SN0054614-00 F S 257 Reserved Not u sed 258 Reserved Not u sed 259 Reserved Not u sed 260 ERROR_DRIVER_RESCAN Driver rescan operation failed (Solaris) 261 Reserved Not u sed 262 Reserved Not u sed 263 Reserved Not u sed 264 Reserved Not u sed 265 Reserved Not u sed 266 Reserved Not u sed 267 Reserved Not u se[...]

  • Pagina 255

    SN0054614-00 F E-1 Appendix E Help Commands T able E -1 is an alphabetic listing of the Help commands. Unless o therwise noted, only one command line option per input file is valid. The hyphen ( - ) and slash ( / ) characters are equivalent. That is, scl i -g and scli /g are both valid commands. T able E -1 uses the following variables: <hba ins[...]

  • Pagina 256

    E – Help Commands E-2 SN0054614-00 F S –b ( <all> | <hba instance> | <hba wwpn> ) [ ( <–rg> <fw | boot| all> ) ] <file name> Updates the HBA boot code from a fil e, where:  <–rg> S pecifie s Option ROM region update m ode.  <all> Updates the flash from a fu ll image file (1MB image file)[...]

  • Pagina 257

    E – Help Commands SN0054614-00 F E-3 A –e ( <hba instance> | <hba wwpn> ) ( view | ? ) Shows the current boot device informa tio n on an HBA port. –e ( <hba instance> | <hba wwpn> ) ( view | ? ) Shows the current boot device informa tio n on an HBA port. –e ( <hba instance> | <hba wwpn> ) disable [ prim |[...]

  • Pagina 258

    E – Help Commands E-4 SN0054614-00 F S –fs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Configures the driver settings. –gs ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current statistics on an HBA [...]

  • Pagina 259

    E – Help Commands SN0054614-00 F E-5 A –ls ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current link status on an HBA port. –m ( <hba instance> | <hba wwpn> ) ( view | ? ) Views selective LUN information of all devices attached to an HBA port. –m ( <[...]

  • Pagina 260

    E – Help Commands E-6 SN0054614-00 F S –p ( <hba instance> | <hba wwpn> ) { <target wwnn> <target wwpn> <target portid> <target id> } Binds the selected device(s) att ached to an HBA port. –p ( <hba instance> | <hba wwpn> ) remove <target wwnn> | unbind <target wwnn> Unbinds a specif[...]

  • Pagina 261

    E – Help Commands SN0054614-00 F E-7 A –s – Suppresses the output . This option c an be combined w ith other op tions. However , this option must be at the beginning or at the end of the command line. –t ( <hba instance> | <hba wwpn> ) Displays the in formation ab out devices (d isks or tape s) attached to an HBA port. –t ( &l[...]

  • Pagina 262

    E – Help Commands E-8 SN0054614-00 F S –x — Writes the ou tput in XML format 1. Option –x can be used to generate an old-style format that is compatible with previo us releases (XML format 1). This option can be combin ed with other options; however , this option must be at the beginning or at the end of th e command line. –x2 — Writes [...]

  • Pagina 263

    SN0054614-00 F Glossary-1 Glossary adapter See HBA. AL_P A Arbitrated Loop_Physical Address. A 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 port s can communicate at a time. All communi- cation passes th rough all ports co nnected to [...]

  • Pagina 264

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Glossary-2 SN0054614-00 F S driver The software t hat interfaces between the file system and a physical dat a storage device or network media. The level structure for Windows XP Professional/2000/Windows Server 2003 drivers is as follows:  Cla[...]

  • Pagina 265

    SN0054614-00 F Glossary-3 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A F_Port The “Fabric” port in a FC fabric switch provides a point-to-point link att achment to a single N_Port. F_Port s are intermediate ports in virtual point-to-p oint links between end ports, for example N_Port [...]

  • Pagina 266

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Glossary-4 SN0054614-00 F S IOCB I/O control block. An IOCB is a command structure in QLogic ISP architect ure. ioctl (input/output control) A system call in Uni x/Linux systems. Allows an application to control or commu- nicate with a device dri[...]

  • Pagina 267

    SN0054614-00 F Glossary-5 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A N_Port ID Virtualization The ability for a single physica l FC end point (N_Port) to support multiple, uniquely addressable, logical end point s. With NPIV , a host FC adapter is shared in such a way that each virtual[...]

  • Pagina 268

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Glossary-6 SN0054614-00 F S  N_Port (Node Port) —an FC port that supports poin t-to-point topology .  NL_Port (Node Loop Port) —an FC port that supports loo p topology .  F_Port (Fabric Port) —a port in a fabric where an N_Port can[...]

  • Pagina 269

    SN0054614-00 F Index-1 Index A -a 4-61, 5-6 abort changes to HBA p arameters 4-29 about the product 4-88 adapter , definition of Glossary-1 Adjunct driver level, definition of Glossary-2 AL_P A, definition of Glossary-1 alias HBA 5-6, A-14 HBA information 4-18 HBA port 4-19 arbitrated loop, definition of Glossary-1 Arbitrated Loop_Physical Address,[...]

  • Pagina 270

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-2 SN0054614-00 F S commands interactive mode 4-1 non-interactive mode 2-3, 5-1, 5-5 -a 4-61, 5-6 -b 4-8, 4-56, 5-7 -c 4-18, 4-22, 5-8, A-3, B-2 -d 4-60, 5-8 -dm 4-62, 4-72, 5-9, A-15, B-3 -e 4-51, 5-9, A-8, B-8 -ei 5-12, D-1 -f 5-12 -fg 4-5[...]

  • Pagina 271

    SN0054614-00 F Index-3 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A DataSize p arameter 5-26 default restoring 4-78 restoring for link 4-81 defining port alias 5-36 definitions of terms Glossary-1 delay timer , interrupt 4-23, 4-27 delay , loop reset 4-23 deleting virtual port 4-86 devic[...]

  • Pagina 272

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-4 SN0054614-00 F S enabling LUNs 5-29 error codes interactive mode C-1 listing 5-12 non-interactive mode D-1 error message XML Format 1 A-2 XML Format 2 B-2 execution throttle 4-23, 4-27 ExecutionT rottle parameter 5-32 exit codes, interact[...]

  • Pagina 273

    SN0054614-00 F Index-5 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A HBA (continued) hard loop ID 4-23 host informati o n, viewin g 4-2 iiDMA settings 4-45 information 4-17, 4-18, 5-2 viewing 5-17, A-4, A-10, B-11, B-17 viewing all 5-42 viewing by port number 4-18 instance 5-6 locating (b[...]

  • Pagina 274

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-6 SN0054614-00 F S installation (continued) Solaris 3-8 Solaris SP ARC 8, 9, 10 3-8 Solaris x86 9, 10 3-9 Windows 3-2 instance number 5-6 port, definition of Glossary-6 interactive mode 4-1 See also non-interactive mode definition of 2-1 ex[...]

  • Pagina 275

    SN0054614-00 F Index-7 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A loop preferred connection 4-25 reset delay 4-23, 4-26 loop (abitrated), definition of Glossary-1 loop ID, definition of Glossary-4 Loop Initialization Process (LI P), definition of Glossary-4 Loop Port (L_Port), definiti[...]

  • Pagina 276

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-8 SN0054614-00 F S non-interactive mode (continued ) error codes D-1 starting 2-3 Non-volatile Random Access Memory (NVRAM), definition of Glossary-5 NPIV (N_Port ID Virtualizat ion) Virtual Menu option 4-83 NPIV , definition of Glossary-4 [...]

  • Pagina 277

    SN0054614-00 F Index-9 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A port driver , definition of Glossary-2 PortDownRetryCount paramete r 5-32 Q -q 4-38, 5-36 QLA/QLE/QEM HBAs supported by 1-4 QLA/QLE24xx 5-5 QLA23xx 4-23, 5-21 QLA24xx 5-21 QLA24xx HBA, VPD 4-20 QLE23xx 4-23, 5-21 QLE24xx[...]

  • Pagina 278

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-10 SN0054614-00 F S show HBA information 5-5 HBA settings 5-4 link status 4-82 LUN list 5-5 parameter settings 5-8 system information 5-4 target list 5-5 silent mode 5-5, 5-38 size, frame 4-25 Small Computer System Interface (SCSI ), defini[...]

  • Pagina 279

    SN0054614-00 F Index-1 1 SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fib re Channel Host Bus Adapte rs A test count parameter 5-20 diagnostics loopback 4-63 increment paramete r 5-20 loopback 4-64 loopback, preparing for 4-65 number of tests p arameter 5-20, 5-26 pattern 5-26 read/write buf fer 4-66, 5-23 results, loop ba[...]

  • Pagina 280

    SANsurfer FC HBA CLI User ’s Guide Command Line Interface for QLogic Fibre Channel Host Bus Adap ters Index-12 SN0054614-00 F S W Windows driver level structure Glossary-2 installing on 3-2 operating systems supp orted by SANsurfer FC HBA CLI 1-4 uninstalling from 3-13 Windows V irtual Server environment 4-84 WWPN, bind by WWPN parameter 5-14 X -[...]