GestioIP is a free and open source web-based IP management system. It supports both IPv4 and IPv6 and provides a very powerful network discovery functions. It provides search and filter functions for both network and hosts. It includes the managements system for VLANs, Leases and Dialup networks along with full IP life cycles. it supports multiple clients with overlapping networks and provides an automatic update of the networks against DNS/OCS InventoryNG/via SNMP.
In this tutorial, we will install GestioIP IP management system on CentOS 7.
Requirements
GestioIP requires at least 2GB RAM, recommended is that you have 4GB RAM and Dual Core CPU. All the required dependencies will be installed throughout the tutorial. You will need a minimal installation of CentOS 7 with root access on it. If you are logged in as a non-root user, you can run sudo -i
to switch to root user.
Installing GestioIP
Before installing any package it is recommended that you update the packages and repository using the following command.
yum -y update
You will need to install EPEL repository as some required dependencies are not available in default YUM repository. Run the following command for same.
yum -y install epel-release
yum -y update
GestioIP requires a web server, MySQL database, and some SNMP packages, you can install the required packages using the following command.
yum -y install httpd mod_perl mariadb mariadb-server make gcc netsnmp net-snmp-utils wget checkpolicy policycoreutils-python
Once you install the above packages start Apache web server and enable it to start at boot time using the following command.
systemctl start httpd
systemctl enable httpd
To start MariaDB and enable it to start at boot time using the following commands.
systemctl start mariadb
systemctl enable mariadb
Now run the following commands to secure your MySQL or MariaDB installation.
mysql_secure_installation
It will run a small script which asks you to provide the root password for MariaDB. As we have just installed MariaDB, the root password is not set, just press enter to proceed further. It will ask you if you want to set a root password for your MariaDB installation, choose y
and set a strong password for the installation. It will also ask you for removing test databases and anonymous users. Most of the questions are self-explanatory and you should answer yes
or y
to all the questions.
Now download the latest version of GestioIP software using the following command.
cd /opt
wget https://excellmedia.dl.sourceforge.net/project/gestioip/gestioip_3.2.tar.gz
You can always check for the link to the latest version of GestioIP on their SourceForge repository.
Extract the archive using the following command.
tar zxvf gestioip_3.2.tar.gz
Now switch to the newly created directory and initiate the setup script provided by GestioIP software.
cd /opt/gestioip_3.2
./setup_gestioip.sh
The setup script will ask you few questions in order to install the software. The questions are provided below along with their recommended answers.
This script will install GestioIP 3.2 on this computer
Do you wish to continue [y]/n? y //Press y to start the installation
Where is Apache daemon binary [/sbin/httpd]? //Press Enter for default
Where is Apache main configuration file [/etc/httpd/conf/httpd.conf]? //Press Enter
Which user account is running Apache web server [apache]? //Press Enter
Which user group is running Apache web server [apache]? //Press Enter
Where is Apache Include configuration directory [/etc/httpd/conf.d/]? //Press Enter
Where is PERL Intrepreter binary [/bin/perl]? //Press Enter
Do you plan to import networks or hosts from spreadsheets [y]/n? y //Press y
Do you wish that Setup installs the missing Perl Modules now [y]/n? y //Press y
Is this ok [y/d/N]: y //Press y to install required Perl modules
Where is MAKE binary [/bin/make]? //Press Enter to proceed
Do you wish that Setup installs required MIBs now [y]/n? n //Press n
Which is the Apache DocumentRoot directory [/var/www/html]? //Press Enter
Where is htpasswd [/bin/htpasswd]? //Press Enter
Which should be the user to access to GestioIP [gipadmin]? admin //Choose your preferred username
Now you will need to open a new terminal and run the following command in it.
/bin/htpasswd -c /etc/httpd/users-gestioip admin
Replace admin
with your preferred username, it will ask you twice for the password. Once done press Enter on the terminal executing script. Furthermore, you will be asked following questions.
Under which directory should GestioIP's script files be installed [/usr/share/gestioip]? //Press Enter
Do you wish that Setup updates SELinux policy now [y]/n? y //Press y
On the successful execution of the script, you will be shown the following message.
+-------------------------------------------------------+
| |
| Installation of GestioIP successfully finished! |
| |
| Please, review /etc/httpd/conf.d/gestioip.conf
| to ensure all is good and |
| |
| RESTART Apache daemon! |
| |
| Then, point your browser to |
| |
| http://server/gestioip/install
| |
| to configure the database server. |
| Access with user "admin" and the
| the password which you created before |
| |
+-------------------------------------------------------+
Once the script has finished the execution, you will need to restart your web server. Run the following command for same.
systemctl restart httpd
You can now access the web-based interface for finalizing the installation of the software using the web based panel. Access the following URL using your favorite web browser.
http://Your-Server-IP/gestioip/install
You will see the following login prompt, enter the administrator username and password created earlier.
HP_NO_IMG/data/uploads/users/5bc5f3e0-17df-4257-afd4-59fc57ecae4e/354581539.png” alt=”” />
Once you are logged in, you will see following welcome screen. Click next to proceed further. In this interface, you will need to provide the database details for your server.
HP_NO_IMG/data/uploads/users/5bc5f3e0-17df-4257-afd4-59fc57ecae4e/794379308.png” alt=”” />
As we have both our Apache web server and MySQL server on both server hence we will put 127.0.0.1
on both web server and MySQL server address. Provide your MySQL root password and a new password for your new database. Click send to proceed further. If the connection is successful then you will see a success message.
Click next page to proceed further. You will now see the interface to configure sites and categories. If your IT structure is distributed over different sites, you can enter the identifiers for each site, you can also provide the categories of your network infrastructure. Further, you can also add additional host categories. Click Send once done. Finally, you will need to run the following command to remove the installation files.
rm -r /var/www/html/gestioip/install
Once done you will see the dashboard for your GestioIP as follows.
HP_NO_IMG/data/uploads/users/5bc5f3e0-17df-4257-afd4-59fc57ecae4e/1743394600.png” alt=”” />
Conclusion
In this tutorial, we have learned how to install GestioIP on CentOS 7. You can now successfully deploy the application and manage your network with ease.