[doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
authorSandrine Ribeau <sandrine.ribeau@logilab.fr>
Mon, 30 Mar 2009 19:38:25 -0700
changeset 1193 24486ce4dea1
parent 1192 82375c14eb26
child 1194 e224f064a268
child 1201 ef2715330b92
[doc] Improve a little bit postgres configuration and environment variables set-up. Needs to be finalized.
doc/book/en/B0011-schema-stdlib.en.txt
doc/book/en/C011-installation.en.txt
doc/book/en/C012-create-instance.en.txt
--- a/doc/book/en/B0011-schema-stdlib.en.txt	Mon Mar 30 12:50:01 2009 -0700
+++ b/doc/book/en/B0011-schema-stdlib.en.txt	Mon Mar 30 19:38:25 2009 -0700
@@ -34,8 +34,8 @@
 (The first 'E' in some of the names is the first letter of 'Erudi', 
 `CubicWeb`'s old name; it might be changed/removed some day.)
 
-  Cubes available
-  ```````````````
+Cubes available
+```````````````
 
 An application is based on several basic cubes. In the set of available
 basic cubes we can find for example :
--- a/doc/book/en/C011-installation.en.txt	Mon Mar 30 12:50:01 2009 -0700
+++ b/doc/book/en/C011-installation.en.txt	Mon Mar 30 19:38:25 2009 -0700
@@ -109,6 +109,11 @@
 Postgres configuration
 ----------------------
 
+.. note::
+    If you already have an existing cluster and postgres server
+    running you do not require to execute the initilization step
+    of your Postgres database.
+
 * First you have to initialize the database Postgres with the command ``initdb``.
   ::
 
@@ -125,15 +130,26 @@
  
     $ chown username /path/to/pgsql
 
-* Create a superuser for `CubicWeb` instance (**root**) ::
-
-    createuser -s username
+* Create a superuser for `CubicWeb` instance: ::
+    
+    $ su
+    $ su - postgres
+    $ createuser -s username
 
-  Initialize the password of the superuser you just created with 
-  ``su - postgres`` and ``psql``.
+  Initialize the password of the superuser you just created for your
+  database: ::
+    
+    $ su 
+    $ su - postgres
+    $ psql
 
-  This password will be asked to you later on where you will create an
-  instance with `cubicweb-ctl create`
+  And then execute de following query: ::
+    
+    ALTER USER username WITH PASSWORD `password`
+
+  This login/password will be requested when you will create an
+  instance with `cubicweb-ctl create` to initialize the database of
+  your application.
 
 .. [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.
 
--- a/doc/book/en/C012-create-instance.en.txt	Mon Mar 30 12:50:01 2009 -0700
+++ b/doc/book/en/C012-create-instance.en.txt	Mon Mar 30 19:38:25 2009 -0700
@@ -62,6 +62,13 @@
 at the time the base is created (import_erschema('MyCube') will
 not properly work otherwise).
 
+.. note::
+    Please note that if you do not wish to use default directory
+    for your cubes library, then you want to use the option
+    --directory to specify where you would like to place
+    the source code of your cube:
+    ``cubicweb-ctl newcube --directory=/path/to/cubes/library cube_name``
+
 Instance creation
 -----------------