This documentation is accurate, but makes the process much more complicated than necessary. New docs are coming soon.

Requirements

Server

python 2.3 http://www.python.org
twisted 2.2 http://www.twistedmatrix.com/products/download

Client

java runtime environment >= 1.4.2 http://java.sun.com/j2se/1.4.2/download.html
twistedjava v0.6.1 http://itamarst.org/software/twistedjava/ (included in distribution)

Cocoa Client

mac os 10.4.1
xcode 2.0(to build)
pyobjc 1.3.6(to build)
twisted SVN(to build)

Quick Start

Client

The Java client is currently using Itamar Shtull-Trauring's port of Twisted's PerspectiveBroker to Java. It works really well, but isn't really actively maintained -- it's been relatively bug-free for some time (at least in my experience). It's small and doesn't get updated much, so I've included it in the distribution.

Python is required for the build_client.py script. If you do not wish to install python, or don't care about building from source, you can download a pre-built client jar file from the InnerSpace website.

  1. download the source archive from  SourceForge
  2. tar zxvf InnerSpace-0.9.1.tar.gz
  3. cd InnerSpace-0.9.1/
  4. python bin/build_client.py
  5. python bin/run_client.py

Cocoa client (experimental)

The Cocoa client is still under development, as it's the first (and so far, only) cocoa app I've written in  PyObjC.

note: you may also download a pre-built binary from the innerspace website.

  1. download and install Twisted Core/Conch
    1. wget http://tmrc.mit.edu/mirror/twisted/Twisted/2.2/Twisted-2.2.0.tar.bz2
    2. tar jxvf Twisted-2.2.0.tar.bz2
    3. cd Twisted-2.2.0/
    4. sudo python setup.py core install
    5. sudo python setup.py conch install
  1. download and install the  PyObjC libraries.
  2. download and compile the InnerSpace Cocoa client
    1. download the source archive from  SourceForge
    2. tar zxvf InnerSpace-0.9.1.tar.gz
    3. cd InnerSpace-0.9.1/cocoa/client
    4. python setup.py py2app
  3. You'll find the resulting binary in the cocoa/client/dist directory

Server

note: when the server is shutdown, it saves its state in the bin directory in a file called "innerspace-shutdown.tap". the bin/run-server.py script looks for this file -- if found, it renames "innerspace.tap" to "innerspace-bak.tap" and "innerspace-shutdown.tap" to "innerspace.tap",and runs the resulting file.

  1. download and install Twisted
    1. wget http://tmrc.mit.edu/mirror/twisted/Twisted/2.2/Twisted-2.2.0.tar.bz2
    2. tar jxvf Twisted-2.2.0.tar.bz2
    3. cd Twisted-2.2.0/
    4. sudo python setup.py core install
    5. sudo python setup.py conch install
  2. download and install InnerSpace
    1. download the source archive from  SourceForge
    2. tar zxvf InnerSpace-0.9.1.tar.gz
    3. cd InnerSpace-0.9.1/
    4. sudo python setup.py install
  3. build a minimal database:
    • python bin/bootstrap_server.py --verbdir verbs/ (from inner.space.minimal module)
    • python bin/bootstrap_server.py --datafile minimal.xml (from XML export file)
  4. to run a server using the provided database
    • bin/run_server.py
  5. to view the log
    • tail -f innerspace.log
  6. to shutdown
    • kill `innerspace.pid`