logo

Manual Pages


Table of Contents

NAME

na_sasadmin - Commands for managing Serial Attached SCSI (SAS) adapters.

SYNOPSIS

sasadmin command argument ...

OVERVIEW

The sasadmin utility commands manage the SAS adapters and expanders used by the storage subsystem. These commands show SAS channels, information about attached expanders or disk shelves, expander and adapter phy (transceiver) states and the status of disk drives.

USAGE

sasadmin
[dev_stats|adapter_state|expander_map|shelf|shelf_short] [<adapter_name>]

sasadmin expander <adapter_name>[.<shelf_id>]

sasadmin expander_phy_state [<adapter_name>[.<shelf_id>]]

SAS DEVICE NAMING CONVENTION

Following is the convention used to name devices in a SAS domain.

End devices are named using the concatenated form <adapter_name>.<shelf_id>.<bay_id>, where

adapter_name: An adapter name of the form Xy, where X is a number and y is a letter (for example, 0c or 0d).

shelf_id: A number between 0 through 99. This number corresponds to the thumbwheel setting in the front of the disk shelf or controller (sometimes referred to as "filer" or "appliance"). If no thumbwheel is present, 0 is used. In the cases where the disk shelf ID is either not assigned or unavailable, the serial number of the disk shelf is used instead.

bay_id: The physical bay number where the disk drive is located. Bays are numbered from left to right, top to bottom, starting with 0. Therefore, bay 0 is the top left slot of the disk shelf.

Examples device names:

0c.5.19 would be the device in bay number 19 of disk shelf number 5 attached to the adapter 0c.

0d.449292.19 would be the device in bay number 19 of disk shelf with the serial number 449292 attached to the adapter 0d.

DESCRIPTION

sasadmin dev_stats [<adapter_name>]
The sasadmin dev_stats command displays various statistics associated with disk drives connected to SAS channels in the controller.
  filer> sasadmin dev_stats 0c

  Device stats on channel 0c:
                                                                  SCSI                SATA
           Cmds   Cmds                                       Trns Ptcl CRC            Init TO TO TO TO TO TO
           Cmplt  Cmplt  Frames  Frames  Vctm Qsce Udrn Ovrn Err  Err  Err  Invd Dlay Fail 1  2  3  4  5  6
  Device   Good   Error  In      Out     Abrt Cnt  Cnt  Cnt  Cnt  Cnt  Cnt  Cnt  Cnt  Cnt  Ct Ct Ct Ct Ct Ct
  -------- ------ ------ ------- ------- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- -- -- -- -- -- --
  0c.00.0  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.1  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.2  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.3  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.4  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.5  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.6  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.7  244912 4      244923  245112  1    0    1    0    0    1    0    0    1    1    0  0  0  0  0  0
  0c.00.8  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.9  74     2      83      218     0    0    1    0    0    0    0    1    0    1    0  0  0  0  0  0
  0c.00.10 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.11 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.12 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.13 244912 4      244923  245112  1    0    1    0    0    1    0    0    1    1    0  0  0  0  0  0
  0c.00.14 244911 4      244922  245111  1    0    1    0    0    1    0    0    1    1    0  0  0  0  0  0
  0c.00.15 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.16 244912 4      244923  245112  1    0    1    0    0    1    0    0    1    1    0  0  0  0  0  0
  0c.00.17 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.18 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.19 74     2      83      218     0    0    1    0    0    0    0    2    0    0    0  0  0  0  0  0
  0c.00.99 13984  1      15522   15522   0    0    3    0    0    0    0    0    0    0    0  0  0  0  0  0

For the definition of the Device field, see "SAS DEVICE NAMING CONVENTION", above.

This command output contains one row for each drive in an enclosure.

The Cmds Cmplt Good column indicates the number of commands successfully completed at the disk drive.

The Cmds Cmplt Error column indicates the number of commands that were completed with an error condition at the disk drive.

The Frames In column refers to a rough estimate of CDB and data frames sent to the disk drive from Data ONTAP(R).

