[tryton-debian-vcs] tryton-server branch debian updated. debian/3.2.0-1-3-g2a0dafe

[Mathias Behrle]

The following commit has been merged in the debian branch:
https://alioth.debian.org/plugins/scmgit/cgi-bin/gitweb.cgi/?p=tryton/tryton-server.git;a=commitdiff;h=debian/3.2.0-1-3-g2a0dafe

commit 2a0dafef2596fee690ae338c8319271251432219
Author: Mathias Behrle <mathiasb at m9s.biz>
Date:   Tue Jun 10 16:56:31 2014 +0200

    Improving setup directions in README.

diff --git a/debian/tryton-server.README.Debian b/debian/tryton-server.README.Debian
index d2130ce..d94a010 100644
--- a/debian/tryton-server.README.Debian
+++ b/debian/tryton-server.README.Debian
@@ -17,8 +17,11 @@ achieve this (you need to execute all commands as root):
 
     # /etc/init.d/postgresql* restart
 
-    Note: Make sure you have setup database password authentication. Please
-    refer to the PostgreSQL manual how to do this.
+    Note: If PostgreSQL runs on another machine than the Tryton server, make sure
+    you have setup database password authentication. Please refer to the
+    PostgreSQL manual how to do this. If they run on the same machine, connection
+    via local sockets is preferred and you are done with the default configuration
+    of the PostgreSQL package.
 
   * Creating the database user:
 
@@ -32,26 +35,53 @@ achieve this (you need to execute all commands as root):
     * and finally enter the password of the postgres superuser.
 
     Note: If you want to run the database as another user than 'tryton', you
-    need to replace 'tryton' above with the user you want to use instead, and
-    you need to adjust in the same way 'db_user = tryton' in /etc/trytond.conf.
+    need to replace 'tryton' above with the user you want to use instead.
+    You need to adjust in the same way 'db_user = tryton' in /etc/trytond.conf.
 
 Preparing the Tryton server
-----------------------------
+---------------------------
 
   * Setting up the Tryton server (trytond):
 
     Adjust /etc/trytond.conf to reflect the setup of your system and use the
     database user and password from step 1 for db_user and db_password.
 
-    Also edit db_host and db_port to point to your PostgreSQL database server,
-    if not running on localhost and/or on non standard port (5432).
+    In case, that the PostgreSQL database runs on another machine (i.e. not
+    localhost), also edit db_host and db_port to point to your PostgreSQL
+    database server.
+
+  * If the Tryton server shall listen on some external interface (i.e. be
+    available for clients connecting from other machines), change the jsonrpc
+    protocol to listen accordingly.
+
+    Examples (listening on alll interfaces):
+      jsonrpc = 0.0.0.0:8000 (for IPv4)
+      jsonrpc = *:8000 (for IPv6)
+      jsonrpc = 0.0.0.0:8000,*:8000 (for both)
+
+  * If the Tryton server is listening on external interfaces, it is highly
+    recommended to enable SSL for the connection:
+      ssl_jsonrpc = True
+
+    Note: The package is prepared to use the snakeoil certfifcates from
+    the ssl-cert package. If you are installing the ssl-cert package after
+    the tryton-server package, take care to add the tryton user to the
+    ssl-cert group.
+
+    # adduser tryton ssl-cert
 
   * Restarting trytond:
 
     # /etc/init.d/tryton-server restart
 
-Note: The following steps (4-5) can also be performed easily from the Tryton
-Client and are not mandatory to be done here.
+Now you are ready to connect with a client, e.g. tryton-client.
+
+
+Creating the database
+---------------------
+
+Note: The following steps can also be performed easily from the Tryton
+Client and are not mandatory to be done on the command line.
 
   * Creating the database:
 
@@ -64,9 +94,11 @@ Client and are not mandatory to be done here.
 
     # /usr/bin/trytond -i all -d tryton
 
-    Note: Use the database name you chose in step 4 (here as default: tryton).
+    Note: Use the database name you chose in the previous step (here as default: tryton).
     You will be asked for the admin password for this database.
 
+As result you will have a bare Tryton database with the base modules installed.
+
 Upgrade
 -------
 
@@ -120,4 +152,4 @@ Now, you're finished. Please be aware of the following things:
 
   * Only the same major version of Tryton client and Tryton server can connect.
 
- -- Mathias Behrle <mathiasb at m9s.biz>  Wed, 12 Mar 2014 16:45:00 +0100
+ -- Mathias Behrle <mathiasb at m9s.biz>  Tue, 10 Jun 2014 16:45:00 +0200
-- 
tryton-server