Chapter 14
Installation

14.1 Download

Various pre-compiled packages are provided. They are named

where

version

specifies the exact revision of Urbi that you are using. It can be simple, 2.0, or more complex, 2.0-beta3-137-g28f8880. In that case,

2.0

is the version of the urbiscript Kernel,

beta3

designates the third pre-release,

137

is the number of changes since beta3 (not counting changes in sub-packages),

g28f8880

is a version control identifier, used internally to track the exact version that is being tested by our users.

arch

describes the architecture, the cpu: ARM, ppc, or x86.

os

is the operating system: linux for GNU/Linux, osx for Mac OS X, or windows for Microsoft Windows.

compiler

is the tool chain used to compile the programs: gcc4 for the GNU Compiler Collection 4.x, vcxx2005 for Microsoft Visual C ++ 2005, vcxx2008 for Microsoft Visual C ++ 2008.

ext

is the package format extension: tar.gz for Unix style tar balls (uncompressed with tar zxf tarfile ), and zip for Windows style zip files.

14.2 Install & Check

The package is relocatable, i.e., it does not need to be put at a specific location, nor does it need special environment variables to be set. It is not necessary to be a super-user to install it. The root of the package, denoted by urbi-root hereafter, is the absolute name of the directory which contains the package.

After the install, the quickest way to test your installation is to run the various programs.

14.2.1 GNU/Linux and Mac OS X

Decompress the package where you want to install it:

 
$ rm -rf 
urbi-root
 
$ cd /tmp 
$ tar zxf 
path-to
/urbi-sdk-2.0-linux-x86-gcc4.tar.gz 
$ mv urbi-sdk-2.0-linux-x86-gcc4 
urbi-root
   

This directory, urbi-root, should contain ‘bin’, ‘FAQ.txt’ and so forth. Do not move things around inside this directory. In order to have an easy access to the Urbi programs, set up your PATH:

 
$ export PATH=
"
urbi-root
/bin:$PATH"
   

 
# Check that urbi is properly set up.
 
$ urbi --version 
 
# Check that urbi-launch is properly installed.
 
$ urbi-launch --version 
# Check that urbi-launch can find its dependencies.
 
$ urbi-launch -- --version 
 
# Check that Urbi can compute.
 
$ urbi -e 
’1+2*3; shutdown;’
 
[00000175] 7
   

14.2.2 Windows

Decompress the zip file wherever you want or execute the installer.

Execute the script ‘urbi.bat’, located at the root of the uncompressed package. It should open a terminal with an interactive Urbi session.

Cygwin Issues