Dell_iDRAC_fan_controller_Docker/README.md

Dell iDRAC fan controller Docker image

https://hub.docker.com/repository/docker/tigerblue77/dell_idrac_fan_controller

Table of Contents

1. Container console log example
2. Usage
3. Parameters
4. Contributing

Container console log example

(back to top)

Prerequisites

To access iDRAC over LAN (not needed in "local" mode) :

1. Log into your iDRAC web console

2. In the left side menu, expand "iDRAC settings", click "Network" then click "IPMI Settings" link at the top of the web page.

3. Check the "Enable IPMI over LAN" checkbox then click "Apply" button.

4. Test access to IPMI over LAN running the following commands :

apt -y install ipmitool
ipmitool -I lanplus \
  -H <iDRAC IP address> \
  -U <iDRAC username> \
  -P <iDRAC password> \
  sdr elist all

(back to top)

Usage

1. with local iDRAC:

docker run -d \
  --name Dell_iDRAC_fan_controller \
  --restart=unless-stopped \
  -e IDRAC_HOST=local \
  -e FAN_SPEED=<decimal or hexadecimal fan speed> \
  -e CPU_TEMPERATURE_TRESHOLD=<decimal temperature treshold> \
  -e CHECK_INTERVAL=<seconds between each check> \
  --device=/dev/ipmi0:/dev/ipmi0:rw \
  tigerblue77/dell_idrac_fan_controller:latest

2. with LAN iDRAC:

docker run -d \
  --name Dell_iDRAC_fan_controller \
  --restart=unless-stopped \
  -e IDRAC_HOST=<iDRAC IP address> \
  -e IDRAC_USERNAME=<iDRAC username> \
  -e IDRAC_PASSWORD=<iDRAC password> \
  -e FAN_SPEED=<decimal or hexadecimal fan speed> \
  -e CPU_TEMPERATURE_TRESHOLD=<decimal temperature treshold> \
  -e CHECK_INTERVAL=<seconds between each check> \
  tigerblue77/dell_idrac_fan_controller:latest

docker-compose.yml examples:

1. to use with local iDRAC:

version: '3'

services:
  Dell_iDRAC_fan_controller:
    image: tigerblue77/dell_idrac_fan_controller:latest
    container_name: Dell_iDRAC_fan_controller
    restart: unless-stopped
    environment:
      - IDRAC_HOST=local
      - FAN_SPEED=<decimal or hexadecimal fan speed>
      - CPU_TEMPERATURE_TRESHOLD=<decimal temperature treshold>
      - CHECK_INTERVAL=<seconds between each check>
    devices:
      - /dev/ipmi0:/dev/ipmi0:rw

2. to use with LAN iDRAC:

version: '3'

services:
  Dell_iDRAC_fan_controller:
    image: tigerblue77/dell_idrac_fan_controller:latest
    container_name: Dell_iDRAC_fan_controller
    restart: unless-stopped
    environment:
      - IDRAC_HOST=<iDRAC IP address>
      - IDRAC_USERNAME=<iDRAC username>
      - IDRAC_PASSWORD=<iDRAC password>
      - FAN_SPEED=<decimal or hexadecimal fan speed>
      - CPU_TEMPERATURE_TRESHOLD=<decimal temperature treshold>
      - CHECK_INTERVAL=<seconds between each check>

(back to top)

Parameters

All parameters are optional as they have default values (including default iDRAC username and password).

• IDRAC_HOST parameter can be set to "local" or to your distant iDRAC's IP address. Default value is "local".
• IDRAC_USERNAME parameter is only necessary if you're adressing a distant iDRAC. Default value is "root".
• IDRAC_PASSWORD parameter is only necessary if you're adressing a distant iDRAC. Default value is "calvin".
• FAN_SPEED parameter can be set as a decimal (from 0 to 100%) or hexadecimaladecimal value (from 0x00 to 0x64) you want to set the fans to. Default value is 5(%).
• CPU_TEMPERATURE_TRESHOLD parameter is the T°junction (junction temperature) threshold beyond which the Dell fan mode defined in your BIOS will become active again (to protect the server hardware against overheat). Default value is 50(°C).
• CHECK_INTERVAL parameter is the time (in seconds) between each temperature check and potential profile change. Default value is 60(s).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)