source: trunk/INSTALL@ 422

$Id: INSTALL 419 2010-07-04 17:52:38Z kdeugau $

Installing the IPDB
===================

1) Untar in a convenient location.  Note that all URLs referenced internally currently assume they will be 
presented at http://host/ip/.

2) Edit cgi-bin/MyIPDB.pm:  you need to set the database DSN and company info.  You 
should probably also set the syslog facility and default custid.

3) Edit cgi-bin/CustIDCK.pm as needed to validate customer IDs.

4) Create the database, and the inital tables using cgi-bin/ipdb.psql.

5) User lists can be maintained two basic ways:

  a) Use the built-in user manager to add and remove users.  This requires mod_auth_pgsql, configured 
with read/write access to the IPDB users table.  A default user admin, password admin, is created in step 4 above 
- make sure to create a new user as an admin, and remove the default user.

  b) Maintain an external .htpasswd file of your own, configured however you like.  In this case the 
access-pwd-update.pl script should edited to match the .htpasswd filename/path and should be called from cron to 
make sure new users get added to the database, and old ones get deleted.  This extra maintenance of user lists is 
necessary to support the access controls, which are stored in the database.

You will have to either temporarily create a user "admin", so that user can grant other users priviledges, or run 
the following on the database:

UPDATE users SET acl='bacdsA' WHERE username='newadminuser';

Replace 'newadminuser' as appropriate.

If you don't do this, nobody will be able to make any changes;  access-pwd-update.pl only grants read access.


Basic installation should now be complete!  Add your ARIN, RIPE, LACNIC, AfriNIC, or APNIC allocations and start 
documenting your netblock usage.

If you want to export rWHOIS data, see http://www.unixadmin.cc/rwhois/ for a place to start on setting up an 
rWHOIS server.  Note that db2rwhois.pl creates and maintains the net-<cidr> trees, all you have to do is 
configure the daemon itself.  Schedule runs of cgi-bin/extras/db2rwhois.pl followed by rwhois_indexer.  You'll 
need to fill in correct organization contact info in MyIPDB.pm.