Creating a New Dev Area

This page explains how to set up a new dev area (for yourself, or for the shifter area).

Detailed instructions on how to create your dev area from scratch can be found using the link below.

SBN DAQ Software Setup InstructionsSBN Software Wiki

Changing onto a DAQ machine

When you're in the GPVM, you should ssh into a different machine if you're planning on running anything (like doing database stuff):

ssh sbnd-evb04

Important: You need to be on a different machine (and not the gateway) to create and build your area! sbnd-daq02 has been a bitch lately, so don't use it.

Navigating to DAQ_DevAreas

Once you're on a DAQ machine, you need to cd into the below directory, where all the DAQ dev areas are:

cd /home/nfs/sbnd/DAQ_DevAreas

Making a new dev directory

Before doing anything else, you need to make a new dev directory in DAQ_DevAreas:

mkdir <new_dev_area>

If you're making a dev area to do a DAQ test out of, use the naming convention below:

DAQ_<your_name>_<date>

Running the createDevArea.sh script

Handily, Amy made a script called createDevArea.sh which does all the heavy lifting when making your dev area. The structure of it is shown below:

createDevArea.sh

#For creating an area in sbnd's home area. Be sbnd for this.
if [ $# -eq 0 ]; then
    >&2 echo "Provide directory name as argument"
    exit 1
fi

#ksu sbnd
AreaName=$1
VERSION=v1_10_04
QUALS=e26:prof:s131

source /daq/software/products/setup   #common area
source /daq/software/products_dev/setup   #dev area
setup sbndaq $VERSION -q$QUALS # update this to the version I want

#echo "l10"
setup mrb v6_08_01
export MRB_PROJECT=sbndaq
export my_sbndaq_version=$(echo  $SETUP_SBNDAQ |cut -d " " -f 2)
export my_sbndaq_quals=$(echo  $SETUP_SBNDAQ |cut -d " " -f 8)

echo sbndaq version: $my_sbndaq_version
echo sbndaq qualifiers: $my_sbndaq_quals

cd /home/nfs/sbnd/DAQ_DevAreas #sbnd/DAQ_DevAreas

#if [ ! -d $AreaName ];
#    echo "Making directory ${AreaName}"
#    mkdir $AreaName
#fi

cd $AreaName
mrb newDev  -q $my_sbndaq_quals -v $my_sbndaq_version
source localProducts_*/setup

cd $MRB_SOURCE
mrb g sbndaq@$my_sbndaq_version sbndaq_artdaq@$my_sbndaq_version sbndaq_artdaq_core@$my_sbndaq_version wibtools@$my_sbndaq_version

cd ..
ln -s srcs/sbndaq/sbn-nd/DAQInterface/ DAQInterface

cd srcs/wibtools
git remote set-url origin https://github.com/SBNSoftware/wibtools.git
git fetch
git checkout $VERSION

cd $MRB_BUILDDIR
cd ..
mrbsetenv
cd $MRB_BUILDDIR
echo "Directory has been made, do 'mrb i -j8' to install. You are now user sbnd. Exit if not desired. "

Within this, it's important to change (if needed) two things:

1

VERSION (line 9)

VERSION is where you select which release of sbndaq-artdaq you want to use. Gennadiy sends out emails with the latest version names.

2

QUALS (line 10)

QUALS is where you select the qualifiers you want to use.

Once you've selection the version and qualifiers you want, you can run the script as seen below, making sure to include the directory you just made as an argument:

source /home/nfs/sbnd/createDevArea.sh <new_dev_area>

Building the dev area

Before you do anything with your dev area, you need to build it. To do this, run the below command:

mrb i -j8

The -j8 part of this will build your area on eight cores in parallel instead of just one (so you can remove it if you don't need it).

Now, you're ready to begin using your dev area! 🙌