====== System Installation ======

On cs390cp@pc.cs.purdue.edu:icypc2011:

  - Download icypc.jar from http://queue.acm.org/icpc ("Game binary (zip download)").
  - Download JOGL (Java for OpenGL) library:
    * http://jogamp.org/deployment/jogamp-current/archive/jogamp-linux-i586/jogl-linux-i586.7z \\ (Download to Mac, 7-unzip, zip, scp to pc, unzip.)

An alternative (but overkill):

  * http://jogamp.org/deployment/jogamp-current/archive/jogamp-linux-amd64/gluegen-linux-amd64.7z
  * http://jogamp.org/deployment/jogamp-current/archive/jogamp-linux-amd64/jogl-linux-amd64.7z

====== For Ladder Web Server Installation ======

  - Assumes Python 2.6 installed.
  - Download and install Django.
    * http://www.djangoproject.com/download/
    * Add django-admin.py to ~/bin directory (for convenience).
    * Add root of Django directory to PYTHONPATH environment variable.
  - Use ssh-keygen to create key for access to sources on github (for write access).
  - Clone source from github (git@github.com:jtkorb/icypc-ladder.git).
  - Follow instructions in README file (copy settings-dist.py and update).
  - Create database tables with ''% ./manage.py syncdb''.  Create admin account (e.g., cs390cp) with password choice.
  - Launch web server: ''% ./manage.py runserver 0.0.0.0:8000'.

====== For 3D Viewing of Trace Files ======

  - Download appropriate version of JOGL (Java for OpenGL) library.
    * http://jogamp.org/deployment/jogamp-current/archive/jogamp-linux-i586/jogl-linux-i586.7z \\ (Download to Mac, 7-unzip, zip, scp to pc, unzip.)
    * <del> http://jogamp.org/deployment/autobuilds/jogl-b198-2010-11-04_05-53-09/build/</del>    
    * unpack zip file (into, e.g., ~/jogl)
  - Add the icypc.jar file and these four JOGL .jar files to the CLASSPATH, e.g., by setting these variables in ~/.bashrc:
    * typeset -x DIR=${HOME}/jogl-2.0-pre-20101104-macosx-universal/lib
    * typeset -x ICYPC=${HOME}/icypc/icypc.jar
    * typeset -x CLASSPATH=${ICYPC}:${DIR}/jogl.all.jar:${DIR}/nativewindow.all.jar:${DIR}/gluegen-rt.jar:${DIR}/newt.all.jar
  - Add OS-specific environment variable that points to the JOGL directory (DIR above)
    * MacOS: typeset -x DYLD_LIBRARY_PATH=${DIR}
    * Linux/Solaris: typeset -x LD_LIBRARY_PATH=${DIR}
    * Windows: Include %DIR% in PATH.
  - Create a trace file and view it in 3D:

  % java -jar ~/icypc/icypc.jar -player java java_example.Hunter -player java java_example.Planter -view trace x.txt
  % java icpc.challenge.view.TracePlayer -view 3D -trace x.txt