.. -*- coding: utf-8 -*-
===========
Mise à jour
===========
:Auteur: Étienne Loks
:date: 2013-03-16
:Copyright: CC-BY 3.0
Ce document présente la mise à jour de Chimère.
.. Warning::
Avant toute mise à jour faites une sauvegarde de la base de données et de
tous vos fichiers d'installation (en particulier si vous avez fait des
changements sur ceux-ci).
La procédure de migration nécessite une connaissance de base de Git et de la
ligne de commande Linux. Ce n'est *pas* une procédure facile. Un travail est en
cours pour faciliter les mises à jour des futures versions de Chimère (>2.0).
Si plusieurs versions de Chimère ont été publiées depuis votre installation,
vous devez répéter toutes les étapes de mise à jour.
Par exemple pour mettre à jour depuis la version 1.1 vers la version 2.0, vous
devez d'abord mettre à jour vers la version 1.2 puis vers la version 2.0.
La seule étape optionnelle est l'intégration de vos personnalisations.
La version stable actuelle est la version 2.0.
.. Note::
Si vous souhaitez améliorer Chimère prenez la branche *master* sur Git.
Les instructions sont données pour Debian Squeeze et Debian Wheezy.
Obtenir des nouvelles versions des dépendances
----------------------------------------------
Si vous souhaitez installer le paquet Debian prévu pour Wheezy, les dépendances
sont gérées par le paquet.
Vous pouvez passer à la section suivante de la documentation.
Version 1.1 -> 1.2
******************
.. code-block:: bash
apt-get install python-lxml libjs-jquery gpsbabel python-gdal
Version 1.2 -> 2.0
******************
Debian Squeeze
++++++++++++++
Activez les backports (http://backports-master.debian.org/Instructions/).
Puis installez les nouvelles dépendances ::
apt-get install -t squeeze-backports python-django python-django-south \
python-simplejson libjs-jquery-ui python-pyexiv2 \
python-feedparser javascript-common libjs-jquery
Debian Wheezy
+++++++++++++
.. code-block:: bash
apt-get install python-django-south python-simplejson libjs-jquery-ui \
python-pyexiv2 python-feedparser javascript-common
Si vous comptez réaliser des imports importants envisagez l'installation
de `Celery `_.
.. code-block:: bash
apt-get install python-django-celery python-kombu
Obtenir les nouvelles sources
-----------------------------
Pour simplifier les instructions suivantes, quelques variables d'environnement
sont initialisées.
.. code-block:: bash
CHIMERE_PATH=/srv/chimere
CHIMERE_BRANCH=v1.2 # version 1.1 -> 1.2
CHIMERE_BRANCH=v2.0 # version 1.2 -> 2.0
CHIMERE_BRANCH=master # version 2.0 -> master
CHIMERE_LOCALNAME=mychimere
Le nom de votre projet (*CHIMERE_LOCALNAME*) est utilisé pour le nom de la
bibliothèque Python correspondant à votre projet ainsi que votre propre
branche Git.
En tant que bibliothèque Python, ce nom doit suivre les règles de nommage des
noms de variable Python : il doit comporter au moins une lettre et peut
comporter autant de nombres et de lettres que souhaité, le caractère tiret bas
(« _ ») est accepté. N'utilisez pas de caractères accentués. Ne commencez pas
par « _ » car cela a une signification particulière en Python.
Depuis les paquets Debian
*************************
Si vous souhaitez disposer de la dernière version stable
de Debian et que vous êtes sous environnement Wheezy, il est
conseillé d'utiliser les paquets prévus à cet effet.
Si vous avez une installation précédente depuis les sources
effacez les répertoires contenant la bibliothèque de base
**conservez** bien les répertoires contenant votre projet.
.. code-block:: bash
rm -rf $CHIMERE_PATH/chimere
Ensuite vous pouvez installer Chimère.
.. code-block:: bash
# ajouter le dépôt Chimère
echo "deb http://debian.peacefrogs.net wheezy main" >> /etc/apt/sources.list
# installation
apt-get update
apt-get install python-django-chimere
Installation depuis les sources
*******************************
Tout d'abord vous avez besoin de la nouvelle version du code source.
Pour la procédure d'installation, le code source doit être celui du dépôt Git.
Pour une précédente installation Git
++++++++++++++++++++++++++++++++++++
.. code-block:: bash
cd $CHIMERE_PATH
git stash # si vous avez des changements pas encore « commités »
git checkout origin/$CHIMERE_BRANCH -b $CHIMERE_LOCALNAME
Pour une précédente installation depuis une archive
+++++++++++++++++++++++++++++++++++++++++++++++++++
Supprimez d'abord votre ancienne installation et obtenez la version Git :
.. code-block:: bash
cd $CHIMERE_PATH
cd ..
rm -rf $CHIMERE_PATH
git clone git://www.peacefrogs.net/git/chimere
cd chimere
git checkout origin/$CHIMERE_BRANCH -b $CHIMERE_LOCALNAME
Mettre à jour les paramètres de base
************************************
Version 1.1 -> 1.2
++++++++++++++++++
.. code-block:: bash
CHIMERE_APP_PATH=$CHIMERE_PATH/chimere
vim $CHIMERE_APP_PATH/settings.py
Ajoutez les lignes suivantes (adaptez en fonction de vos installations
jquery et gpsbabel) :
.. code-block:: python
JQUERY_URL = SERVER_URL + 'jquery/jquery-1.4.4.min.js'
GPSBABEL = '/usr/bin/gpsbabel'
# simplification des trajets avec une tolérance de 5 mètres
GPSBABEL_OPTIONS = 'simplify,crosstrack,error=0.005k'
Version 1.2 -> 2.0
++++++++++++++++++
Patron de projet
................
Un exemple de projet peut être trouvé sur `Gitorious
`_.
Clonez-le et modifiez-le (ou utilisez un autre projet basé sur Chimère) :
.. code-block:: bash
cd $CHIMERE_PATH
git clone git://gitorious.org/chimere-example-project/chimere-example-project.git
django-admin startproject --template=chimere-example-project mychimere_project
rm -rf chimere-example-project
local_settings
..............
Un fichier *local_settings* est maintenant utilisé.
.. code-block:: bash
cd $CHIMERE_APP_PATH
cp local_settings.py.sample local_settings.py
vim local_settings.py
Reportez vos anciens paramètres de *settings.py* vers *local_settings.py*
(au minimum la configuration de votre base de données).
Le paramètre *ROOT_URLCONF* doit être mis à la valeur
« **nom_de_votre_projet.urls** ».
logs
....
Par défaut, des fichiers de *log* sont maintenant écrit dans le fichier :
« */var/log/django/chimere.log* ».
.. code-block:: bash
mkdir /var/log/django
touch /var/log/django/chimere.log
chown www-data -R /var/log/django
Fichiers statiques
..................
Les fichiers statiques sont maintenant gérés avec
« **django.contrib.staticfiles** ».
.. code-block:: bash
cd $CHIMERE_APP_PATH
./manage.py collectstatic
Déplacez vos anciens fichiers statiques vers le nouveau répertoire :
.. code-block:: bash
cp -ra $CHIMERE_PATH/chimere/static/* $CHIMERE_APP_PATH/static/
cp -ra $CHIMERE_PATH/chimere/static/icons/* $CHIMERE_APP_PATH/media/icons/
cp -ra $CHIMERE_PATH/chimere/static/upload $CHIMERE_APP_PATH/media/
rm -rf $CHIMERE_PATH/chimere/static/icons
rm -rf $CHIMERE_PATH/chimere/static/upload
Mettre à jour les permissions des répertoires media :
.. code-block:: bash
chown www-data -R $CHIMERE_APP_PATH/media/
Configuration du serveur Web
............................
Si vous utilisez Apache et WSGI pour mettre à disposition votre Chimère,
changez la configuration pour pointer vers le chemin correct de
configuration : « **nom_de_votre_projet.settings** ».
Changez la directive de votre serveur web pour qu'elle pointe vers le bon
répertoire statique de « **votre_chemin_vers_chimere/chimere/static** » en
« **votre_chemin_vers_chimere/nom_de_votre_projet/static** ».
Version 2.0 -> master
+++++++++++++++++++++
Mettez à jour les paramètres et les fichiers statiques.
.. code-block:: bash
cp $CHIMERE_PATH/example_project/settings.py $CHIMERE_LOCALNAME
./manage.py collectstatic
Migration de la base de données
-------------------------------
Version 1.1 -> 1.2
******************
Les scripts de migration testent votre installation avant de faire des
changements. Vous n'aurez donc probablement pas de perte mais par précaution
avant de les lancer n'oubliez pas de faire une sauvegarde de votre base de
données.
Vous pouvez aussi faire une copie de votre base de données actuelle dans une
nouvelle base et faire la mise à jour sur cette nouvelle base de données.
La bibliothèque GDAL pour Python est nécessaire pour faire fonctionner ces
scripts (disponible avec le paquet *python-gdal* dans Debian).
Si vous souhaitez lancer le script de migration dans un environnement de
production, stoppez l'instance de Chimère avant d'exécuter le script de
migration.
Dans le fichier *settings.py* vérifiez que **chimere.scripts** fait partie
des *INSTALLED_APPS*.
Après cela, dans le répertoire d'installation de Chimère, exécutez simplement
le script.
.. code-block:: bash
cd $CHIMERE_APP_PATH
python ./scripts/upgrade.py
Version 1.2 -> 2.0
******************
Django South est maintenant utilisé pour les migrations de base de données.
.. code-block:: bash
cd $CHIMERE_APP_PATH
./manage.py syncdb --noinput
./manage.py migrate chimere 0001 --fake # simule l'initialisation de la base
# de données
./manage.py migrate chimere
Un champ descriptif est maintenant disponible pour les points d'intérêts. Si
vous souhaitez migrer un ancien *modèle de propriété* vers ce nouveau champ,
un script est disponible.
.. code-block:: bash
cd $CHIMERE_APP_PATH
../chimere/scripts/migrate_properties.py
# suivez les instructions
Version 2.0 -> master
*********************
.. code-block:: bash
cd $CHIMERE_APP_PATH
./manage.py syncdb
# migrations have been reinitialized
./manage.py migrate chimere --delete-ghost-migrations --fake 0001
./manage.py migrate chimere
Mise à jour des traductions
---------------------------
Version 1.1 -> 1.2
******************
.. code-block:: bash
cd $CHIMERE_APP_PATH
./manage.py compilemessages
Version 1.2 -> 2.0 -> master
****************************
.. code-block:: bash
cd $CHIMERE_PATH/chimere
django-admin compilemessages
Forcer le rafraîchissement du cache du navigateur des utilisateurs
------------------------------------------------------------------
Des changements importants au niveau des styles et du javascript sont faits
entre les différentes versions. Cela peut provoquer des dysfonctionnements
importants chez des utilisateurs dont le navigateur web a conservé les anciennes
versions de certains fichiers en cache. Il y a plusieurs moyens de forcer le
rafraîchissement de leur cache. Un de ceux-ci est de changer le chemin vers les
fichiers statiques. Pour faire cela, éditez votre fichier *local_settings.py* et
changez : ::
STATIC_URL = '/static/'
en : ::
STATIC_URL = '/static-v2.0.0/'
Changez la directive concernant les fichiers statiques sur le fichier de
configuration de votre serveur web.
Redémarrez alors le serveur web pour appliquer les changements.
Configurer le framework Sites
-----------------------------
Version 1.2 -> 2.0
******************
Le framework *Sites* vous permet de servir le contenu pour différents domaines
Internet. La plupart des installations serviront le contenu pour un seul domaine
mais ce domaine unique doit être configuré.
Pour cela allez dans les pages web d'administration *Sites > Sites*.
Vous avez juste à changer *example.com* par votre nom de domaine. Si vous
oubliez de faire cela, quelques fonctionnalités comme les flux RSS ne
fonctionneront pas correctement.