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