cubicweb: doc/devmanual_fr/sect_installation.txt@0857f1fd76cf (annotated)

0 b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	1	.. -- coding: utf-8 --
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	2
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	3	============
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	4	Installation
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	5	============
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	6
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	7	Installation de Cubicweb et de ses dépendances
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	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
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	30
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	31	Installation de Postgres
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	32	````````````````````````
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	33	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	34
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	35	.. _Postgres: http://www.postgresql.org/
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	36
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	37
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	38	[FIXME]
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	39	Supprimer tout ce qui fait reference a l'installation des paquets debian des
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	40	que le fclone sur logilab.org fonctionne.
20 dfddcbef6684 Add links between sections. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 0 diff changeset	41
36 f6bcad5c6dfe various doc fixes Nicolas Chauvat <nicolas.chauvat@logilab.fr> parents: 20 diff changeset	42	Tout le système `Cubicweb` est préparé pour l'installation sur une machine
0 b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	43	debian. L'installation manuelle est un peu pénible du fait des nombreuses
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	44	dépendances à installer (twisted, postgres, autres paquets python...). Nous
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	45	supposerons donc ici que l'installation se fait sur une machine debian ayant
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	46	dans ses sources apt un entrepôt contenant les paquets pour Erudi.
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	47
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	48	Pour tout installer sur le système ::
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	49
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	50	apt-get install cubicweb
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	51
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	52	On peut également n'installer que les paquets erudi-server ou erudi-twisted pour
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	53	n'avoir que la partie serveur ou client web sur une machine.
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	54
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	55	Pour tout installer la documentation et les librairies/outils de développement ::
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	56
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	57	apt-get install cubicweb-documentation cubicweb-dev
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	58
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	59	On pourra ensuite installer les paquets suivants :
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	60
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	61	* `pyro` si vous voulez que l'entrepôt soit accessible via Pyro ou si le client
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	62	et le serveur ne sont pas sur la même machine (auquel cas il faut installer ce
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	63	paquet sur les machines clientes et serveur)
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	64
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	65	* `python-ldap` si vous voulez utiliser une source ldap sur le serveur
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	66
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	67	* `postgresql-8.1`, `postgresql-contrib-8.1` et `postgresql-plpython-8.1` la
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	68	machine devant héberger la base de données système
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	69
40 0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	70	.. _ConfigurationEnv:
0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	71
0 b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	72	Configuration de l'environnement
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	73	--------------------------------
40 0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	74
20 dfddcbef6684 Add links between sections. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 0 diff changeset	75	[FIXME]
36 f6bcad5c6dfe various doc fixes Nicolas Chauvat <nicolas.chauvat@logilab.fr> parents: 20 diff changeset	76	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	77	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	78
0 b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	79	Ajouter les lignes suivantes à son `.bashrc` ou `.bash_profile` pour configurer
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	80	votre environnement de développement ::
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	81
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	82	export ERUDI_REGISTRY=~/etc/erudi.d/
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	83	export ERUDI_TEMPLATES=~/hg/
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	84	export ERUDI_RUNTIME=/tmp/
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	85
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	86	Cela suppose que le composant erudi que vous développez est dans un
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	87	sous-répertoire de ~/hg/ et que vous avez créé le répertoire ~/etc/erudi.d/
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	88	pour que `cubicweb-ctl` y place vos instances de test.
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	89
40 0857f1fd76cf Add link to installation in front page. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 36 diff changeset	90	.. _ConfigurationPostgres:
0 b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	91
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	92	Configuration Postgres
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	93	----------------------
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	94	* création d'un super utilisateur pour la création d'instance (root) ::
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	95
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	96	createuser --superuser --createdb -P pgadmin
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	97
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	98	Un mot de passe de connection pour cet utilisateur vous sera demandé. Il
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	99	faudra utiliser ce login / mot de passe à la création d'instance via
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	100	`cubicweb-ctl`
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	101
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	102	* installation des extensions pour l'index plein texte ::
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	103
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	104	cat /usr/share/postgresql/8.1/contrib/tsearch2.sql \| psql -U pgadmin template1
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	105
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	106	* installation du langage plpythonu par défaut ::
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	107
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	108	createlang -U pgadmin plpythonu template1
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	109
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	110
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	111	Configuration Pyro
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	112	------------------
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	113	Si vous utilisez Pyro, il est nécessaire d'avoir un serveur de noms Pyro
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	114	tournant sur votre réseau (par défaut celui-ci est repéré par une requête
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	115	broadcast). Pour cela il faut soit :
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	116
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	117	* le lancer à la main avant le démarrage de erudi avec la commande `pyro-ns`
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	118
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	119	* le lancer à la main avant le démarrage de erudi sous forme d'un serveur avec
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	120	la commande `pyro-nsd start`
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	121
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	122	* éditer le fichier /etc/default/pyro-nsd pour que le serveur de nom pyro soit
b97547f5f1fa Showtime ! Adrien Di Mascio <Adrien.DiMascio@logilab.fr> parents: diff changeset	123	lancé automatiquement au démarrage de la machine
20 dfddcbef6684 Add links between sections. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 0 diff changeset	124
dfddcbef6684 Add links between sections. Sandrine Ribeau <sandrine.ribeau@logilab.fr> parents: 0 diff changeset	125

author	Sandrine Ribeau <sandrine.ribeau@logilab.fr>
	Wed, 12 Nov 2008 14:48:08 -0800
changeset 40	0857f1fd76cf
parent 36	f6bcad5c6dfe
permissions	-rw-r--r--