[open-ils-commits] [GIT] Evergreen ILS branch rel_2_5 updated. b080b36bfbbf8e93779cec663cfb31c4b05fa97d

[Evergreen Git]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".

The branch, rel_2_5 has been updated
       via  b080b36bfbbf8e93779cec663cfb31c4b05fa97d (commit)
      from  cb39d6eeef313d9a68a4ffddbd255e05ecc01594 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit b080b36bfbbf8e93779cec663cfb31c4b05fa97d
Author: Dan Scott <dscott at laurentian.ca>
Date:   Sun Jan 19 13:52:20 2014 -0500

    More explicit database configuration instructions
    
    These README tweaks should help new folk install Evergreen with
    a few less hurdles.
    
    Signed-off-by: Dan Scott <dscott at laurentian.ca>

diff --git a/docs/installation/server_installation.txt b/docs/installation/server_installation.txt
index 708f909..c46b044 100644
--- a/docs/installation/server_installation.txt
+++ b/docs/installation/server_installation.txt
@@ -314,12 +314,15 @@ connection information in `opensrf.xml` for you.
 Creating the Evergreen database
 -------------------------------
 
-By default, the `Makefile.install` prerequisite installer does not install
-the PostgreSQL 9 database server required by every Evergreen system;
-for production use, most libraries install the PostgreSQL database server on a
-dedicated machine. You can install the packages required by Debian or Ubuntu Lucid
-on the machine of your choice using the following commands as the *root*
-Linux account:
+Setting up the PostgreSQL server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For production use, most libraries install the PostgreSQL database server on a
+dedicated machine. Therefore, by default, the `Makefile.install` prerequisite
+installer does *not* install the PostgreSQL 9 database server that is required
+by every Evergreen system. You can install the packages required by Debian or
+Ubuntu Lucid on the machine of your choice using the following commands as the
+*root* Linux account:
 
 .(Debian / Ubuntu / Fedora) Installing PostgreSQL server packages
 
@@ -339,11 +342,13 @@ make -f Open-ILS/src/extras/Makefile.install postgres-server-fedora
 
 .(Fedora) Postgres initialization
 
-Installing Postgres on Fedora requires one additional step.
+Installing Postgres on Fedora also requires you to initialize the PostgreSQL
+cluster and start the service. Issue the following commands as the *root* user:
 
 [source, bash]
 ------------------------------------------------------------------------------
 postgresql-setup initdb
+systemctl start postgresql
 ------------------------------------------------------------------------------
 
 For a standalone PostgreSQL server, install the following Perl modules as the
@@ -380,6 +385,31 @@ password:
 createuser -s -P evergreen
 ------------------------------------------------------------------------------
 
+.Enabling connections to the PostgreSQL database
+
+Your PostgreSQL database may be configured by default to prevent connections,
+for example, it might reject attempts to connect via TCP/IP or from other
+servers. To enable TCP/IP connections from localhost, check your `pg_hba.conf`
+file, found in the `/etc/postgresql/` directory on Debian and Ubuntu, and in
+the `/var/lib/pgsql/data/` directory on Fedora. A simple way to enable TCP/IP
+connections from localhost to all databases with password authentication, which
+would be suitable for a test install of Evergreen on a single server, is to
+ensure the file contains the following entries _before_ any "host ... ident"
+entries:
+
+------------------------------------------------------------------------------
+host    all             all             ::1/128                 md5
+host    all             all             127.0.0.1/32            md5
+------------------------------------------------------------------------------
+
+When you change the `pg_hba.conf` file, you will need to reload PostgreSQL to
+make the changes take effect.  For more information on configuring connectivity
+to PostgreSQL, see
+http://www.postgresql.org/docs/devel/static/auth-pg-hba-conf.html
+
+Creating the Evergreen database and schema
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Once you have created the *evergreen* PostgreSQL account, you also need to
 create the database and schema, and configure your configuration files to point
 at the database server. Issue the following command as the *root* Linux account

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

Summary of changes:
 docs/installation/server_installation.txt |   44 ++++++++++++++++++++++++----
 1 files changed, 37 insertions(+), 7 deletions(-)


hooks/post-receive
-- 
Evergreen ILS