1 .. -*- coding: utf-8 -*- |
|
2 |
|
3 Installation |
|
4 ============ |
|
5 |
|
6 Installation de Cubicweb et de ses dépendances |
|
7 ---------------------------------------------- |
|
8 |
|
9 `CubicWeb` est disponible via un entrepôt Mercurial utilisant l'extension forest. |
|
10 Vous devez donc dans un premier temps vous assurer que Mercurial est bien installé |
|
11 et que vous avez l'extension forest. |
|
12 |
|
13 Installation de Mercurial |
|
14 ````````````````````````` |
|
15 Veuillez vous référer a la documentation en ligne du projet Mercurial_. |
|
16 |
|
17 .. _Mercurial: http://www.selenic.com/mercurial/wiki/ |
|
18 |
|
19 Installation de l'extension forest |
|
20 `````````````````````````````````` |
|
21 Dans un premier temps, récupérez une copie des sources via: http://hg.akoha.org/hgforest/. |
|
22 Ensuite, ajoutez a votre ``~/.hgrc`` les lignes suivantes :: |
|
23 |
|
24 [extensions] |
|
25 hgext.forest= |
|
26 # or, if forest.py is not in the hgext dir: |
|
27 # forest=/path/to/forest.py |
|
28 |
|
29 Récupération des sources |
|
30 ```````````````````````` |
|
31 Clonez la foret dans votre répertoire de travail. |
|
32 |
|
33 :: |
|
34 |
|
35 hg fclone http://www.logilab.org/hg/forests/cubicweb |
|
36 |
|
37 .. note:: |
|
38 Nous vous recommandons de créer un lien symbolique vers l'outil ``cubicweb-ctl`` |
|
39 que vous allez etre amené a utiliser. |
|
40 |
|
41 :: |
|
42 |
|
43 $ ln -s /path/to/forest/cubicweb/bin/cubicweb-ctl ~/bin |
|
44 |
|
45 Installation de Postgres |
|
46 ```````````````````````` |
|
47 Veuillez vous référer a la documentation en ligne du projet Postgres_. |
|
48 |
|
49 .. _Postgres: http://www.postgresql.org/ |
|
50 |
|
51 Vous allez devoir installer les trois paquets suivants: `postgres-8.3`, |
|
52 `postgres-contrib-8.3` and `postgresql-plpython-8.3`. |
|
53 |
|
54 |
|
55 On pourra ensuite installer les paquets suivants : |
|
56 |
|
57 * `pyro` si vous voulez que l'entrepôt soit accessible via Pyro ou si le client |
|
58 et le serveur ne sont pas sur la même machine (auquel cas il faut installer ce |
|
59 paquet sur les machines clientes et serveur) |
|
60 |
|
61 * `python-ldap` si vous voulez utiliser une source ldap sur le serveur |
|
62 |
|
63 |
|
64 .. _ConfigurationEnv: |
|
65 |
|
66 Configuration de l'environnement |
|
67 -------------------------------- |
|
68 |
|
69 [FIXME] |
|
70 Ces variables ne sont plus requises pour le bon fonctionnement de `CubicWeb`, non? |
|
71 A part rajouter la foret dans le PYTHONPATH, rien de plus ne doit etre fait? |
|
72 |
|
73 Mettez à jour votre variable d'environemment PYTHONPATH afin d'y ajouter |
|
74 le chemin d'acces a votre foret ``cubicweb``. |
|
75 |
|
76 Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer |
|
77 votre environnement de développement :: |
|
78 |
|
79 export PYTHONPATH=/full/path/to/cubicweb-forest |
|
80 |
|
81 export ERUDI_REGISTRY=~/etc/erudi.d/ |
|
82 export ERUDI_TEMPLATES=~/hg/ |
|
83 export ERUDI_RUNTIME=/tmp/ |
|
84 |
|
85 Cela suppose que le composant erudi que vous développez est dans un |
|
86 sous-répertoire de *~/hg/* et que vous avez créé le répertoire *~/etc/erudi.d/* |
|
87 pour que `cubicweb-ctl` y place vos instances de test. |
|
88 |
|
89 .. _ConfigurationPostgres: |
|
90 |
|
91 Configuration Postgres |
|
92 ---------------------- |
|
93 * Tout d'abord vous devez initialiser votre base de données Postgres via la |
|
94 commande ``initidb``. |
|
95 :: |
|
96 |
|
97 $ initdb -D /path/to/pgsql |
|
98 |
|
99 Une fois ces paquets installés vous pouvez lancer votre server de base de |
|
100 données Postgres avec la commande suivante: :: |
|
101 |
|
102 $ postgres -D /path/to/psql |
|
103 |
|
104 Si vous ne pouvez exécuter cette commande pour des raisons de permissions |
|
105 assurez-vous que votre utilisateur a droit d'écriture sur les la base de données. |
|
106 |
|
107 :: |
|
108 |
|
109 $ chown username /path/to/pgsql |
|
110 |
|
111 * Création d'un super utilisateur pour la création d'instance (**root**) :: |
|
112 |
|
113 createuser -s username |
|
114 |
|
115 Initialisez le mot de passe de ce superutilisateur ``username`` via |
|
116 ``su - postgres`` puis ``psql``. |
|
117 |
|
118 Un mot de passe de connection pour cet utilisateur vous sera demandé. Il |
|
119 faudra utiliser ce login / mot de passe à la création d'instance via |
|
120 `cubicweb-ctl` |
|
121 |
|
122 [XXX] |
|
123 Est-ce que ces etapes sont vraiment necessaires? |
|
124 sand : lors de l'installation de ma bdd cela n'a pas ete fait |
|
125 et il semble que tout aille bien. Doit etre verifie avec les experts. |
|
126 |
|
127 * installation des extensions pour l'index plein texte :: |
|
128 |
|
129 cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1 |
|
130 |
|
131 * installation du langage plpythonu par défaut :: |
|
132 |
|
133 createlang -U pgadmin plpythonu template1 |
|
134 |
|
135 |
|
136 Configuration Pyro |
|
137 ------------------ |
|
138 Si vous utilisez Pyro, il est nécessaire d'avoir un serveur de noms Pyro |
|
139 tournant sur votre réseau (par défaut celui-ci est repéré par une requête |
|
140 broadcast). Pour cela il faut soit : |
|
141 |
|
142 * le lancer à la main avant le démarrage de erudi avec la commande `pyro-ns` |
|
143 |
|
144 * le lancer à la main avant le démarrage de erudi sous forme d'un serveur avec |
|
145 la commande `pyro-nsd start` |
|
146 |
|
147 * éditer le fichier */etc/default/pyro-nsd* pour que le serveur de nom pyro soit |
|
148 lancé automatiquement au démarrage de la machine |
|
149 |
|
150 |
|