diff options
Diffstat (limited to 'docs/install.rst')
| -rw-r--r-- | docs/install.rst | 46 |
1 files changed, 31 insertions, 15 deletions
diff --git a/docs/install.rst b/docs/install.rst index 426b62d..c1bc5eb 100644 --- a/docs/install.rst +++ b/docs/install.rst @@ -29,6 +29,7 @@ Prerequisites - `psycopg2 <http://freshmeat.net/projects/psycopg/>`_ - `Python Imaging Library <http://www.pythonware.com/products/pil/>`_ - `Beautiful Soup <http://www.crummy.com/software/BeautifulSoup/>`_ + - python-simplejson - `lxml <http://lxml.de/>`_ - `jquery <http://jquery.com/>`_ version 1.7.1 or better - `jquery-ui <http://jqueryui.com/>`_ @@ -46,15 +47,17 @@ Optionaly (but recommanded): - `tinymce <http://tinymce.moxiecode.com/>`_ - `gpsbabel <http://www.gpsbabel.org/>`_ + - django-celery if you want to manage import The simpliest way to obtain these packages is to get them from your favorite Linux distribution repositories. For instance on Debian Wheezy:: apt-get install python python-django python-django-south \ - python-beautifulsoup tinymce apache2 libgeos-3.3.1 proj gdal-bin \ + python-beautifulsoup tinymce apache2 libgeos-3.3.3 proj-bin gdal-bin \ python-gdal python-lxml python-psycopg2 python-imaging gettext \ - postgresql-9.1 postgresql-9.1-postgis libjs-jquery libjs-jquery-ui + postgresql-9.1 postgresql-9.1-postgis libjs-jquery libjs-jquery-ui \ + python-django-celery python-simplejson If these packages do not exist in your distribution's repository, please refer to the applications' websites. @@ -72,7 +75,6 @@ Then, you have to create the database and initialize the geographic types (adapt the paths accordingly to your needs):: createdb --echo --owner chimere-user --encoding UNICODE chimere "My Chimère database" - createlang plpgsql chimere psql -d chimere -f /usr/share/postgresql/9.1/contrib/postgis-1.5/postgis.sql psql -d chimere -f /usr/share/postgresql/9.1/contrib/postgis-1.5/spatial_ref_sys.sql @@ -81,8 +83,8 @@ Install the sources Choose a path to install your Chimère:: - sudo mkdir /var/local/django INSTALL_PATH=/var/local/django + sudo mkdir $INSTALL_PATH From an archive +++++++++++++++ @@ -105,7 +107,7 @@ Another solution is to get the last git version:: git clone git://www.peacefrogs.net/git/chimere cd chimere git tag -l # list tagged versions - git checkout v2.0.0 # checkout the desired version + git checkout v2.0 # checkout the desired version Base configuration @@ -117,21 +119,23 @@ get another project based on Chimere):: cd $INSTALL_PATH/chimere cp -r example_project mychimere_project -In your chimere application directory create settings.py to fit to your +In your chimere application directory create local_settings.py to fit to your configuration. -A base template is provided (settings.py.example) and short descriptions of -the more relevant fields are given below (at least check them):: +A base template is provided (local_settings.py.example) and short descriptions of +the more relevant fields are given below (at least check them). Most of theses +settings are initialized in settings.py. :: cd $INSTALL_PATH/chimere/mychimere_project - cp settings.py.example settings.py - vim settings.py + cp local_settings.py.sample local_settings.py + vim local_settings.py :Fields: + * DATABASES: parameters for the database * PROJECT_NAME: name of the project + * ROOT_URLCONF: url configuration for your project something like: + 'mychimere_project.urls' * ROOT_PATH: path to the installation of Chimère - * SERVER_URL: root of the web address of Chimère - * EXTRA_URL: suffix to the web address of Chimère * EMAIL_HOST: smtp of an email server to send emails * TINYMCE_URL: url to tinymce path (default is appropriate for a Debian installation with tinymce activated) @@ -145,11 +149,8 @@ the more relevant fields are given below (at least check them):: * CHIMERE_DEFAULT_CENTER: center of the map * CHIMERE_DYNAMIC_CATEGORIES: dynamic load of categories on the main map * CHIMERE_DISPLAY_AREAS: display area's shortcuts - * DATABASES: parameters for the database * TIME_ZONE: local time zone for this installation * LANGUAGE_CODE: language code for this installation - * ROOT_URLCONF: url configuration for your project something like: - 'mychimere_project.urls' Manage media path permission:: @@ -157,11 +158,23 @@ Manage media path permission:: sudo chown -R user:www-data media sudo chmod -R g+w media +Create log file:: + + mkdir /var/log/django + touch /var/log/django/chimere.log + sudo chown -R root:www-data /var/log/django/ + sudo chmod -R g+w /var/log/django/ + Regroup static files in one path:: cd $INSTALL_PATH/chimere/mychimere_project ./manage.py collectstatic +Removing celery configuration ++++++++++++++++++++++++++++++ + +TODO + Compiling languages ******************* @@ -213,11 +226,14 @@ Install mod_wsgi for apache:: sudo apt-get install libapache2-mod-wsgi +TODO: adapt apache-wsgi.conf Create and edit a configuration for Chimère:: sudo vim $INSTALL_PATH/chimere/apache/django.wsgi sudo vim $INSTALL_PATH/chimere/apache/apache-wsgi.conf sudo cp $INSTALL_PATH/chimere/apache/apache-wsgi.conf /etc/apache2/sites-available/chimere + # create log dir + sudo mkdir /var/log/apache2/chimere/ Adapt the files django.wsgi (with the correct sys path) and chimere. |