MARIE 0.5 Installation Guide

From MARIE

Jump to: navigation, search

This installation guide is a work in progress. Information will be added or modified continually to help users and developpers get through the installation process. It covers installation of all the required and optional packages for MARIE. Required packages are marked with (*). Version requirements are not exhaustive and final. Other version might worked but have not been tested yet.


Contents

Linux Distribution

Ubuntu "Dapper" with the following package repositories :

  • Officially supported
  • Restricted copyright
  • Community maintained (Universe)
  • Non-free (Multiverse)

Those repositories can be selected using Synaptic.

IMPORTANT NOTE : To simplify installation procedure, all required packages already installed with that distribution won't be mentionned in the procedure. If you use another distribution, some required packages could be missing or not updated to the correct version.


gcc *, g++ *, cpp *

version : 4.0.3

Install the following packages :

  • gcc
  • g++
  • cpp


make *

version : 3.81beta4

Install the following package :

  • make


libltdl3 *

version : 1.5.22-2

Install the following package :

  • libltdl3-dev


Scons *

version : 0.96.92.D002

This version is not available as a package, so it needs to be downloaded from Scons website : http://www.scons.org/

To install in /usr : 

# sudo python setup.py install


Subversion *

version : 1.3.1

Install the following package :

  • subversion
  • esvn (optional Qt front-end)


MARIE *

Version 0.5

This version is not available as a package, so it needs to be downloaded from MARIE website : http://sourceforge.net/project/showfiles.php?group_id=85891

No installation is required at this point. Sources are mandatory to get patch files used in the next steps.

ACE *

version : 5.5.1

This version is not available as a package, so it needs to be downloaded from ACE website : http://www.cs.wustl.edu/~schmidt/ACE.html

Then compile and install ACE. To install in local directory : 

# mkdir build
# cd build
# ../configure --prefix=<local install directory>

To avoid environement variable name clashes with other packages, config.h in build/ace, which is generated after the configure, needs to be modified. Lines that defines variables PACKAGE_VERSION and PACKAGE_NAME must be commented.

Then proceed to the compilation : 

# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.

mpich2 *

version 1.0.3-2

This version is not available as a package. Debian packages are available on mpich2 website : http://www-unix.mcs.anl.gov/mpi/mpich2/. The following packages are required :

  • mpich2_1.0.3-2_i386.deb
  • mpich2-mpd_1.0.3-2_i386.deb
  • libmpich2-1.0_1.0.3-2_i386.deb
  • libmpich2-1.0-dev_1.0.3-2_i386.deb

First install the following package :

  • python2.3-xml

Then use dpkg to install downloaded packages : 

# sudo dpkg -i <downloaded package>

Post-installation intructions

Create and edit file .mpd.conf in your home directory to have the following line : 

secretword = <your_favorite_secret_word>

Make sure this file have the proper rights by doing : 

# chmod 600 ~/.mpd.conf

Player

version 1.6.5

This version is not available as a package, so it needs to be downloaded from Player/Stage website : http://playerstage.sourceforge.net/

Compile and install Player. To install in local directory : 

# ./configure --prefix=<local install directory>
# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.


Stage

version 2.0.0a

This version is not available as a package, so it needs to be downloaded from Player/Stage website : http://playerstage.sourceforge.net/

First install the following package :

  • libgtk2-dev

Then patch stage using diffStage2.0.0.a.patch found in util/patches of marie sources : 

# cp <marie_sources_path>/util/patches/diffStage2.0.0.a.patch <stage_sources_path>
# cd <stage_sources_path>
# patch -p1 < diffStage2.0.0.a.patch

Another command need to be execute to copy X11's rgb.txt file where Stage wants it: 

# sudo cp /etc/X11/rgb.txt /usr/X11R6/lib/X11

Then compile and install Stage. To install in local directory : 

# ./configure --prefix=<local install directory>
# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.

CARMEN

version 0.4.6.ii

This version is not available as a package, so it needs to be downloaded from CARMEN website : http://www.cs.cmu.edu/~carmen/getting_carmen.html

First install the following packages :

  • libgnome-dev
  • libgtk1.2-dev
  • libreadline5-dev
  • gdk-imlib11-dev

Then patch CARMEN using diffCarmen0.4.6.ii.patch found in util/patches of marie sources : 

