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
$ compss> ./submodules_patch.sh
Finally you just need to run the installation script. You have two options:
For all users
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 the current user
For installing COMPSs for the current user run the following commands:
$ compss> cd builders/
$ builders> INSTALL_DIR=$HOME/opt/COMPSs/
$ builders> ./buildlocal ${INSTALL_DIR}
Tip
The buildlocal
script allows to disable the installation of
components. The options can be foun 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
--autoparallel, -a Enable autoparallel module installation
--no-autoparallel, -A Disable autoparallel module 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
--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
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.