From 5b6dc1a05210e71ceda3e1ca691012baadbc23e7 Mon Sep 17 00:00:00 2001 From: Andrew McMillan Date: Sun, 14 Mar 2010 00:21:00 +1300 Subject: [PATCH] Update installation docs. --- docs/website/installation.php | 85 ++++++++++++++++++----------------- 1 file changed, 45 insertions(+), 40 deletions(-) diff --git a/docs/website/installation.php b/docs/website/installation.php index 045e5881..30d9e73b 100644 --- a/docs/website/installation.php +++ b/docs/website/installation.php @@ -103,6 +103,48 @@ order to shorten the path.

Database Setup

+

Connecting to the Database

+ +

Before your database has been created, you should edit your pg_hba.conf +file (in /etc/postgresql/8.x/main/pg_hba.conf on Debian or derivatives) in +order to grant access to the database for the 'davical_dba' user that will +be created to 'own' the database and tables, and also for the 'davical_app' +user which will be created for the web application fo connect as.

+ +

In a simple installation, where you do not have untrusted +users on your database server, and your database is on the same +computer as the web server, the following lines (at the very top +of the pg_hba.conf file) should be enough:

+ +
+local   davical    davical_app   trust
+local   davical    davical_dba   trust
+
+ +

This means that anyone on the local computer (including the +web application) will have rights to connect to the DAViCal +database as the 'davical_app' or 'davical_dba' user. It will not allow remote access, +or access as any user other than 'davical_app' or 'davical_dba'.

+ +

If you want to connect to the database over TCP/IP from your webserver +on '192.168.59.231' (e.g. rather than unix sockets which will only work for +access from the local machine), the lines in the pg_hba.conf file should look +something like:

+ +
+host davical davical_app 192.168.59.231/32 trust
+host davical davical_dba 192.168.59.231/32 trust
+
+ +

If you want greater security, or if you want to have the +database on a different server, you should read the +PostgreSQL documentation on pg_hba.conf +for the version you are using.

+ +

Once you have changed the pg_hba.conf file you will need to +reload or restart the PostgreSQL process for the change to come +into effect.

+

Creating and Building the Database

To create the database itself, run the script:

@@ -120,46 +162,6 @@ may need to do this as the "postgres" user, for example:

su postgres -c /usr/share/davical/dba/create-database.sh -

Connecting to the Database

- -

Once your database has been created, you may also need to -edit your pg_hba.conf file in order to grant the application -access to the database as the 'davical_app' user.

- -

In a simple installation, where you do not have untrusted -users on your database server, and your database is on the same -computer as the web server, the following line (near the top -of the pg_hba.conf file) should be enough:

- -
-local   davical    davical_app   trust
-
- -

This means that anyone on the local computer (including the -web application) will have rights to connect to the DAViCal -database as the 'davical_app' or 'davical_dba' user. It will not allow remote access, -or access as any user other than 'davical_app' or 'davical_dba'.

- -

If you want to connect to the database over TCP/IP rather than -unix sockets, the line in the pg_hba.conf file should look something -like:

- -
-host davical davical_app 127.0.0.1/32 trust
-
- -

If the webserver is on a different machine to the database, that -IP address will need to change to the webserver's IP address.

- -

If you want greater security, or if you want to have the -database on a different server, you should read the -PostgreSQL documentation on pg_hba.conf -for the version you are using.

- -

Once you have changed the pg_hba.conf file you will need to -reload or restart the PostgreSQL process for the change to come -into effect.

-

Apache Configuration

Relative to an existing DocumentRoot

@@ -268,6 +270,9 @@ configuration to one of the supported locales.

  • Polish / Polski
  • Hungarian / Magyar
  • Japanese / 日本語
    • +
  • Italian / Italiano
    • +
  • Swedish / Svenska
    • +

    If you want locale support you probably know more about configuring it than me, but