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 |
|