Skip to content
scaphilo edited this page Jan 6, 2013 · 49 revisions

koalixcrm Installation

Support

There will be a list of local Support in your Country as soon as I get some information about that. Currently there is only one: Me of cause ;-) Visit my website: http://www.koalix.com to get more information about my services.

Requirements

django 1.3

django is an open source web application framework, written in Python, which follows the model-view-controller architectural pattern. It was originally developed to manage several news-oriented sites for The World Company of Lawrence, Kansas, and was released publicly under a BSD license in July 2005; the framework was named after gypsy jazz guitarist Django Reinhardt. In June 2008 it was announced that a newly formed Django Software Foundation will take care of Django in the future. http://www.djangoproject.com/

django-grappelli

https://github.com/sehmaschine/django-grappelli

django-filebrowser

https://github.com/sehmaschine/django-filebrowser

django-south

  • As koalixcrm is still under heavy development and there are few people currently using koalixcrm in production, it makes no sense for me to support migrations. Its on you to do this. I recommend using south for this.

http://south.aeracode.org/

apache fop

Formatting Objects Processor (FOP) is a Java application that converts XSL Formatting Objects (XSL-FO) files to PDF or other printable formats. FOP was originally developed by James Tauber who donated it to the Apache Software Foundation in 1999. It is part of the Apache XML Graphics project. http://xmlgraphics.apache.org/fop/

git

Git is a free & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Every Git clone is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on network access or a central server. Branching and merging are fast and easy to do. http://git-scm.com/

step by step installation

First of all: I decided to not integrate external projects in my repository. This makes it to large and i think everyone should descide on its own wether to use grappelli, south, filebrowser, admin-tools or not. This installation description describes how to install all of them.

ubuntu 10.10

sudo bash
aptitude install apache2 git fop python-django-south python-django
aptitude install libapache2-mod-python subversion postgresql python-psycopg2 mercurial
aptitude install python-lxml

in the file: /etc/postgresql/8.4/main/pg_hba.conf
uncomment the following line ## normaly this schould already be uncommented
local all all ident

sudo su postgres
psql
ALTER USER postgres WITH PASSWORD 'youradminpasswordforpostgresql'; 
CREATE USER koalixcrm WITH PASSWORD 'passwordforkoalixcrmdatabase';
CREATE DATABASE koalixcrm ENCODING 'UTF8'; \q
mkdir ~/Downloads
cd ~/Downloads
hg clone http://bitbucket.org/andrewgodwin/south/
git clone https://github.com/sehmaschine/django-grappelli.git
git clone https://github.com/sehmaschine/django-filebrowser.git
git clone git://github.com/scaphilo/koalixcrm.git
cd /var/www/
cp ~/Downloads/koalixcrm /var/www/
cd /var/www/koalixcrm
cp -r ~/Downloads/django-grappelli/grappelli .
cp -r ~/Downloads/django-filebrowser/filebrowser .
cp settings.default.py settings.py
nano settings.py (you have to adjust your databaseuser and databasepassword)
cp urls.default.py urls.py
nano urls.py (you will have to adjust the document_root of /media/)
python manage.py collectstatic
cd /var/
sudo chown -R www-data: www

make a new file (as root) in /etc/apache2/site-available/koalixcrm with the following content:

<VirtualHost *:80>
   ServerName koalixcrm.localdomain
   ServerAdmin [email protected]
   CustomLog /var/log/apache2/koalixcrm_access.log combined
   PythonPath "['/var/www/koalixcrm'] + sys.path"
   SetHandler python-program
   PythonHandler django.core.handlers.modpython
   SetEnv DJANGO_SETTINGS_MODULE settings
   PythonDebug On
</VirtualHost>

edit the /etc/hosts (as root) in the following way, add in the first line the *koalixcrm.localdomain" 127.0.0.1 localhost koalixcrm.localdomain

a2ensite kalixcrm
service apache reload

What you wanna do next is of cause the test the software. Visit your http://localhost/admin, log in and start testing. To be able to do pdf exports you have to do something more. I advice you to do this with my default templatefiles by executing the installation script.

cd /var/www/koalixcrm
/manage.py koalixcrm_istall_defaulttemplates
sudo mkdir media/pdf
sudo chown www-data: media/pdf
Clone this wiki locally