ipmi-fan-control

ipmi-fan-control is a program written in Rust to control the fans on SuperMicro motherboards based on the readings of temperature sensors.

Note: This has primarily been tested on a 6028U-TR4T+, which uses the X10DRU-i+ motherboard. Also, only Linux and other Unix-like operating systems are currently supported.

Installation

Prebuilt packages for Arch Linux, CentOS, Fedora, openSUSE, Debian, and Ubuntu are available from OBS. Please follow the instructions at the repo's landing page.

For other Unix-like systems, follow the instructions in the next section to build from source. Windows is currently not supported.

Building

The project can be built with the normal cargo tool. To make a debug build, run:

cargo build

or to make a release build, run:

cargo build --release

To build Linux distro-specific packages, first build the corresponding source package:

# SRPM for RPM-based distros
./dist/build_source_package.sh -t srpm
# PKGBUILD for Arch Linux
./dist/build_source_package.sh -t pkgbuild
# dsc for Debian-based distros
./dist/build_source_package.sh -t dsc

and then use the distro's standard utilities for building the binary packages. The source packages will be placed in dist/output/.

Running

If ipmi-fan-control was installed from a package, update /etc/ipmi-fan-control.toml to match the desired configuration and then enable and start the ipmi-fan-control systemd service.

If built from source, make a copy of config.sample.toml and update the values to match your server's configuration. Then, make sure ipmitool is installed as it is required for controlling the fans. Finally, run ipmi-fan-control with:

# Debug
sudo ./target/debug/ipmi-fan-control --config config.toml
# Release
sudo ./target/release/ipmi-fan-control --config config.toml

TODO

• Use libfreeipmi directly instead of interacting with ipmitool shell with rexpect. If the ipmitool shell UI changes, ipmi-fan-control will most likely break.
• Add support for Windows.