doc/devmanual_fr/sect_installation.txt
changeset 50 d642f43eb87d
parent 48 0adf4d507ede
child 51 8c5de7159cab
equal deleted inserted replaced
48:0adf4d507ede 50:d642f43eb87d
     1 .. -*- coding: utf-8 -*-
       
     2 
       
     3 ============
       
     4 Installation
       
     5 ============
       
     6 
       
     7 Installation de Cubicweb et de ses dépendances
       
     8 ----------------------------------------------
       
     9 
       
    10 `CubicWeb` est disponible via un entrepôt Mercurial utilisant l'extension forest.
       
    11 Vous devez donc dans un premier temps vous assurer que Mercurial est bien installé
       
    12 et que vous avez l'extension forest.
       
    13 
       
    14 Installation de Mercurial
       
    15 `````````````````````````
       
    16 Veuillez vous référer a la documentation en ligne du projet Mercurial_.
       
    17 
       
    18 .. _Mercurial: http://www.selenic.com/mercurial/wiki/
       
    19 
       
    20 Installation de l'extension forest
       
    21 ``````````````````````````````````
       
    22 Dans un premier temps, récupérez une copie des sources via: http://hg.akoha.org/hgforest/.
       
    23 Ensuite, ajoutez a votre ``~/.hgrc`` les lignes suivantes ::
       
    24 
       
    25    [extensions]
       
    26    hgext.forest=
       
    27    # or, if forest.py is not in the hgext dir:
       
    28    # forest=/path/to/forest.py
       
    29 
       
    30 
       
    31 Installation de Postgres
       
    32 ````````````````````````
       
    33 Veuillez vous référer a la documentation en ligne du projet Postgres_.
       
    34 
       
    35 .. _Postgres: http://www.postgresql.org/
       
    36 
       
    37 
       
    38 [FIXME]
       
    39 Supprimer tout ce qui fait reference a l'installation des paquets debian des
       
    40 que le fclone sur logilab.org fonctionne.
       
    41 
       
    42 Tout le système `Cubicweb` est préparé pour l'installation sur une machine
       
    43 debian. L'installation manuelle est un peu pénible du fait des nombreuses
       
    44 dépendances à installer (twisted, postgres, autres paquets python...). Nous
       
    45 supposerons donc ici que l'installation se fait sur une machine debian ayant
       
    46 dans ses sources apt un entrepôt contenant les paquets pour Erudi.
       
    47 
       
    48 Pour tout installer sur le système ::
       
    49 
       
    50   apt-get install cubicweb
       
    51 
       
    52 On peut également n'installer que les paquets erudi-server ou erudi-twisted pour
       
    53 n'avoir que la partie serveur ou client web sur une machine.
       
    54 
       
    55 Pour tout installer la documentation et les librairies/outils de développement ::
       
    56 
       
    57   apt-get install cubicweb-documentation cubicweb-dev
       
    58 
       
    59 On pourra ensuite installer les paquets suivants :
       
    60 
       
    61 * `pyro` si vous voulez que l'entrepôt soit accessible via Pyro ou si le client
       
    62   et le serveur ne sont pas sur la même machine (auquel cas il faut installer ce
       
    63   paquet sur les machines clientes et serveur)
       
    64 
       
    65 * `python-ldap` si vous voulez utiliser une source ldap sur le serveur
       
    66 
       
    67 * `postgresql-8.1`, `postgresql-contrib-8.1` et `postgresql-plpython-8.1` la
       
    68   machine devant héberger la base de données système
       
    69 
       
    70 .. _ConfigurationEnv:
       
    71 
       
    72 Configuration de l'environnement
       
    73 --------------------------------
       
    74 
       
    75 [FIXME]
       
    76 Ces variables ne sont plus requises pour le bon fonctionnement de `CubicWeb`, non?
       
    77 A part rajouter la foret dans le PYTHONPATH, rien de plus ne doit etre fait?
       
    78  
       
    79 Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer
       
    80 votre environnement de développement ::
       
    81 
       
    82   export ERUDI_REGISTRY=~/etc/erudi.d/
       
    83   export ERUDI_TEMPLATES=~/hg/
       
    84   export ERUDI_RUNTIME=/tmp/
       
    85 
       
    86 Cela suppose que le composant erudi que vous développez est dans un
       
    87 sous-répertoire de *~/hg/* et que vous avez créé le répertoire *~/etc/erudi.d/*
       
    88 pour que `cubicweb-ctl` y place vos instances de test.
       
    89 
       
    90 .. _ConfigurationPostgres:
       
    91 
       
    92 Configuration Postgres
       
    93 ----------------------
       
    94 * création d'un super utilisateur pour la création d'instance (**root**) ::
       
    95 
       
    96     createuser --superuser --createdb -P pgadmin
       
    97 
       
    98   Un mot de passe de connection pour cet utilisateur vous sera demandé. Il
       
    99   faudra utiliser ce login / mot de passe à la création d'instance via
       
   100   `cubicweb-ctl`
       
   101 
       
   102 * installation des extensions pour l'index plein texte ::
       
   103 
       
   104     cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1
       
   105 
       
   106 * installation du langage plpythonu par défaut ::
       
   107 
       
   108     createlang -U pgadmin plpythonu template1
       
   109 
       
   110 
       
   111 Configuration Pyro
       
   112 ------------------
       
   113 Si vous utilisez Pyro, il est nécessaire d'avoir un serveur de noms Pyro
       
   114 tournant sur votre réseau (par défaut celui-ci est repéré par une requête
       
   115 broadcast). Pour cela il faut soit :
       
   116 
       
   117 * le lancer à la main avant le démarrage de erudi avec la commande `pyro-ns`
       
   118 
       
   119 * le lancer à la main avant le démarrage de erudi sous forme d'un serveur avec
       
   120   la commande `pyro-nsd start`
       
   121 
       
   122 * éditer le fichier */etc/default/pyro-nsd* pour que le serveur de nom pyro soit
       
   123   lancé automatiquement au démarrage de la machine
       
   124 
       
   125