From: Dan Scott <dan@coffeecode.net>
Date: Thu, 21 Jul 2011 21:39:49 +0000 (-0400)
Subject: Update the README to include database installation instructions
X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=ca7a1aed54396f03e71f9c2a56bc5dcd154213a4;p=evergreen%2Fequinox.git

Update the README to include database installation instructions

A long time ago, the database server was installed by default.
Nowadays, installing the database server is a separate step
reserved for whatever machine you want to devote to PostgreSQL.
Not that you can't put it on the same machine as the rest of
Evergreen and OpenSRF...

Signed-off-by: Dan Scott <dscott@laurentian.ca>
Signed-off-by: Thomas Berezansky <tsbere@mvlc.org>
---

diff --git a/README b/README
index da9399530f..a8d110dcd7 100644
--- a/README
+++ b/README
@@ -9,7 +9,7 @@ before you can successfully configure, compile, and install Evergreen.
 
 1. Begin by installing the most recent version of OpenSRF (2.0 or later).
    You can download OpenSRF releases from http://evergreen-ils.org/downloads
-2. On many distributions, it is necessary to install Postgres 9 from external
+2. On many distributions, it is necessary to install PostgreSQL 9 from external
    repositories.
 +
   * On Debian Squeeze, add the following line to `/etc/apt/sources.list`:
@@ -77,10 +77,8 @@ command as the root user to install Evergreen:
 make STAFF_CLIENT_STAMP_ID=rel_2_1 install
 ------------------------------------------------------------------------------
 
-This will install Evergreen, including example configuration files in
+This command installs Evergreen, including example configuration files in
 `/openils/conf/` that you can use as templates for your own configuration files.
-The `STAFF_CLIENT_STAMP_ID` variable stamps the server-side and client-side files
-for the staff client to ensure that they match.
 
 Create the oils_web.xml configuration file:
 -------------------------------------------
@@ -136,12 +134,25 @@ connection information in `opensrf.xml` for you.
 Creating the Evergreen database:
 --------------------------------
 
-PostgreSQL 9.0 will be installed on your system by the `Makefile.install`
-prerequisite installer if packages are available for your distribution, or
-you will have to compile PostgreSQL 9.0 from source and install it (which
-is beyond the scope of this document).
+By default, the `Makefile.install` prerequisite installer does not install
+the PostgreSQL 9.0 database server required by every Evergreen system;
+most libraries install the PostgreSQL database server on a dedicated
+machine. You can install the packages required by Debian, Ubuntu, or Fedora
+using the following commands:
 
-Once the PostgreSQL database server has been installed, you will need to
+.Installing PostgreSQL 9.0 server packages on Debian and Ubuntu
+[source, bash]
+------------------------------------------------------------------------------
+make -f Open-ILS/src/extras/Makefile.install install_pgsql_server_debs_90
+------------------------------------------------------------------------------
+
+.Installing PostgreSQL 9.0 server packages on Fedora
+[source, bash]
+------------------------------------------------------------------------------
+make -f Open-ILS/src/extras/Makefile.install install_fedora_pgsql_server
+------------------------------------------------------------------------------
+
+Once the PostgreSQL database server has been installed, you must
 create the database and add the appropriate languages and extensions to
 support Evergreen. Issue the following commands as the `postgres` user to set
 up a database called `evergreen`. Note that the location of the PostgreSQL