Quick install:
-------------

NOTE: if upgrading, read the UPGRADE file. YOU MUST BE RUNNING POSTGRESQL v7.3 
	OR HIGHER TO PERFORM AN UPGRADE.
NOTE2: if you get a fatal error about an undefined database function, read
       the FAQ section in the README

I assume a working installation of PostgreSQL 7.1 or higher for a new 
installation, and php 4.1 or higher should work. 
To get multilingual support (languages other than English), you will need 
to follow the steps later in this document.

In your web tree (normally /home/httpd/html or /var/www/html), 

1) create a directory called ipplan
2) untar tar-ball into this directory
3) change the directory ownership and permissions of the ipplan directory
   chown -R root.nobody ipplan
   chmod -R 750 ipplan

   this is operating system dependent - the above line is for a Redhat 6.2
   based system. Have a look at the rest of your web tree for the correct
   settings for your system.

   For Redhat 7.x systems use:

   chown -R root.apache ipplan
   chmod -R 750 ipplan

   It is important to set the correct permissions to prevent people from
   seeing your passwords stored in config.php

4) create the database and tables by issuing the following at the
   command prompt as the postgres user (su - postgres):

   createuser -P ipplan
      Enter password for user "ipplan": 
      Enter it again: 
      Shall the new user be allowed to create databases? (y/n) n
      Shall the new user be allowed to create more new users? (y/n) n

   createdb -O ipplan ipplan

   Make sure that the ipplan user is allowed to connect to the ipplan
   database from another user by modifying the pg_hba.conf file if
   required. This file is probably in /var/lib/pgsql/data on a Redhat
   system.

   You will also need to modify postgresql.conf in the same directory
   and allow tcpip_socket connections to port 5432.

   ONLY DO THIS STEP ONCE FOR A NEW INSTALLATION
5) modify the user and password info in the config.php script.
   additional settings can be changed in the config.php script at this
   stage too. See the README for more information.

   be sure to enable transaction support in config.php

6) open a web browser and point it to the installation script in the
   admin directory (http://mywebserver.com/ipplan/admin/install.php)

   you will be prompted to create the database schema. The user created
   above does not have enough rights to create tables so you will need
   to either copy the statements into the database, or temporarily change
   the database password in the config.php file to a database user that has
   enough rights to do this.

   you can manually load the statements by copying the display output
   from the install.php script into a file (example ipplandbf-POSTGRESQL.sql)
   and then executing the file by logining in as the newly created user using
   psql and issue:

   psql ipplan ipplan -f ipplandbf-POSTGRESQL.sql

7) now point your web browser to the main IPplan web page
   (http://mywebserver.com/ipplan), select the admin drop down menu and add 
   customers, groups and users using the admin user defined in the config.php
   file - you MUST create at least one regular user, one group and one customer

8) send me an e-mail about how you use IPplan!

Enabling multilingual support:
-----------------------------

To get multilingual support working, php must be compiled with GNU gettext
support enabled. This is NOT enabled by default. gettext is normally 
installed on all Linux distributions, but may not be available on other
UNIX variants. So if you are not using Linux, download and install gettext
from http://www.gnu.org/software/gettext before installing php. Once gettext
is installed, you will need to recompile php with gettext support enabled.
To do this, follow the instructions for installing php from http://www.php.net,
but make sure you add

	--with-gettext

to the ./configure line. To check if gettext is enabled in php, execute this
simple php script:

<?php
phpinfo();
?>

If you change the language on the IPplan settings page and no change occurs,
try turning on debugging in config.php. This will return an error if the
language change resulted in an error. If an error occurs, try checking the
output of the "locale -a" command on the IPplan webserer to see if the required 
language is installed.

If gettext is installed and you are still having trouble, try changing the
$iso_codes values in /ipplan/config.php to match the values of the
locale -a output for your system. These values differ depending on the
distribution.

If your language is not currently available, feel free to follow the 
instructions in the TRANSLATIONS file and do your own.

Hope it works!
ipplan@gmail.com
