alio2docker

Alice O2 software in a docker (linux image - ubuntu 20.04)

quick how-to

1. git clone https://github.com/matplo/alio2docker.git && cd alio2docker;
2. optional step (see #3 why ) run ./buildDocker.sh to build the docker image locally (you may want to skip this step)
3. run ./runDocker.sh to run a the image... (note: in case no local images is found it will attempt to pull nobetternick/alisoft:o2)
4. run ./buildO2Physics.sh (within the container of course) and be super patient... ;-)
5. optional: you can run ./run_at_test.sh (run analysis tutorial test) - note: will attempt to curl an AOD file to AO2D-tutorial.root - this after entering into the alienv with for example ./enterO2Physics.sh

• to run a single command within the container just add it to the ./runDocker.sh (the container will run it and exit; interactive mode with no command at all)

./runDocker.sh ls -ltr

few notes

• on my laptop (macOS Catalina) I had to increase memory to 6GB for the container to compile... (see options in ./runDocker.sh); note to run analysis chain (thanks O2 experts) O2 needs 8GB shared mem - this is requested at runtime (see ./runDocker.sh)
• on a mac I am using Docker Desktop from Docker itself (one can increase the default mem in settings - global to all containers - default is 2GB)
• ./runDocker.sh will look for the exited (or running) containers and will print a note - you can ignore but this is ueful
• the ./runDocker.sh will try to map your user name within the container - will essentially create a user with your system id (and a home dir) and will look for your ~/.globus files...
• since the ./runDocker.sh prefers the (likely local) image alisoft:o2 to revert to the downloaded nobetternick/alisoft:o2 please retag or/remove the alisoft:o2 (useful commands: docker images -q alisoft:o2 and docker image rm <hashtag>)
• ./buildO2Physics.sh builds only that - need to tune/change if you want AliPhysics ...
• ALICE Software will land in a mounted directory in subdirectories where you cloned the repo... - lots of bytes so beware; within docker container the directory is /alisoft
• note the handy alisoft/enterO2Physics.sh that simply does alienv enter O2Physics/latest-master-o2

for the impatient

• you can try downloading the compiled software pack (includes sources) from a pre-built archive (per request)
• unpack the archive within the directory where cloned (not necessarily within the docker)
• build the container or download (pull - ./runDocker.sh does it automatically)
• run the container - you should be all set with a version of AliceO2Physics