Q-Logic FC manual

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
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Q-Logic FC, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Q-Logic FC one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Q-Logic FC. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Q-Logic FC should contain:
- informations concerning technical data of Q-Logic FC
- name of the manufacturer and a year of construction of the Q-Logic FC item
- rules of operation, control and maintenance of the Q-Logic FC item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Q-Logic FC alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Q-Logic FC, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Q-Logic service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Q-Logic FC.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Q-Logic FC item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’ s Guide Command Line Interface for QLogic FC and FCoE Adapters[...]

  • Page 2

    ii SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Information fu rnished in this manual is believed to be accurate and reliab le. However , QLogic Corporation assumes no responsibility for its use, nor for any infr ingements of patents or other rights of third p arties that may resul[...]

  • Page 3

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters SN0054614-00 K iii Added new FCoE menu option to Interactive Com- mands chapter . 3 Interactive Comman ds Added Flash Imag e V e rsion to list of actual VPD information. “Generate Report (Per Ad apter Port)” o n pag e 3- 1 1 Added new ENode MAC Ad d[...]

  • Page 4

    iv SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Notes[...]

  • Page 5

    SN0054614-00 K v T able of Content s Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Documentation Con ventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 6

    vi SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Uninstalling SANsu rfer FC/CNA HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 Windows Uninst all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 S tandard (GUI) Unin stall . . . .[...]

  • Page 7

    SN0054614-00 K vii SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters HBA Parameters Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24 HBA Parameters (Per Adapter Po rt) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25 Display HBA Parameters (Command Lin e[...]

  • Page 8

    viii SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters T arget Persistent Binding (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57 Display T arget Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . 3-57 T arget Persistent Binding: Bind T arget s . . . [...]

  • Page 9

    SN0054614-00 K ix SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters Diagnostics Menu (Command Line Options -kl, -kr , and -dm) . . . . . . . . . . . 3-76 Diagnostics Loopback T est (Command Line Option -kl) . . . . . . . . . . . 3-77 Display T est Parameters (Loopback) . . . . . . . . . . . . . . . . .[...]

  • Page 10

    x SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters FCoE Utilities Menu for QLx81 xx Adapters (Command Line Option -cna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 - 111 Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 11

    SN0054614-00 K xi SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters T estIncrement (TI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23 OnError (OE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24 LoopbackT ype (L T) . . . . . . . . . . . . [...]

  • Page 12

    xii SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Display HBA Information (Command Line Option -i) . . . . . . . . . . . . . . A-5 Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . A-7 Display LUN List (Command Line Option -l) . . . . . . . . . . . . .[...]

  • Page 13

    SN0054614-00 K xiii SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters Boot Device (Command Line Opt ion -e) . . . . . . . . . . . . . . . . . . . . . . . B-10 Diagnostics Result s— Loopback T est (Command Line Option -kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 14

    xiv SN0054614-00 K SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters List of T ables 1-1 Windows Command Line Inst allation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 2-1 Non-interactive Mode Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 15

    SN0054614-00 K xv Preface The SANsurfer ® FC/CNA HBA CLI tool provides a command line inte rface (CLI) that lets you easily install, configure, an d deploy QLogic ® Fibre Channel (FC) adapters, as well as QLogic Fibre C hannel over Ethernet (FCoE) converged network adapters (CNAs). It also provi des robust diagnostic and troubleshooting capabilit[...]

  • Page 16

    Preface What’s in This Guide xvi SN0054614-00 K The remainder of this guide is org anized into the following chapters and appendices:  1 Installatio n and Removal lists the supporte d QLogic adapters and operating systems, list s the system hardware and sof tware requirements, and provides step-by-step inst ructi ons for installing and uninst [...]

  • Page 17

    Preface License Agreeme nts SN0054614-00 K xvii  Te x t i n ALL CAPIT ALS 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: Attached Port means a QLogic adapter .[...]

  • Page 18

    Preface T echnical Suppor t xviii SN0054614-00 K T echnical Support Customers should cont act their authorized maintenance provider for technical support of their QLogic switch product s. QLogic-direct customers may contact QLogic T echnical Support; others will be redirected to their authorized maintenance provider . Visit the QLogic support W eb [...]

  • Page 19

    SN0054614-00 K 1- 1 1 Inst allation and Removal This chapter lists the supported QLogic adapter s and system requirements, provides procedures for d ownloading and inst alling SANsurfer FC/CNA HBA CLI, and instructions for removing the product. Refer to the following sections:  “Supported QLogic Adapters” on p age 1-2  “Supported Operat[...]

  • Page 20

    1–Installation and Removal Supported QLogic Adapters 1-2 SN0054614-00 K Supported QLogic Adapters SANsurfer FC/CNA HBA CLI is supporte d for the following QLog ic adapters:  QLA2 xx  QLA234 x  QLE2 xx  QLA246 x  QLE246 x  QLE256 x  QLE8042  QLE81 xx  QMI81 xx Not all SANsurfer FC/CNA HBA CLI feat ures are available on e[...]

  • Page 21

    1–Installation and Removal Supported Operating Systems SN0054614-00 K 1-3 Supported Operating Systems SANsurfer FC/CNA HBA CLI is supported on the following operating systems:  Microsof t ® Windows ® :  Windows 2000, 32-bit, Intel x86 Intel 64, AMD64  Windows Server 2003, 32-bit I ntel x86, Intel 64, AMD64  Windows Server 2008, 32-b[...]

  • Page 22

    1–Installation and Removal System Requirement s 1-4 SN0054614-00 K System Requirement s The system requirement s for SANsurfer FC/CNA HBA CLI are described in the following sections:  “Hardware Requirement s” on page 1-4  “Software Requirement s” on page 1-5 Hardware Requirement s The minimum hardware requirement s are as follows: ?[...]

  • Page 23

    1–Installation and Removal System Requirements SN0054614-00 K 1-5  256 MB physical RAM are required to run SANsurfer FC/CNA HBA CLI; running with less memory can caus e disk swapping (“paging” or “p aging out”), which severely af fects performance.  Video car d capable of 256 colors and a screen resolution of 800x 600 pixels.  Ab[...]

  • Page 24

    1–Installation and Removal Downloading the Installa tion Package 1-6 SN0054614-00 K Features Not A vailable When Running Linux with Converged Network Adapte rs When running Linux OS with con verged network adapters (QLE81 xx and QMI81 xx ), the following features are not available:  Support for inbox driver only; no driver update suppo rt  [...]

  • Page 25

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-7 Figure 1-1 shows an example. Figure 1-1 Selecting Adapter Model (Example) The resources p age for the selected mode l appears. 3. Under Mana gement T ools , click SANsurfer CLI... . The End User Sof tware License Agreement p age appears. 4. Scroll t o the bottom and[...]

  • Page 26

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-8 SN0054614-00 K Windows Inst allation T o install SANsurfer FC/CNA HBA CLI on Windows, fo llow either the GUI or command line installation step s:  “S tandard (GUI) Insta llation” on page 1-8  “Command Line Inst allation” on pa ge 1-12 St andard (GUI) Installation Fol[...]

  • Page 27

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-9 After the inst all package is loaded, the W elcome dialog box appears as shown in Figure 1-3 . Figure 1-3 Welcome Dialog Box 2. Read the informa tion, and then click Next .[...]

  • Page 28

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-10 SN0054614-00 K The Choose Destination Location dialog box a ppears as shown in Figure 1-4 . Figure 1-4 Choose Destinat ion Location Dialog Box 3. In the Choose Destinat ion Location dialog box, do one of the following :  T o select the destination location in the dialog box, c[...]

  • Page 29

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-1 1 The Ready to Install th e Program dialog box appears as shown in Figure 1-5 . Figure 1-5 Ready to Inst all the Program Dialog Box 4. Read the informa tion, and then click Inst all . The Setup S tatus dialog box appears as shown in Figure 1-6 . Figure 1-6 Setup S t[...]

  • Page 30

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-12 SN0054614-00 K If you want to stop the installation, click Cancel . The InstallShie ld Wizard Complete dialog box appea rs as shown in Figure 1-7 . Figure 1-7 InstallShield Wi zard Compl ete DIalog Box 5. (Optional.) Se lect one of the following:  If you want to see more infor[...]

  • Page 31

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-13 St andard Command Line Inst allation T ype the following text for a standard inst allation of SANsurfer FC/CNA HBA CLI on a Windows operating system, where xx indicates the version of SANsurfer FC/CNA HBA CLI: scli-1. x . x . xx .windows.exe By default, SANsurfer F[...]

  • Page 32

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-14 SN0054614-00 K T o create a response file for a silent insta llation of SANsurfer FC/CNA HBA CL I, enter the following: scli-1. x . x - xx .windows.exe /r /f1"C:Tempinstall_1.iss" T o run the installation in silent mo de with a log file, enter the following: scli-1. x[...]

  • Page 33

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-15 2. Decompress the file with the following command: gunzip < file name > 3. Enter the followin g command to install the package: rpm -iv scli -x.xx.xx-xx .i386.rpm The new package is installed in the following directory: /opt/QLogic_Corporation/SANsurferCLI T [...]

  • Page 34

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-16 SN0054614-00 K 2. T o see the available package file, type the following: # ls The available p ackages appear . For example: # scli-x.xx.xx-xx.sparc.Solaris.pkg 3. T o install SANsurfer FC/CNA HBA CLI, type the following: # pkgadd -d scli- x.xx.xx-xx .sparc.Solaris.pkg 4. Y ou ar[...]

  • Page 35

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-17 /opt/QLogic_Corporation/SANsurferCLI/libs/libqlsdm.so /opt/QLogic_Corporation/SANsurferCLI/menu.properties /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2 2.dat /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2 3.dat . . . Installation of [...]

  • Page 36

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-18 SN0054614-00 K Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]: q Enter 1 to proceed the installation. 6. T ype the number that corresponds to your operating system, and then press ENTER . The pkgadd program does a se ri[...]

  • Page 37

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-19 3. When the download has finished, S tuffIt ® expands the zip file to a tar file onto the desktop. 4. Double-click the SCL I tar file icon to create the SCLI pkg file. 5. Double-click the SCL I pkg file icon. 6. Follow the Installer menu. The installat ion directo[...]

  • Page 38

    1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI 1-20 SN0054614-00 K If this is the first time you are inst alling SANsurfer FC/CNA HBA CLI, the system shows the following messages: qlogic:~ root# installer -pkg scli- x.x.x-x .pkg -target / installer: Package name is SANsurfer FC/CNA HBA CLI x.x.x Build x installer: Installing onto [...]

  • Page 39

    1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-21 Uninst alling SANsurfer FC/CNA HBA CLI Refer to the following sections for the approp riate procedure to uninst all SANsurfer FC/CNA HBA CLI from your system:  “Windows Uninstall” on page 1-21  “Linux Uninstall” on p age 1-22  “Solaris Uninstal[...]

  • Page 40

    1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI 1-22 SN0054614-00 K Linux Uninst all T o uninstall SANsurfer FC/CNA HBA CLI on a Linux system, go to the comman d line and type one of the following co mmands, where x.xx.xx is the current version of CLI: rpm -e scli- x.xx.xx-xx rpm -e scli T o query for the installed SANsurfer FC/C[...]

  • Page 41

    1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI SN0054614-00 K 1-23 ## Verifying package dependencies. ## Processing package information. ... /opt/QLogic_Corporation/SANsurferCLI/adapters.properties /opt/QLogic_Corporation/SANsurferCLI ## Executing postremove script. scli removed. Menu property file removed. Adapter property file[...]

  • Page 42

    1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI 1-24 SN0054614-00 K SCLI property file removed. ## Updating system information. Removal of <QLSclix> was successful. Macintosh Uninst all Uninstalling SANsu rfer FC/CNA HBA CLI is not necessary for Mac OS X; the native installer automatically upda tes the product whenever it d[...]

  • Page 43

    SN0054614-00 K 2- 1 2 Getting S t arted This chapter provides the following sect ions to help yo u get st arted using SANsurfer FC/CNA HBA CLI:  “S tarting Interactive Mo de” on pa ge 2-1  “S tarting No n-Interactive Mode” on p age 2-4  “T erminology” on page 2-9  “Advanced Features” on p age 2-10 SANsurfer FC/CNA HBA CL[...]

  • Page 44

    2–Getting S tarted S tarting Interactive Mode 2-2 SN0054614-00 K  For Mac OS X, follow these step s: 1. Double-click the SANsurfer FC/CNA HBA CLI (SCLI) icon. 2. A terminal window opens. SCLI (in t eractive mode) scans the host fo r QLogic adapters and SAN storage. 3. Run SCLI commands as required. 4. When fin ished, return to the main menu, a[...]

  • Page 45

    2–Getting S tarted S tarting Interactive Mode SN0054614-00 K 2-3 Depending on which menu you select, may prompt you for more input. For example, if you select HBA Parameters , SANsurfer FC/CNA HBA CLI prompt s you for the port number that corre sponds to the adapter model you want to view . NOTE: Selections on the Main Menu are dynamic, and what [...]

  • Page 46

    2–Getting S tarted S tarting Non-Interactive Mode 2-4 SN0054614-00 K S t arting Non-Interactive Mode T o start SANsurfer FC/CNA HBA CLI in non-interactive mode, type th e following in a command window: scli < parameters > SANsurfer FC/CNA HBA CLI executes the comma nd options, and then terminates. T o list all of the available command line [...]

  • Page 47

    2–Getting S tarted S tarting Non-Inte ractive Mode SN0054614-00 K 2-5 -b 10 10 — Save/update BIOS/FCode a b “-b (Sav e or Update the F lash BIOS or FCode)” on page 4- 7 -c 2 2 2 Show adapter set- tings “-c (Show Para me- ter Settings)” on page 4- 8 -cna 16 16 16 View and modify con- verged network adapters “-cna (FCoE Utili- ties Menu[...]

  • Page 48

    2–Getting S tarted S tarting Non-Interactive Mode 2-6 SN0054614-00 K -g 1 1 1 Show system infor- mation “-g (Display Sys- tem Informat ion)” on page 4- 18 -gs 13 13 13 Adapter statistics “-gs (Show HBA S tatistics)” on page 4-18 -h -? 14 14 14 14 14 14 Show usage Show usage “-h (Help)” on page 4-19 -ha 2 2 2 Adapter alias “-ha (Set [...]

  • Page 49

    2–Getting S tarted S tarting Non-Inte ractive Mode SN0054614-00 K 2-7 -n 3 3 3 Configure adap ter settings “-n (Set Selected HBA Parameter)” on page 4- 35 -o 1 1 1 Output to a file “-o (Output to a File)” on page 4- 37 -p 6 6 6 T arget persistent binding “-p (Display Persis- tent T arget Bind- ing Info)” on page 4-38 -pa 2 2 2 Adapter[...]

  • Page 50

    2–Getting S tarted S tarting Non-Interactive Mode 2-8 SN0054614-00 K 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 more options that [...]

  • Page 51

    2–Getting S tarted T erminology SN0054614-00 K 2-9 For all command line options, SANsurfer FC/CNA HBA CLI shows the following when there are errors in the command line input: Error < error message > SANsurfer FC/CNA HBA CLI v1.x.x Build xx Copyright 2003-2009 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters descrip[...]

  • Page 52

    2–Getting S tarted Advanced Features 2-10 SN0054614-00 K Advanced Features SANsurfer FC/CNA HBA CLI adds the following adva nced features to it s toolset: N_Port ID virtualization (NPIV). NPIV (N_Port ID virtualizatio n) allows you to make the most of your server and Fibre Channel fabric. For inst ance, you can partition your server to support mu[...]

  • Page 53

    SN0054614-00 K 3- 1 3 Interactive Commands This chapter describes the interactive m ode command line options for specific QLogic FC adapters. The interactive mode us es a series of menus from which you select the option you want and enter the number for that option. (For information on non-interactive mode operation—in which yo u simply enter a o[...]

  • Page 54

    3–Interactive Commands 3-2 SN0054614-00 K St arting Interactive Mode T o start the interactive mode, type one of the follo wing: [ scli ] [ scli int] (on some Solaris inst allations) When you st art SANsurfer FC/CNA HBA CLI in in teractive mode, the Main Menu appears as follows: Main Menu 1: General Information 2: HBA Information 3: HBA Parameter[...]

  • Page 55

    3–Interactiv e Commands SN0054614-00 K 3-3 Selections from the Main Menu open new menus. For example, if yo u enter option 1 ( General Information ) on th e main interactive menu, the system shows a new menu, the General Information Menu . From this menu you have several choices including 1: Host Information , 2: Host Topology , and so forth. On [...]

  • Page 56

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-4 SN0054614-00 K 1: General Information  2: Host T opology  2: Save As Txt File General Information Menu (Command Line Option -g) 1: General Information This option shows you general in formation for the adapter . T o see the HBA General Information menu, from the M[...]

  • Page 57

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-5  T otal number of QLogic adapters detect ed ------------------------------------------------------------------------------ Host Name : BRAGI OS Type : Microsoft Windows Svr 2003 Enterprise Ed. x86 OS Version : Service Pack 1 (Build 3790 SDM API Uersio[...]

  • Page 58

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-6 SN0054614-00 K  Save As Txt file  Save As XML File Display (Host T opology) ( Command Line Option -tp | -topology) 1: General Information  2: Host T opology  1: Disp lay The host topology option shows informa tion about interconnect element s (switches or ad[...]

  • Page 59

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-7  Number of Port  Beacon S tatus  Port T ype  Port S tate  Port Information (repeat s for each port) (Every port may not use all items):  Physical Port Number (switch or adapter port nu mber), including:  Port Name (WWPN)  Port S t[...]

  • Page 60

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-8 SN0054614-00 K Host : BRAGI Number of Port : 1 Beacon status : Unsupported Port Type : L_Port Port State : Online ================================= = InterConnect Element = ================================= Type : Switch World Wide Name : 10-00-00-C0-DD-00-6A-9F Domain [...]

  • Page 61

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-9 Product Serial Number : LT06464600001011HGGH Target/Initiator : Target Node Name : 20-00-00-20-37-11-FF-EF Port Name : 21-00-00-20-37-11-FF-EF Vendor Id : SEAGATE Product Id : ST118273 CLAR18 Product Revision : SG1D Product Serial Number : LP602669000019[...]

  • Page 62

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-10 SN0054614-00 K Beacon status : Off Port Type : Unknown Port State : LinkDown Hit <RETURN> to continue: Save As Txt File (Command Line Option -b) 1. General Information  2: Host T opology  2: Save As Txt File When you save the host topology to a te xt file, [...]

  • Page 63

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-1 1  Adapter Model  Port Number  Port WWPN  Port S tatus Generate Report (Per Adapter Port) 1: General Information  3: Report  1 - n: Port Number If you enter the number for an adapter port instance from th e list, the system shows a vari[...]

  • Page 64

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-12 SN0054614-00 K  Actual Connection Mode  Actual Data Rate  PortT ype (T opology)  T arget Count  PCI Bus Number (Windows and Linux)  PCI Device Number (Windows and Linux)  Adapter S tatus (online, of fline)  Adapter VPD Header (V ital Product Dat[...]

  • Page 65

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-13  Interrupt Delay T imer  Execution Throttle  Login Retry Count  Port Down Retry Count  Enable LIP Full Login  Link Down T imeout (in seconds)  Enable T arget Reset  LUNs Per T arget  Enable Receive Out Of Order Frame  Drive[...]

  • Page 66

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-14 SN0054614-00 K  St a t u s  LUN N (Repeats for each LUN)  Product V endor  Product ID  Product revision  LUN  Size  Ty p e  WWULN  Selective LUN Information Header (repeat s for each selective LUN)  Adapter Instance  Adapter Part Num[...]

  • Page 67

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-15 Host Name : BRAGI OS Type : Microsoft Windows Server 2003 Enterprise Edition x86 OS Version : Service Pack 1 (Build 3790) SDM API Version : 1.28.0.50 QLSDM.DLL ------------------------------------------------------------------------------ HBA Model 2200[...]

  • Page 68

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-16 SN0054614-00 K HBA VPD Information ------------------------------------------------------------------------------ Feature is not supported with selected HBA (Instance 1 - 2200)! ------------------------------------------------------------------------------ HBA Paramete[...]

  • Page 69

    3–Interactiv e Commands General Information Menu (Com mand Line Option -g) SN0054614-00 K 3-17 ------------------------------------------------------------------------------ HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00 ------------------------------------------------------------------------------ Path : 0 Target : 0 De[...]

  • Page 70

    3–Interactive Commands General Information Menu (Command Lin e Option -g) 3-18 SN0054614-00 K Product Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Revision : SG1D LUN : 0 Size : 16.95 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 20-00-00-20-37-11-FF-EF ----------------------------------------------------------[...]

  • Page 71

    3–Interactiv e Commands HBA Information Menu ( Command Line Option -i) SN0054614-00 K 3-19 ---------------------------- ------ 00-00-00-00-00-00-00-00 0 ---------------------------- ------ (Alternate 1) Boot Port Name LUN ---------------------------- ------ 00-00-00-00-00-00-00-00 0 ---------------------------- ------ (Alternate 2) Boot Port Name[...]

  • Page 72

    3–Interactive Commands HBA Information Menu (Command Line Option -i) 3-20 SN0054614-00 K  Additional adapters (as appropriate)  All adapters Here is an example of a typical HBA Information Menu . In this examp le, the host includes three adapters with two port s each: HBA Information Menu HBA Model 2200: 1: Port 1: WWPN: 21-00-00-E0-8B-03-5[...]

  • Page 73

    3–Interactiv e Commands HBA Information Menu ( Command Line Option -i) SN0054614-00 K 3-21 If you select a number correspon ding to an FCoE engin e rather than a port, the following general information is shown: ----------------------------------------------------------------- Host Name : TARGET3 HBA Model : QLE8042 HBA Description : QLE8042 Merc[...]

  • Page 74

    3–Interactive Commands HBA Information Menu (Command Line Option -i) 3-22 SN0054614-00 K T o create, modify , or delete an adapter alias: 1. From the Main Menu , type the number for the HBA Information option, a nd then press ENTER . 2. T ype the number for the adapter you want to configu re, and then press ENTER . 3. T ype the number for the HBA[...]

  • Page 75

    3–Interactiv e Commands HBA Information Menu ( Command Line Option -i) SN0054614-00 K 3-23 T o create, modify , or delete an adapter port alias: 1. From the Main Menu , type the number for the HBA Information option, a nd then press ENTER . 2. T ype the number for the HBA Port for which you want to change the Port Alias, and then press ENTER . 3.[...]

  • Page 76

    3–Interactive Commands HBA Parameters Menu 3-24 SN0054614-00 K  BIOS V ersion (Windows and Linux)  FCode V ersion (Solaris)  Flash Image V ersion (QLE81 xx adapters only) If the adapter does not sup port VPD, the following message appears: VPD not supported on current HBA x ! HBA Information (All HBAs) 2: HBA Information  n : All HBAs[...]

  • Page 77

    3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-25  All adapters Here is an example of an HBA Parameters Menu . In this example, the h ost includes three adapters with two ports each a nd one adapter with a single p ort (see HBA Parameters (Per Adapter Port) and HBA Parameters (All HBAs) ): HBA Model QLA2342: 1. Port 1 WWPN 21-00-[...]

  • Page 78

    3–Interactive Commands HBA Parameters Menu 3-26 SN0054614-00 K Display HBA Parameters (Command Line Option -c#) 3: HBA Parameters  n: Port Instance  1: Display HBA Par ameters When you select this option, th e following pa rameters appear:  Connection Options  Data Rate (4Gb a nd above adapters)  Frame Size  Hard Loop ID  Loo[...]

  • Page 79

    3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-27  Enable LIP Full Login (QLA/QLE23 xx adapters)  Link Down T imeout (seconds)  Enable T arget Reset  LUNs per T arget  Enable Receive Out Of Order Frame  Commit Changes  Abort Changes T able 3-1 lists the configurable adapt er parameters alphabetically by name and[...]

  • Page 80

    3–Interactive Commands HBA Parameters Menu 3-28 SN0054614-00 K 1. Connection Options (re ad-only on QLE8042, QLE/QMI81 xx , and SMB adapters): 0 = Loop Only 1 = Point-to-point Only 2 = Loop preferred, ot herwise Point-to-Point 3 = Point-to-Point, otherwise Loop (QLA22xx Only) 2. Data Rate (read only on QLE8042 and SMB adap ters): 0 = 1 Gbs 1 = 2 [...]

  • Page 81

    3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-29 Dat a Rate 3: HBA Parameters  N: Por t Number  2: Configu re HBA Parame ters  n. Data Rate This option shows the Data Rate menu. (Note that da ta rate configuratio n is not available for all adapter port inst an ces.) From this menu you can select:  Auto  1 Gbps  2 [...]

  • Page 82

    3–Interactive Commands HBA Parameters Menu 3-30 SN0054614-00 K Enable HBA Port BIOS 3: HBA Parameters  N: Port Number  2: Configure HBA Parameters  n. Enable HBA Port BIOS This option allows you to enable or disable the BIOS boot set ting. When this setting is disabled, the ROM BIOS on th e adapter is disabled. If you are booting from a [...]

  • Page 83

    3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-31 Login Retry Count 3: HBA Parameters  N: Port Number  2: Configure HBA Parame ters  n. Login Ret ry Count This choice gives you the option to set the Login Retry Count to a value from 0 to 255. Enable LIP Reset 3: HBA Parameters  N: Por t Number  2: Co nfigure HBA Para[...]

  • Page 84

    3–Interactive Commands HBA Parameters Menu 3-32 SN0054614-00 K Commit Changes 3: HBA Parameters  N: Por t Number  2: Co nfigure HBA Parameters  n. Commit changes Choose this option to make t he changes permanent. Abort Changes 3: HBA Parameters  N: Por t Number  2: Configure HBA P arameters  n: Abort c hanges Choose this option [...]

  • Page 85

    3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-33 HBA Parameters (Per FCoE Engine) 3: HBA Parameters  n: FCoE Engine The FCoE Parameters menu appears only fo r the QLE8042 adapter and has the following options:  Display FCoE Parameters  Configure FCoE Parameters  Return to Previous Menu Display FCoE Parameters 3: HBA Par[...]

  • Page 86

    3–Interactive Commands HBA Parameters Menu 3-34 SN0054614-00 K FCoE Parameters Menu FCoE Engine (QLE8042) Port 0 Desc: QLE8042 Mercury CNA 1: Port Type 2: Pause Type 3: FCoE COS 4: Save Changes 5: Return to Previous Menu If you make any changes to the configurat ion of the FCoE engine, select the Save Changes option before you leave the FCoE Para[...]

  • Page 87

    3–Interactiv e Commands HBA Parameters Menu SN0054614-00 K 3-35 Priority Flow Control enables you to manage p auses in traffic according to assigned priorities to class of service (CoS ) frames; that is, on per-flow basis. CoS is a way of managing traffic in a network by grouping similar types of traffic (for example, e-mail, streaming video, voi[...]

  • Page 88

    3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-36 SN0054614-00 K The priority p ause mask is a bitmap of CoS values for which p ause is being enabled. SANsurfer FC/CNA HBA CL I allows you to select or clear boxes from 0 to 7, representing the dif ferent CoS val ues for which p ause is being enabled (or disabl[...]

  • Page 89

    3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-37 T arget/LUN List (Per Adapter Port) 4: Target/LUN List  1 - n T arget List Menu - Port n When you select an HBA port inst ance from the Target/LUN List , a list of LUNs (disks) attached to that port instance appears. T echnical information for ea[...]

  • Page 90

    3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-38 SN0054614-00 K Vendor : SEAGATE Product ID : ST318453FC Product Rev : 0006 Serial Number : 3JA9TN7600007523T6P1 Node Name : 20-00-00-11-C6-2D-5B-FA Portname : 22-00-00-11-C6-2D-5B-FA Port ID : 02-0A-DE And so on. Y ou can select any LUN and view additional inf[...]

  • Page 91

    3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-39 Desc: QLE2462 PCI Express to 4Gb FC Dual Channel 1: Information 2: Persistent Names 3: Return to Previous Menu Information 4: Target/LUN List  1 - n T arget List Menu Port n  1 - n: T arget  1 - n: LUN (Number)  1: In formation When you [...]

  • Page 92

    3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-40 SN0054614-00 K When you select Persistent Names from the previous menu , the following Persistent Names Menu for that LUN a ppears. This menu provides options to view , add, and delete persistent names for the LUN. For example: Persistent Names Menu HBA Instan[...]

  • Page 93

    3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-41 3. Delete T o delete persistent binding for the LUN, select 3 on the Persis tent Names Menu . SANsurfer FC/CNA HBA CLI lists the existing LUN persistent binding names, prompt s you to select one for deletion, and then immedia tely deletes the persis[...]

  • Page 94

    3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-42 SN0054614-00 K Here is an example of the LUN information. Product Vendor : SEAGATE Product ID : ST318453FC Product Revision : 0006 LUN : 0 Size : SBC-2 Direct Access block device (e.g. magnetic disk) WWULN : 20-00-00-11-C6-2D-5A-3F ----------------------------[...]

  • Page 95

    3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-43 1: Disk 1 on QLA2462 (HBA Instance 0) Vendor : SEAGATE Product ID : ST336607FC Product Rev : 0006 Serial Number : 3JA9TN7600007517FK7W Port Name : 22-00-00-11-C6-2D-5A-B8 Port ID : 02-0A-EO And so on. Individual LUN 4: Target/LUN List  n: Port Nu[...]

  • Page 96

    3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-44 SN0054614-00 K  Product V endor  Product ID  Port Name  Port ID  LUN ID  OS LUN Name (on Solaris and Linux) Here is an example of the LUN information: Product Vendor : SEAGATE Product ID : ST336607FC Product Revision : 0006 LUN : 0 Size : 34.[...]

  • Page 97

    3–Interactiv e Commands T arget/LUN List Menu (Command Line Options -t and -l) SN0054614-00 K 3-45 Here is an example of the All Targets option. Note: 0 to return to Main Menu Enter Selection: 3 ------------------------------------------------------------------ HBA Instance 5: QLA2300 Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 PortID 11-05-EF ----------[...]

  • Page 98

    3–Interactive Commands T arget /LUN List Men u (Comman d Line Opt ions -t an d -l) 3-46 SN0054614-00 K ------------------------------------------------------------- HBA Instance 0: QLA2462 Port 1 WWPN 21-00-00-E0-8B-1F-9D-F0 Port ID 02-00-00 ------------------------------------------------------------- Target WWPN (22-00-00-04-CF-9C-24-CA) ------[...]

  • Page 99

    3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-47 T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) 5: Target Link Speed or 5: iiDMA Settings This option shows the Target Link Spe ed Menu or iiDMA Menu that includes a list of all adapters and port inst ances detected,[...]

  • Page 100

    3–Interactive Commands T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 3-48 SN0054614-00 K Configuring the iiDMA Settings Use the intelligent interleaved direct memory access (iiDMA) menu to sele ct the intelligent interleave factor settings per adap ter type and device. T o configure iiDMA settings: 1. From the SANsurfer FC[...]

  • Page 101

    3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-49 iiDMA settings have been saved to selected target(s) on HBA instance n .  To e x i t iiDMA Settings without making any changes, select No . 5. T o use Advanced Configuration : a. Select the adap ter . b. From the device list, se lect[...]

  • Page 102

    3–Interactive Commands T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 3-50 SN0054614-00 K HBA Instance 0 (QLA2463 Port 1) : Online Desc: QLA2462 PCI-X 2.0 to 4Gb PC Dual Channel 1: Disk Vendor : SEAGATE Product ID : ST318453FC Product Rev : DF12 Serial Number : 3EV0NYSG000072496DYD Port Name : 22-00-00-04-CF-9C-24-CA Port I[...]

  • Page 103

    3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-51 Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Rev : SG1D Serial Number : LP60266900001919HQ1K Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Intelligent Interleave Factor: 4 Gbps 3: Apply Changes to selected Target(s) 4:[...]

  • Page 104

    3–Interactive Commands T arget Link S p eed or iiDMA Settin gs Menu (Command Line Option -q) 3-52 SN0054614-00 K T arget Link Speed: All HBA s, Basic Configuration 5: Target Link Speed  2: All HBAs  1: Basic Con figuration When you select this option, th e T arget Link S peed Menu (Basic) for All HBAs appears. It of fers the link speed opti[...]

  • Page 105

    3–Interactiv e Commands T arget Link S peed or iiDMA Settings Menu (Command Line Option -q) SN0054614-00 K 3-53 Vendor : SEAGATE Product ID : ST318453FC Product Rev : 00006 Serial Number : 3JA9AYSG000072496FBJ Port Name : 22-00-00-0C-50-68-1E-9A Port ID : 11-0A-E2 Max Target Link Rate : 4 Gbps ... m: Disk 2 on QLA2462 (HBA Instance 1) Vendor : SE[...]

  • Page 106

    3–Interactive Commands T arget Pe rsistent Bin dings Menu ( Command L ine Option -p) 3-54 SN0054614-00 K New iiDMA setting has been saved to seleted target(s) on HBA instance 0. iiDMA Settings: Disk 5: iiDMA Settings  1 - n: HBA Port n  n: Disk n When you select a sp ecific disk on the adapter po rt, the following options are available on t[...]

  • Page 107

    3–Interactiv e Commands T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 K 3-55 T arget Persistent Bindings (Per Adapter Port) (Command Line Option -p) 6: Target Persistent Bindings  1 - n: T arget Persistent Bindings HBA Instance n When you select an adapter instance to view or change it s binding, this menu the T arget [...]

  • Page 108

    3–Interactive Commands T arget Pe rsistent Bin dings Menu ( Command L ine Option -p) 3-56 SN0054614-00 K Here is an example of the T arget Persistent Binding Me nu for HBA Inst ance n : Target Persistent binding Menu HBA Instance 0 1: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-04-CF-9C-24-CA Port ID : 02-00-E1 Bind : No Ta[...]

  • Page 109

    3–Interactiv e Commands T arget Persistent Bindings Menu (Command Line Option -p) SN0054614-00 K 3-57 T ype the number for the option you want, and then press ENTER . T arget Persistent Binding: Unbind T argets (Command Line Option -p) 6: Target Persistent Binding  1 - n: T arget Persistent Binding HBA In stance n  3: Unbin d T arget(s) The[...]

  • Page 110

    3–Interactive Commands Selective LUNs Menu ( Command Line Option -m) 3-58 SN0054614-00 K Selective LUNs Menu (Command Line Option -m) 7: Selective LUNs When you select this option, SAN surfer FC/CNA HBA CLI shows the Selective LUNs Menu (see ), allowing you to select an individual a dapter port or All HBAs . Selective LUNs (Per Adapter Port) 7: S[...]

  • Page 111

    3–Interactiv e Commands Selective LUN s Menu (Co mmand Line Option -m ) SN0054614-00 K 3-59 1: Disk Vendor : SEAGATE Product ID : ST136403FC Port Name : 21-00-00-20-37-1A-6B-CF Port ID : 11-01-E4 Bind : Yes Target ID : 0 2: Disk Vendor : SEAGATE Product ID : ST118273 CLAR18 Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Bind : Yes Target [...]

  • Page 112

    3–Interactive Commands Boot Device M enu (Comma nd Line Op tion -e) 3-60 SN0054614-00 K Please reboot the system for the saved configuration to become effective. Boot Device Menu (Command Line Option -e) 8: Boot Device When you select this option, SANsurf er FC/CNA HBA CLI shows the standard HBA Port Instance menu (see “HBA Port Inst ance” on[...]

  • Page 113

    3–Interactiv e Commands Boot Device Menu (Command Line Option -e) SN0054614-00 K 3-61 ------------------------------------------------------------------------------ HBA Instance 0: 2200 Port 1 WWPN 21-00-00-E0-8B-03-55-7C PortID 00-00-EF ------------------------------------------------------------------------------ Boot Device Settings: ---------[...]

  • Page 114

    3–Interactive Commands Driver Settings Menu (Command Line Option -fg) 3-62 SN0054614-00 K LUN List Menu 8: Boot Device  n: Port Nu mber  2: Config ure Boot Device  2: Bo ot Device Se ttings  1: LUN List Menu When you select this option, SAN surfer FC/CNA HBA CLI shows the LUN List Menu , which includ es a list of LUNs on the selected [...]

  • Page 115

    3–Interactiv e Commands Driver Settings Menu ( Command Line Option -fg) SN0054614-00 K 3-63 The current settings for t he Present persistently bound target(s)... and Bind by... are indicated by the word Current in p arentheses af ter the selection. T o change these settings, select the menu number corresponding to the other option. T o save your [...]

  • Page 116

    3–Interactive Commands Utilities Menu 3-64 SN0054614-00 K Utilities Menu 10: Utilities The Utilities Menu provides optio ns for saving and restoring Flash and ada pter parameters. Y ou can save adapter p arameters in either a generic file or in a server manufacturer template such as QL ogic, HP , IBM, EMC, and so on. Saving parameters in a temp l[...]

  • Page 117

    3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-65 Up date Flash (Per Adap ter Port or All HBAs) (Command Line Option -b) 10: Utilities  1: Update Flash When you select Update Flash , you are promp ted to select either o ne of your adapter port inst ances or All HBAs to update. SANsurfer FC/CNA HBA CLI then prompts you to Update Entire[...]

  • Page 118

    3–Interactive Commands Utilities Menu 3-66 SN0054614-00 K Warning: Please update the HBA parameters with extreme care. Incorrectly updating the HBA parameters may render the HBA inoperable. If you currently have boot device information set up in the HBA parameters, updating the HBA parameters from a file may result in changing that information. I[...]

  • Page 119

    3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-67  Maximum LUNs Per T arget specifies the maximum number of L UNs per target. Multiple LUN sup port is typically for RAID boxes that use LUNs to map drives.  Port Down Retry Count sp ecifies the number of times SANsurfer FC/CNA HBA CLI retries a command to a port returning port down s[...]

  • Page 120

    3–Interactive Commands Utilities Menu 3-68 SN0054614-00 K When you select the HBA Parameters Template option, SANsurfer FC/CNA HBA CLI prompts you to select an adapter port (or All HBAs ), and then of fers some or all of the following template types:  Dell (Dell-specific settings)  EMC (EMC-specific settings)  HP (HP-specific settings) T[...]

  • Page 121

    3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-69  HPQ (HP-specific settings—2Gb HP adapters)  IBM (IBM-specific settings)  QLGC (QLogic-specific settings)  SUN (Sun-specific settings) Select one of the t emplates to apply it immediately to t he adapter port inst ance (or All HBAs .) The following is returned: Updating HBA [...]

  • Page 122

    3–Interactive Commands Utilities Menu 3-70 SN0054614-00 K Firmware Preload Table Update Menu HBA Model QLA2462 Port 1: WWPN: 21-00-00-E0-8B-1F-9D-F0 Loop Down Port 2: WWPN: 21-01-00-E0-8B-3F-9D-F0 Online HBA Model QLE2562 1: Port 1: WWPN: 21-00-00-1B-32-1B-4E-4C Online Port 2: WWPN: 21-01-00-1B-32-3B-4E-4C Online 2: All HBAs 3: Return to Previous[...]

  • Page 123

    3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-71 Port 1: WWPN: 21-00-00-E0-8B-1F-9D-F0 Loop Down Port 2: WWPN: 21-01-00-E0-8B-3F-9D-F0 Online HBA Model QLE2562 1: Port 1: WWPN: 21-00-00-1B-32-1B-4E-4C Online Port 2: WWPN: 21-01-00-1B-32-3B-4E-4C Online 2: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1 Enter a [...]

  • Page 124

    3–Interactive Commands Utilities Menu 3-72 SN0054614-00 K Current Version: v1.0 Enter a file name or Hit <RETURN> to abort: c:QLE8142_MPI.dat Saving current MPI config table of HBA instance 0 to c:QLE8142_MPI.dat... Mpi Configuration v1.0 of HBA instance 0 saved successfully. Driver Rescan (Command Line Option -rs) 10: Utilities  n : D[...]

  • Page 125

    3–Interactiv e Commands Utilities Menu SN0054614-00 K 3-73 2. Select the number corresponding to the QLE25 6 x adapter port for which you want to update firmware, or select the option fo r All HBAs . SANsurfer FC/CNA HBA CLI shows the following wa rning: Warning: Please update the HBA firmware area with extreme care. Incorrectly updating the firm[...]

  • Page 126

    3–Interactive Commands Utilities Menu 3-74 SN0054614-00 K ; ; FW Area data file for standard card ;************************************************************************** ; !!!!! DO NOT CHANGE THE ORDER OF THE DATA !!!!!!!!!!!! ;************************************************************************** ; ;**************************************[...]

  • Page 127

    3–Interactiv e Commands Beacon Menu SN0054614-00 K 3-75 Beacon Menu 11: Beacon The Beacon menu provides options for beaconing : a process by which an LED on a device (adapter or t arget) is flashed or blinked to locate it. Use the Locate HBA option to beacon a specified adapter . Use the Locate Target option to beacon a specified storage device ([...]

  • Page 128

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-76 SN0054614-00 K 2: Disk Vendor : SEAGATE Product ID : ST118273 CLAR18 Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Beacon : No 3: Beacon Selected Target(s) 4: Return to Previous Menu Y ou can select a disk number to blink the LED on that target. The b[...]

  • Page 129

    3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-77 When you select this option from the Main Menu , S ANsurfer FC/CNA HBA CLI shows Diagnostics Menu with the st andard list of adapter ports. T ype the number for the port on which you want to run diagnostic tests and the n press ENTER . When y[...]

  • Page 130

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-78 SN0054614-00 K  Display T est Parameters  Reset T est Parameters  Configure T est Parameters  S tart Diagn ostic T est Diagnostic test s interrupt normal adapter operations. At the completion of the testing, the adapter’s state before the tests a[...]

  • Page 131

    3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-79  If the adapter port is not connected to the fa bric through a point-to-point connection (F-port) and is not connected to a swit ch, change the setting to loop only , if not currently set to this option.  If the adapter port is connecte[...]

  • Page 132

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-80 SN0054614-00 K Data Size (Bytes) : 512 Number of test(s)(1-65535) : 65535 Test Increment(1-65535) : 1 On Error : Ignore Test Continuous : OFF Loopback Type : External Loopback ------------------------------------------------------------------------------ Reset[...]

  • Page 133

    3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-81 T able 3-10. Adapter Diagnostics Configuration Se ttings Parameter Name <p aram name> Alias <p aram alias> V alue <param value> Description DataPattern DP 00–FF C R PAT CSP A T CJTP A T See table note 1 Loopback test only [...]

  • Page 134

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-82 SN0054614-00 K Selecting the Loopback Type option (ava ilable only for 8Gb adapt ers) shows the currently type and allows you to change the type to one of the following loopback test types:  10 bit Internal Loopback  1 bit Serial Loopback  External Lo[...]

  • Page 135

    3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-83 Finished 6376 iterations in 1 second(s)... Diagnostics Read/W rite Buffer T est 12: Diagnostics  n: Port Nu mber  2: Read /Write Bu ffer T est When you select this option, SANsurfe r FC/CNA HBA CLI sh ows the Read/Write Buffer Test Menu[...]

  • Page 136

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-84 SN0054614-00 K  1 = Loopback T est  2 = Read/W rite Buf fer T est 4. The Read/Write Buffe r Test Menu appears. Se lect one of the following options: 1. Display Test Parameters. T ype 1 to show the current p arameter values. 2. Reset Test Parameters. T yp[...]

  • Page 137

    3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-85 operations. Please make sure there is no active I/O before starting the test(s). Do you want to proceed with the test(s)? 1. Yes 2. No T ype 1 to proceed or 2 to cancel the operation. If you proceed, the test runs as shown in the following ex[...]

  • Page 138

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-86 SN0054614-00 K T ransceiver Details: General Select the General option o n the Transceiver De tails menu to view general information for the selected adapt er port. The following shows an example: ---------------------------------------------------------------[...]

  • Page 139

    3–Interactiv e Commands Diagnostics M enu (Comm and Line O ptions -kl, -kr , and -dm) SN0054614-00 K 3-87 Address A0 Identifier: SFP Ext. Identifier: GBIC/SFP defined by serial ID only Connector: LC Ethernet Speed: 10 GBytes/Sec Compliance: 0x00 0x00 0x00 FC Link Length: FC Transmitter Tech: FC Transmission Media: FC Speed: Encoding: Reserved BR,[...]

  • Page 140

    3–Interactive Commands Diagnostics Menu (Command Line Op tions -kl, -kr , and -dm) 3-88 SN0054614-00 K 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 Address A2 Temp High Alarm: 0x4e00 Temp Low Alarm: 0x0c00 Temp High Warning: 0x4900 Temp Low Warning: 0x1100 Voltage High Alarm: 0x9088 Voltage Low Alarm: 0x7148 Voltage High Warning: 0x8ca0 Voltage Low Wa[...]

  • Page 141

    3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-89 Reserved MSB: 0x00 Reserved LSB: 0x00 Status/Control Bits:-Data_Ready_Bar: 0x0 -LOS: 0x0 -TX Fault: 0x0 -Soft RX Rate Select: 0x0 -RX Rate Select State: 0x1 -Soft TX Disable: 0x0 -TX Disable State: 0x0 -TX Signal Power Low Alarm: 0x0 -TX Signal Power H[...]

  • Page 142

    3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-90 SN0054614-00 K HBA S t atistics: Monitoring (Command Line Option -gs) 13: Statistics  1: HBA Statistics When you select this option, SAN surfer FC/CNA HBA CLI shows the HBA Statistics Menu including the following options:  Configuration  Show HBA S tatistics [...]

  • Page 143

    3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-91 LogToFile (LF): null.csv 5. T o restore the adapter default s, select Restore Default , and then press ENTER . The following message appears: Resetting to default settings..., done. 6. T o change the polling, select Auto Poll , an d then press ENTER . [...]

  • Page 144

    3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-92 SN0054614-00 K Resetting to default settings..., done. Auto Poll 13: Statistics  1: HBA Statistics  1 : Configuratio n  3: Auto Poll SANsurfer FC/CNA HBA CLI shows two polling options:  AutoPoll  Manual Poll If you select the Auto Poll option, the syste[...]

  • Page 145

    3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-93 The file name extension .csv indicates a comma separated value file t ype. Show HBA St atistics 13: Statistics  1: HBA Statistics  1 : Show HBA Statistics T o view the adapter port st atistics: 1. From the Main Menu , type the number for the S ta[...]

  • Page 146

    3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-94 SN0054614-00 K  “Configuration” on page 3-9 4  “Show Link S tatus” on p age 3-96 Configuration 13: Statistics  2: Link Status  1: Configuration When you select the Configuration option, t he Link Status Settings Menu appears and allows you to view [...]

  • Page 147

    3–Interactiv e Commands S tatistics Menu (Command Line Options -gs and -ls) SN0054614-00 K 3-95 Resetting to default settings..., done. Auto Poll Menu 13: Statistics  2: Link Status  1: Configurat ion  3: Auto Poll SANsurfer FC/CNA HBA CLI shows two polling options:  Auto Poll  Manual Poll If you select the Auto Poll option, the sy[...]

  • Page 148

    3–Interactive Commands S tatistics Menu (Command Line Options -gs and -ls) 3-96 SN0054614-00 K The file name extension .csv indicates a comma separated value file t ype. Show Link St atus 13: Statistics  2: Link Status  2: Show Link Status The Show Link Status option shows a menu of port numbers from which you can select the port for which [...]

  • Page 149

    3–Interactiv e Commands Virtual Menu (Com mand Li ne Option -vp) SN0054614-00 K 3-97 V irtual Menu (Command Line Option -vp) 14: Virtual Menu QLogic's SANsurfer FC/CNA HBA CLI for Windows and Solaris works in conjunction with QLogic's N_Port ID virt ua lization (NPIV)-cap abl e driver . NPIV is an ANSI T1 1 standard that describes how m[...]

  • Page 150

    3–Interactive Commands Virtual Menu (Com mand Line Option - vp) 3-98 SN0054614-00 K When you select the Virtual Menu option from the main menu, the Virtual Menu appears, showing:  Adapter Model  Port Number  WWPN  S tatus (Online/Loop do wn)  (Additional adapters)  (Additional ports) Virtual port op tions include the following: [...]

  • Page 151

    3–Interactiv e Commands Virtual Menu (Com mand Li ne Option -vp) SN0054614-00 K 3-99 In addition, the following notes app ly:  The maximum number of virtual adapters t hat can be created of a physical adapter is 15.  vPort means virtual port in all the displays.  In command line mode, you must u se the WWPN instead of adapter instance nu[...]

  • Page 152

    3–Interactive Commands Virtual Menu (Com mand Line Option - vp) 3-100 SN0054614-00 K Create Virtual Port(s) 14: Virtual  1: Virtual Menu  3: Create a V irtual Port When you select this option, th e Create Virtual Port Menu for this adapter instance appears showin g:  HBA Instance n  Adapter Model Port Nu mber  St a t u s  Descri[...]

  • Page 153

    3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-101 Enter Hex Pattern (xx) : T ype two hex digits. The system creates the new virtual port, for exa mple: (Create Virtual Port Menu) Enter Selection: 2 Enter Hex Pattern <xx>: EF The system returns the following: Virtual Port 21-EF-00-8B-14-5A-CF created successful[...]

  • Page 154

    3–Interactive Commands QoS Menu (Command Line Option -qos) 3-102 SN0054614-00 K  Setting the QoS by priority (the default for newly created virtual port s) lets you set the priority level for e ach of the defined virtua l ports. T his enables to you give preference to data tr ansmissions for one virtual port over others by giving it a higher p[...]

  • Page 155

    3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-103 QoS Priority Menu 15: QoS  n : Port number  1: QoS Priority Setting the QoS by priority let s you set the priority level for each of the defined virtual ports. This enab les to you give preference to dat a transmissions for one virtual port over others by givin[...]

  • Page 156

    3–Interactive Commands QoS Menu (Command Line Option -qos) 3-104 SN0054614-00 K 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 The QoS Priority Menu reappears and list s all the virtual ports. 5. V erify that the priority level is correct for the virtual port that you change d. 6. (Optional) T o prevent further chang[...]

  • Page 157

    3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-105 Desc: QMH2562 PCI-E to 8Gb FC Dual Channel Mezz HBA 1: Bandwidth Speed 2: Bandwidth Percentage 3: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1 When deciding how much bandwid th to as sign to a virtual p ort, consider the bandwidth req uir[...]

  • Page 158

    3–Interactive Commands QoS Menu (Command Line Option -qos) 3-106 SN0054614-00 K 2. If the virtual port is already enab led and unlocked, proceed to St e p 3 . Otherwise: a. The vir tual port must be Enabled to set the bandwid th. T o enable a currently disabled vPort, enter 1 for the Enable/Disable QoS Setti ngs option and then 1 again to Enable [...]

  • Page 159

    3–Interactiv e Commands QoS Menu (Command Line Option -qos) SN0054614-00 K 3-107 QoS Bandwid th Percentage Menu 15: QoS  n : Port number  2: QoS Bandwidth  2: Bandwidth Perce ntage T o set the bandwid th percentage for a virtua l port: 1. From the QoS Bandwidth Perce ntage Menu , type the number corresponding to the virtual port that you[...]

  • Page 160

    3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-108 SN0054614-00 K Hit <RETURN> to continue: FCoE Menu (Command Line Option -cna) 16: FCoE Fibre Channel over Ethernet (FCoE) is a new technolo gy that allows FC storage traffic to tra vel over an Ethernet fabric. This promo tes I/O consolidation, whereby data (TCP/IP) a nd stor[...]

  • Page 161

    3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-109 Up date Firmware 16: FCoE  1: Update Firmware Use this option to update the firmware on the a dapter ’s ASIC chip. When you select the Update Firmware option from the FCoE Utility menu, SANsurfer FC/CNA HBA CLI prompts you to enter the file name (usually a .bi [...]

  • Page 162

    3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 10 SN0054614-00 K Number of Transmitted 802.3x Pause Control Packets: 0 Number of Transmitted Per-Priority Pause Packets: 0 Number of Transmitted Packets with Error: 0 Number of Received Packets < 64 bytes: 0 Number of Received Packets = 64 bytes: 0 Number of Received Packets <[...]

  • Page 163

    3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3 - 111 scli -fcoe ( < hba instance > | < hba wwpn > ) --log --list T o show a specific log entry by Log ID, enter the following command: scli -fcoe ( < hba instance > | < hba wwpn > ) --log --id < logid > Link Event s 16: FCoE  3: Logs: ?[...]

  • Page 164

    3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 12 SN0054614-00 K 1: Information 2: Data Center Bridging 3: DCE Statistics 4: TLV 5: Return to Previous Menu The following sections explai n each of these menu options:  “Information” on p age 3-1 12  “Data Center Bridging” on page 3-1 12  “DCE S tatistics” on p[...]

  • Page 165

    3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 13 ---------------------------- DCBX Enable : Enabled Willing : Enabled Port Pause Type : Per Priority Pause SAN Priority COS : 3 ---------------------------- ETS ---------------------------- Priority Txt Mode : Bandwidth SAN Bandwidth Percent : 50 SAN Unused Bw To LA[...]

  • Page 166

    3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 14 SN0054614-00 K DCE St atistics 16: FCoE  3: DCE Statistics When you select the DCE Statistics option from the FCoE Utilities Menu for QLE81 xx /QMI81 xx adapters, a submenu menu appears with the following options for data ce nter Ethernet (DCE):  Display Settings (see pag e[...]

  • Page 167

    3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 15 Display Settings 16: FCoE  3: DCE Statistics  1: Display Sett ings Select the Display Settings option to show the current DCE statist ics settings for the selected adapter , for example: --------------------------------------- DCE Statistics Settings --------[...]

  • Page 168

    3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 16 SN0054614-00 K ------------------------------------------------------------- DCE Statistics Details for CNA Instance 0 - QLE8142 ------------------------------------------------------------- Transmit Packets: 143885 Transmit Octets: 17373502 Transmit Multicast Packets: 20036 Tran[...]

  • Page 169

    3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 17 Receive CBFC Pause Frames 0: 0 Receive CBFC Pause Frames 1: 0 Receive CBFC Pause Frames 2: 0 Receive CBFC Pause Frames 3: 0 Receive CBFC Pause Frames 4: 0 Receive CBFC Pause Frames 5: 0 Receive CBFC Pause Frames 6: 0 Receive CBFC Pause Frames 7: 0 Receive FCoE Pack[...]

  • Page 170

    3–Interactive Commands FCoE Menu (Command Li ne Option -cna) 3-1 18 SN0054614-00 K TL V 16: FCoE  4: TL V When you select the TLV option from the FCoE Utilities Me nu for QLE81 xx /QMI81 xx adapters, a submenu menu promp ts you to view either Details or Raw type-length-value (TL V) data for DCBX. The TL V for link layer discovery protocol (LLD[...]

  • Page 171

    3–Interactiv e Commands FCoE Menu (Command Line Option -cna) SN0054614-00 K 3-1 19 Priority Group ID of Priority 7: 0 Priority Group ID of Priority 6: 0 Priority Group 0 Percentage: 50 Priority Group 1 Percentage: 50 Priority Group 2 Percentage: 0 Priority Group 3 Percentage: 0 Priority Group 4 Percentage: 0 Priority Group 5 Percentage: 0 Priorit[...]

  • Page 172

    3–Interactive Commands Help Menu (Comm and Line Option -h) 3-120 SN0054614-00 K PFC Enabled on Priority 0: No PFC Enabled on Priority 1: No PFC Enabled on Priority 2: No PFC Enabled on Priority 3: Yes PFC Enabled on Priority 4: No PFC Enabled on Priority 5: No PFC Enabled on Priority 6: No PFC Enabled on Priority 7: No Number of Traffic Classes S[...]

  • Page 173

    3–Interactiv e Commands Help Menu (Command Line Option -h) SN0054614-00 K 3-121 T o view help for FCoE using the co mmand line option, enter the following command: scli -fcoe Content s 14 (or 15): Help  1: Contents When you select the Contents option, SANsurfer FC/CNA HBA CLI shows the entire Help menu. Y ou can see the help menu options rearr[...]

  • Page 174

    3–Interactive Commands Help Menu (Comm and Line Option -h) 3-122 SN0054614-00 K Notes[...]

  • Page 175

    SN0054614-00 K 4- 1 4 Non-Interactive Commands This chapter contains the info rmation in the help (to view help, ente r 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. The non-interactive com[...]

  • Page 176

    4–Non-Interactive Commands Display System Information (Comm and Line Options -g, -z, and -tp) 4-2 SN0054614-00 K  SAN target management (SDM) API version  List of adapters: adapter mode l, port number , WWPN, serial number (SN), adapter number (adapter 0–n), and status (o nline/of fline)  T otal number of QLogic FC adapters detect ed H[...]

  • Page 177

    4–Non-Inte ractive Comma nds Display System Information (Comm and Line Options -g, -z, and -tp) SN0054614-00 K 4-3 Host T opology (Command Line Option -tp) The command format for Host T opology is: # scli -tp When you select this option, SANsurf er FC/CNA HBA CLI shows the information in “Host Configuration (Comma nd Line Option -z)” on p age[...]

  • Page 178

    4–Non-Interactive Commands Display System Information (Comm and Line Options -g, -z, and -tp) 4-4 SN0054614-00 K  Port T ype  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 ad apter , tape device, or disk [...]

  • Page 179

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-5 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 line. U[...]

  • Page 180

    4–Non-Interactive Commands Command Summary 4-6 SN0054614-00 K Y ou cannot combine the command -f with any other options:  -f = Input Parameter Op tions from a T ext File (see “-f (Input Parameter Options from a T ext File)” on page 4-13 ). For example: # scli -f command.txt In addition, the following gene ral rules for commands apply:  [...]

  • Page 181

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-7 T o view the adapter port’s LED beacon st ate, type: # scli -a (< hba instance > | < hba wwpn >)(view | ?) When the adapter’s LED is flashing, the following message appears: HBA Port x - LED Flashing is ON. When the adapter’s LED is not flashing, the following messa[...]

  • Page 182

    4–Non-Interactive Commands Command Summary 4-8 SN0054614-00 K T o update one or all adapter ’s Flash with new BIOS or FCode, type: # scli -b (all | < hba instance > | < hba wwpn >) [(<-rg> | all)] < BIOS/FCode File Name > Where: T o save the BIOS/FCode to a file, type: # scli -b (< hba instance > | < hba wwpn &g[...]

  • Page 183

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-9 The -cna command line options use t he following variables: T o view general information for the adapter , issue the following command: scli -cna < hba instance >|< hba wwpn > --geninfo T o view data center bridging exchange protocol (DCBX) settings, issue th e following [...]

  • Page 184

    4–Non-Interactive Commands Command Summary 4-10 SN0054614-00 K -d (Up date Device Driver) Use the -d command to update the adap ter ’s device driver: scli -d < file name > Where: -dm (Display Diagnostics Monitoring Info) This option allows you to show general o r detailed Digital Diagnost ic Monitoring Interface for optica l transceivers.[...]

  • Page 185

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-1 1 # scli -dm (< hba instance > | < hba wwpn > | all)details | det Where: -e (Boot Device View | Select | Disable) Use the -e command to:  Show the current boot-device selection for all adapters.  Show the current boot-device selection for a specific adapter .  Se[...]

  • Page 186

    4–Non-Interactive Commands Command Summary 4-12 SN0054614-00 K < hba instance > < hba wwpn > < target wwnn > < target wwpn > < target id > < lun id > If the system does not have an a dapter with a boot device selected, th e following message appears: There is no boot device selected for any HBA in the system. F[...]

  • Page 187

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-13 In Solaris SP ARC, setting the t arget ID to the target of the boot -selected LUN is equivalent to persistently binding the t arget (see “-p (Display Persistent T arget Binding Info)” on p age 4-38 ). Therefore, if the target is persistently bound, it s boot device entry must ha[...]

  • Page 188

    4–Non-Interactive Commands Command Summary 4-14 SN0054614-00 K  The file must contain a single line.  The file must contain o nly paramet ers.  The file cannot cont ain another -f option. The following example shows how to set the con nection option of an adapte r to default (loop preferred, otherwise point-to-point) and th e data rate t[...]

  • Page 189

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-15 In the previous commands, the variables in dicate the following (see also T able 4-4 : Firmware Up date Commands T o update the firmware on the FCoE, issue the following command: # scli -fcoe ( < hba instance > | < hba wwpn > ) --loadfw <firmware file> hba instan c[...]

  • Page 190

    4–Non-Interactive Commands Command Summary 4-16 SN0054614-00 K Network Interface St atistics Commands T o show the FCoE network interface statistics, issue the followin g command: # scli -fcoe ( < hba instance > | < hba wwpn > ) --mon --nsl --port n FCoE Log Commands T o show the FCoE available l ogs, issue the following commands: T o[...]

  • Page 191

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-17 Where: The pairs < p aram name > < para m v al ue > and < par am ali as > < par a m v a lu e > can be repeated to set multiple p arameters in a single command. T able 4-5 lists the driver configuration parameter names and aliases. The following restrictions a[...]

  • Page 192

    4–Non-Interactive Commands Command Summary 4-18 SN0054614-00 K -g (Display System Information) T o view system information, type: # scli -g For details of t his command, see “Display System Information (Command Line Options -g, -z, and -tp)” on p age 4-1 . -gs (Show HBA St atistics) T o view the adapter statistics, type: # scli -gs ( < hba[...]

  • Page 193

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-19 -h (Help) T ype the following text to view the help file: # scli (-h | ?) T ype the following text to view hel p information for an individua l command: # scli < Command Line Parameter > (-h | ?) For example, typing scli -l -h shows: SANsurfer FC/CNA HBA CLI v1. x . x Build x [...]

  • Page 194

    4–Non-Interactive Commands Command Summary 4-20 SN0054614-00 K Where: T o set an alias for the selected adapter: # scli -ha (< hba instance > | < hba wwpn >) < alias > T o delete the current alias of the selected adapter: # scli -ha (< hba instance > | < hba wwpn >) delete T o view the current alias of the selected a[...]

  • Page 195

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-21 # scli -kl (< hba instance > | < hba wwpn >) T o do a loopback test with customized parameters, type: # scli -kl (< hba instance > | < hba wwpn >) [(< param name > | < param alias >) < param value >] Where: Sections “DataPattern (DP)” o [...]

  • Page 196

    4–Non-Interactive Commands Command Summary 4-22 SN0054614-00 K The data p attern must be in a two-character hexadecimal pattern in the range of 00–FF . The hexadecimal letters can be uppercase or lowe rcase. The default pattern is random, for example: # scli -kl(< hba instance > | < hba wwpn >) DP Random T o enter a customized value[...]

  • Page 197

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-23 Dat aS ize (DS) For the loopback test, the dat a size specifies the data (frame payload) size in bytes. The data size is the actual dat a t hat is transferred during any given pass of the test. DS <param value> DataSize <param value> The valid data sizes are as follows: [...]

  • Page 198

    4–Non-Interactive Commands Command Summary 4-24 SN0054614-00 K  12 (Windows)  25 (Solaris)  2 (Linux and Macintosh) The default test increment is 1. The test in crement cannot be larger than the number of tests run (see “T estCount (TC)” on pag e 4-23 ). OnError (OE) For the loopback test, OnError is either: OE < param value > [...]

  • Page 199

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-25 T able 4-10 lists the operating system driver versions that do not require a loopback connector . . T o do a loopback test using the current parameters, type: # scli - -kl (< hba instance > | < hba wwpn >) T o do a loopback test with custom parameters, type: # scli - -kl[...]

  • Page 200

    4–Non-Interactive Commands Command Summary 4-26 SN0054614-00 K # scli - kl < hba instance > DP FF DS 8 TC 500 TI 10 OE 1 Y ou do not have to set each parameter for the loopback test. If you do not specify a paramete r in the command line, the current p arameter value is used. For example, the following command se ts the dat a pattern to FFh[...]

  • Page 201

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-27 -kl ( < hba instance > | < hba wwpn >) [{(< param name > | < param alias >) < param value >}] -kl (Run HBA Diagnost ics Loopback T est) The < pa ram name >, < p aram alias >, and < para m va l ue > options are described in T able 4-1 1[...]

  • Page 202

    4–Non-Interactive Commands Command Summary 4-28 SN0054614-00 K Where: Sections “DataPattern (DP)” o n page 4- 21 through “OnError (OE)” on page 4-24 describe how to change th e default p arameters for both of these test s. “Run a Loopback T est” on page 4-24 cont ains command line examples and test results for a loopback test. “Run [...]

  • Page 203

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-29 T o do a read/write buffer test using the cu rrent parameters, type: # scli -kr (< hba instance > | < hba wwpn >) T o exclude a device or devices on the selected adapter port, type: # scli -kr (< hba instance >|< hba wwpn >) [(-EX | -EXCLUDE) < target wwpn[...]

  • Page 204

    4–Non-Interactive Commands Command Summary 4-30 SN0054614-00 K Run Adapter Diagnostics R ead-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/statu s ?[...]

  • Page 205

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-31 If the read/write buf fer test fails, the system shows the following information :  Loop/port ID (the loop ID of the adapter whe n operating in loop mode).  Stat us :  Success —The test passed.  Error —A data miscomp are or link status firmware error occurred.  Fa[...]

  • Page 206

    4–Non-Interactive Commands Command Summary 4-32 SN0054614-00 K  Link Failure —Number of link failures  Loss of sync —Number of sync loss errors  Loss of signal —Number of signal loss errors  Invalid CRC —Number of invalid CRCs -l (Display LUN Info) This command shows LUN information for:  All adapters  A specific target [...]

  • Page 207

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-33 Where: T able 4-13 defines the link status p arameter names, aliases, and values. -m (View , En able, or Disable LUNs) hba instan ce = Ad apter number (u se -g command to find) hba wwpn = World wide port name of the ada pter param name = Name of the paramete r (see T able 4-13 ) par[...]

  • Page 208

    4–Non-Interactive Commands Command Summary 4-34 SN0054614-00 K Use the -m command to:  View all selective L UNs for all adapter ports  View an ad apter ’s selective LUN list  View the current selective state of a LUN on a specific target  Enable (select) a LUN on a specific t arget on a specific adapter  Disable (deselect) a LUN [...]

  • Page 209

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-35 T o disable (deselect) a LUN on a specific target on a specific a dapter , type: # 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 sp[...]

  • Page 210

    4–Non-Interactive Commands Command Summary 4-36 SN0054614-00 K The pairs < p aram name > < para m v al ue > and < par am ali as > < par a m v a lu e > can be repeated to set multiple p arameters with a single command. T able 4-14 lists the adapter para meter names and aliases. . par am a li as = Alias of the parameter s pa[...]

  • Page 211

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-37 -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 a Connection Options: 0 = Loop only 1 = Point-to-point only 2 = Loop pre ferr[...]

  • Page 212

    4–Non-Interactive Commands Command Summary 4-38 SN0054614-00 K Where the file name is systemLUNinfo , all message s are located in the directory indicated for the system plat form: -p (Display Persistent T a rget Binding Info) With this command you can:  Show binding information for one or on all ad apters  Bind a specific target to a selec[...]

  • Page 213

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-39 The following example is a typical SANsurf er FC/CNA HBA CLI output showing all target s currently bound to an adapter: -------------------------------------------------------------------------- HBA 0: QLA2462 Port 1 WWPN xx - xx - xx - xx - xx - xx - xx - xx Port ID 11-06-EF ------[...]

  • Page 214

    4–Non-Interactive Commands Command Summary 4-40 SN0054614-00 K Where: T o unbind all targets on a specific adapter port or on all adapter ports, type: # scli -p (< hba instance > | < hba wwpn > | all) (remove all | unbind all) Where: -p a (Define Port Alias) With this command you can:  Define the port alias for a specific adapter p[...]

  • Page 215

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-41 -pl (Show , Add, and Delete Persistent Names) This option provides persistent device names for sto rage devices. T o display persistent device names for a specific LUN or all LUNs, type: #s cli -pl < hba instance >|< hba wwpn > --info [< target id > < lun id >[...]

  • Page 216

    4–Non-Interactive Commands Command Summary 4-42 SN0054614-00 K -q (View or Set T arget Link Speed) T ype the following command to view the link speed of all ta rgets att ached to one adapter or all adapters: # scli -q ( < hba instance > | < hba wwpn > | < all >) [-targets | -t ] Where: T o view the link speed of a specific targe[...]

  • Page 217

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-43 T o set the link speed of selected target(s) a ttached to one adapter to the designated speed, type the f ollowing command: # scli -q (< hba instance > | < hba wwpn > | <all>) < target wwpn > <speed> Where: -qos (QoS Menu) SANsurfer FC/CNA HBA CLI provi[...]

  • Page 218

    4–Non-Interactive Commands Command Summary 4-44 SN0054614-00 K Y ou can specify the QoS of the virtual port based on either prio rity , bandwidth speed, or bandwid th percentage, wh ere: Y ou can change the lock and enable prope rties of the virtual port using the following options: -r (Up date HBA Parameters) T o update the adapter parameters, t[...]

  • Page 219

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-45 -s (Silent Mode) In non-interactive mode, the system shows result and st atus messages generated by SANsurfer FC/CNA HBA CLI (by default) unless suppressed by silen t mode. Y ou can combine this option with the -o option (see == “-o (Output to a File)” on page 4-37 ) so the outp[...]

  • Page 220

    4–Non-Interactive Commands Command Summary 4-46 SN0054614-00 K T o show the target information for a spe cific target on a specific ada pter , type: -t (< hba instance > | < hba wwpn >) (< target wwpn > | < target port id >) iiDMA (intelligent interleaved direct memory a ccess) settings include:  —targets | –t appli[...]

  • Page 221

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-47 T o save the current adapter firmware preload t able to a DAT file, enter the following command: # scli -u ( < hba instance > | < hba wwpn > ) save < file name > Where:  < hba instance > is the adapter inst ance number of an adapter port.  < hba wwpn[...]

  • Page 222

    4–Non-Interactive Commands Command Summary 4-48 SN0054614-00 K # 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 create a virtual port with a specific WWPN, type: # scli -vp (< hba inst[...]

  • Page 223

    4–Non-Inte ractive Comma nds Command Summary SN0054614-00 K 4-49 Y ou can use this option with all no n-interactive mode options th at have a corresponding interactive mode option (see T able 4-1 ). This option must be the first or last command in the command line. When you use this option, the system shows all result and status messages in XML f[...]

  • Page 224

    4–Non-Interactive Commands Command Summary 4-50 SN0054614-00 K Notes[...]

  • Page 225

    SN0054614-00 K A-1 A XML Format 1 Output Part s The -x1 command line option (see “-x (Outpu t in XML Format 1)” on p age 4-48 ) shows all output in XML format 1. This section de fines the XML format 1 output, which consists of the f ollowing part s:  “Main T ag” on page A-1  “Utility Header” on page A-1  “S tatus Message” o[...]

  • Page 226

    A–XML Format 1 XML Format 1 T ags for Each Option A-2 SN0054614-00 K S t atus Message Before the closing main t ag </QLogic> , SANsurfer FC/CNA HBA CLI shows returning st atus from the execution of the command lin e parameters and the error messages. A return value of 0 indicates success; a return value of 1 indicates failure:  Successfu[...]

  • Page 227

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-3  “Display Device List (Comm and Line Option -t)” on page A-7  “Display LUN List (Command Line Option -l)” on p age A-7  “T arget Persistent Binding (Command Line Option -p)” on page A-8  “Selective LUNs (Command Line Option -m)” on p age A-8  “Bo[...]

  • Page 228

    A–XML Format 1 XML Format 1 T ags for Each Option A-4 SN0054614-00 K <OSVersion> OS Version (and patches) </OSVersion> <HBA Port="value" WWNN="value" WWPN="value" /> <NumOfHBA> Number of QLogic FC HBA(s) </NumOfHBA> </Host> <Status> 0 </Status> <Reboot> 0 </Reb[...]

  • Page 229

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-5 For multiple adapters, repeat the preceding sequen ce with the ID number (ID Number="value") of the next adapter . Display HBA Information (Command Line Option -i) The XML Format 1 for adapter g eneral information is as follows: <?xml version="1.0" encodin[...]

  • Page 230

    A–XML Format 1 XML Format 1 T ags for Each Option A-6 SN0054614-00 K <GeneralInfo Port="value" Model="value" HBAID="value" HBAALias="" HBAPort="" PortAlias="" WWNN="value" WWPN="value" PortID="value" SerialNumber="value" DriverVersion="valu[...]

  • Page 231

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-7 </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Display Device List (Command Line Option -t) The XML Format 1 for adapter d evice information is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <Q[...]

  • Page 232

    A–XML Format 1 XML Format 1 T ags for Each Option A-8 SN0054614-00 K <LUN ID="value" WWULN="value" Vendor ="value" Product ="value" Revision ="value" Size="value"> Type="value" /> </Target> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboo[...]

  • Page 233

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-9 <HBA> <HBA Port="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <EnabledLUN ID="value" LUNWWNN="value" LUNWWPN="value"/>[...]

  • Page 234

    A–XML Format 1 XML Format 1 T ags for Each Option A-10 SN0054614-00 K CRCError="value" DisparityError="value" FrameLengthError="value" Result="value"/> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Diagnostics Result s—Read/Write Buffer T est (Command Li[...]

  • Page 235

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-1 1 BindbyPortID="value" /> /DriverSettings> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Display All Information for One or All Adapters (Command Line Option -z) The XML Format 1 for all adapter information is more[...]

  • Page 236

    A–XML Format 1 XML Format 1 T ags for Each Option A-12 SN0054614-00 K <Host> <Name> Host Name </Name> <OSType> OS Type </OSType> <OSVersion> OS Version (and patches where applicable) </OSVersion> <HBA Port="value" WWNN="value" WWPN="value" /> <NumOfHBA> Number of [...]

  • Page 237

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-13 EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <Info Path= "value" Vendor [...]

  • Page 238

    A–XML Format 1 XML Format 1 T ags for Each Option A-14 SN0054614-00 K Link S t atistics (Command Line Option -ls ) The XML Format 1 for the lin k st atistics option is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>vn.nn.nn [...]

  • Page 239

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-15 DeviceError="value" Reset="value" IOCount="value" IOPS="value" BPS="value" TimeStamp="value" /> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> HBA Alias (Command Line [...]

  • Page 240

    A–XML Format 1 XML Format 1 T ags for Each Option A-16 SN0054614-00 K HBA T ransceiver Det ails (Command Line Option -dm) The XML Format 1 for adapter tra nsceiver details (general information) is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName>[...]

  • Page 241

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-17 <MeasuredTxPowerUnit>(mW)</MeasuredTxPowerUnit> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning&g[...]

  • Page 242

    A–XML Format 1 XML Format 1 T ags for Each Option A-18 SN0054614-00 K <Length-50um> "value" </Length-50um> <Length-62.5um> "value" </Length-62.5um> <Length-Copper> "value" </Length-Copper> <VendorName>"value"</VendorName> <VendorOUI> "value" &l[...]

  • Page 243

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-19 <TempHighWarning>"value"</TempHighWarning> <TempLowWarning>"value" </TempLowWarning> <VoltageHighAlarm>"value"</VoltageHighAlarm> <VoltageLowAlarm>"value"</VoltageLowAlarm> <VoltageHighWa[...]

  • Page 244

    A–XML Format 1 XML Format 1 T ags for Each Option A-20 SN0054614-00 K <SoftRXRateSelect> "value" </SoftRXRateSelect> <RXRateSelectState> "value" </RXRateSelectState> <SoftTXDisable> "value"</SoftTXDisable> <TXDisableState> "value" </TXDisableState> </Status[...]

  • Page 245

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-21 WWPN="value" VendorId="value" Model="value" SerialNumber="value" Alias="value" PortAlias="value" DriverVersion="value" FirmwareVersion="value" Host="value" TotalNumberOfDevices="value[...]

  • Page 246

    A–XML Format 1 XML Format 1 T ags for Each Option A-22 SN0054614-00 K <HBA PortName="value" Host="DataUnavailable"/> </AttachedPort> </PhysicalPort> ... ... </PhysicalPort> <PhysicalPort Number="value"> <Port WWPN="value" State="value" Type="value" TXPort[...]

  • Page 247

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-23 <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <Menlo> <GeneralInfo HostName="TARGET3" Model="QLE8000" Description="QLE8042 Mercury CNA" FirmwareVersion=&quo[...]

  • Page 248

    A–XML Format 1 XML Format 1 T ags for Each Option A-24 SN0054614-00 K <HBA> <HBA Port="3" WWNN="20-00-00-E0-8B-80-5F-0F" WWPN="21-00-00-E0-8B-80-5F-0F" /> <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVer[...]

  • Page 249

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-25 <Entry No="18" Info="No Data"/> <Entry No="19" Info="No Data"/> </FCoELogs> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> </HBA> </QLogic> Display FCoE DCBX Th[...]

  • Page 250

    A–XML Format 1 XML Format 1 T ags for Each Option A-26 SN0054614-00 K Info="No Data"/> <Entry No="9" Info="No Data"/> <Entry No="10" Info="No Data"/> <Entry No="11" Info="No Data"/> <Entry No="12" Info="No Data"/> <Entry No=&quo[...]

  • Page 251

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-27 </NumberofTransmittedPacketsEqual64bytes> <NumberofTransmittedPacketsLessThanOrEqual127bytes> 0 </NumberofTransmittedPacketsLessThanOrEqual127bytes> <NumberofTransmittedPacketsLessThanOrEqual256bytes> 0 </NumberofTransmittedPacketsLessThanOrEqual256by[...]

  • Page 252

    A–XML Format 1 XML Format 1 T ags for Each Option A-28 SN0054614-00 K <NumberofTransmittedGoodPackets> 0 </NumberofTransmittedGoodPackets> <NumberofTransmittedUnicastPackets> 0 </NumberofTransmittedUnicastPackets> <NumberofTransmittedMulticastPackets> 0 </NumberofTransmittedMulticastPackets> <NumberofTransmi[...]

  • Page 253

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-29 <NumberofReceivedPacketsLessThanOrEqual511bytes> 0 </NumberofReceivedPacketsLessThanOrEqual511bytes> <NumberofReceivedPacketsLessThanOrEqual1023bytes> 0 </NumberofReceivedPacketsLessThanOrEqual1023bytes> <NumberofReceivedPacketsLessThanOrEqual1518byte[...]

  • Page 254

    A–XML Format 1 XML Format 1 T ags for Each Option A-30 SN0054614-00 K 0 </NumberofReceivedMulticastPackets> <NumberofReceivedBroadcastPackets> 0 </NumberofReceivedBroadcastPackets> <NumberofReceivedPacketsWithVLANtag> 0 </NumberofReceivedPacketsWithVLANtag> <NumberofReceivedOversizedPacketsWithGoodCRC> 0 </N[...]

  • Page 255

    A–XML Format 1 XML Format 1 T ags for Each Option SN0054614-00 K A-31 </NumberofReceivedPer-PriorityPausePackets> </NSLPortStatistics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic>[...]

  • Page 256

    A–XML Format 1 XML Format 1 T ags for Each Option A-32 SN0054614-00 K Notes[...]

  • Page 257

    SN0054614-00 K B-1 B XML Format 2 This appendix provides the following info rmation:  “Output Parts” on p age B-1 explains the output of XML format 2.  “XML Format 2 T ags for Each Option” on p age B-3 lists the XML format 2 tags for each option. Output Part s The -x2 command line option (se e “-x2 (Output in XML Format 2)” on p a[...]

  • Page 258

    B–XML Format 2 Output Parts B-2 SN0054614-00 K Utility Header The following header information is shown af ter the main tag: <AppName> SANsurfer FC/CNA HBA CLI </AppName> <AppVersion> X.YY.ZZ Build XX</AppVersion> <AppXMLVersion> X.YY </AppXMLVersion> S t atus Message Before the closing main t ag </QLogic>[...]

  • Page 259

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-3 XML Format 2 T ags for Each Option The following sections describe the XML Format 2 for each command line option:  “Display System Information (C ommand Line Option -g)” on p age B-4  “Display Adapter Settings (Command Line Op tion -c)” on pa ge B-4  “Display [...]

  • Page 260

    B–XML Format 2 XML Format 2 T ags for Each Option B-4 SN0054614-00 K Display System Information (Command Line Option -g) The command format is: scli -g -x2 The XML Format 2 for system information outpu t is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLISANsurfe[...]

  • Page 261

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-5 FrameSize="value" HardLoopId="value" LoopResetDelay="value" EnableHostAdapterBIOS="value" EnableHardLoopId="value" FibreChannelTapeSupport="value" OperationMode="value" IntDelayTimer="value" Executio[...]

  • Page 262

    B–XML Format 2 XML Format 2 T ags for Each Option B-6 SN0054614-00 K HBAPort="value" PortAlias="value" WWNN="value" WWPN="value" PortID="value" SerialNumber="value" DriverVersion="value" BIOSVersion="value" FirmwareVersion="value" PCIbus="value" PC[...]

  • Page 263

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-7 PortType="value" Status="value" </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic> Here is the VPD information: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SAN[...]

  • Page 264

    B–XML Format 2 XML Format 2 T ags for Each Option B-8 SN0054614-00 K <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <Info Path="value" ID="value" Vendor="value" ProcuctID="value" Revision="value" SerialNumber="value" DeviceID= "value" PortID= &[...]

  • Page 265

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-9 </HBA> <Status> n </Status> <Reboot> n /Reboot> </QLogic> The <Target> sequence repeat s for each LUN attached to the t arget. The LUN list is listed under the targ et, not under the adapter . T arget Persistent Binding (Command Line Option[...]

  • Page 266

    B–XML Format 2 XML Format 2 T ags for Each Option B-10 SN0054614-00 K <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <EnabledLUN ID="value&quo[...]

  • Page 267

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-1 1 </HBA> <Status> n </Status> <?ErrorMsg> "message" </ErrorMsg?> <Reboot> n /Reboot> </QLogic> The <HBA> …< /HBA> sequen ce repeat s for each adapter . Diagnostics Result s— Loopback T est (Command Line Optio[...]

  • Page 268

    B–XML Format 2 XML Format 2 T ags for Each Option B-12 SN0054614-00 K <Status> n </Status> <Reboot> n /Reboot> </QLogic> Diagnostics Result s—Read/Write Buffer T est (Command Line Option -kr) The command format is: scli -kr (< hba instance > | < hba wwpn >) [(-EX | -EXCLUDE) < target wwpn >] (< pa[...]

  • Page 269

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-13 <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <DriverSettings> <Info PersistentPlusNew="value" PersistentOnly="value" BindbyWWPN="value&qu[...]

  • Page 270

    B–XML Format 2 XML Format 2 T ags for Each Option B-14 SN0054614-00 K The command format is: scli -z (< hba instance > | < hba wwpn > | all) -x2 The XML Format 2 for all adapter information is as follows: <?xml version="value" encoding="value"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppNa[...]

  • Page 271

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-15 PortType="value" Status="value" /> <Param ConnectionOption="value" <VPD> <VPD ProductIdentifier=""/> </VPD> <Param ConnectionOption="value" DataRate="value" FrameSize="value" HardLo[...]

  • Page 272

    B–XML Format 2 XML Format 2 T ags for Each Option B-16 SN0054614-00 K <TargetBinding TargetWWNN="value" TargetWWPN="value" TargetPortID="value" TargetID="value" /> > <BootDeviceInfo> <BootParam EnableSelectableBoot="value" /> <BootDevice TargetWWPN="value" LUNID=&[...]

  • Page 273

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-17 <HBA> <HBA Instance="value" HBAModel="value" HBAPort="value" WWNN="value" WWPN="value" /> <LinkStatus PortName="value" LinkFailure="value" SyncLoss="value" SignalLoss="value"[...]

  • Page 274

    B–XML Format 2 XML Format 2 T ags for Each Option B-18 SN0054614-00 K HBA Alias (Command Line Option -ha) The command format is: scli -ha (< hba instance > | < hba wwpn >) view | ? -x2 The XML Format 2 for the adap ter alias option is as follo ws: <?xml version="value" encoding="value"?> <QLogic> <Ap[...]

  • Page 275

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-19 The XML Format 2 for adapter tra nsceiver details (detailed inf ormation) is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>v1.7.0 Build 15</AppVersion[...]

  • Page 276

    B–XML Format 2 XML Format 2 T ags for Each Option B-20 SN0054614-00 K <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value"</HighWarning> <LowWarning>"value"</LowWarning> <LowAlarm>"[...]

  • Page 277

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-21 <Diagnostics> <Temperature> <MeasuredTemperature>(C)</MeasuredTemperature> <Value>"value"</Value> <Status>"value"</Status> <HighAlarm>"value"</HighAlarm> <HighWarning>"value&quo[...]

  • Page 278

    B–XML Format 2 XML Format 2 T ags for Each Option B-22 SN0054614-00 K The XML Format 2 for adapter tra nsceiver details (general information) is as follows: # scli -dm (< hba instance > | < hba wwpn > | all) (details | det) -x2 The XML Format 2 for adapter tra nsceiver details (detailed inf ormation) is as follows: <?xml version=&q[...]

  • Page 279

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-23 <TX_DisableImplementedAndDisablesSerialOP> "value"</TX_DisableImplementedAndDisablesSerialOP> <RATE_SelectImplemented> "value" </RATE_SelectImplemented> </Options> <BR-Max> "value" </BR-Max> <BR-Min> [...]

  • Page 280

    B–XML Format 2 XML Format 2 T ags for Each Option B-24 SN0054614-00 K <RXPowerLowWarning>"value"</RXPowerLowWarning> <Rx_PWR-4>"value"</Rx_PWR-4> <Rx_PWR-3>"value"</Rx_PWR-3> <Rx_PWR-2>"value"</Rx_PWR-2> <Rx_PWR-1>"value"</Rx_PWR-1> <R[...]

  • Page 281

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-25 <TXPowerHighWarning> "value" </TXPowerHighWarning> <TXBiasLowWarning> "value" </TXBiasLowWarning> <TXBiasHighWarning> "value" </TXBiasHighWarning> <VccLowWarning> "value" </VccLowWarning> &l[...]

  • Page 282

    B–XML Format 2 XML Format 2 T ags for Each Option B-26 SN0054614-00 K BeaconStatus="value" <PhysicalPortInformation> <PhysicalPortNumber="value"> <Port WWPN="value" State="value" Type="value" TXPortType="value" ModuleType="value" <AttachedPort Type="value[...]

  • Page 283

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-27 Display FCoE Information The XML Format 2 for FCoE information outpu t is as follows: <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <H[...]

  • Page 284

    B–XML Format 2 XML Format 2 T ags for Each Option B-28 SN0054614-00 K <?xml version="1.0" encoding="ISO-8859-1"?> <QLogic> <AppName>SANsurfer FC/CNA HBA CLI</AppName> <AppVersion>1.7.1.23</AppVersion> <HBA> <HBA Instance="3" HBAModel="QLE8402" HBAPort="1&quo[...]

  • Page 285

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-29 <Entry No="16" Info="No Data"/> <Entry No="17" Info="No Data"/> <Entry No="18" Info="No Data"/> <Entry No="19" Info="No Data"/> </FCoELogs> </HBA> <Status> [...]

  • Page 286

    B–XML Format 2 XML Format 2 T ags for Each Option B-30 SN0054614-00 K Info="No Data"/> <Entry No="7" Info="No Data"/> <Entry No="8" Info="No Data"/> <Entry No="9" Info="No Data"/> <Entry No="10" Info="No Data"/> <Entry No="[...]

  • Page 287

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-31 </NumberofTransmittedPacketsLessThan64bytes> <NumberofTransmittedPacketsEqual64bytes> 0 </NumberofTransmittedPacketsEqual64bytes> <NumberofTransmittedPacketsLessThanOrEqual127bytes> 0 </NumberofTransmittedPacketsLessThanOrEqual127bytes> <Numbero[...]

  • Page 288

    B–XML Format 2 XML Format 2 T ags for Each Option B-32 SN0054614-00 K <NumberofTransmittedBytesforGoodPackets> 0 </NumberofTransmittedBytesforGoodPackets> <NumberofTransmittedGoodPackets> 0 </NumberofTransmittedGoodPackets> <NumberofTransmittedUnicastPackets> 0 </NumberofTransmittedUnicastPackets> <NumberofT[...]

  • Page 289

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-33 <NumberofReceivedPacketsLessThanOrEqual255bytes> 0 </NumberofReceivedPacketsLessThanOrEqual255bytes> <NumberofReceivedPacketsLessThanOrEqual511bytes> 0 </NumberofReceivedPacketsLessThanOrEqual511bytes> <NumberofReceivedPacketsLessThanOrEqual1023bytes&[...]

  • Page 290

    B–XML Format 2 XML Format 2 T ags for Each Option B-34 SN0054614-00 K 0 </NumberofReceivedUnicastPackets> <NumberofReceivedMulticastPackets> 0 </NumberofReceivedMulticastPackets> <NumberofReceivedBroadcastPackets> 0 </NumberofReceivedBroadcastPackets> <NumberofReceivedPacketsWithVLANtag> 0 </NumberofReceived[...]

  • Page 291

    B–XML Format 2 XML Format 2 T ags for Each Option SN0054614-00 K B-35 </NumberofReceived_802_3x_PauseControlPackets> <NumberofReceivedPer-PriorityPausePackets> 0 </NumberofReceivedPer-PriorityPausePackets> </NSLPortStatistics> </HBA> <Status> 0 </Status> <Reboot> 0 </Reboot> </QLogic>[...]

  • Page 292

    B–XML Format 2 XML Format 2 T ags for Each Option B-36 SN0054614-00 K Notes[...]

  • Page 293

    SN0054614-00 K C-1 C Error/Exit Return Codes T o list the error/exit return codes while running SANsurfer FC/CNA HBA CLI in interactive mode: 1. From the Main Menu , select the Help option, and then press ENTER . 2. On the Help Men u , select Exit Codes , and then press ENTER . T o list the SANsurfer FC/CNA HBA CLI non-interactive error/exit codes [...]

  • Page 294

    C–Error/Exit Return Codes C-2 SN0054614-00 K 8 ERROR_NO_HBA Unable to open the adapter handle 9 ERROR_UNKNOWN_HBA Adapter is unknown to SANsurfer FC/CNA HBA CLI 10 ERROR_INV ALID_SSID Ad apter has inva lid SSDID/SSVID 1 1 ERROR_MISMA TCH_SSID The specified Flash/NVRAM file does not have the SSDID/SSVI D that match the adapter 12 ERROR_MISMA TCH_C[...]

  • Page 295

    C–Error/Exit Return Codes SN0054614-00 K C-3 30 ERROR_INCORRECT_RISC_CODE _FILE Incorrect RISC image 31 ERROR_INCOR RECT_BOOT_CODE_FILE Incorrect BIOS/FCode boot image 32 ERROR_INCORRECT_FULL_IMAGE_FILE Inco rrect 1M F lash imag e 33 ERROR_CORRUPTED_FLASH_IMAGE_ FILE Flash image file is corrupted 34 ERROR_FLASH_UPDA TE_F AILURE Failed to update F[...]

  • Page 296

    C–Error/Exit Return Codes C-4 SN0054614-00 K 49 Reserved Not used 50 ERROR_FC_LINK_UNKNOWN_ST A TUS Error getting FC link status 51 ERROR_RESET_LINK_ST A TUS Unable to reset adap ter link sta tus 52 ERROR_INV ALIDE_ST A TISTICS_P ARAMS Invalid link status/stati stics parameter set- tings 53 Reserved Not used 54 Reserved Not used 55 Reserved Not u[...]

  • Page 297

    C–Error/Exit Return Codes SN0054614-00 K C-5 72 ERROR_NO_SP ACE_LEFT Command failed because no space lef t on the drive 73 ERROR_MISSING_TEMPLA TE_FILE Un able to find template file 74 Reserved Not used 75 Reserved Not used 76 Reserved Not used 77 Reserved Not used 78 Reserved Not used 79 Reserved Not used 80 ERROR_INV ALID_SERIAL_N O Invalid ada[...]

  • Page 298

    C–Error/Exit Return Codes C-6 SN0054614-00 K 94 ERROR_T ARGET_NO_DIRECT_ACCESS Boot device settings failed because the boot target is no t a direct access device 95 ERROR_INV ALID_BOOT_SETTINGS Boot de vice parameter is invalid/incor rect 96 ERROR_UNSUPPORTED_BOOT_ SETTINGS Unsupported boot device settings 97 Reserved Not used 98 Reserved Not use[...]

  • Page 299

    C–Error/Exit Return Codes SN0054614-00 K C-7 1 17 ERROR_DELETE_T ARGET_PERSISTENT_ ENTRY Failed to delete tar get persistent binding 11 8 ERROR_LUN_NOT_FOU ND S pecified L UN ID not available 1 19 ERROR_NO_DEVICE_FOUND Adapter does not have att ached devices 120 ERROR_OPTION_UNSUPPORTED_DRV Opti on is not availabl e with running d river 121 ERROR[...]

  • Page 300

    C–Error/Exit Return Codes C-8 SN0054614-00 K 140 ERROR_UNKNOWN_FILE_FORMA T Unable to determine file format 141 ERROR_READ_DRV_VER _SYS_FILE Failed to read driv er version from sys file 142 ERROR_INIT_SECURITY_DE SCRIPTOR Failed to initialize secur ity descriptor during driver update 143 ERROR_SET_SECURITY_DESCRIPTOR Failed to set security descri[...]

  • Page 301

    C–Error/Exit Return Codes SN0054614-00 K C-9 163 ERROR_NO_SN_VPD Serial numb er is missing in V PD data 164 ERROR_RETRIEVE_VPD_DA T A Failed to read VPD of selected adapter 165 ERROR_UNSUPPORT_VPD_OPT Option is not supported with selected adapter 166 Reserved Internal used 167 Reserved Not used 168 Reserved Not used 169 Reserved Not used 170 Rese[...]

  • Page 302

    C–Error/Exit Return Codes C-10 SN0054614-00 K 189 IBM Reserved Blocked 190 IBM Reserved Blocked 191 IBM Reserved Blocked 192 IBM Reserved Blocked 193 Reserved Not used 194 Reserved Not used 195 Reserved Not used 196 Reserved Not used 197 Reserved Not used 198 Reserved Not used 199 Reserved Not used 200 ERROR_SA VE_SEL_LUN_CONFIG Failed to save se[...]

  • Page 303

    C–Error/Exit Return Codes SN0054614-00 K C-1 1 216 ERROR_SET_SWITCH_IP_ADDRESS Failed to set switch IP address 217 ERROR_INV ALID_SWITCH_INP UT Inva lid switch p a rameters settings 218 ERROR_INV ALID_ADMIN_ACCOUNT Admin account is required 219 ERROR_INV ALID_ADMIN_P A SSWORD A dmin password is incorrect 220 ERROR_INV ALID_OPTION Switch input is [...]

  • Page 304

    C–Error/Exit Return Codes C-12 SN0054614-00 K 239 Reserved Not used 240 ERROR_NO_T ARGET_S ELECTED Unable to run target beacon be cause no device i s sel ected 241 ERROR_GET_BEACON_ST A TE Unable to get the beacon status 242 ERROR_SET_BEACON_ST A TE Un able to set the beac on status 243 ERROR_BEACON_UNSUPPO RTED Beacon operation is unsupported 24[...]

  • Page 305

    C–Error/Exit Return Codes SN0054614-00 K C-13 264 Reserved Not used 265 Reserved Not used 266 Reserved Not used 267 Reserved Not used 268 Reserved Not used 269 Reserved Not used 270 ERROR_ADAPTER_PROP_MISSING Adapter property file is missing 271 Reserved Not used 272 Reserved Not used 273 Reserved Not used 274 Reserved Not used 275 Reserved Not u[...]

  • Page 306

    C–Error/Exit Return Codes C-14 SN0054614-00 K 288 Reserved Not used 289 Reserved Not used 290 Reserved Not used 291 ERROR_VIRTUAL _HBA_LO CKED vPort is currently locked 292 ERROR_VPORT_NOT_BELONG_T O_ PPORT vPort does not belong to the physical port 293 ERROR_DUPLICA TE_WWPN_VIRTUAL_ HBA Found duplicat e vPort WWPN 294 Reserved Not used 295 Reser[...]

  • Page 307

    C–Error/Exit Return Codes SN0054614-00 K C-15 312 ERROR_GET_MENLO_ETH_MONITORING Failed to quer y FCoE Ethernet port st atis- tics 313 ERROR_GET_MENLO_FC_MONITORING Failed to query FCoE FC port statistics 314 ERROR_GET_MENLO_NSL_MONIT ORING Failed to query FCoE NSL port st atistics 315 ERROR_CORRUPTED_LOG_DA T A FCoE lo g data seems to be corrup [...]

  • Page 308

    C–Error/Exit Return Codes C-16 SN0054614-00 K 335 Reserved Not used 336 Reserved Not used 337 Reserved Not used 338 Reserved Not used 339 Reserved Not used 340 ERROR_GET_UDEV_NAME Unable to query udev persistent device name 341 ERROR_DISPLA Y_LUN_PERSISTENT_ NAME Error displaying udev persistent device name of the specified LUN 342 ERROR_SET_LUN_[...]

  • Page 309

    C–Error/Exit Return Codes SN0054614-00 K C-17 356 Reserved Not used 357 Reserved Not used 358 Reserved Not used 359 Reserved Not used 360 ERROR_FW_SERDES_UPDA TE_F AILURE Unable to update firmware SerDes t able on the specified adapter 361 ERROR_FW_SERDES_SA VE_F A ILURE Unable to save current ad apter firmware serdes tab le to a DA T file 362 Re[...]

  • Page 310

    C–Error/Exit Return Codes C-18 SN0054614-00 K 378 ERROR_QOS_PERCENT AGE_OVERFLOW Failed to apply changes on selected port (QoS bandwidth over flow) 379 ERROR_VPORT_DISABLE_ QOS_SETTING Failed to apply ch anges on selected port (QoS settings is currently disabled) 380 ERROR_VPORT_LOC K_QOS_SETTING Failed to ap ply changes on selected port (QoS set[...]

  • Page 311

    C–Error/Exit Return Codes SN0054614-00 K C-19 449 Reserved Not used 450 ERROR_IL T_SIGNA TURE_MISMA TCH The image layout tab le (IL T) signature does not match 451 ERROR_INCORRECT_FCOE_FLASH_ IMAGE Unable to find an adap ter that matches with the Flash image 452 ERROR_V ALIDA TE_FCOE_FLASH_IMAGE Failed to verify Flash image 453 ERROR_MOD IFY_FCOE[...]

  • Page 312

    C–Error/Exit Return Codes C-20 SN0054614-00 K 473 Reserved Not used 474 Reserved Not used 475 Reserved Not used 476 Reserved Not used 477 Reserved Not used 478 Reserved Not used 479 Reserved Not used 480 ERROR_GET_DCBX_P AR AMETERS Failed to get DCBX TL V T able C-1. Error/Exit Return Codes (Continued) Return Code Name Description[...]

  • Page 313

    SN0054614-00 K D-1 D Help Commands T able D-2 is an alphabetic listing of the Help commands. Unless otherwise noted, only one command line option per input file is valid. The hyphen ( - ) and slash ( / ) characters are equivalent. For example, scl i -g and scli /g are both valid commands. T able D-1 describes each variable used in t he command line[...]

  • Page 314

    D–Help Commands D-2 SN0054614-00 K <target wwpn> World wide port nam e of a target device. ( xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx ). <vport hex> Worl d wide port name of the virt ual po rt with the two hexadeci- mal digits in byte three suppli ed by the user . <vport wwpn> World wide port nam e of a virtual port. T able D-2[...]

  • Page 315

    D–Help Commands SN0054614-00 K D-3 –d <file n ame > Performs a driver update to the adapters. <file name> is the full path o f the driver file in inf/zip or exe format. –dm ( <hba instance> | <hba wwpn> | <all> ) general | ge n | details | det Runs a tran sceiver (SFF /SFP) diag nostics on an adapter port and sho[...]

  • Page 316

    D–Help Commands D-4 SN0054614-00 K –e ( <hba instance> | <hba wwpn> <target wwnn> <target wwpn> <lun id> [ prim | alt1 | alt2 | alt3] Configures the operating system to boo t from a specific targe t:  prim : Primary Boot Port Name  alt1 : Alternate 1 Boot Port Name  alt2 : Alternate 2 Boot Port Name  al[...]

  • Page 317

    D–Help Commands SN0054614-00 K D-5 –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 adapter [...]

  • Page 318

    D–Help Commands D-6 SN0054614-00 K –ls ( <hba instance> | <hba wwpn> ) { ( <param name> | <param alias> ) <param value> } Shows the current link status on an adapte r port. –m ( <hba instan ce> | <hba wwpn> ) ( view | ? ) Views selective LUN information of all devices att ached to an adapter port. –[...]

  • Page 319

    D–Help Commands SN0054614-00 K D-7 –p ( <hba instance> | <hba wwpn> ) { <target wwnn> <target wwpn> <target portid> <target id> } Binds the selected device(s) att ached to an adapter port. –p ( <hba instan ce> | <hba wwpn> ) remove <target wwnn> | unbind <target wwnn> Unbinds a speci[...]

  • Page 320

    D–Help Commands D-8 SN0054614-00 K –q ( <hba instance> | <hba wwpn> | <all> ) [ –targets | –t ] Shows the current iiDMA settings of all t ar- gets on an ad apter port or all adapters. -qos <hba instance>|<hba wwpn> info --vp <all> [--spd|--per] Shows current QoS settings for all virtual ports on a physica[...]

  • Page 321

    D–Help Commands SN0054614-00 K D-9 -u ( <hba instan ce> | <hba wwpn> ) save <file name> Saves the current a dapter firmware preload area to a DAT file. –v — Shows the current version. –vp ( <hba instance> | <hba wwpn> ) create <vport hex> Creates a virtual port with your own WWPN. –vp ( <hba instance[...]

  • Page 322

    D–Help Commands D-10 SN0054614-00 K Notes[...]

  • Page 323

    SN0054614-00 K Glossary-1 Glossary adapter The board that interfaces between the host system and the t arget devices. Adapter is synonymous with host bus adapter (HBA) , host channel adapter (HCA) , host adapter , and adapter board . adapter alias A user-defined name for an adapter . adapter port A port on the adapter board. adapter port alias A us[...]

  • Page 324

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-2 SN0054614-00 K boot device The device, usually the hard disk, that contains the operating system th e BIOS uses to boot from when the computer is started. cache A temporary high-speed storage (memory) area where recently used or freque ntly [...]

  • Page 325

    SN0054614-00 K Glossary-3 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters DCB Data center bridging. Provides enh ance- ments to existin g 802.1 bridge specifica- tions to satisfy the requiremen ts of protocols and applicatio ns in the dat a center . Because existing high-perfor- mance data centers ty[...]

  • Page 326

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-4 SN0054614-00 K fabric loop port See FL_Port . fabric port See F_Port . fabric switch Also, switched fabric . A fabric switch connects multip le devices from indepen- dent FC-arbitrated loops (FC-ALs) and point-to-point topologies into a fabr[...]

  • Page 327

    SN0054614-00 K Glossary-5 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters input/output control See IOCTL . intelligent interleaved direct memory access See iiDMA . inter-switch link See ISL . IOCTL Input/output control. A system call in UNIX/Linux systems. Allows an application to control or communic[...]

  • Page 328

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-6 SN0054614-00 K Using LUNs, the FC host can address multiple peripheral devices that may share a common controller . LUN masking A software featu re that assigns LUNs to specific servers or hides LUNs from specific servers for maximum access [...]

  • Page 329

    SN0054614-00 K Glossary-7 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters other NL_Ports in virtual point-to-point links through an FC_AL open loop circuit often through FC_AL (arbitrated loop) open loop circuit of ten through FC-AL hub or loop switch devices. See: E_Port , F_Port , FL_Port , G_Port [...]

  • Page 330

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-8 SN0054614-00 K port inst ance The number of the port in the system. Each adapter may have one or multiple ports, identified with regard to the adapter as port 0, port 1 and so forth. to avoid confusion when dealing with a system containing n[...]

  • Page 331

    SN0054614-00 K Glossary-9 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters TL V T ype-length-value (TL V) is optional infor- mation that may be encoded as an element inside the protocol. The type and length fields are fixed in size (typically 1 to 4 bytes), and the value field is of variable size. The[...]

  • Page 332

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Glossary-10 SN0054614-00 K Notes[...]

  • Page 333

    SN0054614-00 K Index-1 Index Numerics 1 bit serial loopback test 3-82 10 bit internal loopback test 3-82 A -a 3-75 , 4-6 abort changes to adapter p arameters 3-32 about the product 3-121 adapter alias defining 4-6 , A-15 , B-18 definition of Glossary-1 setting and deleting 4-19 showing 3-21 adapter information viewing 3-19 , 3-21 , 4-2 , 4-20 , A-5[...]

  • Page 334

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-2 SN0054614-00 K AL_P A definition of Glossary-1 in adapter parameter templa te 3-66 AL, definition of Glossary-1 alias adapter information 3-21 adapter port 3-22 adapter , defining 4-6 , A-15 API library , SDM 3-5 arbitrated loop, definition of [...]

  • Page 335

    SN0054614-00 K In dex-3 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters commands ( continued ) -a 3-75 , 4-6 -b 3-10 , 3-65 , 4-7 -c 3-21 , 3-26 , 4-8 , A-4 , B-4 -cna 3-108 , 4-8 -d 3-69 , 4-10 -dm 3-76 , 3-85 , 4-10 , A-16 , B-20 -e 3-60 , 4-1 1 , A-9 , B-10 -ei 4-13 , C-1 -f 4-13 -fcoe 4-14 -fg 3-[...]

  • Page 336

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-4 SN0054614-00 K current settings adapter statistics 3-91 link status 3-94 customer support xviii D -d 3-69 , 4-10 data pattern p arameter 4-21 size parame ter 4-23 vital product (VPD) 3-23 data center bridging, See DCB data center bridging excha[...]

  • Page 337

    SN0054614-00 K In dex-5 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters -dm 3-76 , 3-85 , 4-10 , A-16 , B-20 documentatio n conventions used in guide xvi related xvii revision history ii DP parameter 4-21 , 4-30 driver definition of Glossary-3 IOCTL 3-5 rescanning 3-72 settings, configuring 3-62 , 4-[...]

  • Page 338

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-6 SN0054614-00 K FCoE adapter information 3-1 12 data center bridging 3-1 12 TL V , viewing 3-1 18 Utilities menu for QLE80xx 3-10 8 Utilities menu for QLx81xx 3-1 1 1 -fcoe 4-14 FCoE, definition of Glossary-4 FCoE engine adapter para meters 3-33[...]

  • Page 339

    SN0054614-00 K In dex-7 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters hard loop ID configuring 3-26 enabling 4-36 specifying 3-29 HardLoopID parameter 4-36 hardware requirement s 1-4 HBA, See adapter help about the product 3-121 file, viewing 4-19 Help Menu 3-120 host configuration, refreshing 3-19[...]

  • Page 340

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-8 SN0054614-00 K J JBOD (just a bunch of disks), definition of Glossary-5 K -kl 3-76 , 3-77 , 4-20 , 4-24 , A-9 , B-1 1 -kr 3-76 , 3-83 , 4-27 , 4-28 , A-10 , B-12 L -l 3-21 , 3-36 , 4-5 , 4-32 , A-7 , B-8 L_Port, definition of Glossary-5 L1 cach[...]

  • Page 341

    SN0054614-00 K In dex-9 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters LoopbackT ype parameter 4-24 loop-only connection 3-28 -ls 3-89 , 3-93 , 4-32 , A-14 , B-16 L T parameter 4-24 LUN masking, definition of Glossary-6 LUNs configuration, displaying 3-58 configuring automatically 3-59 configuring m[...]

  • Page 342

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-10 SN0054614-00 K non-interactive mode ( continued ) starting 2-4 non-volatile random access memory , definition of Glossary-7 NPIV definition of Glossary-7 Virtual Menu option 3-97 number of tests p arameter 4-23 , 4-30 NVRAM, definition of Glos[...]

  • Page 343

    SN0054614-00 K Index-1 1 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters port ( continued ) listing 3-99 quality of service 4-43 user-generated 3-100 port alias creating, editing, deleting 3-22 , 4-40 XML Format 1 A-15 port down retry count 3-26 , 3-31 PortDownRetryCount paramete r 4-36 preface to gu[...]

  • Page 344

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-12 SN0054614-00 K SANsurfer FC HBA CLI ( continued ) software requireme nts 1-5 supported QLogic adapters 1-2 saving adapter para meters 3-66 configuration 3-62 Fcode 4-7 firmware area 3-74 , 4-46 firmware preload ta ble 3-70 Flash BIOS 4-7 Flash[...]

  • Page 345

    SN0054614-00 K Index-13 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters target beacon, st arting and stopping 4-46 binding 3-57 binding info, viewing 4-38 binding, definition of Glossary- 8 definition of Glossary-8 ID 4-6 ID, Solaris 4-12 link speed, setting and viewing 4-42 list 3-37 locating (beaco[...]

  • Page 346

    SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for Q Log ic FC and FCoE Adapters Index-14 SN0054614-00 K uninstall Linux 1-22 Macintosh 1-24 Solaris SP ARC 8, 9, and 10 1-22 Solaris x86 8, 9, and 10 1-23 VMware 1-24 Windows 1-21 unknown adapter types 1-2 unsupported adapters 1-2 unsupported features 1-5 updating adapter para meter [...]

  • Page 347

    SN0054614-00 K Index-15 SANsurfer FC/CNA HBA CLI User ’s Guide Command Line Interface for QLogic FC and FCoE Ad apters world wide node name, See WWNN world wide port name, See WWPN WWNN definition of Glossary-9 notation fo r 2-4 WWPN bind by WWPN parameter 4-17 definition of Glossary-9 notation fo r 2-4 X -x 3-10 , 4-5 , 4-48 -x1 A-1 -x2 3-10 , 4[...]

  • Page 348

    © 2004–2009 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic, the QLogic logo, QLA, and SANsurfer are register ed trademarks of QLogic Cor poration. Apple, Finder , Mac OS, Macintosh, Power Mac, Panther , Tiger , and Safari are registe red trademarks of Ap ple, Inc. AMD is a r egister[...]