The Frames Out column refers to a rough estimate of Response and data frames sent from the drive to Data ONTAP(R).

The Vctm Abrt (victim abort) column refers to the number of commands that were issued for this driver, but were aborted.

The Qsce Cnt (quiesce count) column refers to the number of times commands were held back from being sent to the disk drive.

The Udrn Cnt (underrun count) column refers to the number of commands that were completed with a data underrun.

The Ovrn Cnt (overrun count) column refers to the number of commands that were completed with a data overrun.

The Trns Err Cnt (transport error count) column refers to the number of commands that encountered transport errors.

The SCSI Ptcl Err Cnt (SCSI protocol error count) column refers to the number of commands that encountered SCSI protocol errors.

The CRC Err Cnt (CRC error count) column refers to the number of commands that encountered parity errors.

The Invd Cnt (invalidate count) column refers to the number times the disk drive was not found on a device scan.

The Dlay Cnt (delay count) column refers to the number times commands were delayed in being sent to the disk drive.

The SATA Init Fail Cnt (SATA initialization failure count) column refers to the number times the SAS adapter firmware issued "SATA initialization command sequence" failed for the disk drive.

The TO 1 Ct (Timeout 1 count) column refers to the number of times a command had to be retried one time before succeeding.

The TO 2 Ct (Timeout 2 count) column refers to the number of times a command had to be retried two times before succeeding.

The TO 3 Ct (Timeout 3 count) column refers to the number of times a command had to be retried three times before succeeding.

The TO 4 Ct (Timeout 4 count) column refers to the number of times a command had to be retried four times before succeeding.

The TO 5 Ct (Timeout 5 count) column refers to the number of times a command had to be retried five times before succeeding.

The TO 6 Ct (Timeout 6 count) column refers to the number of times a command had to be retried six times before succeeding.

sasadmin adapter_state [<adapter_name>]
The sasadmin adapter_state command displays the state of a logical adapter and its phys. It displays the following information.

  filer> sasadmin adapter_state 0c
  State for adapter channel 0c: UP
                           Invald Disprt Loss   Phy    Phy
                           DWord  Error  Sync   Reset  Change
     PHY STATE             Count  Count  Count  Prob   Count
     --------------------------------------------------------
       0 3.0 Gb/s          0      0      0      0      0
       1 3.0 Gb/s          0      0      0      0      0
       2 3.0 Gb/s          0      0      0      0      0
       3 3.0 Gb/s          0      0      0      0      0

     Frames In                     : 1027453
     Frames Out                    : 1024493
     Command Completed successfully: 1022722
     Command Completed in error    : 49

The State for adapter channel field displays the adapter name and its current state, which is one of the following:

INITING:
This state is entered only upon system boot while internal structures are being initialized.

DOWN:
The channel is currently not functional. It could either be a result of the adapter being reset, or an adapter port has gone down.

UP:
The normal operating state, where the channel is connected and all phys in the channel are up.

UP (degraded):
The channel is up, but one or more of the constituent phys are not connected at the programmed maximum link rate.

OFFLINE (logical):
This state is entered upon user request. All devices are invalidated before entering this state. This state is not exited until a user manually requests that the adapter be brought online again.

OFFLINE (physical):
This state is entered when, after enabling the adapter, all the constituent phys fail to come up because the channel is not connected to any end device. User intervention is not required if the end devices are hot-plugged into this channel in this state.

ZOMBIFIED:
The entry into this state is only for a short time (typically 30 seconds) and the adapter is then automatically returned to the UP state. While the adapter is in this state, devices are not invalidated, they are held in a temporary state of suspended animation.

The PHY refers to the adapter physical phy number for which the state is displayed.

The STATE refers to the current state of the phy. Possible states are Rate unknown (Link up but link speed not known), Disabled (Phy disabled), Spd neg. fail (Speed negotiations between the expander and the host bus adapter [HBA] failed), SATA OOB fail (SATA out-of-band-signaling [OOB] sequence failed), 1.5 Gb/s (Link up at 1.5 Gb/s), 3.0 Gb/s (Link up at 3.0 Gb/s) and State unknown (Current state is none of the others).

