sasinfo(1m) - osol9

1sasinfo(1M)             System Administration Commands             sasinfo(1M)
2
3
4

NAME

6       sasinfo - Serial Attached SCSI HBA port command line interface
7

SYNOPSIS

9       sasinfo hba [-v] [HBA_Name]...
10
11
12       sasinfo hba-port [-lvy] [-a HBA_Name] [HBA_port_nam]...
13
14
15       sasinfo expander [-vt] [-p HBA_port_Name] [Expander_SAS_Addr]...
16
17
18       sasinfo target-port [-s | -v] [Target_port_SAS_Addr]...
19
20
21       sasinfo logical-unit | lu [-v] [device_path]...
22
23
24       sasinfo [-V]
25
26
27       sasinfo [-?]
28
29

DESCRIPTION

31       The  sasinfo utility is a command line interface that collects adminis‐
32       trative information on Serial Attached SCSI-2 (SAS-2) host bus  adapter
33       (HBA)  that supports the Storage Management HBA API (SM-HBA). The util‐
34       ity reports attributes of HBA ports and of expander  devices  and  SCSI
35       target devices that might be connected to those HBA ports.
36
37
38       sasinfo is implemented as a set of subcommands, described below.
39

SUB-COMMANDS

41       The following subcommands are supported by sasinfo.
42
43       hba
44
45           Lists information for the HBA referenced by the specified HBA_name.
46           If HBA_name is not specified, all HBAs on the host will be listed.
47
48
49       hba-port
50
51           Lists information for the HBA  port  referenced  by  the  specified
52           HBA_port_Name.  If HBA_port_Name is not specified, all HBA ports on
53           the host will be listed. Note that HBA  ports  can  be  dynamically
54           configured/unconfigured  so  that the number of HBA ports on an HBA
55           can change as connections to target devices are  established.  With
56           no connections to a storage device, no HBA port is configured.
57
58
59       expander
60
61           Lists hierarchical view of the expander referenced by the specified
62           Expander_SAS_Addr. If no argument is specified, all expanders  that
63           are visible across all HBA ports on the host will be listed.
64
65
66       target-port
67
68           Lists  information  for  those  target  ports  referenced  by  Tar‐
69           get_port_SAS_Addr address. If no argument is specified, all  target
70           ports that are visible on the host will be listed.
71
72
73       logical-unit | lu
74
75           Lists  the logical unit referenced by the specified device_path. If
76           device_path is not specified, all SAS logical units will be listed,
77           including the SAS Management Protocol (SMP) target port.
78
79

OPTIONS

81       The following options are supported.
82
83       -?, --help
84
85           Displays usage information
86
87
88       -a, --hba HBA_Name
89
90           Retrieve  HBA  port  information from the HBA_Name of an HBA on the
91           host. The -a option can only be used with the hba-port subcommand.
92
93
94       -l, --phy-linkstat
95
96           Lists the link error statistics information for the phys on the HBA
97           port  referenced by the specified HBA_port_Name or all HBA ports if
98           no HBA port is specified. This option is used only  with  the  hba-
99           port subcommand.
100
101
102       -p HBA_port_SAS_Addr, --port HBA_port_SAS_Addr
103
104           Retrieve  remote port information from the HBA_port_SAS_Addr of the
105           local HBA port on the host. The -p option can be used only with the
106           expander subcommand.
107
108
109       -s, --scsi
110
111           Lists  SCSI attributes for target ports that are requested for dis‐
112           play. This option is only used for the target-port subcommand.
113
114
115       -v, --verbose
116
117           Display details on  hardware  information,  such  as  SAS  address,
118           topology  device,  and  so  forth,  based  on  which  subcommand is
119           invoked.
120
121
122       -V, --version
123
124           Displays the version information.
125
126
127       -y, --phy
128
129           Lists  the  phy  information  on  the   HBA   port   specified   by
130           HBA_port_Name  or  all  HBA ports if no HBA port is specified. This
131           option is used only with the hba-port subcommand.
132
133

