Building¶
The software stack is rather complicated. Obiwan is a wrapper around legacypipe, which has many dependences. So there are two methods for installing everything, Docker and from scratch.
Obiwan with Docker¶
Docker is the preferred method, as Obiwan can be run from a laptop and NERSC using the same Docker image. The Docker image is available on Docker Hub.
On your laptop¶
First pull:
docker pull adematti/obiwan:DR9
To run on-the-fly:
docker run adematti/obiwan:DR9 ./yourscript.sh
Or in interactive mode, you can bind mount your working directory absolutepath:
docker run --volume absolutepath:/homedir/ -it adematti/obiwan:DR9 /bin/bash
which allows you to work as usual (type exit to exit).
On NERSC¶
First pull:
shifterimg -v pull adematti/obiwan:DR9
To run on-the-fly:
shifter --module=mpich-cle6 --image=adematti/obiwan:DR9 ./yourscript.sh
In interactive mode:
shifter --volume absolutepath:/homedir/ --image=adematti/obiwan:DR9 /bin/bash
Note
For further information on shifter, see shifter docs 1.
Obiwan from scratch¶
To install Obiwan from scratch, the simplest way is to follow instructions in the Travis file:
first go through apt installs, then install.