The Invald DWord Count (invalid dword count) column refers to the number of invalid dwords seen (outside of the phy reset sequence) on this phy.

The Disprt Error Count (disparity error count) column refers to the number of dwords with a running disparity error seen (outside the phy reset sequence) on this phy.

The Loss Sync Count (loss of dword synchronization) column refers to the number of times the phy lost dword synchronization and restarted the link reset sequence of the phy reset sequence.

The Phy Reset Prob (phy reset problem count) column refers to the number of times the phy reset sequence failed.

The Phy Change Count column refers to the number of times the phy link status changed.

The Frames In field refers to a rough count of response frames and data frames received by the adapter.

The Frames Out field refers to a rough count of command frames and data frames transmitted by the adapter.

The Command Completed successfully field refers to the number of commands successfully executed by the adapter.

The Command Completed in error field refers to the number of commands executed by this adapter that resulted in an error.

sasadmin expander_map [<adapter_name>]
The sasadmin expander_map command displays the following product information about SAS expanders attached to SAS channels in the filer.

  filer> sasadmin expander_map

  Expanders on channel 0c:
  Level 1: WWN 500c0ff10a42633f, ID 0, Serial Number 0x000a4263, Product 'NA-2400-SM-SAS  ', Rev '0D04', Slot B

  Expanders on channel 0d:
  Level 1: WWN 500c0ff10a426f3f, ID 1, Serial Number 0x000a426f, Product 'NA-2400-SAS     ', Rev '0D04', Slot B
  Level 2: WWN 500c0ff10a42613f, ID 2, Serial Number 0x000a4261, Product 'NA-2400-SAS     ', Rev '0D04', Slot B
  Level 3: WWN 500c0ff10a41f03f, ID 3, Serial Number 0x000a41f0, Product 'NA-2400-SAS     ', Rev '0D04', Slot B
  Level 4: WWN 500c0ff10a42423f, ID 4, Serial Number 0x000a4242, Product 'NA-2400-SAS     ', Rev '0D04', Slot B

The Level field refers to the SAS topology level assigned by the first SAS adapter port that discovered the expander during SAS discovery.

The WWN field refers to the base SAS address of the expander.

The ID field identifies the disk shelf ID of the chassis enclosing the expander. For the definition of the disk shelf ID field, see "SAS DEVICE NAMING CONVENTION", above.

The Serial Number refers to the back plane serial number for the enclosure.

The Product displays the marketing name for the enclosure.

The Rev field identifies the expander firmware revision number.

The Slot field refers to the slot where the expander resides. The top module is termed Slot A and the bottom module is termed Slot B.

sasadmin shelf [<adapter_name>]
The sasadmin shelf command displays a pictorial representation of the drive population of a shelf.

  filer> sasadmin shelf 0c.0
  +-------------------------------------------------------------------------------+
  | SHELF ID:   0    SHELF SERIAL NUMBER: 000a4250                                |
  +-------------------+-------------------+-------------------+-------------------+
  |  0       3.0 Gb/s |  1       3.0 Gb/s |  2       3.0 Gb/s |  3       3.0 Gb/s |
  +-------------------+-------------------+-------------------+-------------------+
  |  4       3.0 Gb/s |  5       3.0 Gb/s |  6       3.0 Gb/s |  7       3.0 Gb/s |
  +-------------------+-------------------+-------------------+-------------------+
  |  8       3.0 Gb/s |  9       3.0 Gb/s | 10       3.0 Gb/s | 11       3.0 Gb/s |
  +-------------------+-------------------+-------------------+-------------------+
  | 12       3.0 Gb/s | 13       3.0 Gb/s | 14       3.0 Gb/s | 15       3.0 Gb/s |
  +-------------------+-------------------+-------------------+-------------------+
  | 16       3.0 Gb/s | 17       3.0 Gb/s | 18       3.0 Gb/s | 19       3.0 Gb/s |
  +-------------------+-------------------+-------------------+-------------------+

