Building software on top of EESSI¶
Building software on top of EESSI with EasyBuild¶
Building on top of EESSI with EasyBuild is relatively straightforward. One crucial feature is that EasyBuild supports building against operating system libraries that are not in a standard prefix (such as
/usr/lib). This is required when building against EESSI, since all of the software in EESSI is built against the compatibility layer.
Starting the EESSI software environment¶
Start your environment as described here
To configure EasyBuild, first, check out the EESSI software-layer repository. We advise you to check out the branch corresponding to the version of EESSI you would like to use.
If you are unsure which version you are using, you can run
To build on top of e.g. version
2023.06 of the EESSI software stack, we check it out, and go into that directory:
/tmp/ as our working directory, and use
$HOME/.local/easybuild as our installpath:
We use EasyBuild's default behaviour in optimizing for the host architecture. Since the EESSI initialization script also loads the EESSI stack that is optimized for your host architecture, this matches nicely. However, if you work on a cluster with heterogeneous node types, you have to realize you can only use these builds on the same architecture as where you build them. You can use different
EASYBUILD_INSTALLPATHs if you want to build for different host architectures. For example, when you are on a system that has a mix of
AMD zen3 and
AMD zen4 nodes, you might want to use
EASYBUILD_INSTALLPATH=$HOME/.local/easybuild/zen3 when building on a
EASYBUILD_INSTALLPATH=$HOME/.local/easybuild/zen4 when building on a
zen4 node. Then, in the step beloww, instead of the
module use command listed there, you can use
module use $HOME/.local/easybuild/zen3/modules/all when you want to run on a
zen3 node and
module use $HOME/.local/easybuild/zen4/modules/all when you want to run on a
Now, you are ready to build. For example, at the time of writing,
netCDF-4.9.0-gompi-2022a.eb was not in the EESSI environment yet, so you can build it yourself:
If this netCDF module is available by the time you are trying, you can force a local rebuild by adding the
--rebuild argument in order to experiment with building locally, or pick a different EasyConfig to build.
Using the newly built module¶
First, you'll need to add the subdirectory of the
EASYBUILD_INSTALLPATH that contains the modules to the
MODULEPATH. You can do that using:
you may want to do this as part of your
Be careful adding to the
MODULEPATH in your
.bashrc if you are on a cluster with heterogeneous architectures. You don't want to pick up on a module that was not compiled for the correct architectures accidentally.
Since your module is built on top of the EESSI environment, that needs to be loaded first (as described here), if you haven't already done so.
Finally, you should be able to load our newly build module:
Manually building software op top of EESSI¶
Building software on top of EESSI would require your linker to use the same system-dependencies as the software in EESSI does. In other words: it requires you to link against libraries from the compatibility layer, instead of from your host OS.
While we plan to support this in the future, manually building on top of EESSI is currently not supported yet in a trivial way.