Skip to main content

storage disk set-led

Identify disks by turning on their LEDs

Availability: This command is available to cluster administrators at the admin privilege level.

Description​

The storage disk set-led command controls the LED of a specified disk.

You can turn an LED on or off, cause it to blink or stop blinking, or test it.

This command is useful for locating a disk in its shelf.

Parameters​

-action {on|off|blink|blinkoff|testall|resetall} - Action
This parameter specifies the state to which the LED is to be set. Possible values include the following:

  • on - The LED is lit steadily

  • off - The LED is not lit

  • blink - The LED blinks

  • blinkoff - The LED stops blinking and is not lit

  • testall - This tests the operation of every disk enclosure's hardware and drivers per node. Do not use this value in normal operation.

  • resetall - This resets the LED of every disk on the node and lights up the LED of disks with faults.

{ [-disk <disk path name>] - Disk Name
This specifies the disk whose LED is to be set. Disk names take one of the following forms:

  • Disks are named in the form <stack-id>.<shelf>.<bay>

  • Disks on multi-disk carriers are named in the form <stack-id>.<shelf>.<bay>.<lun>

  • Virtual disks are named in the form <prefix>.<number>, where prefix is the storage array's prefix and number is a unique ascending number.

Disk names take one of the following forms on clusters that are not yet fully upgraded to Data ONTAP 8.3:

  • Disks that are not attached to a switch are named in the form <node>:<host_adapter>.<loop_ID>. For disks with a LUN, the form is <node>:<host_adapter>.<loop_ID>L<LUN>. For instance, disk number 16 on host adapter 1a on a node named node0a is named node0a:1a.16. The same disk on LUN lun0 is named node0a:1a.16Llun0.

  • Disks that are attached to a switch are named in the form <node>:<switch_name>:<switch_port>.<loop_ID>. For disks with a LUN, the form is <node>:<switch_name>:<switch_port>.<loop_ID>L<LUN>. For instance, disk number 08 on port 11 of switch fc1 on a node named node0a is named node0a:fc1:11.08. The same disk on LUN lun1 is named node0a:fc1:11.08Llun1.

Before the cluster is upgraded to Data ONTAP 8.3, the same disk can have multiple disk names, depending on how the disk is connected. For example, a disk known to a node named alpha as alpha:1a.19 can be known to a node named beta as beta:0b.37. All names are listed in the output of queries and are equally valid. To determine a disk's unique identity, run a detailed query and look for the disk's universal unique identifier (UUID) or serial number.

| [-adapter <text>] - Adapter Name
The name of the adapter to which the shelves of disks of interest are attached to.
[-node {<nodename>|local}]} - Node Name
The node for which action is to be taken.
[-duration <integer>] - Duration (minutes)
This specifies the duration, in minutes, that the LED is to remain in the specified state. Only actions "on" and "blink" are supported.
[-iteration <integer>] - Test iterations
This specifies the number of iterations to run the action for. Only action "test-all" is supported.

Examples​

The following example causes the LEDs on all disks whose names match the pattern Cluster1* to turn on for 5 minutes: 

Cluster1::> storage disk set-led -disk Cluster1* -action on -duration 5
The following example causes the LEDs on all disks attached to adapter 0b on Node2 to turn on for 1 minute:
Cluster1::> storage disk set-led -node Node2 -adapter 0b -action on -duration 1
The following example resets the LEDs on all disks on the local node and causes the LEDs of disks with faults to turn on:
Cluster1::> storage disk set-led -action resetall
The following example causes the LEDs on all disks whose names match the pattern Cluster1* to turn on for 2 minutes:
Cluster1::> storage disk set-led -disk Cluster1* -action on -duration 2
The following example tests the LEDs on all disks owned by the local node for 3 iterations:
Cluster1::> storage disk set-led -action testall -iteration 3