Installation

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 2.3.9

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

django-filebrowser 3.4.3

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

django-south 0.7.6

django-south is used for model and data migration purpose. This is essential when you are already working on koalixcrm and want to keep updated with future changes. 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-pip
mkdir /opt/django/
cd /opt/django
git clone git://github.com/django/django.git
cd django
git checkout 1.3
pip install .
pip install django-south
aptitude install libapache2-mod-python subversion postgresql python-psycopg2 mercurial
aptitude install python-lxml
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
git clone https://github.com/sehmaschine/django-grappelli.git
cd django-grappelli
git checkout 2.3.9
cd ..
git clone https://github.com/sehmaschine/django-filebrowser.git
cd django-filebrowser
git checkout 3.4.3
cd ..
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 youradminemail@yourhoster.com
   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
python manage.py syncdb --all
python manage.py migrate --fake
/manage.py koalixcrm_istall_defaulttemplates
sudo mkdir media/pdf
sudo chown www-data: media/pdf