CAIMAN Setup Guide

1. Clone the repository

   git clone git@code.jlab.org:hallb/clas12/calibration/caiman.git
   

2. Install the databases:

   git clone git@code.jlab.org:hallb/clas12/calibration/caiman-data.git caiman/caiman-data
   

3. Pull the Apptainer image:

   caiman/bin/caiman --upgrade
   

   • NOTE: This will fail if you are not in caiman/libexec/user.rb; if you are just installing locally for yourself, just add yourself in this file.
4. If this will be the official ifarm installation, set permissions; official deployment requires the user to be in the clas12caiman group.
   • Set group ownership to clas12caiman:

     chown -R $LOGNAME:clas12caiman caiman
     

   • Set directories' setgid bit so new files inherit the group:

     find caiman -type d -exec chmod g+s {} +
     

   • Make database files and the directories they are in be group writable:

     find caiman/caiman-data -type f -name '*.sqlite3' -exec chmod g+w {} +
     find caiman/caiman-data -type d -exec chmod g+w {} +
     

5. Proceed with the User Guide.