wiki:RecommendedSystemSetup

Version 18 (modified by welberge, 6 years ago) (diff)

--

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 7 through applications->techfak->RCINFO package selector, select jdk-1.7.
  • Recommended: install SoaScript
  • If SoaScript is not installed: set up the ANT_OPTS variable (e.g. by editing .bashrc)
    export ANT_OPTS="-Xmx256M -XX:MaxPermSize=256M"
    

Ubuntu setup

  • 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
    
    sudo apt-get install libboost-program-options-dev libboost-signals-dev (possibly just ignore if
    packages do not exist)
    
  • Install java 7
    sudo apt-get install openjdk-7-jdk
    

If java 6 was already installed, setup java 7 as default compiler and jre

sudo update-alternatives --config java
sudo update-alternatives --config javac
  • Install ant > 1.8
    sudo apt-get install ant
    

setup the ANT_OPTS (e.g. in .bashrc):

export ANT_OPTS="-Xmx256M -XX:MaxPermSize=256M"

Mac setup

  • Setup  homebrew as your package management system
  • Install  XQuartz
  • Add the following line to .bashrc:
    export PATH=/usr/local/bin:/usr/local/sbin:$PATH
    
  • (Sept. 2013) Downgrade to protobuf 2.4:
    cd `brew --prefix` 
    git checkout 544209f /usr/local/Library/Formula/protobuf.rb 
    
  • (Sept. 2013) Downgrade to a non-broken version of CMake-Default:
    git checkout 68c419b Library/Formula/cmake.rb 
    
  • Install python:
    brew install python 
    
  • Install the following packages:
    brew install pyqt freeimage libzzip boost libxml++ libxml2 wget git cmake protobuf sdl_mixer qt4 pygtk 
    
  • Install python-protobuf:
    pip install protobuf 
    
  • 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 (Comment: Ignore any XCode errors while installing) 
    
  • In OS X 10.8, to allow pkg-config to resolve libxml2:
    sudo ln -s /usr/local/Cellar/libxml2/2.9.1/lib/pkgconfig/libxml-2.0.pc /usr/lib/pkgconfig 
    

Windows setup

  • Install java 7
  • 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
  • Add the following line to the top of the file antrc_pre.bat in your home directory (e.g. c:\Users\yourusername)
    set ANT_OPTS=-Xmx256M -XX:MaxPermSize=256M
    
  • 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
    }