You are here: Home / Getting PIPS / Building and Installing PIPS from SVN

Building and Installing PIPS from SVN

Detailed instructions on how to build and install PIPS from the PIPS subversion repository. This is currently the preferred method for installing PIPS.

Step 1: Install required dependencies

For compilation:

ca-certificates
wget
subversion (preferably >= 1.5)
make
sed
perl
cproto (see the Known Bugs section)
gcc
flex
bison
ctags
libreadline-dev
libncurses-dev

For validation:

gfortran
indent

Optional dependencies:

For documentation:

latex
htlatex

For epips:

emacs

For jpips:

JDK

For pyps:

python (preferably 2.5 - 2.7)
swig

For gpips:

GTK2

Step 2: Download the setup script and make it executable

The script can be downloaded here: setup_pips.sh.

$ wget https://scm.cri.ensmp.fr/svn/nlpmake/trunk/makes/setup_pips.sh
$ chmod +x setup_pips.sh

Step 3: Run the setup script

You can execute the setup_pips.sh shell script to install a possibly working pips version and your development branches if you have any.

Note: what does this script do ? It will:

Checkout the source code for PIPS, Newgen and Linear from the SVN repository (in MYPIPS/prod).
Checkout the validation test cases from SVN (in MYPIPS/validation)
Checkout a working copy for the private user's branch, if any (in MYPIPS/pips_dev).
Download and install the Polylib library

Additionally, the script will complain in case any dependencies listed in Step 1. are missing.

 $ ./setup_pips.sh [destination [user]]

where:

destination is the destination directory (default: ~/MYPIPS)
user is...

Note: The script will take a few minutes for downloads and compilations.

Step 4: Load the PIPS environment variables

$ source ~/MYPIPS/pipsrc.sh

Notes:

You may want to make this change permanent by inserting the above line in your ~/.profile or ~/.bashrc file.
If you prefer to work in your private branch (for PIPS developers only), make the environment variable PIPS_ROOT point to MYPIPS/pips_dev rather than MYPIPS/prod/pips.

Step 5: Validate the build

$ unset LANG
$ cd ~/MYPIPS/validation
$ make -j4 validate

At this point, you should have a working copy of PIPS.

Annex: Rebuilding Pips

Different reasons may require rebuilding PIPS:

Update your working copy from SVN
Integrate your own transformations
Relaunch a failed build
...

The following commands will rebuild your entire PIPS environment (including dependencies surch as Newgen, Linear, etc.):

$ cd MYPIPS/prod
$ make unbuild
$ make -j1 build

Notes:

The -j1 flag may be necessary to prevent make from performing concurrent builds on our dual-core CPU, depending on the default behaviour of the make utility for a given platform.

If you have a private branch in the SVN repository, you should repeat this operation in ~/MYPIPS/pips_dev.

Known Bugs

cproto 4.6 and PIPS are known to be incompatible. If you need to install cproto from source, be sure to download it from here, *not* the Sourceforge page (which offers only version 4.6) :

http://invisible-island.net/cproto/cproto.html

Current version (at the time of writing) is cproto 4.7l.