Recommended System Setup
Asap is developed jointly on Ubuntu 12.04 LTS 64 bit and Mac (10.7 Lion, 10.8 Mountain Lion). We recommend using these operating systems. Most Asap components are OS-neutral and also function on other Linux distributions and on Windows. A notable exception is the Ogreviewer used for the Billie character. We regularly use AsapRealizer and related components in Windows 7, 64 bit (with 64-bit Java).
Techfak setup
- Install Java 8 through applications->techfak->RCINFO package selector, select java8.
- Recommended: install SoaScript
Ubuntu setup (for non-techfak machines)
- Install the following packages:
sudo apt-get install wget git cmake ant libboost-dev libboost-regex-dev libboost-system-dev libboost-filesystem-dev libfreeimage-dev libogre-dev libqt4-dev libprotobuf-dev libsdl-mixer1.2-dev libxml++2.6-dev uuid-dev libzzip-dev python-gtk2-dev python-qt4 python-protobuf python-setuptools libtinyxml-dev protobuf-compiler
sudo apt-get install libboost-program-options-dev libboost-signals-dev (possibly just ignore if packages do not exist)
On newer Ubuntu versions (tested for 13.10), you should install Ogre 1.8 instead of the default ogre version (package libogre-1.8-dev instead of libogre-dev). TODO: other requirements of ogre 1.8, e.g. run billie with ./go.billie.ogre1.8.
- Install spread, download from: http://www.techfak.uni-bielefeld.de/~ryaghoub/spread-src-4.2.0-soa.tgz
cd ~/Downloads; tar xvzf spread-src-4.2.0-soa.tgz cd spread-src-4.2.0 ./configure; make; sudo make install
- Add Spread in LD_LIBRARY_PATH, in ~/.bashrc:
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/local/lib
- Install java 8
sudo apt-get install openjdk-8-jdk
If java 6/7 was already installed, setup java 7 as default compiler and jre
sudo update-alternatives --config java sudo update-alternatives --config javac
TODO: install instructions when openjdk-8 is not available on your distribution
- Install ant > 1.8
sudo apt-get install ant
Mac setup
Currently supported: Yosemite, Mavericks (10.10, 10.9); legacy: 10.7 Lion, 10.8 Mountain Lion
- Install Homebrew http://brew.sh
- Add this to .bashrc:
export PATH=/usr/local/bin:/usr/local/sbin:$PATH
- Install XQuartz http://xquartz.macosforge.org/landing/
- Get the pre-packaged Ogre 1.9 installation from http://www.techfak.uni-bielefeld.de/~ryaghoub/ogre-1.9.0-mac-soa.tar.gz
unpack it:
cd /Library/Frameworks; sudo tar xvpzf ogre-1.9.0-mac-soa.tar.gz
- The protobuf library must currently not be newer than 2.5.x. Prepare homebrew to use a 2.5 version:
cd `brew --prefix` git checkout 6de7a23 Library/Formula/protobuf.rb
- Install the following packages using homebrew. The first command installs homebrew's python. Make sure it is used after installation (hash -r; which python should print /usr/local/bin/python).
brew install python brew install ant pyqt freeimage libzzip boost libxml++ libxml2 wget git cmake protobuf sdl_mixer qt4 pygtk tinyxml
- Install python packages:
pip install protobuf
- Install spread (soa version):
Download: http://www.techfak.uni-bielefeld.de/~ryaghoub/spread-src-4.2.0-soa.tgz
cd ~/Downloads; tar xvzf spread-src-4.2.0-soa.tgz cd spread-src-4.2.0; ./configure; make; sudo make install
- IF there is a problem with finding QtOpenGL later, link Qt to /Library/Frameworks:
cd `brew --prefix`/Cellar/qt/4.8.6/Frameworks sudo ln -s /usr/local/Cellar/qt/4.8.6/Frameworks/*.framework /Library/Frameworks
Windows setup
- Install java 8
- Install Python 2.7.x and make sure the python binary is on your path
- Obtain a recent version (>= 1.8.2) of apache ant, put the ant bin directory on your PATH
- Get spread binaries from http://www.spread.org and unzip them
- Add a spread.conf file to the directory in which you unzipped the spread binaries, it should contain
Spread_Segment 127.0.0.255:4803 { localhost 127.0.0.1 }
- Download the protoc 2.4.1 binaries (newer ones currently don't work with Asap) from http://code.google.com/p/protobuf/, unzip them and add them to your path
- create an rsb.conf file in a .config subdirectory of your home, containing
[transport.spread] enabled = 1 host = localhost port = 4803 [transport.socket] enabled = 0
- Install setuptools from https://pypi.python.org/pypi/setuptools