site Logement Dauphine
This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Benjamin Dauvergne a46cbf9123 bump release to 0.25 2015-12-05 18:13:40 +01:00
appli_project add max_length parameter to email, first_name and last_name fields of the registration form 2015-12-05 18:11:38 +01:00
help/fr help: retire les références aux parties administrateurs et profils offre dans la documentation des comptes étudiants/chercheurs 2013-04-10 18:34:17 +02:00
.gitignore mise à jour de gitignore 2013-04-10 17:49:28 +02:00
Changelog bump release to 0.12 2013-06-13 12:37:19 +02:00
Makefile bump release to 0.25 2015-12-05 18:13:40 +01:00
README ajout des instructions de mise à jour 2013-06-07 10:14:54 +02:00
build_virtualenv.sh update build_virtualenv.sh 2013-06-07 12:02:48 +02:00
create_superuser.sh remplace manage.py par logement-prod 2012-06-19 13:54:31 +02:00
cronfile fix typo dans cronfile 2012-06-21 14:15:52 +02:00
cubewerx_extra.wkt.addendum finition des script d'installation et de désinstallation 2012-04-10 20:34:26 +02:00
flush_database.sh remplace manage.py par logement-prod 2012-06-19 13:54:31 +02:00
init.d utilise le mode « threaded » pour le serveur d'application Django 2012-12-12 09:48:46 +01:00
install.application.sh remplace manage.py par logement-prod 2012-06-19 13:54:31 +02:00
install.pgsql.sh install.pgsql: ni initdb, ni start 2012-04-13 15:42:18 +02:00
install.rpm.sh install.sh renommé install.rpm.sh 2012-04-17 12:07:54 +02:00
logement-dev manage.py: upgrade control scripts for Django 1.4 2013-05-22 10:54:38 +02:00
logement-prod manage.py: upgrade control scripts for Django 1.4 2013-05-22 10:54:38 +02:00
nginx.conf Ajoute client_max_body_size au vhost nginx 2015-07-01 16:07:12 +02:00
requirements Add requirement for django-picklefield 2015-07-01 12:58:39 +02:00
uninstall.sh uninstall /etc/init.d/logement 2012-04-17 12:05:16 +02:00
update.application.sh corrige script d'update (quat) 2013-04-08 04:53:45 +02:00

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