How to install MpdRoot

Before installing MpdRoot make sure that the following packages are installed on your system!

• • Install packages needed for RedHat-based OS (eg, Scientific Linux):

• • Install packages needed for Debian-based OS (eg, Ubuntu):

Installing the external packages

1. 1. Set an installation path for the external packages, e.g. /opt

export INSTALLATION_PATH=/opt
cd $INSTALLATION_PATH

1. 1. Install the FairSoft package

The June 2019 release of FairSoft can be downloaded from GitHub:

git clone https://github.com/FairRootGroup/FairSoft.git fairsoft
cd fairsoft
git checkout jun19p1

Apply patch (to add the last ROOT functions concerned with PostgreSQL databases):

wget http://nc13.jinr.ru/data/fairsoft_jun19p1.patch
patch -p1 -i fairsoft_jun19p1.patch

Installing fairsoft: follow the instructions on the screen. You can use options suggested below.

./configure.sh
# 1) GCC (on Linux)
# 1) No Debug Info
# 2) No (not install FairMQ Only)
# 1) Yes (install Simulation engines and event generators)
# 2) Internet (install G4 files from internet)
# 2) No (not compile Geant4 in multihreaded mode)
# 2) No (not install the python bindings)
# path: $INSTALLATION_PATH/fairsoft/install

1. 1. Install the FairRoot environment

The release of FairRoot (18.2.0) can be downloaded from GitHub:

cd $INSTALLATION_PATH
export SIMPATH=$INSTALLATION_PATH/fairsoft/install
export PATH=$SIMPATH/bin:$PATH
git clone https://github.com/FairRootGroup/FairRoot.git fairroot
cd fairroot
git checkout v18.2.0

Apply patch (to correct WriteConfigFile for BmnRoot installation):

wget http://nc13.jinr.ru/data/fairroot_18_20.patch
patch -p1 -i fairroot_18_20.patch

Installing fairroot:

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX="$INSTALLATION_PATH/fairroot/install" ..
make
make install

Installing the mpdroot software

1. 1. Choose the installation directory

Go to the directory where you want to install the MpdRoot software, e. g. home directory:

cd ~

1. 1. Clone GIT repository

Register on JINR GitLab with @jinr.ru mail, if you have not already done. Add SSH key (readme) to your profile to not enter the password every time you access.

1. 1. • Clone GIT repository with HTTPS (read-only access)

for MpdRoot (pro release branch. If you want the last developer version, add -b dev):

git clone -b new_fair_structur --recursive https://git.jinr.ru/nica/mpdroot.git

1. 1. • Clone GIT repository with SSH (for developers)

for MpdRoot (dev developer branch):

git clone -b new_fair_structur --recursive git@git.jinr.ru:nica/mpdroot.git

1. 1. Installation procedure for MpdRoot

      • Configure:

"cd mpdroot"
mkdir build
. SetEnv.sh
cd build
cmake ..

By default, in the SetEnv.sh file SIMPATH points to /opt/fairsoft/install, and FAIRROOTPATH – /opt/fairroot/install directories. If you installed FairSoft or FairRoot to another directory, please, change SIMPATH and FAIRROOTPATH variables in the file (“export SIMPATH=[your FairSoft install path]” and “export FAIRROOTPATH=[your FairRoot install path]”).

1. 1. • Build the framework:

make
. config.sh

1. 1. • Run “. config.sh” every time you run terminal to work with BmnRoot/MpdRoot

1. 1. Update your local branch from origin branch:

"cd mpdroot" 
git pull --recurse-submodules