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

1. Install Homebrew  http://brew.sh

2. Add this to .bashrc:

export PATH=/usr/local/bin:/usr/local/sbin:$PATH

3. Install XQuartz  http://xquartz.macosforge.org/landing/

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

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

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

7. Install python packages:

       pip install protobuf
   

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

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