EXAMPLES

135       Example 1 Listing All HBAs
136
137
138       The following command lists all HBAs on the host.
139
140
141         # sasinfo hba
142         HBA Name: SUNW-pmcs-0
143         HBA Name: SUNW-pmcs-1
144
145
146
147       Example 2 Listing All HBAs with Details
148
149
150       The following command lists all HBAs on the host,  along  with  related
151       details. Note that each HBA has two HBA ports configured, with each HBA
152       port connected to a storage device.
153
154
155         # sasinfo hba -v
156         HBA Name: SUNW-pmcs-0
157             Manufacturer: sun
158             Model: SAS Gen-2
159             Firmware Version: 1.1
160             FCode/BIOS Version: 1.1
161             Serial Number: 111-11111
162             Driver Name: smvsl
163             Driver Version: 1.1
164             Number of HBA Ports: 2
165         HBA Name: SUNW-pmcs-1
166             Manufacturer: sun
167             Model: SAS Gen-2
168             Firmware Version: 1.1
169             FCode/BIOS Version: 1.1
170             Serial Number: 111-11111
171             Driver Name: smvsl
172             Driver Version: 1.1
173             Number of HBA Ports: 2
174
175
176
177       Example 3 Listing All HBA Ports
178
179
180       The following command lists all HBA ports on the host.
181
182
183         # sasinfo hba-port
184         HBA Name: SUNW-pmcs-0
185             HBA Port Name: /dev/cfg/c1
186             HBA Port Name: /dev/cfg/c2
187         HBA Name: SUNW-pmcs-1
188             HBA Port Name: /dev/cfg/c3
189             HBA Port Name: /dev/cfg/c4
190
191
192
193       Example 4 Listing all HBA Ports with Details
194
195
196       The following command lists all HBA ports, with accompanying details.
197
198
199         # sasinfo hba-port -v
200         HBA Name: SUNW-pmcs-0
201             HBA Port Name: /dev/cfg/c1
202                 Type: sas-device
203                 State: online
204                 Local SAS Address: 5000c50000d756aa
205                 Attached Port SAS Address: 50800201a5a502bf
206                 Number of Phys: 4
207             HBA Port Name: /dev/cfg/c25000c50000d756cc
208                 Type: sas-device
209                 State: online
210                 Local SAS Address: 5000c50000d756aa
211                 Attached Port SAS Address: 50800201a5a503bf
212                 Number of Phys: 4
213         HBA Name: SUNW-pmcs-1
214             HBA Port Name: /dev/cfg/c3
215                 Type: sas-device
216                 State: online
217                 Local SAS Address: 5000c50000d756cc
218                 Attached Port SAS Address: 50800201a5a504bf
219                 Number of Phys: 4
220             HBA Port Name: /dev/cfg/c4
221                 Type: sas-device
222                 State: online
223                 Local SAS Address: 5000c50000d756cc
224                 Attached Port SAS Address: 50800201a5a505bf
225                 Number of Phys: 4
226
227
228
229       Example 5 Listing phy Information for All HBA Ports
230
231
232       The following command lists phy information for all HBA ports.
233
234
235         # sasinfo hba-port -y
236         HBA Name: SUNW-pmcs-0
237             HBA Port Name: /dev/cfg/c1
238                 Phy Information:
239                  Identifier: 0
240                    State: enabled
241                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
242                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
243                    NegotiatedLinkRate: 3Gbit
244                  Identifier: 1
245                    State: enabled
246                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
247                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
248                    NegotiatedLinkRate: 3Gbit
249                  Identifier: 2
250                    State: enabled
251                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
252                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
253                    NegotiatedLinkRate: 3Gbit
254                  Identifier: 3
255                    State: enabled
256                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
257                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
258                    NegotiatedLinkRate: 3Gbit
259             HBA Port Name: /dev/cfg/c2
260                 Phy Information:
261                  Identifier: 4
262                    State: enabled
263                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
264                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
265                    NegotiatedLinkRate: 3Gbit
266                  Identifier: 5
267                    State: enabled
268                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
269                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
270                    NegotiatedLinkRate: 3Gbit
271                 Identifier: 6
272                    State: enabled
273                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
274                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
275                    NegotiatedLinkRate: 3Gbit
276                 Identifier: 7
277                    State: enabled
278                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
279                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
280                    NegotiatedLinkRate: 3Gbit
281         HBA Name: SUNW-pmcs-1
282             HBA Port Name: /dev/cfg/c3
283                 Phy Information:
284                  Identifier: 0
285                    State: enabled
286                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
287                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
288                    NegotiatedLinkRate: 3Gbit
289                  Identifier: 1
290                    State: enabled
291                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
292                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
293                    NegotiatedLinkRate: 3Gbit
294                  Identifier: 2
295                    State: enabled
296                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
297                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
298                    NegotiatedLinkRate: 3Gbit
299                  Identifier: 3
300                    State: enabled
301                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
302                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
303                    NegotiatedLinkRate: 3Gbit
304             HBA Port Name: /dev/cfg/c4
305                 Phy Information:
306                  Identifier: 4
307                    State: enabled
308                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
309                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
310                    NegotiatedLinkRate: 3Gbit
311                  Identifier: 5
312                    State: enabled
313                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
314                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
315                    NegotiatedLinkRate: 3Gbit
316                  Identifier: 6
317                    State: enabled
318                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
319                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
320                    NegotiatedLinkRate: 3Gbit
321                  Identifier: 7
322                    State: enabled
323                    HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
324                    ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
325                    NegotiatedLinkRate: 3Gbit
326
327
328
329       Example 6 Listing phy Link Error Statistics for a Specific HBA Port
330
331
332       The following command lists phy link error statistics for a  particular
333       port.
334
335
336         # sasinfo hba-port -ly /dev/cfg/c1
337         HBA Name: SUNW-pmcs-0
338           HBA Port Name: /dev/cfg/c1
339             Phy Information:
340               Identifier: 0
341                State: enabled
342                  HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
343                  ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
344                  NegotiatedLinkRate: 3Gbit
345                  Link Error Statistics:
346                    Invalid Dword: 0
347                    Running Disparity Error: 0
348                    Loss of Dword Sync: 0
349                    Reset Problem: 0
350               Identifier: 1
351                  State: enabled
352                  HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
353                  ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
354                  NegotiatedLinkRate: 3Gbit
355                  Link Error Statistics:
356                    Invalid Dword: 0
357                    Running Disparity Error: 0
358                    Loss of Dword Sync: 0
359                    Reset Problem: 0
360                Identifier: 2
361                   State: enabled
362                   HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
363                   ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
364                   NegotiatedLinkRate: 3Gbit
365                   Link Error Statistics:
366                     Invalid Dword: 0
367                     Running Disparity Error: 0
368                     Loss of Dword Sync: 0
369                     Reset Problem: 0
370                Identifier: 3
371                   State: enabled
372                   HardwareLinkRate(Min/Max): 1.5Gbit/3Gbit
373                   ProgrammedLinkRate(Min/Max): 1.5Gbit/3Gbit
374                   NegotiatedLinkRate: 3Gbit
375                   Link Error Statistics:
376                     Invalid Dword: 0
377                     Running Disparity Error: 0
378                     Loss of Dword Sync: 0
379                     Reset Problem: 0
380
381
382
383       Example 7 Listing Expanders Connected to an HBA Port
384
385
386       The  following command lists all expanders that are visible through the
387       specified HBA port.
388
389
390         # sasinfo expander -p /dev/cfg/c1
391         HBA Name: SUNW-pmcs-0
392           HBA Port Name: /dev/cfg/c1
393             Expander SAS Address(Tier 1): 50800201a5a502bf
394                Expander SAS Address(Tier 2): 50800201a5a50233
395                Expander SAS Address(Tier 2); 5000c5000d2da812
396             Expander SAS Address(Tier 1): 50800201a5a503bf
397                Expander SAS Address(Tier 2): 50800201a5a502d2
398                Expander SAS Address(Tier 2); 5000c5000d2da823
399
400
401
402       Example 8 Listing Detailed Information on Expanders
403
404
405       The following command lists detailed information on all expanders  that
406       are visible through the specified HBA port.
407
408
409         # sasinfo expander -v -p /dev/cfg/c1
410         HBA Name: SUNW-pmcs-0
411           HBA Port Name: /dev/cfg/c1
412             Expander SAS Address(Tier 1): 50800201a5a502bf
413               OS Device Name: /dev/smp/expd0
414               State: online
415                 Expander SAS Address(Tier 2): 50800201a5a50233
416                   OS Device Name: /dev/smp/expd2
417                   State: online
418                 Expander SAS Address(Tier 2); 5000c5000d2da812
419                   OS Device Name: /dev/smp/expd3
420                   State: online
421             Expander SAS Address(Tier 1): 50800201a5a503bf
422               OS Device Name: /dev/smp/expd1
423               State: online
424                 Expander SAS Address(Tier 2): 50800201a5a502d2
425                   OS Device Name: /dev/smp/expd3
426                   State: online
427                 Expander SAS Address(Tier 2); 5000c5000d2da823
428                   OS Device Name: /dev/smp/expd4
429                   State: online
430
431
432
433       Example 9 Listing Target Ports Attached to Expanders
434
435
436       The  following  command  lists  all  target  ports that are attached to
437       expanders connected to a specified HBA port.
438
439
440         # sasinfo expander -t -p /dev/cfg/c1
441         HBA Name: SUNW-pmcs-0
442           HBA Port Name: /dev/cfg/c1
443              Expander SAS Address(Tier 1): 50800201a5a502bf
444                Target Port SAS Address: 50800201a5a504f1
445                   Expander SAS Address(Tier 2): 50800201a5a50233
446                     Target Port SAS Address: 50800201a5a502be
447                     Target Port SAS Address: 5000c5000d2da8b2
448                   Expander SAS Address(Tier 2); 5000c5000d2da812
449                     Target Port SAS Address: 50800201a5a502be
450                     Target Port SAS Address: 50800201a5a508b2
451              Expander SAS Address(Tier 1): 50800201a5a503bf
452                Target Port SAS Address: 50800201a5a50421
453                   Expander SAS Address(Tier 2): 50800201a5a502d2
454                     Target Port SAS Address: 50800201a5a503be
455                     Target Port SAS Address: 5000c5000d2da7be
456                   Expander SAS Address(Tier 2); 5000c5000d2da823
457                     Target Port SAS Address: 50800201a5a503be
458                     Target Port SAS Address: 5000c5000d2da7be
459
460
461
462       Example 10 Listing Target Port Information
463
464
465       The following command lists all target ports discovered on the host.
466
467
468         # sasinfo target-port
469         Target Port SAS Address: 5000c5000bae4009
470         Target Port SAS Address: 5000c5000baef4b1
471         Target Port SAS Address: 5000c5000bae3fe1
472         Target Port SAS Address: 5000c5000bae49d9
473         Target Port SAS Address: 5000c5000bae36c5
474
475
476
477       Example 11 Listing Target Port Information with Topology Details
478
479
480       The following command lists all target ports  with  the  HBA  port  and
481       expander that they are connected to.
482
483
484         # sasinfo target-port -v
485         Target Port SAS Address: 5000c5000bae4009
486           Type: SAS Device
487           HBA Port Name: /dev/cfg/c7
488             Expander Device SAS Address: 500e004aaaaaaa3f
489           HBA Port Name: /dev/cfg/c5
490             Expander Device SAS Address: 500e004aaaaaaa3f
491         Target Port SAS Address: 5000c5000baef4b1
492           Type: SAS Device
493           HBA Port Name: /dev/cfg/c7
494             Expander Device SAS Address: 500e004aaaaaaa3f
495           HBA Port Name: /dev/cfg/c5
496             Expander Device SAS Address: 500e004aaaaaaa3f
497         Target Port SAS Address: 5000c5000bae3fe1
498           Type: SAS Device
499           HBA Port Name: /dev/cfg/c7
500             Expander Device SAS Address: 500e004aaaaaaa3f
501           HBA Port Name: /dev/cfg/c5
502             Expander Device SAS Address: 500e004aaaaaaa3f
503         Target Port SAS Address: 5000c5000bae49d9
504           Type: SAS Device
505           HBA Port Name: /dev/cfg/c7
506             Expander Device SAS Address: 500e004aaaaaaa3f
507           HBA Port Name: /dev/cfg/c5
508             Expander Device SAS Address: 500e004aaaaaaa3f
509         Target Port SAS Address: 5000c5000bae36c5
510           Type: SAS Device
511           HBA Port Name: /dev/cfg/c7
512             Expander Device SAS Address: 500e004aaaaaaa3f
513           HBA Port Name: /dev/cfg/c5
514             Expander Device SAS Address: 500e004aaaaaaa3f
515
516
517
518       Example 12 Listing Target Ports with SCSI Information
519
520
521       The  following  command  lists  all target port details, including SCSI
522       information for each target port.
523
524
525         # sasinfo target-port -s 5000c5000bae4009
526         Target Port SAS Address: 5000c5000bae4009
527            Type: SAS Device
528                 HBA Port Name: /dev/cfg/c7
529                     Expander Device SAS Address: 500e004aaaaaaa3f
530                         LUN : 0
531                           OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2
532                           Vendor:   Sun
533                           Product:  J4400
534                           Device Type: Disk
535                 HBA Port Name: /dev/cfg/c5
536                     Expander Device SAS Address: 500e004aaaaaaa3f
537                         LUN : 0
538                           OS Device Name : /dev/rdsk/c6t5000C5000BAE400Bd0s2
539                           Vendor:   Sun
540                           Product:  J4400
541                           Device Type: Disk
542
543
544
545       Example 13 Listing the Logical Units
546
547
548       The following command lists the logical units on a host.
549
550
551         # sasinfo logical-unit
552         OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
553         OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2
554
555
556
557       Example 14 Listing Additional Information on Logical Units
558
559
560       The following command displays  additional  logical  unit   information
561       using the -v option for device /dev/rmt/On.
562
563
564         # sasinfo lu -v
565         OS Device Name: /dev/rdsk/c4t50020F2300B4904Ed0s2
566            HBA Port Name: /dev/cfg/c1
567              Target Port SAS Address: 50020f2300b4904e
568                 LUN: 0
569            Vendor: Sun
570            Product: J4400
571            Device Type: Disk
572         OS Device Name: /dev/rdsk/c4t50020F230000B4AFd0s2
573            HBA Port Name: /dev/cfg/c1
574              Target Port SAS Address: 50020f230063100b
575                 LUN: 0
576            Vendor: Sun
577            Product: J4400
578            Device Type: Disk
579
580
581

ATTRIBUTES

583       See attributes(5) for descriptions of the following attributes:
584
585
586
587
588       ┌─────────────────────────────┬─────────────────────────────┐
589       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
590       ├─────────────────────────────┼─────────────────────────────┤
591       │Availability                 │SUNWsmhba                    │
592       ├─────────────────────────────┼─────────────────────────────┤
593       │Interface Stability          │Committed                    │
594       └─────────────────────────────┴─────────────────────────────┘
595