doc/book/en/C011-installation.en.txt
author Sandrine Ribeau <sandrine.ribeau@logilab.fr>
Mon, 30 Mar 2009 19:38:25 -0700
changeset 1193 24486ce4dea1
parent 1192 82375c14eb26
child 1195 79c1abc64304
child 1201 ef2715330b92
permissions -rw-r--r--
[doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     1
.. -*- coding: utf-8 -*-
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     2
221
19125141f6eb [doc] Add internal link. Suppress content display which creates duplicated toc.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 152
diff changeset
     3
.. _CubicWebInstallation:
19125141f6eb [doc] Add internal link. Suppress content display which creates duplicated toc.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 152
diff changeset
     4
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     5
Installation
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     6
============
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
     7
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
     8
Installation of `Cubicweb` and its dependencies
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
     9
-----------------------------------------------
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    10
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    11
`CubicWeb` is packaged for Debian and Ubuntu, but can be installed from source
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    12
using a tarball or the Mercurial version control system.
105
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    13
152
b435d80d0c9e [doc] rewrite paragraph about installing debian and ubuntu packages
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 127
diff changeset
    14
Debian and Ubuntu packages
b435d80d0c9e [doc] rewrite paragraph about installing debian and ubuntu packages
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 127
diff changeset
    15
```````````````````````````
b435d80d0c9e [doc] rewrite paragraph about installing debian and ubuntu packages
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 127
diff changeset
    16
Depending on the distribution you are using, add the appropriate line to your list
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    17
of sources (for example by editing ``/etc/apt/sources.list``).
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    18
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    19
For Debian Lenny::
105
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    20
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    21
  deb http://ftp.logilab.org/dists/ lenny/
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    22
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    23
For Debian Sid::
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    24
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    25
  deb http://ftp.logilab.org/dists/ sid/
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    26
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    27
For Ubuntu Hardy::
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    28
105
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    29
  deb http://ftp.logilab.org/dists/ hardy/
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    30
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    31
152
b435d80d0c9e [doc] rewrite paragraph about installing debian and ubuntu packages
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 127
diff changeset
    32
You can now install the required packages with the following command: ::
105
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    33
269
6751132d3648 [doc] Add cubicweb-dev package to install.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 267
diff changeset
    34
  apt-get update 
6751132d3648 [doc] Add cubicweb-dev package to install.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 267
diff changeset
    35
  apt-get install cubicweb
6751132d3648 [doc] Add cubicweb-dev package to install.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 267
diff changeset
    36
  apt-get install cubicweb-dev
6751132d3648 [doc] Add cubicweb-dev package to install.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 267
diff changeset
    37
105
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    38
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    39
This is it!
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    40
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    41
Install from source
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    42
```````````````````
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    43
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    44
You can download the archive containing the sources from our `ftp site`_ at: ::
105
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    45
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    46
  http://ftp.logilab.org/pub/cubicweb/
300166b41ea9 [doc] Moved installation from mercurial forest in appendix. Cleaned installation section but needs improvements.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 98
diff changeset
    47
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    48
.. _`ftp site`: http://ftp.logilab.org/pub/cubicweb/
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    49
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    50
or keep up to date with on-going development by using Mercurial and its forest
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    51
extension::
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    52
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    53
  hg fclone http://www.logilab.org/hg/forests/cubicweb
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    54
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    55
See :ref:`MercurialPresentation` for more details about Mercurial.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    56
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    57
Postgres installation
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    58
`````````````````````
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    59
267
843e0b1bf991 [doc] simpler install and mercurial instructions
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 221
diff changeset
    60
Please refer to the `Postgresql project online documentation`_.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    61
271
e150b92237d9 [doc] Add link to cubicweb's forge for cubes available.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 269
diff changeset
    62
.. _`Postgresql project online documentation`: http://www.postgresql.org/
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    63
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    64
You need to install the three following packages: `postgres-8.3`,
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    65
`postgres-contrib-8.3` and `postgresql-plpython-8.3`.
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    66
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    67
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    68
Then you can install:
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    69
564
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
    70
* `pyro` if you wish the repository to be accessible through Pyro
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    71
  or if the client and the server are not running on the same machine
564
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
    72
  (in which case the packages will have to be installed on both
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    73
  machines)
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    74
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    75
* `python-ldap` if you plan to use a LDAP source on the server
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    76
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    77
.. _ConfigurationEnv:
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    78
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    79
Environment configuration
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    80
-------------------------
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    81
271
e150b92237d9 [doc] Add link to cubicweb's forge for cubes available.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 269
diff changeset
    82
If you installed `CubicWeb` by cloning the Mercurial forest, then you
564
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
    83
will need to update the environment variable PYTHONPATH by adding  
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
    84
the path to the forest ``cubicweb``:
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    85
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    86
Add the following lines to either `.bashrc` or `.bash_profile` to configure
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
    87
your development environment ::
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    88
  
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    89
  export PYTHONPATH=/full/path/to/cubicweb-forest
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    90
271
e150b92237d9 [doc] Add link to cubicweb's forge for cubes available.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 269
diff changeset
    91
If you installed the debian packages, no configuration is required.
e150b92237d9 [doc] Add link to cubicweb's forge for cubes available.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 269
diff changeset
    92
Your new cubes will be placed in `/usr/share/cubicweb/cubes` and
e150b92237d9 [doc] Add link to cubicweb's forge for cubes available.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 269
diff changeset
    93
your applications will be placed in `/etc/cubicweb.d`.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
    94
1192
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
    95
To use others directories then you will have to configure the
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
    96
following environment variables as follows: ::
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
    97
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
    98
    export CW_CUBES_PATH=~/lib/cubes
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
    99
    export CW_REGISTRY=~/etc/cubicweb.d/
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   100
    export CW_INSTANCE_DATA=$CW_REGISTRY
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   101
    export CW_RUNTIME=/tmp
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   102
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   103
.. note::
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   104
    The values given above are our suggestions but of course
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   105
    can be different.
82375c14eb26 [doc] Add set-up of environment variables.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 564
diff changeset
   106
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   107
.. _ConfigurationPostgres:
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   108
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   109
Postgres configuration
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   110
----------------------
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   111
1193
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   112
.. note::
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   113
    If you already have an existing cluster and postgres server
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   114
    running you do not require to execute the initilization step
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   115
    of your Postgres database.
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   116
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   117
* First you have to initialize the database Postgres with the command ``initdb``.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   118
  ::
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   119
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   120
    $ initdb -D /path/to/pgsql
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   121
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   122
  Once initialized, you can launch the database server Postgres 
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   123
  with the command: ::
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   124
  
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   125
    $ postgres -D /path/to/psql
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   126
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   127
  If you cannot execute this command due to permission issues, please
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   128
  make sure that your username has write access on the database.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   129
  ::
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   130
 
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   131
    $ chown username /path/to/pgsql
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   132
1193
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   133
* Create a superuser for `CubicWeb` instance: ::
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   134
    
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   135
    $ su
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   136
    $ su - postgres
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   137
    $ createuser -s username
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   138
1193
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   139
  Initialize the password of the superuser you just created for your
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   140
  database: ::
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   141
    
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   142
    $ su 
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   143
    $ su - postgres
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   144
    $ psql
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   145
1193
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   146
  And then execute de following query: ::
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   147
    
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   148
    ALTER USER username WITH PASSWORD `password`
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   149
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   150
  This login/password will be requested when you will create an
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   151
  instance with `cubicweb-ctl create` to initialize the database of
24486ce4dea1 [doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 1192
diff changeset
   152
  your application.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   153
564
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
   154
.. [XXX] Est-ce que ces etapes sont vraiment necessaires?  sand : lors de l'installation de ma bdd cela n'a pas ete fait et il semble que tout aille bien. Doit etre verifie avec les experts.
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   155
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   156
* installation of plain-text index extension ::
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   157
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   158
    cat /usr/share/postgresql/8.3/contrib/tsearch2.sql | psql -U username template1
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   159
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   160
* installation of plpythonu language by default ::
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   161
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   162
    createlang -U pgadmin plpythonu template1
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   163
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   164
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   165
Pyro configuration
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   166
------------------
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   167
564
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
   168
If you use Pyro, it is required to have a name server Pyro running on your
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   169
network (by default it is identified by a broadcast request).
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   170
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   171
To do so, you need to :
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   172
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   173
* launch the server manually before starting cubicweb with `pyro-ns`
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   174
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   175
* launch the server manually before starting cubicweb as a server with
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   176
  `pyro-nsd start`
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   177
98
f756ead5746a [doc] Initial translation of first two section in installation chapter.
Sandrine Ribeau <sandrine.ribeau@logilab.fr>
parents: 93
diff changeset
   178
* edit the file ``/etc/default/pyro-nsd`` so that the name server pyro
564
8b48724d4c2b some doc typos
Emile Anclin <emile.anclin@logilab.fr>
parents: 271
diff changeset
   179
  will be launched automatically when the machine fire up
93
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   180
9c919a47e140 [doc] total file reorganisation - phase 1 complete
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
diff changeset
   181