For the definition of the Shelf ID field, see "SAS DEVICE NAMING CONVENTION", above.

The SHELF SERIAL NUMBER field refers to the back plane serial number for the enclosure.

The output for this command, from second row downloads, corresponds to the actual physical drive layout, as seen from the front of the shelf. For each slot the leftmost field indicates the Bay ID of the slot, as defined in "SAS DEVICE NAMING CONVENTION", above, and the right-most field indicates the Phy state of the expander phy routed to that slot. For the definition of the Phy state field, see "STATE" under "sasadmin adapter_state", above.

sasadmin shelf_short [<adapter_name>]
The sasadmin shelf_short command displays the short form of the sasadmin shelf command above.

  filer> sasadmin shelf_short 0c.0
       +-------------------+
     0 |  0 |  1 |  2 |  3 |
       |  4 |  5 |  6 |  7 |
       |  8 |  9 | 10 | 11 |
       | 12 | 13 | 14 | 15 |
       | 16 | 17 | 18 | 19 |
       +-------------------+

The output for this command corresponds to the actual physical disk drive layout, as seen from the front of the disk shelf. For each slot the Bay ID is printed if the expander phy routed to the bay is up at 1.5 Gb/s or 3.0 Gb/s, "XX" is printed if the expander phy link rate is unknown, "DD" is printed if the expander phy is disabled and "FF" is printed if the expander phy failed SATA OOB or speed negotiations.

sasadmin expander_phy_state [<adapter_name>[.<shelf_id>]]

The sasadmin expander_phy_state command displays the state of expander phys. It displays the following information.

  filer> sasadmin expander_phy_state  0c.0
                                    Dngl     Pwr         Invald Disprt Loss   Phy    Phy    Phy
                            Dongle  FW   Pwr Ccl Rsv Rls DWord  Error  Sync   Reset  Change Change SATA
  PHY/BAY STATE             Type    Rev. ON  Cnt Cnt Cnt Count  Count  Count  Prob   Cnt H  Cnt S  Affiliation
  ------- ----------------- ------- ---- --- --- --- --- ------ ------ ------ ------ ------ ------ ----------------
   0/P0:0 3.0 Gb/s          ------- ---- --- --- --- --- 0      0      0      0      1      0      ----------------
   1/P0:1 3.0 Gb/s          ------- ---- --- --- --- --- 0      0      0      0      1      0      ----------------
   2/P0:2 3.0 Gb/s          ------- ---- --- --- --- --- 0      0      0      0      1      0      ----------------
   3/P0:3 3.0 Gb/s          ------- ---- --- --- --- --- 0      0      0      0      1      0      ----------------
   4/P1:0 Rate unknown
   5/P1:1 Rate unknown
   6/P1:2 Rate unknown
   7/P1:3 Rate unknown
   8/0    3.0 Gb/s          SPS3G   3    YES 0   0   0   13     12     1      0      2      0      f081053ef0000000
   9/1    3.0 Gb/s          SPS3G   3    YES 0   0   0   14     13     1      0      3      0      f081053ef0000000
  10/2    3.0 Gb/s          SPS3G   3    YES 0   0   0   14     14     1      0      3      0      f081053ef0000000
  11/3    3.0 Gb/s          SPS3G   3    YES 0   0   0   14     13     1      0      3      0      f081053ef0000000
  12/4    3.0 Gb/s          SPS3G   3    YES 0   0   0   14     13     1      0      3      0      f081053ef0000000
  13/5    3.0 Gb/s          SPS3G   3    YES 0   0   0   14     14     1      0      3      0      f081053ef0000000
  14/6    3.0 Gb/s          SPS3G   3    YES 0   0   0   15     15     1      0      3      0      f081053ef0000000
  15/7    3.0 Gb/s          SPS3G   3    YES 0   0   0   13     13     1      0      3      0      f081053ef0000000
  16/8    3.0 Gb/s          SPS3G   3    YES 0   0   0   15     14     1      0      3      0      f081053ef0000000
  17/9    3.0 Gb/s          SPS3G   3    YES 0   0   0   15     15     1      0      3      0      f081053ef0000000
  18/10   3.0 Gb/s          SPS3G   3    YES 0   0   0   14     14     1      0      3      0      f081053ef0000000
  19/11   3.0 Gb/s          SPS3G   3    YES 0   0   0   15     14     1      0      3      0      f081053ef0000000
  20/12   3.0 Gb/s          SPS3G   3    YES 0   0   0   15     14     1      0      3      0      f081053ef0000000
  21/13   3.0 Gb/s          SPS3G   3    YES 0   0   0   14     13     1      0      3      0      f081053ef0000000
  22/14   3.0 Gb/s          SPS3G   3    YES 0   0   0   15     14     1      0      3      0      f081053ef0000000
  23/15   3.0 Gb/s          SPS3G   3    YES 0   0   0   15     15     1      0      3      0      f081053ef0000000
  24/16   3.0 Gb/s          SPS3G   3    YES 0   0   0   14     14     1      0      3      0      f081053ef0000000
  25/17   3.0 Gb/s          SPS3G   3    YES 0   0   0   14     14     1      0      3      0      f081053ef0000000
  26/18   3.0 Gb/s          SPS3G   3    YES 0   0   0   14     14     1      0      3      0      f081053ef0000000
  27/19   3.0 Gb/s          SPS3G   3    YES 0   0   0   13     13     1      0      3      0      f081053ef0000000

