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 Ubuntu Linux
There are only four steps to get orbit working on Ubuntu or Debian: Install Python 2.4+, install Orbited, insteal rel, then finally install demjson.
Python
Python is an open-source interpreted dynamic language. You should already have Python 2.4+ on your system. If you have reason to believe that you don’t, then try running python in a terminal window. The interpreter should start up and display the version. If you don’t have the Python interpreter then run sudo apt-get install python to install the latest version of Python.
Orbited
The second step is to install the Orbit Event Daemon itself. The install process of Orbited requires that you download setuptools. Instead of manually installing setuptools and then manually installing Orbited, you can simply use the bootstrap script. Right-click and save ez_setup.py to your hard drive, then at the command line 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 Orbited from the cheeseshop repository.
If you already have setuptools installed, then you should have the easy_install binary as well. In this case, just run easy_install orbited and it will download and install the daemon.
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 (optional)
This step may speed up your network performance, though it is strictly not necessary to develop and prototype with Orbited. The pyevent package 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. There are three basic steps to installing pyevent.
- Install the Python Development Header files. You can do this by running sudo apt-get install python-dev in a terminal.
- Install the libevent Development Header files. You can do this by running sudo apt-get install libevent1 libevent-dev in a terminal.
- Download the pyevent source, pyevent-0.3.tar.gz and extract it to your hard drive. Find that directory in a terminal and run sudo python setup.py install. This should compile and install pyevent.
Note, If you encounter errors with the previous step, you may need to execute this command first: sudo apt-get install gcc libc6-dev
You can test your success by running python to enter the Python interpreter, and then executing the command import event. If you don’t receive any errors then you were successful.
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.