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