dauphine-logement/README

Installation
============

Lancer les scripts d'installation depuis le répertoire du projet :

	# cd /usr/src/appli-dauphine-vX.Y/
	# ./install.rpm.sh
	# ./install.pgsql.sh
	# ./install.application.sh

Notes:
* install.rpm.sh : installe les sources yum et paquets logiciels nécessaires
* install.pgsql.sh : initialise la base de données postgresql "logement"
* install.application.sh : installe l'application proprement dite,
  remet à zéro la base de données et y ajoute des données initiales
* le code de l'application est installé dans /home/logement/src
* lors de cette procédure, tous les services sont (re)démarrés et
  l'application est visible via le web

Initialisation des données
==========================

Creation d'un superutilisateur (il en faut au moins un) :

	# cd /home/logement/src
	# ./create_superuser.sh

... et répondre aux questions.

Gestion du service
==================

La commande de lancement de l'application est :
	# service logement start
La commande d'arrêt est :
	# service logement stop

Autres services en jeu : nginx, postgresql, memcached

Fichier de configuration
========================

Si des variables de configuration devaient avoir des valeurs différentes des
valeurs de base, on mettra cette configuration dans le fichier
/etc/logement/local_settings_dev.py en développement, et
/etc/logement/local_settings_prod.py en production.

On pourra notamment définir la valeur LDAP_BIND_PASSWORD qui contrôle
l'authentification administrative auprès du serveur LDAP pour la récupération
des attributs des utilisateurs CAS.

Configuration derrière un reverse-proxy SSL
===========================================

Il faut tout d'abord indiquer à l'application logement comment détecter que la
connection forwardé est en fait sécurisé, pour cela ajouter à
/etc/logement/local_settings_dev.py les lignes suivantes:

	SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTOCOL', 'https')

Ensuite il faut faire en sorte que le reverse proxy transmette un entête nommé
X-Forwarded-Protocol ayant la valeur « https ». Si ce n'est pas possible on
définira cet entête en dur dans le serveur web local, par exemple dans nginx:

	fastcgi_param HTTP_X_FORWARDED_PROTOCOL "https";

ou bien pour Apache 2 (il faut activer le module mod_env):

	SetEnv HTTP_X_FORWARDED_PROTOCOL "https"

Sauvegarde et restauration
==========================

Il faut sauvegarder/restaurer la base de donnée PostgreSQL nommée
habituellement "logement" ainsi que le répertoire /var/lib/logement/media/
contenant les fichiers joints par les utilisateurs (photos des annonces, images
du CMS).

Mise à jour
===========

Il faut d'abord décompresser la mise à jour:

  tar xvzf appli-logement-X.X.tar.gz

Aller dans le répertoire décompressé:

  cd appli-logement-X.X

Puis éxécuter le script d'installation de l'application:

  ./install.application.sh