hpc_eff

Energy Optimization Governor for HPC systems.
Reads power, price, and CO₂ intensity data, then sets the CPU governor based on a calculated rating.

All the functionality and code logic located in src/hpc_eff stem from https://gitlab.cesnet.cz/dexter/hpc_eff.

---

Overview

hpc_eff is designed to be run periodically (e.g., via cron every few minutes) under root.
It evaluates current energy conditions, prints debug logs if enabled, and sets the CPU frequency governor accordingly.

Main steps performed:

1. Load configuration from /etc/hpc_eff/config.ini
2. Fetch current electricity price
3. Read current power usage via a configured shell command
4. Read current CPU frequency
5. Retrieve available CPU frequencies and governors
6. Fetch historical energy price averages and classify current price
7. Fetch last 24h CO₂ values and calculate rating
8. Apply CPU governor based on rating

---

Installation

1. Clone the repository:

   git clone git@github.com:CESNET/hpc_eff.git
   cd hpc_eff

2. Install the dependencies:

   sudo dnf install ipmitool cpufrequtils make kernel-tools rpm-build rpmdevtools -y

3. Build and install:

   make

4. Configure:

   sudo vi /etc/hpc_eff/config.ini