Requirements and Installation

Requirements

• Python 3

Optional Requirements

• docker >= 17.12.0-ce

• docker package for Python

Installation

1. Install pycompss-cli:

   Since the PyCOMPSs CLI package is available in Pypi, it can be easly installed with pip as follows:

   $ python3 -m pip install pycompss-cli
   

2. Check the pycompss-cli installation:

   In order to check that it is correctly installed, check that the pycompss-cli executables (pycompss, compss and dislib, which can be used indiferently) are available from your command line.

   $ pycompss
   [PyCOMPSs CLI options will be shown]
   

Installing docker is optional and it’s only required for running and deploying Docker type environments.

Unix

2. Install Docker (continue with step 3 if already installed):

   2.1. Suggested Docker installation instructions:

   • Docker for Mac. Or, if you prefer to use Homebrew.

   • Docker for Ubuntu.

   • Docker for Arch Linux.

   Be aware that for some distributions the Docker package has been renamed from docker to docker-ce. Make sure you install the new package.

   2.2. Add user to docker group to run the containers as a non-root user:

   • Instructions

   2.3. Check that docker is correctly installed:

   $ docker --version
   $ docker ps # this should be empty as no docker processes are yet running.
   

3. Install docker for python:

   $ python3 -m pip install docker
   

   Tip

   Some Linux distributions do not include the $HOME/.local/bin folder in the PATH environment variable, preventing to access to the pycompss-cli commands (and any other Python packages installed in the user HOME).

   If you experience that the pycompss| compss| dislib command is not available after the installation, you may need to include the following line into your .bashrc and execute it in your current session:

   $ export PATH=${HOME}/.local/bin:${PATH}
   

Windows

1. Install Docker (continue with step 2 if already installed):

   2.1. Suggested Docker installation instructions:

   • Docker for Windows.

   2.2. Check that docker is correctly installed:

   $ docker --version
   $ docker ps # this should be empty as no docker processes are yet running.
   

2. Install docker-py for python:

   $  conda install -c conda-forge/label/cf201901 docker-py