Skip to content

Installation

LittleWhite-tb edited this page Mar 18, 2015 · 1 revision

Minimal Configuration

Currently, FoREST is in early development stage. It supports recent Linux and only Intel SandyBridge processors for the moment. Support for IvyBridge processors will come soon.

If you are unsure, the installation script should normally test that for you and abort if it is not compatible.

Downloading the program

For the moment, FoREST is only distrubuted as source code. You can directly download it using git.

FoREST uses an external tool to perform its energy measurements. This tool is called lPowerProbe and is used as a submodule of FoREST.

To fetch lPowerProbe before compiling, simply type git submodule init.

Compilation

FoREST is only distributed as source code that you must compile, meaning a full C and C++ compilation chain must be available on your computer (make, gcc, g++, ...). Moreover, python must also be available.

To compile the program, fetch the source code from the repository and compile it using make. Some preliminary compilation will occur, followed by an offline profiling phase. The offline profiling step takes up to a few minutes (depending on your processor model) and calibrates FoREST to allow maximal energy savings.

You need a root access for the last step of the compilation.

Running

FoREST can be launched using the localRest executable. The daemon requires an access to the offline profiling result gathered at the end of the compilation. For that reason, it is preferable to not move the executable file after compilation.

The executable accepts one option, either "performance" or "energy". If you specify "performance", FoREST will save as much as possible energy on the processor while not degrading the execution time of programs by more than 5%. On the other hand, if you chose "energy", FoREST will save as much energy as possible with no consideration on performance.

Clone this wiki locally