Warning!

This page applies to an older version of Orbited (Version 0.3) For info on the current version see the main documentation.


Installing Orbited on OS X

There are only four steps to get orbit working on OS X: Install Python 2.5, install Orbited, install rel, and finally install demjson

Python

On OS X 10.5 Leopard, Python 2.5 is already installed, so skip this step. Python is an open-source interpreted dynamic language. Although the Orbited code-base will run fine on Python 2.4, there is no pyevent installer for Python 2.4, only Python 2.5. Therefore, to simplify the installation of pyevent, this tutorial assumes you will be using Python 2.5. If you don’t already have it installed, visit python.org/download or simply download the Python 2.5.1 Universal OS X Installer directly and run it.

Orbited

The second step is to install the Orbit Event Daemon itself, which first requires setuptools. On OS X 10.5 Leopard, setuptools is already installed, so if you are using Leopard, or if you already otherwise have setuptools installed, just open up a terminal, and run easy_install orbited, and you’re done. On earlier versions of OS X, install setuptools and Orbited in one step using the bootstrap script. Control-click and save ez_setup.py to your hard drive, then in a terminal window navigate to its containing folder and execute python ez_setup.py orbited to begin the install process. This will download setuptools if you don’t already have it, and then download and install Orbited from the cheeseshop repository.

demjson

The third step is to install demjson. Just execute the command easy_install demjson and you should have it installed.

rel

The rel library is an asynchronous network library that wraps the best method of network IO available on your system. To install it, simply type easy_install rel

pyevent

pyevent is a Python interface to the popular libevent library. It allows for fast, asynchronous network I/O that scales well. libevent will choose the best possible polling method available on your system. To install pyevent download the OS X pyevent Universal Python 2.5 Installer and run it.

At this point you’re done. Orbited is on your system and ready for use. You can start it up by executing orbited in a terminal window.