Build Guide

1. Check-out LRTE scripts

git clone https://github.com/mzhaom/lrte.git

2. Download the required tar-balls:

cd lrte; TAR_DIR=upstream ./grte/download.sh

This step will download all the required source packages(to build LRTE) into upstream directory.

3. Build LRTE

3.1 Build using docker.

This is recommended because docker provides a consistent environment.

./release.py --docker_image=ubuntu:14.04 --no_build_crosstool

This step will just build LRTE packages inside ubuntu container and put them under the output/lrte directory. The process will take several minutes to hours depending on this CPU/memory of the build host.

There are a few options that can be used to tune the output package:

  --email EMAIL         Email address used as package maintainer (default:
                        foo@bar.io)
  --lrte_prefix         Directory prefix where lrte gets installed (default:
                        /usr/lrte)

--lrte_prefix is a very useful option when you want to control the output package's internal structure. By default, the prefix is /usr/lrte and the dynamic library loader will be hard coded to /usr/lrte/v1/lib64/ld-linux-x86-64.so.2. By changing it to something like $HOME/lrte, you can use LRTE without having to install it to a system location under /usr.

3.2 Build on metal host directly

3.3 Advanced build setting

grte/grte.cfg can be changed to further tune the LRTE building process. For example, "/usr/lrte/v2" can be changed to "/usr/lrte/v3" by changing GRTEVERSION to 3. This allows different major releases of LRTE co-exist on the same machine.