How to run Byteflow blog engine on Jython
I’m already write some articles about problems in running Trac on Jython. Today i describe successfully installation of popular Django-based blog engine Byteflow on Jython.
Step 1: Install Java, Jython, Django
To setup Byteflow on Jython you must install JDK, and Jython compiler. I’m recommend to use Sun JDK version 1.6 and latest Jython from 2.5 branch (Now latest version of Jython is 2.5b0 and final 2.5 version will released soon).
Note: if you install Jython on computer without graphical interface you must run console version of installer:
$java -jar jython_installer-2.5b0.jar --console
otherwise you get error:
java.awt.HeadlessException:
No X11 DISPLAY variable was set, but this program performed an operation which requires it.
Note: After Jython installation you must set executable flag on jython binary:
$chmod +x <path to Jython home>/bin/jython
After it you need to install Django. Django from version 1.0.0 work out of box with Jython, therefore you can get latest version of 1.0.x branch (Now latest version of Django is 1.0.2).
$wget http://www.djangoproject.com/download/1.0.2/tarball/
$tar xjvf Django-1.0.2-final.tar.gz
$cd Django-1.0.2-final
$jython setup.py install
Step 2: Install Byteflow requirements Byteflow depends on some libraries which not distributed with Jython, therefore you must download and install it manually.
Install database wrapper: Jython can’t use standard DBAPI-2.0 modules because they use low level C-implementation of driver, instead it use JDBC database drivers and zxjdbc wrapper.
You must download and install django-jython module which provide Django database wrappers for jdbc drivers:
$svn co http://django-jython.googlecode.com/svn/trunk/ django-jython
$cd django-jython
$jython setup.py install
Currently it support only postgresql and sqlite3.but work on other databases (including mysql) in progress.
Also you must download appropriate jdbc driver, for Postgresql you must to download it from http://jdbc.postgresql.org/
Install BeautifulSoup:
You must download and compile BeautifulSoup module for Jython:
$wget http://www.crummy.com/software/BeautifulSoup/download/BeautifulSoup.tar.gz
$tar xzvf BeautifulSoup.tar.gz
$cd BeautifulSoup-3.0.7a
$jython setup.py install
Install ElementTree:
Byteflow use ElementTree ant you need to install in by standard way:
$svn checkout http://jython-elementtree.googlecode.com/svn/trunk elementtree
$cd elementtree
$jython setup.py install --stdlib
Install OpenID:
Download and install python-openid version2:
$wget "http://openidenabled.com/files/python-openid/packages/python-openid-2.2.1.tar.bz2"
$jar xzvf python-openid-2.2.1.tar.bz2
$cd python-openid-2.2.1
$jython setup.py install
Step 3: Download, configure and run Byteflow:
You can download Byteflow from mercurial repository and follow simple installation guide:
$hg clone http://hg.piranha.org.ua/byteflow/
$cd byteflow
After this you must change some configuration values in settings_local.py according of you preferences. You must change value in
DATABASE_ENGINE field to use django-jython wrapper:
DATABASE_ENGINE = 'doj.backends.zxjdbc.postgresql' # variants: mysql, sqlite3
Also you must change value of CAPTCHA variable — set recaptcha if you have account on recaptcha or disable captcha by specify empty value. You must do this because captcha module depends on PIL which is not ported to Jython.
Now you are ready to create Byteflow database. You need specify path to jdbc jar file in classpath because otherwise Jython can’t resolve this:
$export JYTHON_HOME=<path to Jython home>
$java -classpath $JYTHON_HOME/jython-complete.jar:<path to dowloaded jdbc jar>/postgresql-8.3-604.jdbc3.jar
-Dpython.home="$JYTHON_HOME" org.python.util.jython manage.py syncdb
After this you can finally run Byteflow instance with django internal http server:
$export JYTHON_HOME=<path to Jython home>
$java -classpath $JYTHON_HOME/jython-complete.jar:<path to dowloaded jdbc jar>/postgresql-8.3-604.jdbc3.jar
-Dpython.home="$JYTHON_HOME" org.python.util.jython manage.py runserver
Reference:
Distributions:
Modules:
Articles:
