You are on page 1of 19

IPplan

IPplan Installation and Configuration Guideline

This document will show you on how to install and configure the IPplan v4.92a on CentOS 6
with a few simple steps.

2/14/2013 Prepared by Koemleang Chea


Chea Koemleang koemleang.chea@gmail.com

Table of Content

1. What is IPplan? ........................................................................................................................ 2


2. IPplan installation .................................................................................................................... 2
3. User and Group creation ......................................................................................................... 6
4. IP address creation and management ..................................................................................... 8
5. Backup and Recovery ............................................................................................................. 16

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

1. What is IPplan?

IPplan is a free (GPL), web based, multilingual, TCP IP address management (IPAM) software
and tracking tool written in php 4, simplifying the administration of your IP address space.
IPplan goes beyond TCPIP address management including DNS administration, configuration file
management, circuit management (customizable via templates) and storing of hardware
information (customizable via templates). IPplan can handle a single network or cater for
multiple networks and customers with overlapping address space. Makes managing IP
addresses and managing IP address space simple and easy!

2. IPplan installation

IPplan requires the following services

Start the web and mysql service and make them auto startup at boot

Download the IPplan and copy to the server. Extract zip file

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Copy IPplan directory to Document Root of Web Server and grant the permission to web service

Set the password for root account of the MySQL database (It’s not the root account of system)

Create a database named “ipplan” in the MySQL

Grant the permission of the database to ipplan account

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Now, let’s edit the main configuration file of IPplan

Make sure the following values match with database which has been created

Define credential for the web login account

Stop the firewall service

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Open a web browser and navigate to http://server-ip/ipplan/admin/install.php. Select “New


Installation” and click “Go!”

Login using the credential that has been defined in the main configuration file

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

3. User and Group creation

After the installation is completed, we need to create user and group to manage the IPplan, so
click on “New Group”

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Specify the group name and permission and click on “Create group”

After the group creation, let’s create a new user. Click “New User”

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Specify the User ID, full name, email, password and group. Then click on “Create User”

4. IP address creation and management

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Firstly, we need to create a new “Customer/Autonomous System”

It will ask you for the username and password, so just put the account which has been created

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Complete the “Customer/Autonomous System”, and “Submit”

Secondly, create a new “Network Area”

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Specify the “Area Address” & “Description” then “Submit”

Thirdly, create a “Network Range/Supernet”

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Specify the “Range address” and “Submit”

Last, create “Subnet”

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Complete the information required and “Submit”

To delete/edit/modify/split/join the subnet, just go as below

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

Select which section needed to modify and “Submit”

Here you are able to manage subnet as required

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

To quick view the IP address, which are in use or free, go the following

Then, it will show you as below

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

5. Backup and Recovery

Since the installation and configuration is completed, the backup is highly required to ensure
the persistence of operation. To backup database of IPplan, issue the following command.
NOTE:

- “mysqldump” is the mysql backup command


- “-u ipplan” is the parameter used to specify the user
- “-pipplanpw” is the parameter used to specify the password. “ipplanpw” is the password
- “ipplan” is the database name
- “>” is parameter used to export the database
- “ipplan.sql” is the new database backup file

Assuming that the database was error or destroyed, it’ll show the error “Could no connect to
database”. In this case, we will delete the database and test the restoration of the backup
database file. “Highly note that NEVER EVER issue the following command in the real working
environment since it will affect to IPplan database. It is just for testing purpose only.”

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

After the database is missed, we will not be able to access the IPplan

Now let’s restore back the backup database file. First, create a database named “ipplan” and
then restore backup database file.

IPplan Installation and Configuration Guideline


Chea Koemleang koemleang.chea@gmail.com

After the restoration is completed, everything will be back as previous

IPplan Installation and Configuration Guideline