There are many ways to install ULFM. For large scale experiments or large platforms, you should follow the instructions from the ULFM 2.0 repository. However, for a quick test, or for a small non-performance critical test, one might want to spend time on working on the concepts instead of installing. Thus, we provide a docker image for those who want to quickly test it’s capabilities.
Using the Docker Image
- Install Docker
- Docker can be seen as a “lightweight” virtual machine.
- Docker is available for a wide range of systems (MacOS, Windows, Linux).
- You can install Docker quickly, either by downloading one of the official builds for MacOS or Windows, or by installing Docker from your Linux package manager (e.g.
yum install docker,
port install docker-io, etc.)
- In a terminal, Run
1docker run hello-world
to verify that the docker installation works.
- Load the pre-compiled ULFM Docker machine into your Docker installation
1docker pull abouteiller/mpi-ft-ulfm
- Source the docker aliases in a terminal, this will redirect the “make”
and “mpirun” command in the local shell to execute in the Docker machine.
12alias make='docker run -v $PWD:$PWD:V -w $PWD abouteiller/mpi-ft-ulfm make'alias mpirun='docker run -v $(pwd):$(pwd):V -w $(pwd) abouteiller/mpi-ft-ulfm mpirun --oversubscribe -mca btl tcp,self'
- Run some example to see how this works. Quick examples can be found in the tutorial examples directory. You can now type
maketo compile the examples using the Docker provided “mpicc”, and you can execute the generated examples in the Docker machine using
1mpirun -np 10 example