Installation of `Cubicweb` and its dependancies

-----------------------------------------------

`CubicWeb` is available as a Mercurial repository using the forest extension.

First make sure Mercurial is installed and that the forest extension is

available.

Mercurial installation

``````````````````````

Please refer to the project online documentation Mercurial_.

We also provide in this book a quick guide on how to use

Mercurial (:ref:`Mercurial`).

Installation of the forest extension

````````````````````````````````````

Set up the forest extension by getting a copy of the sources 

from http://hg.akoha.org/hgforest/ and adding the following 

lines to your ``~/.hgrc``: ::

Get `CubicWeb` source code

``````````````````````````

Clone the forest in you working directory.

  We recommand you to create a symbolic link to the command ``cubicweb-ctl``

  as you will use it pretty often.

Postgres installation

`````````````````````

Please refer to the project online documentation Postgres_.

You need to install the three following packages: `postgres-8.3`,

Then you can install:

* `pyro` if you wish the repository is accessible through Pyro

  or if the client and the server are not running on the same machine

  (in suche case the packages will have to be isntalled on both

  machines)

* `python-ldap` if you plan to use a LDAP source on the server

Environment configuration

-------------------------

Update the environment variable PYTHONPATH to add to it the path to

the forest ``cubicweb``.

Add the following lines to either `.bashrc` or `.bash_profile` to configure

your development environment ::

  //deprecated??

Postgres configuration

* First you have to initialize the database Postgres with the command ``initdb``.

  Once initialized, you can launch the database server Postgres 

  with the command: ::

  If you cannot execute this command due to permission issues, please

  make sure that your username has write access on the database.

* Create a superuser for `CubicWeb` instance (**root**) ::

  Initialize the password of the superuser you juste created with 

  ``su - postgres`` and ``psql``.

  This password will be asked to you later on where you will create an

  instance with `cubicweb-ctl create`

* installation of plain-text index extension ::

    cat /usr/share/postgresql/8.3/contrib/tsearch2.sql | psql -U username template1

* installation of plpythonu language by default ::

Pyro configuration

If you use Pyro, it is required to have a name server Pyro runing on your

network (by default it is identified by a broadcast request).

To do so, you need to :

* launch the server manually before starting cubicweb with `pyro-ns`

* launch the server manually before starting cubicweb as a server with

  `pyro-nsd start`

* edit the file ``/etc/default/pyro-nsd`` so that the name server pyro

  will be launched automatically when the macine fire up