Installing CODES with Cortex

This page describes the step-by-step process to compile CODES and its dependencies and enable Cortex. First, create a directory in which all these dependencies will be installed. In the following, we will assume this directory is $HOME/CODES.

Installing DUMPI (mandatory)

cd $HOME/CODES
git clone https://github.com/sstsimulator/sst-dumpi.git
mv sst-dumpi dumpi
cd dumpi
./bootstrap.sh
mkdir build
cd build
../configure --disable-libdumpi --enable-libundumpi --prefix=$HOME/CODES/install/dumpi
make
make install
cd ../..

Installing Python (optional)

wget https://www.python.org/ftp/python/2.7.12/Python-2.7.12.tgz
tar xvf Python-2.7.12.tgz
mv Python-2.7.12 python
cd python
mkdir build
cd build
../configure --prefix=$HOME/CODES/install/python
make
make install
cd ../..

Installing Boost-Python (mandatory if Python is enabled, optional otherwise)

Make sure you PATH points to where the previously built Python is installed, before continuing. Conflict between different Python installations are the source of most issues in later steps of the installation process.

Download boost at http://www.boost.org/users/download/ (version 1.62 is required. Other versions might lead to build issues. 1.62 is available at the boost archives.)

tar xvf boost_1_62_0.tar.gz
mv boost_1_62_0 boost
cd boost
./bootstrap.sh --prefix=$HOME/CODES/install/boost --with-libraries=python --with-python-root=$HOME/CODES/install/python
./b2
./b2 install

Installing Cortex (mandatory)

git clone https://xgitlab.cels.anl.gov/mdorier/dumpi-cortex.git
mv dumpi-cortex cortex
cd cortex
mkdir build
cd build
cmake .. -G "Unix Makefiles" -DMPICH_FORWARD:BOOL=TRUE -DCMAKE_INSTALL_PREFIX=$HOME/CODES/install/cortex -DDUMPI_ROOT=$HOME/CODES/install/dumpi \
                                                                -DBOOST_ROOT=$HOME/CODES/install/boost -DPYTHON_ROOT=$HOME/CODES/install/python
make
make install
cd ../..

NOTE: if you don't want Python, remove the definitions of BOOST_ROOT and PYTHON_ROOT in the call to cmake.

Installing ROSS

git clone https://github.com/ROSS-org/ROSS.git
mv ROSS ross
cd ross
mkdir build
cd build
ARCH=x86_64 CC=mpicc CXX=mpicxx cmake .. -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=$HOME/CODES/install/ross
make
make install
cd ../..

Installing CODES

git clone https://xgitlab.cels.anl.gov/codes/codes.git
cd codes
./prepare.sh
mkdir build
cd build
../configure --prefix=$HOME/CODES/install/codes CC=mpicc CXX=mpicxx PKG_CONFIG_PATH=$HOME/CODES/install/ross/lib/pkgconfig \
                     --with-dumpi=$HOME/CODES/install/dumpi --with-cortex=$HOME/CODES/install/cortex --with-python=$HOME/CODES/install/python \
                         --with-boost=$HOME/CODES/install/boost
make
make install
cd ../..

NOTE: if you don't want Python, remove the --with-python and --with-boost arguments in the call to configure.