# HG changeset patch
# User Sandrine Ribeau <sandrine.ribeau@logilab.fr>
# Date 1226961473 28800
# Node ID 4559604895cb188c8951278fd160cef3ec055cf9
# Parent  22665a052a31efb231dbd7e669bc74b332c038e4
Updates installation with use of mercurial forest. Needs to be improved.

diff -r 22665a052a31 -r 4559604895cb doc/book/fr/sect_installation.txt
--- a/doc/book/fr/sect_installation.txt	Mon Nov 17 11:16:33 2008 -0800
+++ b/doc/book/fr/sect_installation.txt	Mon Nov 17 14:37:53 2008 -0800
@@ -27,6 +27,21 @@
    # or, if forest.py is not in the hgext dir:
    # forest=/path/to/forest.py
 
+Récupération des sources
+````````````````````````
+Clonez la foret dans votre répertoire de travail. 
+
+::
+
+  hg fclone http://www.logilab.org/hg/forests/cubicweb
+
+.. note:: 
+  Nous vous recommandons de créer un lien symbolique vers l'outil ``cubicweb-ctl``
+  que vous allez etre amené a utiliser.
+
+  ::
+    
+    $ ln -s /path/to/forest/cubicweb/bin/cubicweb-ctl ~/bin
 
 Installation de Postgres
 ````````````````````````
@@ -34,27 +49,9 @@
 
 .. _Postgres: http://www.postgresql.org/
 
-
-[FIXME]
-Supprimer tout ce qui fait reference a l'installation des paquets debian des
-que le fclone sur logilab.org fonctionne.
-
-Tout le système `Cubicweb` est préparé pour l'installation sur une machine
-debian. L'installation manuelle est un peu pénible du fait des nombreuses
-dépendances à installer (twisted, postgres, autres paquets python...). Nous
-supposerons donc ici que l'installation se fait sur une machine debian ayant
-dans ses sources apt un entrepôt contenant les paquets pour Erudi.
+Vous allez devoir installer les trois paquets suivants: `postgres-8.3`,
+`postgres-contrib-8.3` and `postgresql-plpython-8.3`.
 
-Pour tout installer sur le système ::
-
-  apt-get install cubicweb
-
-On peut également n'installer que les paquets erudi-server ou erudi-twisted pour
-n'avoir que la partie serveur ou client web sur une machine.
-
-Pour tout installer la documentation et les librairies/outils de développement ::
-
-  apt-get install cubicweb-documentation cubicweb-dev
 
 On pourra ensuite installer les paquets suivants :
 
@@ -64,8 +61,6 @@
 
 * `python-ldap` si vous voulez utiliser une source ldap sur le serveur
 
-* `postgresql-8.1`, `postgresql-contrib-8.1` et `postgresql-plpython-8.1` la
-  machine devant héberger la base de données système
 
 .. _ConfigurationEnv:
 
@@ -75,10 +70,15 @@
 [FIXME]
 Ces variables ne sont plus requises pour le bon fonctionnement de `CubicWeb`, non?
 A part rajouter la foret dans le PYTHONPATH, rien de plus ne doit etre fait?
- 
+
+Mettez à jour votre variable d'environemment PYTHONPATH afin d'y ajouter
+le chemin d'acces a votre foret ``cubicweb``. 
+
 Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer
 votre environnement de développement ::
-
+  
+  export PYTHONPATH=/full/path/to/cubicweb-forest
+  
   export ERUDI_REGISTRY=~/etc/erudi.d/
   export ERUDI_TEMPLATES=~/hg/
   export ERUDI_RUNTIME=/tmp/
@@ -91,14 +91,40 @@
 
 Configuration Postgres
 ----------------------
-* création d'un super utilisateur pour la création d'instance (**root**) ::
+* Tout d'abord vous devez initialiser votre base de données Postgres via la
+  commande ``initidb``.
+  ::
+
+    $ initdb -D /path/to/pgsql
+
+  Une fois ces paquets installés vous pouvez lancer votre server de base de 
+  données Postgres avec la commande suivante: ::
+  
+    $ postgres -D /path/to/psql
 
-    createuser --superuser --createdb -P pgadmin
+  Si vous ne pouvez exécuter cette commande pour des raisons de permissions
+  assurez-vous que votre utilisateur a droit d'écriture sur les la base de données.
+
+  ::
+ 
+    $ chown username /path/to/pgsql
+
+* Création d'un super utilisateur pour la création d'instance (**root**) ::
+
+    createuser -s username
+
+  Initialisez le mot de passe de ce superutilisateur ``username`` via
+  ``su - postgres`` puis ``psql``.
 
   Un mot de passe de connection pour cet utilisateur vous sera demandé. Il
   faudra utiliser ce login / mot de passe à la création d'instance via
   `cubicweb-ctl`
 
+[XXX]
+Est-ce que ces etapes sont vraiment necessaires? 
+sand : lors de l'installation de ma bdd cela n'a pas ete fait
+et il semble que tout aille bien. Doit etre verifie avec les experts.
+
 * installation des extensions pour l'index plein texte ::
 
     cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1