IndexNextUpPreviousUrbi SDK 2.7.5

Chapter 16
Installation

 16.1 Download
 16.2 Install & Check
  16.2.1 GNU/Linux and Mac OS X
  16.2.2 Windows

16.1 Download

Various pre-compiled packages are provided. They are named

urbi-sdk-version-arch-os-compiler.ext

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

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

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

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

Inputs and outputs of windows native application are buffered under Cygwin. Thus, either running the interactive mode of Urbi or watching the output of the server under Cygwin is not recommended.