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