ledctl

controls enclosure LEDs for Intel RAID controllers and storage systems

TLDR

Turn on Locate LED for devices

$ sudo ledctl locate=[/dev/sda,/dev/sdb]

Turn off Locate LED

$ sudo ledctl locate_off=[/dev/sda,/dev/sdb]

Turn off Status and Failure LEDs

$ sudo ledctl off=[/dev/sda,/dev/sdb]

Turn off all LEDs (normal state)

$ sudo ledctl normal=[/dev/sda,/dev/sdb]

SYNOPSIS

ledctl [options] pattern=devicelist_ ...

ledctl controls enclosure LEDs for Intel RAID controllers and storage systems. It allows physical identification of disks by blinking the Locate LED, and manages status indicators for disk states.This is particularly useful in data centers with many disks, allowing administrators to physically locate specific drives that need attention, replacement, or are part of a rebuild operation.

OPTIONS

-L, --list-controllers

List detected controllers and their type.

-x, --listed-only

Apply changes only to the listed devices; leave others unchanged.

-l FILE, --log=FILE

Write log output to the given file.

--quiet, --error, --warning, --info, --debug, --all

Set logging verbosity.

-h, --help

Show help.

-v, --version

Show version.

PATTERNS

locate=DEVICES

Turn on the Locate LED (blue blinking)

locate_off=DEVICES

Turn off the Locate LED

off=DEVICES

Turn off Status and Failure LEDs

normal=DEVICES

Turn off all LEDs, return to normal state

rebuild=DEVICES

Set rebuild pattern (used during RAID rebuild)

failure=DEVICES, disk_failed=DEVICES

Set failure pattern (solid red)

ica=DEVICES, degraded=DEVICES

In a critical array.

ifa=DEVICES, failed_array=DEVICES

In a failed array.

hotspare=DEVICES

Mark as hot spare.

pfa=DEVICES

Predicted failure analysis.

Devices may be given either comma-separated (e.g. locate=/dev/sda,/dev/sdb) or in braces (e.g. locate={ /dev/sda /dev/sdb }).

CAVEATS

Requires Intel hardware with LED support (AHCI, ISCI, VMD enclosures). Needs root privileges. Not all enclosures support all LED patterns.

HISTORY

ledctl is part of the ledmon package, developed by Intel for managing storage enclosure LEDs on their RAID and storage hardware platforms.