The PHY/BAY STATE field is of the format logical phy number/[Port Number:Phy Number|Bay ID] <Phy State>.

The logical phy number field displays the logical phy number for which information is being displayed.

The Port Number:Phy Number combination field displays whether this phy is part of a wide port SAS link and the phy number within the wide port.

For the definition of the Bay ID field, see "SAS DEVICE NAMING CONVENTION", above.

For the definition of the Phy State field, see "STATE" under "sasadmin adapter_state", above.

The Dongle Type column represents the type of dongle attached, if the attached end device is a SATA disk drive.

The Dngl. FW Rev. (dongle firmware revision) column displays the firmware version running in the dongle controller.

The Pwr ON (power on) column indicates how many times disk drive power was successfully turned on by this particular module.

The Pwr Ccl Cnt (power cycle count) column indicates how many times disk drive power has been successfully turned off and then successfully turned back on by this particular module.

The Rsv Cnt (reserve count) column indicates how many times the Emulate Reserve function was successfully completed for this phy.

The Rls Cnt (release count) column indicates how many times the Emulate Release function was successfully completed for this phy.

For the definitions of Invald DWord Count, Disprt Error Count, Loss Sync Count, Phy Reset Prob, see "sasadmin adapter_state", above.

The Phy Change Cnt H (phy change count hardware) column returns the number times the expander transmitted BROADCAST(CHANGE) in response to a phy transitioning from disabled to enabled.

The Phy Change Cnt S (phy change count software) column returns the number of times the SAS adapter notified the Data ONTAP(R) SAS driver of a state change associated with the phy.

The SATA Affiliation column displays the world wide name (WWN) of the initiator that currently holds the affiliation, if the end device is a SATA disk drive.

sasadmin expander <adapter_name>[.<shelf_id>]

