#FairSoft

This repository contain the installation routines of all the external software needed to compile and use FairRoot. To simplify the installation procedure of all these packages we provide a set of scripts which will automatically download, unpack, configure, build‚ and install all required software.

The scripts work on most Linux flavors and on Mac OSX. If you encounter any problems please create an issue at https://fairroot-redmine.gsi.de . To do this you have to register and/or login first.

##Prerequisites

The script needs a complete build environment to compile all the source code. A list of all needed system packages can be found in the DEPENDENCIES file. All these system packages are installed using the package manager of the used Linux flavor. A list of complete command lines to install all packages in one go are also added in the DEPENDENCIES file, so one only has to cut-n-paste the appropriate command line to a terminal window and start the installation.

##Guided Installation

To start the installation procedure one has to run the configure.sh script which is found in the main directory of FairSoft from within this directory. If the script is called without parameters one is guided through some menus to choose the appropriate setup.

FairSoft> ./configure.sh

In the first menu one has to define the compiler which should be used for the installation. The normal choices would be gcc for Linux and Clang for Mac OSX. The compiler must be installed on the system. If one choose a compiler which is not installed, the installation procedure will stop when checking for the prerequisites defined above.

In the second menu one has to decide if the packages should be installed in debug, normal or optimization mode. If one choose the optimization mode one should also define the correct optimization flags in the file scripts/check_system.sh, even if there are some default settings. If unsure don't use the optimization option.

In the third menu you can choose between the usage of ROOT5 and ROOT6. FairRoot running with ROOT6 has known problems on some Linux flavors, so please use this option not for your production setup. The new option ROOT6 is only for development and for testing purposes.

In the forth menu one has to define if one need to install all packages to run a simulation. If unsure choose Yes.

If the previous choice was Yes one has to define in the next menu how to handle the Geant4 data files. These files have after installation a size of approximately 650 MB. If you don't intent to use Geant4 you should choose Don't install, if unsure choose one of the other options described below.

If the data files should be installed it is normally save to choose the option Internet which will download the files and does the installation automatically when installing Geant4. Only if your system cannot download the files during installation, choose the Directory option. In this case one has to put the files into the transport directory so that they can be installed. One can download the files from the following webpage.

http://geant4.cern.ch/support/download.shtml

In the next menu one has to decide if the python bindings for Geant4 and Root should be installed. The python bindings are only needed for the Ship experiment, so if unsure choose No.

In the last menu one has to define the installation directory. All the programs will be installed into this directory. One shouldn't use as installation directory a directory which is used by the system (e.g. /usr or /usr/local). Since it is possible to install several version of "FairSoft" in parallel it is advisable to use a name tag in the directory name (e.g. <install_dir>/fairsoft_mar15)

After passing all menus the installation process will check if all needed system packages are installed. If one or more packages are missing the installation process will stop with an detailed error message. In this case please install the missing system packages and start the installation again.

The installation procedure may take a long time depending on your computer. If the installation procedure stops with an error it is save to start the script again. It will check which packages have been already compilled and installed successfully and will skip these packages.

##Installation with configuration file

As an alternative for experienced users it is also possible to pass an input file to the script which defines all the needed information. The configure.sh script will check if all variables are defined in the input file and if the values are allowed. In case an error is found the script will stop with an error message. Three example files (automatic.conf, grid.conf, and recoonly.conf) can be found in the main directory of FairSoft.

##Included Packages

• cmake 3.3.2 (only installed if installed version is to old)
• gtest 1.7.0
• gsl 1.16
• boost 1_61_0
• Pythia6 416
• HepMC 2.06.09
• Pythia8 212
• Geant4 10.02.p1
• xrootd 4.1.1
• ROOT v5.34.36 or v6.06.02
• Pluto v5.37
• Geant321+_vmc v2-1
• VGM v4-3
• G4VMC v3-3
• MillePede V04-03-04
• ZeroMQ 4.1.3
• Protocoll Buffers 2.6.1
• Nano Message 0.8-beta
• FlatBuffers 1.3.0
• MessagePack 1.4.1

In case the python bindings are build the following additional packages will be installed

• XercesC 3.1.2
• G4Py Version which comes with Geant4

##Installation of ALFA (Alice-FAIR software)

The ALFA installation will install the FairSoft as above and after that it will install three more packages:

• FairRoot

• DDS

• AliRoot

  FairSoft> ./alfaconfig.sh

The script will get the source code of all the packages from their own repostories, compile and install them. The versions and the urls of the different repositories used are specified in the file "scripts/package_versions.sh"

##Removal of packages

The installation script is mainly meant for one time installation of all packages. For developers we provide also another script which can remove the temporary files produced during compilation and the installed files for each of the packages. The script takes care also to delete all other packages which depend on the package which is removed. As an example given if you remove root then also geant4, vgm and geant4_vmc will be removed since these packages depend on root.

The skript is either called with one parameter which is the package name

./make_clean.sh root

to remove only the temporary files or with the second parameter all

./make_clean.sh root all

which will also remove the files istalled into the installation directory.