6.7. ikergune user guide

ikergune takes its name from a technology transfer project with a Basque industrial company.

The OmpSs-2@FPGA releases are automatically installed in the server. They are available through a module file for each target architecture. This document describes how to load and use the modules to compile an example application. Once the modules are loaded, the workflow in the server should be the same as in the Docker images.

6.7.1. General remarks

  • The OmpSs-2@FPGA toolchain is installed in a version folder under the /opt/bsc/ directory.

  • Third-party libraries required to run some programs are installed in the corresponding folder under the /opt/lib/ directory.

  • The rest of the software (Xilinx toolchain, modules, etc.) is installed under the /tools/ directory.

6.7.2. Logging into the system

ikergune is accessible from crdbmaster crdbmaster.bsc.es Alternatively, it can be accessed through the 8422 port in crdbmaster and ssh connection will be redirected to the actual host:

ssh -p 8422 crdbmaster.bsc.es

Also, this can be automated by adding a ikergune host into ssh config:

Host ikergune
    HostName crdbmaster.bsc.es
    Port 8422

6.7.3. Module structure

The ompss-2 modules are:

  • ompss-2/x86_64/*[release version]*

This will automatically load the default Vivado version, although an arbitrary version can be loaded before ompss:

module load vivado/2024.2 ompss-2/x86_64/git

To list all available modules in the system run:

module avail

6.7.4. Build applications

To generate an application binary and bitstream, you could refer to Compile OmpSs-2@FPGA programs as the steps are general enough.

Note that the appropriate modules need to be loaded. See Module structure.