goa/doc/devmanual_fr/sect_installation.txt
changeset 0 b97547f5f1fa
equal deleted inserted replaced
-1:000000000000 0:b97547f5f1fa
       
     1 Installation de cubicweb et de ses dépendances
       
     2 -------------------------------------------
       
     3 Tout le système CubicWeb est préparé pour l'installation sur une machine
       
     4 debian. L'installation manuelle est un peu pénible du fait des nombreuses
       
     5 dépendances à installer (twisted, postgres, autres paquets python...). Nous
       
     6 supposerons donc ici que l'installation se fait sur une machine debian ayant
       
     7 dans ses sources apt un entrepôt contenant les paquets pour CubicWeb.
       
     8 
       
     9 Pour tout installer sur le système ::
       
    10 
       
    11   apt-get install cubicweb
       
    12 
       
    13 On peut également n'installer que les paquets cubicweb-server ou cubicweb-twisted pour
       
    14 n'avoir que la partie serveur ou client web sur une machine.
       
    15 
       
    16 Pour tout installer la documentation et les librairies/outils de développement ::
       
    17 
       
    18   apt-get install cubicweb-documentation cubicweb-dev
       
    19 
       
    20 On pourra ensuite installer les paquets suivants :
       
    21 
       
    22 * `pyro` si vous voulez que l'entrepôt soit accessible via Pyro ou si le client
       
    23   et le serveur ne sont pas sur la même machine (auquel cas il faut installer ce
       
    24   paquet sur les machines clientes et serveur)
       
    25 
       
    26 * `python-ldap` si vous voulez utiliser une source ldap sur le serveur
       
    27 
       
    28 * `postgresql-8.1`, `postgresql-contrib-8.1` et `postgresql-plpython-8.1` la
       
    29   machine devant héberger la base de données système
       
    30 
       
    31 Configuration de l'environnement
       
    32 --------------------------------
       
    33 Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer
       
    34 votre environnement de développement ::
       
    35 
       
    36   export CW_REGISTRY=~/etc/cubicweb.d/
       
    37   export CW_CUBES=~/hg/
       
    38   export CW_RUNTIME=/tmp/
       
    39 
       
    40 Cela suppose que le composant cubicweb que vous développez est dans un
       
    41 sous-répertoire de *~/hg/* et que vous avez créé le répertoire *~/etc/cubicweb.d/*
       
    42 pour que `cubicweb-ctl` y place vos instances de test.
       
    43 
       
    44 
       
    45 Configuration Postgres
       
    46 ----------------------
       
    47 * création d'un super utilisateur pour la création d'instance (**root**) ::
       
    48 
       
    49     createuser --superuser --createdb -P pgadmin
       
    50 
       
    51   Un mot de passe de connection pour cet utilisateur vous sera demandé. Il
       
    52   faudra utiliser ce login / mot de passe à la création d'instance via
       
    53   `cubicweb-ctl`
       
    54 
       
    55 * installation des extensions pour l'index plein texte ::
       
    56 
       
    57     cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1
       
    58 
       
    59 * installation du langage plpythonu par défaut ::
       
    60 
       
    61     createlang -U pgadmin plpythonu template1
       
    62 
       
    63 
       
    64 Configuration Pyro
       
    65 ------------------
       
    66 Si vous utilisez Pyro, il est nécessaire d'avoir un serveur de noms Pyro
       
    67 tournant sur votre réseau (par défaut celui-ci est repéré par une requête
       
    68 broadcast). Pour cela il faut soit :
       
    69 
       
    70 * le lancer à la main avant le démarrage de cubicweb avec la commande `pyro-ns`
       
    71 
       
    72 * le lancer à la main avant le démarrage de cubicweb sous forme d'un serveur avec
       
    73   la commande `pyro-nsd start`
       
    74 
       
    75 * éditer le fichier */etc/default/pyro-nsd* pour que le serveur de nom pyro soit
       
    76   lancé automatiquement au démarrage de la machine