Chapter 13
Installation

Read this chapter is you plan to install a pre-compiled package from Gostai. If Urbi is already installed, see Listing 2, “Getting Started”. If you plan to compile Urbi yourself, be sure to read the Listing 18, “Building Urbi SDK ”.

13.1 Download

If you already have an Urbi installed on your machine, proceed to Section 13.2.

13.1.1 Download Urbi 3.0.0

The following table gives a quick access to the packages we provide. You may also directly browse https://github.com/jcbaillie/urbi/urbi/3.0.0/. For other versions of Urbi SDK, see Section 13.1.2.

13.1.2 Download a Specific Version of Urbi

All the versions of Urbi are available at https://github.com/jcbaillie/urbi/urbi/.

Our packages are named as follows:

where

kind

defines what the package is about:

sdk

Urbi SDK, i.e., the full package, including libraries, headers, programs, documentation, etc. This is meant for the computers of the developers.

runtime

Only what is needed to run (as opposed to compile) Urbi programs. This is meant for robots.

doc

The whole documentation.

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 Urbi 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. For Unix architectures, tar.bz2; uncompress them with tar xf tarfile. For Windows hosts, we provide zip files (‘*.zip’) for both “release” and “debug” flavors, and installers (for instance ‘*.exe’). You are encouraged to use the installers, since in addition to installing headers and libraries, they also install Visual C++ Wizards to create UObjects, they take care of installing the Visual Runtime if needed, and they install Gostai Console and Gostai Editor.

13.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.

13.2.1 GNU/Linux and Mac OS X

Decompress the package where you want to install it. If urbi-sdk-2.x denotes the version of Urbi SDK you downloaded (say, urbi-sdk-2.x is ‘urbi-sdk-2.3-linux-x86-gcc4’), run something like:

 
$ rm -rf urbi-root 
$ cd /tmp 
$ tar xf path-to/urbi-sdk-2.x.tar.bz2 
$ mv urbi-sdk-2.x 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
       

13.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