.. index::
    single: llebeig

Llebeig cluster installation
=============================

.. _llebeig-installation:

The `OmpSs-2\@FPGA
releases <https://github.com/bsc-pm-ompss-at-fpga/ompss-2-at-fpga-releases>`_
are automatically installed in the Llebeig cluster. 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 Llebeig
cluster should be the same as in the Docker images.


General remarks
---------------

* The OmpSs\@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.


.. _llebeig-login:

Logging into llebeig
--------------------

Llebeig is accessible from HCA ``ssh.hca.bsc.es``
Alternatively, it can be accessed through the ``8412`` port in HCA
and ssh connection will be redirected to the actual host:

.. code:: bash

    ssh -p 8412 ssh.hca.bsc.es

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

.. code:: bash

    Host llebeig
        HostName ssh.hca.bsc.es
        Port 8412


.. _llebeig-modules:

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:

.. code:: bash

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

To list all available modules in the system run:

.. code:: bash

    module avail


Build applications
------------------

To generate an application binary and bitstream, you could refer to :ref:`compile-ompss2atfpga-programs`
as the steps are general enough.

Note that the appropriate modules need to be loaded. See :ref:`llebeig-modules`.