93 lines
2.8 KiB
Plaintext
93 lines
2.8 KiB
Plaintext
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
|