LARIATSOFT DOCKER GUIDE

Docker User Guide: https://docs.docker.com/engine/userguide/ Docker Quick Reference: https://docs.docker.com/engine/reference/run/

---

###INSTALL

1. Start The Container

2. Start a new docker container:

   $ docker run -itv /data/$USER:/data wghilliard/lariatsoft # Note: The '-v /data:/data' is the volume mount point, # syntax is as follows '-v :<docker_destination>'

OR

1. Start an existing docker container:

   $ docker ps -a

   $ docker start CONTAINER_ID

   $ docker attach CONTAINER_ID`

2. Setup Lariatsoft Enviournment:

   $ cd /products

   $ source setup

   $ setup gitflow

   $ setup mrb

   $ setup ninja v1_6_0a

   $ setup lariatsoft v04_35_00 -q e9:prof

   $ source ./dev/localProducts_lariatsoft_v04_35_00_e9_prof/setup

3. (Optional) Make an out directory:

   $ mkdir /data/$USER/out # Note: The directory may not be writable if the mount volume specified earlier # is created by a different $USER.

###GENERAL NOTES:

• Data transfer into and out of the docker container is most easily done via the mount point, however scp is also and option. https://docs.docker.com/machine/reference/scp/
• Docker containers by default have access to all system resources, however constraints can be added. https://docs.docker.com/engine/reference/run/#runtime-constraints-on-resources

FUTURE PLANS:

• Automated lariatsoft environment setup.
• Built-in self testing.
• Container size reduction.