Warning, /JETSCAPE/README_LINUX.md is written in an unsupported language. File is not indexed.
0001 In order to install and compile the JETSCAPE framework on a Linux machine, one need to follow the following steps:
0002
0003 1. Clone the repository from Github:
0004 - git clone https://github.com/amajumder/JETSCAPE-COMP.git
0005 - Enter your Github credentials
0006
0007 2. Install and configure HepMC (Version 3.0.0 or higher)
0008 - Create a folder for installing HepMC
0009 - Go to the created folder
0010 - wget http://hepmc.web.cern.ch/hepmc/releases/hepmc3.0.0.tgz
0011 - tar -xvzf hepmc3.0.0.tgz
0012 - Go to the extracted folder
0013 - cd hepmc3.0.0/cmake
0014 - Run cmake command
0015 - cmake ..
0016 - Run make command (the user has to be sudoer)
0017 - make all install
0018 - The default path to install HepMC is /usr/local/lib/
0019
0020 3. Change Cmake configuration for HepMC (If Cmake could not find HepMC)
0021 - Set "HEPMC_DIR" as the root directory of HepMC
0022 - Go to ../framework/Modules
0023 - Open FindHEPMC.cmake
0024 - vim FindHEPMC.cmake
0025 - Make sure that cmake looks for the correct "include" and "lib" directories of HepMC
0026 - By default is "${HEPMC_DIR}/include/"
0027 - By default is "${HEPMC_DIR}/lib"
0028 - Replace "${HEPMC_DIR}" with "ENV{HEPMC_DIR}" if you are not root
0029 - The library file that cmake must find is "libHepMC.so"
0030
0031
0032 4. Install Pythia8
0033 - Create a folder for installing Pythia8
0034 - Got to the created folder
0035 - wget http://home.thep.lu.se/~torbjorn/pythia8/pythia8226.tgz
0036 - tar -xvzf pythia8226.tgz
0037 - Go to the extracted folder
0038 - cd pythia8226
0039 - Run make command
0040 - make
0041
0042 5. Configure the address of Pythia8 in the ../framework/setup.sh (If cmake could not find Pythia)
0043 - vim setup.sh
0044 - Change "PYTHIAINSTALLDIR" to the installing folder of Pythia8
0045 - Update the "PYTHIA8DIR" and "PYTHIA8_ROOT_DIR" address
0046 - should be "${PYTHIAINSTALLDIR}/pythia8226" by default
0047 - ./setup.sh
0048 - Make sure the variable are set into the session
0049 - Use source if they are not set
0050
0051 6. Install Boost libraries (Version 1.5 or higher)
0052 - wget https://dl.bintray.com/boostorg/release/1.64.0/source/boost_1_64_0.tar.gz
0053 - tar -xvzf boost_1_64_0.tar.gz
0054 - Go to the directory tools/build/.
0055 - Run bootstrap.sh
0056 - ./bootstrap.sh
0057 - Run b2 --prefix=PREFIX where PREFIX is the directory where you want Boost. Build to be installed
0058 - ./b2 install --prefix=PREFIX
0059 - Set "BOOST_ROOT" variable to the root directory of boost
0060 - export BOOST_ROOT=<root_directory>
0061
0062 7. Install HDF5 C++ library
0063 - wget https://support.hdfgroup.org/ftp/HDF5/releases/hdf5-1.8/hdf5-1.8.18/src/hdf5-1.8.18.tar
0064 - tar -xvvf hdf5-1.8.18.tar
0065 - ./configure
0066 - make
0067
0068 8. Create a build folder in ../src/framework
0069 - mkdir build
0070 - Got to the build folder
0071 - cd build
0072 - Make sure that in CMakeLists.text there is a condition on UNIX not LINUX
0073 - if(UNIX)
0074 message( STATUS "Linux : " ${CMAKE_HOST_SYSTEM})
0075 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
0076 endif()
0077 - Make sure $LD_LIBRARY_PATH is set to the address of dynamic library files
0078 - echo $LD_LIBRARY_PATH
0079 - If there is nothing to dispay
0080 - export LD_LIBRARY_PATH=<dynamic_lib_dir>
0081 - If the address is not included in the variable
0082 - LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<dynamic_lib_dir>
0083 - Run cmake
0084 - cmake ..
0085 - If cmake cannot find HDF5 library, set "-DCMAKE_LIBRARY_PATH" and "-DCMAKE_INCLUDE_PATH" flags when you run cmake
0086 - cmake -DCMAKE_LIBRARY_PATH=<HDF5_Include_Path> -DCMAKE_INCLUDE_PATH=<HDF5_Lib_Path> ..
0087 - run make
0088 - make
0089
