| author | Nicolas Chauvat <nicolas.chauvat@logilab.fr> |
| Wed, 12 Nov 2008 21:12:49 +0100 | |
| changeset 36 | f6bcad5c6dfe |
| parent 20 | dfddcbef6684 |
| child 40 | 0857f1fd76cf |
| 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 |
---------------------------------------------- |
|
|
20
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
9 |
[TODO] |
|
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
10 |
Decrire l'installation de la foret mercurial plutot qu'avec |
|
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
11 |
les paquets debian |
|
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
12 |
|
|
36
f6bcad5c6dfe
various doc fixes
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
20
diff
changeset
|
13 |
Tout le système `Cubicweb` est préparé pour l'installation sur une machine |
| 0 | 14 |
debian. L'installation manuelle est un peu pénible du fait des nombreuses |
15 |
dépendances à installer (twisted, postgres, autres paquets python...). Nous |
|
16 |
supposerons donc ici que l'installation se fait sur une machine debian ayant |
|
17 |
dans ses sources apt un entrepôt contenant les paquets pour Erudi. |
|
18 |
||
19 |
Pour tout installer sur le système :: |
|
20 |
||
21 |
apt-get install cubicweb |
|
22 |
||
23 |
On peut également n'installer que les paquets erudi-server ou erudi-twisted pour |
|
24 |
n'avoir que la partie serveur ou client web sur une machine. |
|
25 |
||
26 |
Pour tout installer la documentation et les librairies/outils de développement :: |
|
27 |
||
28 |
apt-get install cubicweb-documentation cubicweb-dev |
|
29 |
||
30 |
On pourra ensuite installer les paquets suivants : |
|
31 |
||
32 |
* `pyro` si vous voulez que l'entrepôt soit accessible via Pyro ou si le client |
|
33 |
et le serveur ne sont pas sur la même machine (auquel cas il faut installer ce |
|
34 |
paquet sur les machines clientes et serveur) |
|
35 |
||
36 |
* `python-ldap` si vous voulez utiliser une source ldap sur le serveur |
|
37 |
||
38 |
* `postgresql-8.1`, `postgresql-contrib-8.1` et `postgresql-plpython-8.1` la |
|
39 |
machine devant héberger la base de données système |
|
40 |
||
41 |
Configuration de l'environnement |
|
42 |
-------------------------------- |
|
|
20
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
43 |
[FIXME] |
|
36
f6bcad5c6dfe
various doc fixes
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
20
diff
changeset
|
44 |
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
|
45 |
A part rajouter la foret dans le PYTHONPATH, rien de plus ne doit etre fait? |
|
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
46 |
|
| 0 | 47 |
Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer |
48 |
votre environnement de développement :: |
|
49 |
||
50 |
export ERUDI_REGISTRY=~/etc/erudi.d/ |
|
51 |
export ERUDI_TEMPLATES=~/hg/ |
|
52 |
export ERUDI_RUNTIME=/tmp/ |
|
53 |
||
54 |
Cela suppose que le composant erudi que vous développez est dans un |
|
55 |
sous-répertoire de *~/hg/* et que vous avez créé le répertoire *~/etc/erudi.d/* |
|
56 |
pour que `cubicweb-ctl` y place vos instances de test. |
|
57 |
||
58 |
||
59 |
Configuration Postgres |
|
60 |
---------------------- |
|
61 |
* création d'un super utilisateur pour la création d'instance (**root**) :: |
|
62 |
||
63 |
createuser --superuser --createdb -P pgadmin |
|
64 |
||
65 |
Un mot de passe de connection pour cet utilisateur vous sera demandé. Il |
|
66 |
faudra utiliser ce login / mot de passe à la création d'instance via |
|
67 |
`cubicweb-ctl` |
|
68 |
||
69 |
* installation des extensions pour l'index plein texte :: |
|
70 |
||
71 |
cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1 |
|
72 |
||
73 |
* installation du langage plpythonu par défaut :: |
|
74 |
||
75 |
createlang -U pgadmin plpythonu template1 |
|
76 |
||
77 |
||
78 |
Configuration Pyro |
|
79 |
------------------ |
|
80 |
Si vous utilisez Pyro, il est nécessaire d'avoir un serveur de noms Pyro |
|
81 |
tournant sur votre réseau (par défaut celui-ci est repéré par une requête |
|
82 |
broadcast). Pour cela il faut soit : |
|
83 |
||
84 |
* le lancer à la main avant le démarrage de erudi avec la commande `pyro-ns` |
|
85 |
||
86 |
* le lancer à la main avant le démarrage de erudi sous forme d'un serveur avec |
|
87 |
la commande `pyro-nsd start` |
|
88 |
||
89 |
* éditer le fichier */etc/default/pyro-nsd* pour que le serveur de nom pyro soit |
|
90 |
lancé automatiquement au démarrage de la machine |
|
|
20
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
91 |
|
|
dfddcbef6684
Add links between sections.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents:
0
diff
changeset
|
92 |