Skip to content

Install Rose From Source

Jump to bottom
Chunhua "Leo" Liao edited this page Aug 29, 2022 · 10 revisions

This page describes the basics of installing ROSE from source. These instructions assume you have the necessary dependencies including a compatible version of GCC and Boost, see Supported Configurations. Go to Installing compiler and boost from source for more information about GCC and Boost. Go to Software Dependencies for more information about ROSE dependencies.

This tutorial shows using the release branch of ROSE which undergoes extensive testing though is updated infrequently. If you want the latest version of rose you should use the develop branch which can be updated multiple times per day but undergoes more limited testing.

System specific instructions are available for the following systems.

Summary

Here is a summary of the commands needed to install ROSE.

PREFIX=/path/to/my/rose/directory
NUM_PROCESSORS=10 
BOOST_ROOT=/path/to/my/boost/installation/directory
export LD_LIBRARY_PATH="${BOOST_ROOT}/lib:$LD_LIBRARY_PATH"
git clone -b release https://github.com/rose-compiler/rose "${PREFIX}/src"
cd "${PREFIX}/src"
./build
mkdir ../build
cd ../build
../src/configure --prefix="${PREFIX}/install" \
                 --enable-languages=c,c++ \
                 --with-boost="${BOOST_ROOT}"
make core -j${NUM_PROCESSORS}
make install-core -j${NUM_PROCESSORS}
make check-core -j${NUM_PROCESSORS}

Set Up Enviroment

PREFIX=/path/to/my/rose/directory
NUM_PROCESSORS=10 
BOOST_ROOT=/path/to/my/boost/installation/directory
export LD_LIBRARY_PATH="${BOOST_ROOT}/lib:$LD_LIBRARY_PATH"

The first commands are to set up your environment for installing rose. The first command is to specify the location for rose to be installed. Under this directory the src, build, and install trees will be placed. ROSE install can be run in parallel so the next command is to set the level of parallelism. There should be at least 1.5GB of memory for each process. The next two commands are to let ROSE locate the installation of Boost.

Download, Build and Configure

git clone -b release https://github.com/rose-compiler/rose "${PREFIX}/src"
cd "${PREFIX}/src"
./build
mkdir ../build
cd ../build
../src/configure --prefix="${PREFIX}/install" \
                 --enable-languages=c,c++ \
                 --with-boost="${BOOST_ROOT}"

You need to clone the version of ROSE you want to install, more information about ROSE versions can be found at Distribution. Next change directory to the source tree and run build to set up for installing. Next navigate to the location of the build tree and run configure giving it the location for ROSE install, location of Boost, and languages to enable. More information on configure can be found at Configuring ROSE.

Make ROSE

make core -j${NUM_PROCESSORS}
make install-core -j${NUM_PROCESSORS}
make check-core -j${NUM_PROCESSORS}

The final steps are to run make core, make install-core, and make check-core. This will install the rose core libraries without any tools. Running make, make install, and make core will make all tools as well which takes significantly more time.

Setup Environment Variables

For example, if you use bash, you can use the settings:

ROSE_INS=/home/path/to/rose/install
export ROSE_INS

PATH=$ROSE_INS/bin:$PATH
export PATH

LD_LIBRARY_PATH=$ROSE_INS/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH
Clone this wiki locally