This guide will help quickly get you up and running with a local copy of Moksha. It will run the Moksha WSGI application using the Paste threaded http server, a single orbited daemon with an embeded MorbidQ stomp message broker, SQLite SQLAlchemy and Feed databases, and an in-memory cache. This setup is meant to be dead-simple to get up and running, and is not designed for production deployments.
This installation method has been tested with OSX, Fedora, and RHEL. See the Setting up a Moksha RPM & mod_wsgi environment for a deploying with RPM and mod_wsgi.
You’ll need the virtualenv package.
# yum -y install python-virtualenv python-memcached gcc
The start-moksha script mentioned below should install all of the necessary dependencies. However, it will attempt to compile a few things, such as lxml. So, you may need to install some additional dependencies like libxml2 and libxslt in order to build it. If you’re using yum, you can easily install all of the build requirements by doing:
# yum-builddep -y python-lxml PyOpenSSL python-sqlite2
$ git clone git://git.fedorahosted.org/git/moksha
$ ./start-moksha
Note
This script takes care of setting up your TurboGears2 virtual environment the first time it is run. To drop into the virtualenv manually you can run source tg2env/bin/activate to enter it, and deactivate to leave it.
$ ./stop-moksha
Now you can navigate your web browser to the following url:
Note
Going to 127.0.0.1 will not work properly with the current Orbited setup, so you must make sure to go to localhost.