ugreen/proxmox-led-install.md

Proxmox LED installation

My TL;DR installation instructions to get https://github.com/miskcoo/ugreen_dx4600_leds_controller#start-at-boot-for-debian-12 installed.

Maintenance tasks

New disks added/removed/leds stuck.

lsblk -S -x hctl -o name,hctl,serial
systemctl restart ugreen-diskiomon

Maintain serials in /etc/ugreen-leds.conf and restart the service

systemctl stop ugreen-diskiomon
systemctl start ugreen-diskiomon
systemctl status ugreen-diskiomon

Fix after Proxmox Kernel Update

modprobe -v led-ugreen

shows in which directory and with which name modules are missing install these missing modules, adjusting names if necessary

dkms install ugreen-led/0.1 -k 6.17.2-2-pve
modprobe -v led-ugreen
./ugreen_leds_controller/scripts/ugreen-probe-leds

should now be successful

Afterwards restart services

systemctl daemon-reload
systemctl start ugreen-netdevmon@enp2s0

status check should now be positive with

systemctl status ugreen-netdevmon@enp2s0

Fix drives with

systemctl start ugreen-diskiomon
systemctl enable ugreen-diskiomon
systemctl status ugreen-diskiomon

Installation steps

1. Modify /etc/apt/sources.list and non-free

deb http://deb.debian.org/debian bookworm main contrib non-free

2. Run apt-get update

3. Attempt install apt-get install dkms git i2c-tools you may get an error, if so try apt --fix-broken install.

4. Install PVE headers. apt install pve-headers-$(uname -r)

5. Download .deb package from github and into a folder on the server. Attempt to install dpkg -i led-ugreen-dkms_0.1_amd64.deb

6. Download source scripts git clone https://github.com/miskcoo/ugreen_dx4600_leds_controller.git

7. Execute modprobe -v i2c-dev

8. Execute script within folder and verify LEDs are seen.

# sh /root/ugreen_leds_controller/scripts/ugreen-probe-leds 
Found I2C device /dev/i2c-0

9. Create the systemd configuration; pick the eth# to monitor and enable the service to start at boot if all goes well.

root@UNO:~/ugreen_leds_controller/scripts# ls
ugreen-diskiomon	  ugreen-leds.conf  ugreen-netdevmon@.service
ugreen-diskiomon.service  ugreen-netdevmon  ugreen-probe-leds

10. move the scripts to /usr/bin

root@UNO:~/ugreen__leds_controller/scripts# for f in ${scripts[@]}; do
    chmod +x "scripts/$f"
    cp "scripts/$f" /usr/bin
done

11. copy the config-files

root@UNO:/root/ugreen_leds_controller/scripts cp ugreen-leds.conf /etc/ugreen-leds.conf
root@UNO:/root/ugreen_leds_controller/scripts cp *.service /etc/systemd/system/

12. prepare the services (please be sure to replace enp88s0 with the ethernetport that you want to monitor)

root@UNO:/root/ugreen_leds_controller/scripts systemctl daemon-reload
root@UNO:/root/ugreen_leds_controller/scripts systemctl start ugreen-netdevmon@enp88s0
root@UNO:/root/ugreen_leds_controller/scripts systemctl start ugreen-diskiomon
root@UNO:/root/ugreen_leds_controller/scripts systemctl enable ugreen-diskiomon
Created symlink /etc/systemd/system/multi-user.target.wants/ugreen-diskiomon.service → /etc/systemd/system/ugreen-diskiomon.service.
root@UNO:/root/ugreen_leds_controller/scripts systemctl enable ugreen-netdevmon@enp88s0
Created symlink /etc/systemd/system/multi-user.target.wants/ugreen-netdevmon@enp88s0.service → /etc/systemd/system/ugreen-netdevmon@.service.

The network LED should now be blinking if there's network activity. The software is installed on proxmox; you can configure disk LEDs.

Disk mapping to LEDs

I won't repeat the content from https://github.com/miskcoo/ugreen_dx4600_leds_controller?tab=readme-ov-file#disk-mapping simply dump the list of commands that are specific to my setup but this should be enough for you to get the idea.

DXP6800 Pro has special mappings. 0:0:0:0 and 1:0:0:0 are mapped to disk5 and disk6, and 2:0:0:0 to 6:0:0:0 are mapped to disk1 to disk4

1. lsblk -S -x hctl -o name,hctl,serial Displays current diskinfo.

2. edit or create /etc/modules-load.d/ugreen-led.conf

i2c-dev
led-ugreen
ledtrig-oneshot
ledtrig-netdev

3. Edit configuration with DXP6800 Pro settings.

CHECK_GATEWAY_CONNECTIVITY=true
CHECK_LINK_SPEED=true

4. If we installed the dkms in the lazy way via .deb package. The file /usr/bin/ugreen-diskiomon is out of date, let's wipe it out with one that works and is modified by me to have the DXP6800 Pro special map pre-configred.

/usr/bin/ugreen-diskiomon DXP6800 Pro settings to override.

hctl_map=("2:0:0:0" "3:0:0:0" "4:0:0:0" "5:0:0:0" "0:0:0:0" "1:0:0:0")
ata_map=("ata3" "ata4" "ata5" "ata6" "ata1" "ata2")