The sasadmin expander command display the following information about the configuration of an expander.

  filer> sasadmin expander 0c
  WWN 500c0ff00a42503f, ID 0, Serial Number 0xa4250
  Manufacturer: Vendor 'NETAPP  ', Product 'NA-2400-SM-SAS  ', Rev '0C04', Level 1, Slot A
  PHY[ 0/P0:0/S]: 3.0 Gb/s, Initiator f081053b80000000
  PHY[ 1/P0:1/S]: 3.0 Gb/s, Initiator f081053b80000000
  PHY[ 2/P0:2/S]: 3.0 Gb/s, Initiator f081053b80000000
  PHY[ 3/P0:3/S]: 3.0 Gb/s, Initiator f081053b80000000
  PHY[ 4/P1:0/T]: Rate unknown
  PHY[ 5/P1:1/T]: Rate unknown
  PHY[ 6/P1:2/T]: Rate unknown
  PHY[ 7/P1:3/T]: Rate unknown
  PHY[ 8/   0/T]: 3.0 Gb/s, SATA Device 500c0ff00a425008 (0c.00.0)
  PHY[ 9/   1/T]: 3.0 Gb/s, SATA Device 500c0ff00a425009 (0c.00.1)
  PHY[10/   2/T]: 3.0 Gb/s, SATA Device 500c0ff00a42500a (0c.00.2)
  PHY[11/   3/T]: 3.0 Gb/s, SATA Device 500c0ff00a42500b (0c.00.3)
  PHY[12/   4/T]: 3.0 Gb/s, SATA Device 500c0ff00a42500c (0c.00.4)
  PHY[13/   5/T]: 3.0 Gb/s, SATA Device 500c0ff00a42500d (0c.00.5)
  PHY[14/   6/T]: 3.0 Gb/s, SATA Device 500c0ff00a42500e (0c.00.6)
  PHY[15/   7/T]: 3.0 Gb/s, SATA Device 500c0ff00a42500f (0c.00.7)
  PHY[16/   8/T]: 3.0 Gb/s, SATA Device 500c0ff00a425010 (0c.00.8)
  PHY[17/   9/T]: 3.0 Gb/s, SATA Device 500c0ff00a425011 (0c.00.9)
  PHY[18/  10/T]: 3.0 Gb/s, SATA Device 500c0ff00a425012 (0c.00.10)
  PHY[19/  11/T]: 3.0 Gb/s, SATA Device 500c0ff00a425013 (0c.00.11)
  PHY[20/  12/T]: 3.0 Gb/s, SATA Device 500c0ff00a425014 (0c.00.12)
  PHY[21/  13/T]: 3.0 Gb/s, SATA Device 500c0ff00a425015 (0c.00.13)
  PHY[22/  14/T]: 3.0 Gb/s, SATA Device 500c0ff00a425016 (0c.00.14)
  PHY[23/  15/T]: 3.0 Gb/s, SATA Device 500c0ff00a425017 (0c.00.15)
  PHY[24/  16/T]: 3.0 Gb/s, SATA Device 500c0ff00a425018 (0c.00.16)
  PHY[25/  17/T]: 3.0 Gb/s, SATA Device 500c0ff00a425019 (0c.00.17)
  PHY[26/  18/T]: 3.0 Gb/s, SATA Device 500c0ff00a42501a (0c.00.18)
  PHY[27/  19/T]: 3.0 Gb/s, SATA Device 500c0ff00a42501b (0c.00.19)
  PHY[28/  20/T]: 3.0 Gb/s, SATA Device 500c0ff00a42501c (0c.00.20)
  PHY[29/  21/T]: 3.0 Gb/s, SATA Device 500c0ff00a42501d (0c.00.21)
  PHY[30/  22/T]: 3.0 Gb/s, SATA Device 500c0ff00a42501e (0c.00.22)
  PHY[31/  23/T]: 3.0 Gb/s, SATA Device 500c0ff00a42501f (0c.00.23)
  PHY[32/  99/D]: 3.0 Gb/s, Virtual SAS Device 500c0ff00a42503e (0c.00.99)

The WWN field refers to the base SAS address of the expander.

For the definition of the ID field, see "SAS DEVICE NAMING CONVENTION", above.

The Serial Number refers to the back plane serial number of the enclosure where the expander is housed.