# cp <marie_sources_path>/util/patches/diffCarmen0.4.6.ii.patch <carmen_sources_path>
# cd <carmen_sources_path>
# patch -p1 < diffCarmen0.4.6.ii.patch

To install CARMEN in a local directory, it is recommended to copy all the sources in the desire installation directory and then compile from there. This is related to an issue with CARMEN installation scripts that doesn't behave as expected.

Then compile Carmen : 

# cd src
# ./configure (select default options when requested)
# make
# make install (only if install in default path, otherwise it is not recommanded)

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.

FlowDesigner

version CVS (0.9.1)

This version is not available as a package, so it needs to be downloaded from FlowDesigner CVS repository. Follow instructions on FlowDesigner website to get latest CVS sources : http://sourceforge.net/cvs/?group_id=99346

First install the following package :

  • fftw-dev (optional)

Then compile and install FlowDesigner. To install in local directory : 

# ./autogen.sh --prefix=<local install directory>
# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.

RobotFlow

version CVS (0.2.7)

This version is not available as a package, so it needs to be downloaded from RobotFlow CVS repository. Follow instructions on RobotFlow website to get latest CVS sources : http://sourceforge.net/cvs/?group_id=51402

First install the following package :

  • libcv-dev (optional)
  • libsdl1.2-dev (optional)

Then compile and install RobotFlow : 

# ./autogen.sh
# make
# make install

WxWidgets

Version 2.6.2

Altough there's a package for WxWidgets, for some dependencies to string representation format, the package cannot be used directly. WxWidgets then needs to be downloaded from WxWidgets website : http://www.wxwidgets.org/.

Compile and install WxWidgets. To install in local directory : 

# ./configure --prefix = <local installation path>
# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.


CPPUnit

version 1.12.0

This version is not available as a package, so it needs to be downloaded from CPPUnit website : https://sourceforge.net/project/showfiles.php?group_id=11795

First install the following package :

  • doxygen (optional)
  • graphviz (optional)

Then patch CPPUnit using diffCPPUnit1.12.0.patch found in util/patches of marie sources : 

# cp <marie_sources_path>/util/patches/diffCPPUnit1.12.0.patch <cppunit_sources_path>
# cd <cppunit_sources_path>
# patch -p1 < diffCPPUnit1.12.0.patch

Then compile and install CPPUnit. To install in local directory : 

# ./configure --prefix=<local install directory>
# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.


Mockpp

version 1.11.5

This version is not available as a package, so it needs to be downloaded from Mockpp website : http://mockpp.sourceforge.net/

First install the following package :

  • automake1.9

Then patch mockpp using diffMockpp1.11.5.patch found in util/patches of marie sources : 

# cp <marie_sources_path>/util/patches/diffMockpp1.11.5.patch <mockpp_sources_path>
# cd <mockpp_sources_path>
# patch -p1 < diffMockpp1.11.5.patch

Then compile and install Mockpp. To install in local directory : 

# ./configure --prefix=<local install directory>
# make
# make install

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.


Doxygen

version : 1.4.6

Install the following package :

  • doxygen


Graphviz

version : 2.2.1

Install the following package :

  • graphviz


MARIE

Version 0.5

First install the following package :

  • libqt4-dev (optional)

Then compile and install MARIE. To install in local directory : 

# scons prefix=<local install directory>
# scons install

If you want to install MARIE in a shared directory (e.g. /usr/local or /usr/local/MARIE) and some previous softwares are in non-default directories (e.g. Player in /usr/local/player instead of /usr/local) : 

# scons prefix=<shared install directory>
# sudo sh -c "PATH=$PATH scons install"

Post-installation intructions

Add <prefix>/lib in environment variable LD_LIBRARY_PATH.
Add <prefix>/bin in environment variable PATH.
Add <prefix>/lib/pkgconfig in environment variable PKG_CONFIG_PATH.

You can also compile unit tests and install MARIE's unit testing tools library by doing : 

# scons check install

If you're using FlowDesigner, this post-installation command is required : 

# export FLOWDESIGNER_PATH=<MARIE local install directory>/lib
Retrieved from "http://marie.sourceforge.net/wiki/index.php/MARIE_0.5_Installation_Guide"
Personal tools
Resources on SourceForge