[[TracNav(TracNav/TOC_install)]]
= Ubuntu Linux =

''Last checked (not all the dependencies reviewed) (r1293): 15. May. 2008 by [wiki:BenjaminKnecht Beni] on Ubuntu 8.04 (Hardy Heron)''

Unfortunately there is not yet a Debian package available for Orxonox. We're eager to release one, though.

== Dependencies and third party libs ==

For developers we recommend to install the latest version of [http://ogre3d.org/index.php?option=com_content&task=view&id=412&Itemid=132 Ogre]. However, you might run into problems compiling Ogre.

Packages: cmake, libogre-dev, libois-dev, libenet1-dev, libboost-thread-dev, libfreeimage-dev, libzzip-dev, liblua5.1-0-dev, tcl8.4-dev

To install use the following command or just use your favorite packet manager.
{{{
  $ sudo aptitude install build-essential cmake libogre14-dev libois-dev libnet1-dev libboost-thread-dev libfreeimage-dev libzzip-dev liblua5.1-0-dev tcl8.4-dev
}}}

=== CEGUI ===

'''We do not require CEGUI at the moment, so don't bother installing it.'''

Using the CEGui package (libcegui) from Ubuntu results in runtime errors during the loading sequence of Ogre. Building CEGui by yourself with the right options solves the problem:

 1. Download CEGui from the [http://www.cegui.org.uk/ official page]
 1. Unzip the package
{{{
tar xzf CEGUI-0.5.0b.tar.gz
}}}
 1. Enter the directory and configure CEGui with the following options 
{{{
cd CEGUI-0.5.0/
./configure --with-default-xml-parser=TinyXMLParser --with-default-image-codec=TGAImageCodec
}}}
 1. Compile and install CEGui and you're ready to go
{{{
make
sudo make install
}}}

== Get our source ==
Check out the source via anonymous subversion login. This will download the whole project to the directory orxonox-dir.
{{{
$ svn co http://svn.orxonox.net/orxonox/trunk orxonox-trunk
}}}
You won't be able to commit your own code (check in) with the anonymous subversion repository. You have to ask us for a username/password combination. If you already have an account, check it out like this:
{{{
$ svn co https://svn.orxonox.net/orxonox/trunk orxonox-trunk
}}}
You will be asked for your username and password, that you got from us.

We have a seperate data repository. Download it via SVN as well. For instance use this command:
{{{
$ svn co http://svn.orxonox.net/data/Media media
}}}

== Compile ==

{{{
$ cd orxonox-trunk
$ cmake .
...
$ make
...
$ ./run
}}}

If you get errors running cmake you most certainly forgot to install a package. Run ./cmakeclearcache after you installed the missing packages and run cmake again.

If ./run doesn't work check out ''bin/orxonox.ini'' and compare the given data-path with the one you downloaded the data repository to. If the paths don't match, change it in the orxonox.ini and try ./run again.

== Possible Bugs ==
=== Graphics ===
Using the "radeon" driver with your ATI graphics card (on Gutsy) will result in ugly shadow bugs in Ogre. Use flgrx instead.

=== Ogre ===
If you haven't installed Ogre with the package manager, you'll have to change the path in ''orxonox-dir/bin/plugin.cfg'' from ''/usr/lib/OGRE'' to ''/usr/local/lib/OGRE''.


-----

[[OutdatedPage]]

''tutorial works (patrick, 04/16/07)''

=== Ubuntu Versions ===
Installing Orxonox was tested on Ubuntu Dapper Drake (6.06), Edgy Eft (6.10) and Feisty Fawn (7.04).

=== Installing the Libraries ===

{{{
wraith user $ sudo aptitude install libsdl1.2-dev libsdl-image1.2-dev libsdl-ttf2.0-dev libsdl-mixer1.2-dev libsdl-net1.2-dev libqt4-dev libglut3-dev libglew-dev libopenal-dev libvorbis-dev libavformat-dev libcurl3-dev liblualib50-dev
...
}}}

=== Installing developer tools ===

{{{
wraith user $ sudo aptitude install subversion automake1.9 g++
}}}

=== Getting the Source & Data ===

Check out the source and Data via svn anonymous, this will download the hole project to the directory orxonox-dir
{{{
wraith user $ svn co http://svn.orxonox.net/orxonox.OLD/trunk orxonox-dir/trunk
wraith user $ svn co http://svn.orxonox.net/data/trunk orxonox-dir/data/trunk
}}}
You won't be able to commit (check in) anything with the anonymous repository. You have to ask us for user/pass combination. If you have already an account check it out like this:
{{{
wraith user $ svn co https://svn.orxonox.net/orxonox.OLD/trunk orxonox-dir/trunk
wraith user $ svn co https://svn.orxonox.net/data/trunk orxonox-dir/data/trunk 
}}}
You will be asked for user name and password, that you have from us. 


=== Compiling ===
Just change into the trunk directory, execute configure and make....
{{{
wraith user $ cd ./orxonox-dir/trunk/
wraith user $ ./autogen.sh
wraith user $ ./configure
...
wraith user $ make
}}}

=== Playing ===
{{{
wraith user $ cd ./orxonox-dir/trunk/src
wraith user $ ./orxonox
}}}
Select the data file orxonox/data/trunk/data.oxd in the menu and play!


=== Ubuntu package (OUTDATED) ===
Instead of compiling Orxonox you can also get the Ubuntu packages here [http://people.ee.ethz.ch/~psachs]

or you can add the following source to /etc/apt/sources.list:
{{{
deb http://people.ee.ethz.ch/~psachs edgy games
}}}

=== Known Bugs ===
If you have an ATI card you probably have to start Orxonox with the following command (If you compiled it yourself its ./orxonox instead of orxonox):
{{{
env R300_SPAN_DISABLE_LOCKING="true" orxonox 
}}}

If you get an error message (while compiling) that 'msr.h' is missing you have to copy it from the following path. (If you have a different kernel version the path may differ)
{{{
sudo cp /usr/src/linux-headers-2.6.17-10/include/asm-i386/msr.h /usr/include/asm-i386/msr.h 
}}}

If you get an error message '/usr/bin/ld cannot find -llualib' use the following command to solve the problem:
{{{
cd /usr/lib/
sudo ln -s  liblualib50.a liblualib.a
}}}