                                                           
       IPAC-NG Version 1.12
       (c) 1997 - 2000 Moritz Both                        
       (c) 2001 Al Zaharov                                
       For copyright notice see at the bottom of this file

    Did you read original README file? You have to. This file consist of
  step-by-step instructions how to enable and use new possibilities of ipac-ng.
  Reading docs from postgresql, apache and maybe some other packets is
  mandatory for succesfull start working with ipac-ng.
    
    WARNING!!! new features that are described here were tested to work
	with 2.4.x kernels only.

    0) Most of your questions about compilation setting up and startup will
	be defeat with reading all textual files in this packet (sources are 
	not mandatory to read)
    1) First of all: "./configure --enable-classic=no".
	Choose method of log saving suitable for you:
	    - palin-file - old method logs are saved in many files;
			    not recommended; there are possibilities that this
			    method will be removed in future releases;
	    - gdbm - this one is using gdbm database (used by default);
	    - postgre - using postgresql, recommended for large/huge databases.
    2) Create user "root" in postgresql, you may do it as follows:
	"createuser root". Must run from user which may create new postgresql
	users, for e.g. postgres.
    3) Create users access base with "createdb ipac". Where "ipac" is the name 
	of the database to create and it is fixed = cannot be changed for now.
    4) Create the database skeleton containing example data with 
    	"pg_restore -d ipac ipac-ng.sql". If you need no example data add "-s" 
	option. Also you may try "pg_restore -F c -d ipac-ng.sq" or 
	"psql ipac <ipac-ng.sql".
    5) Compile the packet with "make". For succesfull making you have to 
	install postgresql-devel, glibc-devel and gdbm-devel packets. Kernel
	headers will also help.
    6) If step 5 is succesfull install with "make install" and proceed, 
	repeat steps 0 and 5 otherwise.
    7) Create /var/www/http.passwd file.
    8) Copy contents of html directory to your DocumentRoot.
    9) Find "AllowOverride None" directive in your http server's config that 
	belongs to /cgi-bin/ and replace None with AuthConfig.
    10) Add to your http.passwd file user "admin". You may do so by issuing
	"htpasswd http.passwd admin".
    11) Make your web server to be able give away documents via ssl.
    12) Add this to your web server's config:
	    <Directory "< DocumentRoot>/stat">              
	        RewriteEngine       on                    
	        RewriteCond %{HTTPS} !=on                 
		RewriteRule ^/.*    - [F]                 
		AuthType            Basic                 
		AuthName            "Statistics server"   
		AuthUserFile        /var/www/http.passwd  
		Require             valid-user            
	    </Directory>                                  
    13) Restart your http server.
    14) Point your lovely browser to https://<your server>/stat,
	follow the links.
    15) Want to understand how does it work? Then change something with 
	www frontend and do "fetchipac -R". Repeat.
    16) Want to allow your users to browse their statistics? Add them to your
	http.passwd. Also there are some adjustable parameters inside of 
	traffic script. You may adjust them as you want.
    17) Initial startup of data gathering - "fetchipac -S".
    18) To allow user to access network do: "fetchipac -L <user's login>".
    19) Disallowing done if there is no more bucks at user's account or if
	"fetchipac -O <user's login>" command was issued.
    20) Then you have to write a {hate,love,bug,etc}letter to 
	kaiser13@mail2000.ru.


COPYRIGHT

  Copyright (C) 1997 - 2000 Moritz Both
                2001 Al Zaharov
 
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.
 
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
 
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
  The author can be reached via email: moritz@daneben.de, or by
  snail mail: Moritz Both, Im Moore 26, 30167 Hannover,
              Germany. Phone: +49-511-1610129

  Al Zaharov can be reached via: kaiser13@mail2000.ru or by 
	phone +7-382-2550319
