Building from sources

This section describes the steps to install COMPSs from the sources.

The first step is downloading the source code from the Git repository.

$ git clone https://github.com/bsc-wdc/compss.git
$ cd compss

Then, you need to download the embedded dependencies from the git submodules.

$ compss> ./submodules_get.sh

Warning

Before running the installation script in macOS distributions, some previous definitions need to be done:

$ alias readlink=/usr/local/bin/greadlink
$ export LIBTOOL=`which glibtool`
$ export LIBTOOLIZE=`which glibtoolize`
$ export JAVA_HOME=/usr/local/cellar/openjdk@8/1.8.0+282/libexec/openjdk.jdk/Contents/Home

Finally you just need to run the installation script. You have two options:

For installing COMPSs for all users run the following command:

$ compss> cd builders/
$ builders> export INSTALL_DIR=/opt/COMPSs/
$ builders> sudo -E ./buildlocal ${INSTALL_DIR}

Attention

Root access is required.

For installing COMPSs for the current user run the following commands:

$ compss> cd builders/
$ builders> INSTALL_DIR=$HOME/opt/COMPSs/
$ builders> ./buildlocal ${INSTALL_DIR}

Warning

In macOS distributions, the System Integrity Protection (SIP) does not allow to modify the /System folder even with root permissions. This means the installation building from sources can only be installed for the current user.

Tip

The buildlocal script allows to disable the installation of components. The options can be found in the command help:

$ compss> cd builders/
$ builders> ./buildlocal -h

  Usage: ./buildlocal [options] targetDir
    * Options:
        --help, -h                  Print this help message

        --opts                      Show available options

        --version, -v               Print COMPSs version

        --monitor, -m               Enable Monitor installation
        --no-monitor, -M            Disable Monitor installation
                                    Default: true

        --bindings, -b              Enable bindings installation
        --no-bindings, -B           Disable bindings installation
                                    Default: true

        --pycompss, -p              Enable PyCOMPSs installation
        --no-pycompss, -P           Disable PyCOMPSs installation
                                    Default: true

        --tracing, -t               Enable tracing system installation
        --no-tracing, -T            Disable tracing system installation
                                    Default: true

        --kafka, -k                 Enable Kafka module installation
        --no-kafka, -K              Disable Kafka module installation
                                    Default: true

        --jacoco, -j                Enable Jacoco module installation
        --no-jacoco, -J             Disable Jacoco module installation
                                    Default: true

        --dlb, -d                   Enable dlb module installation
        --no-dlb, -D                Disable dlb module installation
                                    Default: true

        --cli, -c                   Enable Command Line Interface module installation
        --no-cli, -C                Disable Command Line Interface module installation
                                    Default: true

        --nothing, -N               Disable all previous options
                                    Default: unused

        --user-exec=<str>           Enables a specific user execution for maven compilation
                                    When used the maven install is not cleaned.
                                    Default: false

        --skip-tests                Disables MVN unit tests
                                    Default:

    * Parameters:
        targetDir                   COMPSs installation directory
                                    Default: /opt/COMPSs

Warning

Components Tracing, Kafka, Jacoco and DLB cannot be installed in macOS distributions. Therefore, at least options -T -K -J -D must be used when invoking buildlocal

Post installation

Once your COMPSs package has been installed remember to log out and back in again to end the installation process.

Caution

Using Ubuntu version 18.04 or higher requires to comment the following lines in your .bashrc in order to have the appropriate environment after logging out and back again (which in these distributions it must be from the complete system (e.g. gnome) not only from the terminal, or restart the whole machine).

# If not running interactively, don't do anything
# case $- in          #
#     *i*) ;;         # Comment these lines before logging out
#       *) return;;   # from the whole gnome (or restart the machine).
# esac                #

In addition, COMPSs requires ssh passwordless access. If you need to set up your machine for the first time please take a look at Additional Configuration Section for a detailed description of the additional configuration.