In this tutorial we will learn How to Install IPAM tool GestioIP on Linux using the yum/dnf package manager as well as docker compose deployment
Introduction
GestioIP is a automated, web based IPv4/IPv6 address management (IPAM) software. It features powerful network discovery and IP tracking functions and offers search and filter functions for both networks and host, permitting Internet Search Engine equivalent expressions. This lets you find the information that administrators frequently need easily and quickly. GestioIP IPAM is free software.
Features
- Simple to use and well-organized data display
- Strong fast search for the network and host that is easily accessed from any page, allowing expressions similar to those used in Internet search engines, such as “exact match” or -string_to_ignore.
- Ability to handle address ranges for various clients separately
- A built-in VLAN administration mechanism
- An integrated dial-up and rental line management system
- An integrated control scheme for self-governing systems
- SNMP for network and VLAN discovery
- DNS zone file generator for forward and reverse zones (supporting BIND and tinydns zone files) and host detection via SNMP
- displays the host’s status.
- Check with just one click if an IP address responds to ping requests and whether
- displays available network ranges
- Online subnet calculator: integrated subnet calculator
- A hierarchical IPv6 addressing plan builder that is integrated
- Adaptable columns for hosts and networks
- IP ranges reserved for certain uses (like DHCP)
- Web form to quickly switch from GestióIP IPAM to spreadsheet-based IP address management (.xls – MS Excel)
- SNMP-capable devices can import networks via a web form.
- a web form to host or export networks to CSV files
- Integration of GSS-TSIG secure dynamic DNS updates with Microsoft DNS and Bind DNS server
- SNMP-based automatic network updating
- Networks are automatically updated against DNS
- Networks are automatically updated against OCS Inventory NG Statistics
- Completely auditable
- Simple installation using a script
- thoroughly recorded
- Portuguese, Catalan, Chinese (traditional and modern), Dutch, English, French, German, Italian, and Russian are among the many languages spoken there.
- total support for IPv4 and IPv6
Requirements
Host Operating System : Any one of the Linux distributions is supported: Debian, Ubuntu, Fedora, Redhat, CentOS, SuSE. We are using Redhat based OS Rocky Linux 8
Software: Apache2 with mod_perl, Mysql or MariaDB
Hardware (min): DualCore CPU 2GHz, RAM: 2GB (recommended: 4GB)
The Host must be able to connect to the Internet. Please check for Proxy if you are behind any corporate network.
Installation using Package Manager
Firewall Adaption to the Host
$ sudo firewall-cmd --zone=public --add-port=80/tcp
Create MariaDB root password
$ sudo systemctl start mariadb.service
$ sudo mysql_secure_installation
Enable EPEL RPM repository
$ sudo yum install epel-release
Script based installation
Download the script
$ wget http://sourceforge.net/projects/gestioip/files/gestioip_3.5.tar.gz
Untar the file gestioip_3.5.tar.gz
$ tar vzxf gestioip_3.5.tar.gz
Move inside the new directory
$ cd gestioip_3.5
Execute the script now
$ sudo ./setup_gestioip.sh
Now you can follow the instruction as prompted by the script towards its completion. A log file would be created with a name date_setup.log in the same folder where the script is located.
Once the script is completed successfully you can restart the HTTP service
$ sudo service httpd restart
You should be able to access the We based database configuration at http://server_ip/gestioip/install
Installation using docker-compose
Clone the repo or download & unzip the zip file
$ git clone https://github.com/muebel/gestioip-docker-compose
OR
$ wget https://github.com/muebel/gestioip-docker-compose/archive/main.zip
$ unzip main.zip
$ mv gestioip-docker-compose-main gestioip-docker-compose
Move to the new Directory
$ cd gestioip-docker-compose
Change the .env file followed by deploying using docker-compose
$ docker-compose up -d
Expected Result
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
89a10df7ffb5 gestioip/gestioip:3555 "/gestioip_install/s…" 1 hours ago Up 1 hours 0.0.0.0:8080->80/tcp gip
0d5efdg2dfb9 mysql:5 "docker-entrypoint.s…" 1 hours ago Up 1 hours 3306/tcp, 33060/tcp gip-mysql
Now you can access to the Gestioip Installation at
http://IP_DOCKER_HOST
Make use of the of the below default credentials
Username: gipadmin
Password: PASSWORD
Please do change the password after first login from “Manage >Users”