+
−Installation de cubicweb et de ses d�pendances
+
−-------------------------------------------
+
−Tout le syst�me CubicWeb est pr�par� pour l'installation sur une machine
+
−debian. L'installation manuelle est un peu p�nible du fait des nombreuses
+
−d�pendances � installer (twisted, postgres, autres paquets python...). Nous
+
−supposerons donc ici que l'installation se fait sur une machine debian ayant
+
−dans ses sources apt un entrep�t contenant les paquets pour CubicWeb.
+
−
+
−Pour tout installer sur le syst�me ::
+
−
+
−  apt-get install cubicweb
+
−
+
−On peut �galement n'installer que les paquets cubicweb-server ou cubicweb-twisted pour
+
−n'avoir que la partie serveur ou client web sur une machine.
+
−
+
−Pour tout installer la documentation et les librairies/outils de d�veloppement ::
+
−
+
−  apt-get install cubicweb-documentation cubicweb-dev
+
−
+
−On pourra ensuite installer les paquets suivants :
+
−
+
−* `pyro` si vous voulez que l'entrep�t soit accessible via Pyro ou si le client
+
−  et le serveur ne sont pas sur la m�me machine (auquel cas il faut installer ce
+
−  paquet sur les machines clientes et serveur)
+
−
+
−* `python-ldap` si vous voulez utiliser une source ldap sur le serveur
+
−
+
−* `postgresql-8.1`, `postgresql-contrib-8.1` et `postgresql-plpython-8.1` la
+
−  machine devant h�berger la base de donn�es syst�me
+
−
+
−Configuration de l'environnement
+
−--------------------------------
+
−Ajouter les lignes suivantes � son `.bashrc` ou `.bash_profile` pour configurer
+
−votre environnement de d�veloppement ::
+
−
+
−  export CW_REGISTRY=~/etc/cubicweb.d/
+
−  export CW_CUBES=~/hg/
+
−  export CW_RUNTIME=/tmp/
+
−
+
−Cela suppose que le composant cubicweb que vous d�veloppez est dans un
+
−sous-r�pertoire de *~/hg/* et que vous avez cr�� le r�pertoire *~/etc/cubicweb.d/*
+
−pour que `cubicweb-ctl` y place vos instances de test.
+
−
+
−
+
−Configuration Postgres
+
−----------------------
+
−* cr�ation d'un super utilisateur pour la cr�ation d'instance (**root**) ::
+
−
+
−    createuser --superuser --createdb -P pgadmin
+
−
+
−  Un mot de passe de connection pour cet utilisateur vous sera demand�. Il
+
−  faudra utiliser ce login / mot de passe � la cr�ation d'instance via
+
−  `cubicweb-ctl`
+
−
+
−* installation des extensions pour l'index plein texte ::
+
−
+
−    cat /usr/share/postgresql/8.1/contrib/tsearch2.sql | psql -U pgadmin template1
+
−
+
−* installation du langage plpythonu par d�faut ::
+
−
+
−    createlang -U pgadmin plpythonu template1
+
−
+
−
+
−Configuration Pyro
+
−------------------
+
−Si vous utilisez Pyro, il est n�cessaire d'avoir un serveur de noms Pyro
+
−tournant sur votre r�seau (par d�faut celui-ci est rep�r� par une requ�te
+
−broadcast). Pour cela il faut soit :
+
−
+
−* le lancer � la main avant le d�marrage de cubicweb avec la commande `pyro-ns`
+
−
+
−* le lancer � la main avant le d�marrage de cubicweb sous forme d'un serveur avec
+
−  la commande `pyro-nsd start`
+
−
+
−* �diter le fichier */etc/default/pyro-nsd* pour que le serveur de nom pyro soit
+
−  lanc� automatiquement au d�marrage de la machine