The Vendor field of the Manufacturer line refers to the Vendor Identification field reported by the Report Manufacturer Info SMP command. It is 8 bytes of left-aligned ASCII data that was assigned by INCITS and is set to "NETAPP ", with all trailing white spaces filled with blank characters (20h).

For the definition of the Product field of the Manufacturer line see the Product field definition under "sasadmin expander_map", above.

The Rev field of the Manufacturer line refers to the running firmware version of the expander.

The Level field of the Manufacturer line refers to the SAS topology level assigned by the first SAS adapter port that discovered the expander during SAS discovery.

The Slot field refers to the slot where the expander resides. The top module is termed Slot A and the bottom module is termed Slot B.

The remaining portion of the output of the command displays information regarding each phy of the expander. The format of each line would be as follows:

PHY[<logical phy number>/[Port Number:Phy Number|Bay ID]/<routing attribute>]:<Phy State>, [[Virtual] <End device type> <WWN> <Device name>]

The logical phy number field displays the logical phy number for which information is being displayed.

The Port Number:Phy Number combination field displays whether this phy is part of a wide port SAS link and the phy number within the wide port.

For the definition of the Bay ID field, see "SAS DEVICE NAMING CONVENTION", above.

The routing attribute field display the SAS routing attribute for the phy. Possible routing attribute types are S for subtractive routing, T for table routing and D for direct routing.

For the definition of the Phy State field, see "STATE" under "sasadmin adapter_state", above.

The End device type field displays the type of end device attached to this phy. Possible end device types are "Unknown", "Initiator", "Expander", "SAS Device" and "SATA Device". The optional attribute Virtual is added if the end device is a SAS virtual device. For example, the SCSI Enclosure Services (SES) device in the expander is a virtual device.

The WWN field refers to the SAS address of the end device attached to this phy.

The Device name field display the Data ONTAP(R) device name, if the end device is either a SAS or a SATA disk drive, which is described in "SAS DEVICE NAMING CONVENTION", above.

DISPLAYS

Example output for all commands is included in their descriptions.

OPTIONS

All options for all commands are included in their descriptions.

EMS MESSAGES

sas.adapter.reset:

The Data ONTAP SAS driver is resetting the specified host adapter. This can occur during normal error handling or when requested by the user.

sas.device.quiesce:

This indicates that at least one command to the specified device has not been completed in what would be the normally expected timeframe. In this case, the driver stops sending additional commands to the device until all outstanding commands have the opportunity to be completed. This condition is automatically handled by the Data ONTAP(R) SAS driver.

sas.device.timeout:

All outstanding commands to the specified device have not been completed within the allotted time. As part of the standard error handling sequence managed by the Data ONTAP SAS driver, all commands to the device are aborted and reissued.

sas.device.resetting:

This indicates that device level error recovery has escalated to resetting the device. It is usually seen in association with error conditions such as device level timeouts or transmission errors. This event reports the recovery action taken by the Data ONTAP(R) SAS driver when evaluating associated device or link related error conditions.

sas.channel.resetting:

This indicates that error recovery has escalated to resetting all devices on the specified channel. It is usually seen in association with error conditions such as device level timeouts or transmission errors. This event is intended to report the recovery action taken by the Data ONTAP SAS driver when evaluating associated device or link related error conditions.

sas.adapter.bad:

The SAS adapter failed to initialize.

sas.adapter.firmware.fault:

A firmware fault was detected on the SAS adapter and it is being reset to recover.

sas.adapter.not.ready:

The SAS adapter did not become ready after being reset.

sas.adapter.error:

The SAS adapter driver encountered an error with the adapter. The adapter is being reset to recover.

sas.adapter.unexpected.status:

The SAS adapter returned an unexpected status and is being reset to recover.

ERRORS

"Not a SAS adapter."

"No such adapter adapter_name."

"This operation not allowed on channel chan_name."

"Device device_name is not valid or does not exist."

"Failed."

BUGS

No known bugs exist at this time.

SEE ALSO

na_cf(1), na_storage(1), na_san(1),


Table of Contents