Installation GestioIP 2.1 
=========================

GestioIP is an web based IP network and IP address
management tool. See the README file for more details.


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

Apache2 with mod_perl, Mysql5.x, Perl


Installation Instructions for openSUSE 11 
========================================

The installation of GestioIP consists of two parts.
A command line part to install the required perl modules
and to configure the apache web server and a web-based
part to create and configure the mysql database.


-------------------------------------------
*** Installation of required packages ***
-------------------------------------------

Make sure that the following packages are installed
(all available from the openSUSE repository)

   apache2
   apache2-mod_perl
   make
   Perl-DBD-mysql
   perl-DBI
   Perl-Net-IP
   perl-libwww-perl


To install all packets needed by GestioIP execute the
following command:

$ sudo zypper install apache2 apache2-mod_perl make Perl-DBD-mysql perl-DBI Perl-Net-IP perl-libwww-perl


Download and install the perl modules which are not availabel from
the openSUSE repository

$ wget http://search.cpan.org/CPAN/authors/id/D/DL/DLUX/Parallel-ForkManager-0.7.5.tar.gz
$ wget http://search.cpan.org/CPAN/authors/id/C/CH/CHORNY/Net-Ping-External-0.13.zip

Untar/unzip and install the modules

$ tar vzxf module.tar.gz/unzip module.zip
$ cd module
$ perl Makefile.pl
$ make
$ sudo make install


-------------------
*** Preparation ***
-------------------

(1) Download the latest version of GestioIP from
    http://www.gestioip.net

(2) Untar the file gestioip_2.1.x.tar.gz and change to the
    new folder gestioip_2.1.x:

$ tar vzxf gestioip_2.1.x.tar.gz
$ cd gestioip_2.1.x


(3) Move the folder "gestioip" to the DocumentRoot of your
    apache webserver (/srv/www) and change the rights
    to 777 (only for the installation):

$ sudo mv gestioip /srv/www/
$ sudo chmod -R 777 /srv/www/gestioip


-----------------------------
*** Configuration apache2 ***
-----------------------------

(4) Create two users (one with ro and one with rw access): 

$ sudo htpasswd2 -c /etc/apache2/users-gestioip gipoper
(-c to create the file users-gestioip)
$ sudo htpasswd2 /etc/apache2/users-gestioip gipadmin


Create a VirtualHost:

(5) Open the the VirtualHost configuration file of apache2
   ./apache22/gestioip.suse with your favorite editor and change
    the attribute "ServerName" to your domain:

      ServerName gestioip.your-domain.org


(6) Copy the customized file ./apache22/gestioip.suse to the
    virtual host configuration directory of your apache2:

$ sudo cp apache22/gestioip.suse /etc/apache2/conf.d/gestioip.conf



(7) Restart the apache web server

$ sudo /usr/sbin/apache2ctl restart

   +++ Note:
   if the apache web server doesn't come up take a look at the
   error-log (/var/log/apache/error_log)


(8) Create a DNS record for the VirtualHost (gestioip.your-domain.org)

   +++ Note:
   If you don't want to create a DNS record yet: An entry in the
   /etc/hosts file of your workstation will work for test usage, too.
   (or C:\windows\system32\drivers\etc\hosts if you use windows)

   1.2.3.4	gestioip.your-domain.org	gestioip

   (replace the 1.2.3.4 with the IP of your apache webserver)


(9) Access with the (rw) username/password which you created before
    (e.g. gipadmin) to the web-based installation of GestioIP

      http://gestioip.your-domain.org/install

    and follow the instructions to terminate the installation




====================================================
GestioIP Copyright (C) 2009 Marc Uebel <contact@gestioip.net>