Basic Installation
==================

Typically,

  ./configure
  make
  make install

should work if everything is in place.

For testing

  make check

can be used. Before starting tests, be sure to have a running dbupdate.

Running
=======

* Check the "syncupdates.conf" file, and edit options to suit your
  installation.

* Start the backend by "sup_backend -f <path_to_syncupdates.conf>"
* Optionally, start the process monitor by "sup_watch"
* In order to configure webupdates, edit the configurable options in
  the "Webupdates.pm" file. Typically you should edit these variables:

  $IMGURL        where icons are located
  $HTMLURL       where *.html from this distribution are located
  $COPYRIGHTURL  A link to the copyright notice for your database
  @SYNCUPDATES   List of databases that can be updated via the web
                 interface. For each database, the following should be
                 defined:

                 url         URL for sup_frontend, syncupdates frontend
                 whoishost   whois query host
                 whoisport   whois query port
                 source      name of the source
                 caption     a distinctive name for the database, should be
                             unique
                 queryurl    link to the whois query web interface

  $FORMACTION variable is safe to leave empty in almost all installations.
  If you experience problems with Netscape 4 or lower, set this to the
  URI of "webupdates.pl".

Requirements
============

* C Compiler                  http://www.gnu.org/software/gcc/
* glib >= 1.2.0               http://www.gtk.org/
* cgi-util >= 2.1.4           http://www.newbreedsoftware.com/cgi-util/
* dbupdate                    ftp://ftp.ripe.net/ripe/dbase/software/
* Apache Web Server           http://httpd.apache.org/
  (Any other web server will do, but it's what we use)
* perl >= 5.6.0               http://www.cpan.org/src/
* Perl Modules, that can be installed from CPAN, by the command 'perl
  -MCPAN  -e 'install <module>'' if it doesn't already exist:
       Mail::Mailer
       LWP::Simple
       LWP::UserAgent
       HTTP::Request::Common
       Cache::FileCache
       Crypt::Simple
       IO::Socket::INET
       Getopt::Std
       CGI::Application
* RPSL-OL           ftp://ftp.ripe.net/ripe/dbase/software/RPSL-OL-3.1.1.tar.gz
* Net::Whois::RIPE::RPSL can also be found in the RPSL-OL distribution, under
  perl subdirectory.

Configure Options
=================

Apart from configure, CFLAGS, CPPFLAGS and PATH environment variables
may need changing.

--with-cgidir=<PREFIX/cgi-bin>

  The place where cgi scripts (and the configuration file) will be placed.

--with-cgiurl=<http://localhost/cgi-bin/sup_frontend>

  How sup_frontend is seen by the rest of the world.

--with-ripconf=<sysconfdir/rip.config>

  Default rip.config to use.

--with-user=<dbase>

  The user that will run the system. It is used during monitoring.

--with-alertaddr=<dbase>

  The email address to send alerts to
