How To Setup IT Operational Portal Using iTop On CentOS 7

Introduction

iTop, stands for IT Operational Portal, is an Open Source web-based application for the day to day operations of an IT environment. iTop was designed with the ITIL best practices in mind but does not dictate any specific process, the application is flexible enough to adapt to your processes whether you want rather informal and pragmatic processes or a strict ITIL aligned behavior.

This tool is ideal for Help Desk agents, Support engineers, Service managers, IT managers and End-users. Hence it is based on Apache, MySQL, and PHP, so you can run it on any operating system that supports those applications like Windows, Linux, MacOS and Solaris as well.

Using iTop you can:

– Document your entire IT infrastructure assets such as servers, applications, network devices, virtual machines, contacts.. etc.

– Manage incidents, user requests, planned outages.

– Document IT services and contracts with external providers including service level agreements.

– Export all the information in a manual or scripted manner.

– Import or synchronize/federate any data from external systems.

Features

– Fully configurable CMDB.
– HelpDesk and Incident Management.
– Service and Contract Management.
– Change Management.
– Configuration Management.
– Automatic SLA management.
– Automatic impact analysis.
– CSV import tool for all data.
– Consistency audit to check data quality.
– Data synchronization (data federation).

In this tutorial let us see how to setup the iTop on CentOS 6.5 and Debian 7, although it should work on RHEL, Scientific Linux 6.x and Ubuntu 13.10 as well.

Prerequisites

As it relies on apache, mysql and php, we need a server that has a working LAMP stack. To install LAMP server, refer the following articles that matches your platform.

  • Install Apache

Apache is an open-source multi-platform web server. It provides a full range of web server features including CGI, SSL and virtual domains.

To install Apache, enter the following command from your terminal:

# yum install httpd -y

Start the Apache service and let it start automatically on every reboot:

# service httpd start
# chkconfig httpd on

Allow Apache server default port 80 through your firewall/router if you want to connect from remote systems. To do that, edit file /etc/sysconfig/iptables,

# vi /etc/sysconfig/iptables
Add the following lines.

[…]
-A INPUT -m state –state NEW -m tcp -p tcp –dport 80 -j ACCEP
[…]
Restart iptables:

# service iptables restart
Test Apache:

Open your web browser and navigate to http://localhost/ or http://server-ip-address/.

Apache HTTP Server Test Page powered by CentOS - Mozilla Firefox_001
  • Install MySQL

MySQL is an enterprise class, open source, world’s second most used database. MySQL is a popular choice of database for use in web applications, and is a central component of the widely used LAMP open source web application software stack.

To install MySQL, enter the following command:

# yum install mysql mysql-server -y

Start the MySQL service and make to start automatically on every reboot.

# service mysqld start
# chkconfig mysqld on
Setup MySQL root password

By default, mysql root user doesn’t has password. To secure mysql, we have to setup mysql root user password.

# mysql_secure_installation

NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MySQL
SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY!
In order to log into MySQL to secure it, we’ll need the current
password for the root user. If you’ve just installed MySQL, and
you haven’t set the root password yet, the password will be blank,
so you should just press enter here.

Enter current password for root (enter for none): ## Press Enter ##
OK, successfully used password, moving on…
Setting the root password ensures that nobody can log into the MySQL
root user without the proper authorisation.

Set root password? [Y/n] ## Press Enter ##
New password: ## Enter new password ##
Re-enter new password: ## Re-enter new password ##

Password updated successfully!
Reloading privilege tables..
… Success!

By default, a MySQL installation has an anonymous user, allowing anyone
to log into MySQL without having to have a user account created for
them. This is intended only for testing, and to make the installation
go a bit smoother. You should remove them before moving into a
production environment.

Remove anonymous users? [Y/n] ## Press Enter ##
… Success!

Normally, root should only be allowed to connect from ‘localhost’. This
ensures that someone cannot guess at the root password from the network.

Disallow root login remotely? [Y/n] ## Press Enter ##
… Success!

By default, MySQL comes with a database named ‘test’ that anyone can
access. This is also intended only for testing, and should be removed
before moving into a production environment.

Remove test database and access to it? [Y/n] ## Press Enter ##

– Dropping test database…
… Success!
– Removing privileges on test database…
… Success!
Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.

Reload privilege tables now? [Y/n] ## Press Enter ##
… Success!

Cleaning up…

All done! If you’ve completed all of the above steps, your MySQL
installation should now be secure.

Thanks for using MySQL!

  • Install PHP

PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely used open-source general purpose scripting language that is especially suited for web development and can be embedded into HTML.

Install PHP with following command:

# yum install php -y
Test PHP

Create a sample “testphp.php” file in Apache document root folder and append the lines as shown below:

# vi /var/www/html/testphp.php
Add the following lines.

Restart httpd service:

# service httpd restart
Navigate to http://server-ip-address/testphp.php. It will display all the details about php such as version, build date and commands etc.

If you wanna to get MySQL support in your PHP, you should install “php-mysql” package. If you want to install all php modules just you use the command “yum install php*”

[root@server ~]

# yum install php-mysql -y

Now open the phptest.php file in your browser using http://ip-address/testphp.php or http://domain-name/testphp.php. Scroll down and you will see the mysql module will be presented there.

phpinfo() - Mozilla Firefox_002
  • Install phpMyAdmin

phpMyAdmin is a free open source web interface tool, used to manage your MySQL databases. By default phpMyAdmin is not found in CentOS official repositories. So let us install it using EPEL repository.

To install EPEL repository, follow the below link:

#cd /tmp
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
#ls *.rpm
To install epel-release-7-5.noarch.rpm, type:
#sudo yum install epel-release-latest-7.noarch.rpm

Now install phpMyAdmin

# yum install phpmyadmin -y
Configure phpMyAdmin

Edit the phpmyadmin.conf file.

# vi /etc/httpd/conf.d/phpMyAdmin.conf
Find and comment the whole /<Directory> section as shown below:

[…]
Alias /phpMyAdmin /usr/share/phpMyAdmin
Alias /phpmyadmin /usr/share/phpMyAdmin

#<Directory /usr/share/phpMyAdmin/>
# <IfModule mod_authz_core.c>
# # Apache 2.4
# Require local
# </IfModule>
# <IfModule !mod_authz_core.c>
# # Apache 2.2
# Order Deny,Allow
# Deny from All
# Allow from 127.0.0.1
# Allow from ::1
# </IfModule>
#</Directory>
[…]

Open “config.inc.php” file and change from “cookie” to “http” to change the authentication in phpMyAdmin:

# cp /usr/share/phpMyAdmin/config.sample.inc.php /usr/share/phpMyAdmin/config.inc.php
# vi /usr/share/phpMyAdmin/config.inc.php
Change cookie to http.

[…]
/* Authentication type */
$cfg[‘Servers’][$i][‘auth_type’] = ‘http’;
[…]
Restart the Apache service:

# service httpd restart

Now you can access the phpmyadmin console by navigating to http://server-ip-address/phpmyadmin/ from your browser.

Enter your MySQL username and password which you have given in previous steps. In my case its “root” and “centos”.

phpMyAdmin - Mozilla Firefox_003

Now you will be redirected to the phpmyadmin dashboard.page as shown below.

192.168.1.101 - localhost | phpMyAdmin 4.1.2 - Mozilla Firefox_004

Now you will able to manage your MariaDB databases from phpMyAdmin web interface.

Then install the following php extensions.

On CentOS/RHEL/Scientific Linux:

# yum install php-mysql php-mcrypt php-xml php-cli php-soap php-ldap graphviz
On Debian/Ubuntu:

# vi /etc/php.ini
Set post_max_size as 32M.

[…]
post_max_size = 32M
[…]

Download iTap

You can download the latest version from here.

# wget http://sourceforge.net/projects/itop/files/itop/2.0.2/iTop-2.0.2-1476.zip
Extract the zip file with command:

# unzip iTop-2.0.2-1476.zip

The above command extracts the zip file as a folder called ‘web’ in your current directory. Copy the ‘web’ folder contents to apache root folder.

# cp -fr web/ /var/www/html/itop

If you’re on a Debian/Ubuntu system, then the command would be:

# cp -fr web/ /var/www/itop

Create the following folders and make them to be writable.

# mkdir /var/www/html/itop/conf
# mkdir /var/www/html/itop/data
# mkdir /var/www/html/itop/env-production
# mkdir /var/www/html/itop/log
# chmod 777 /var/www/html/itop/conf/
# chmod 777 /var/www/html/itop/data
# chmod 777 /var/www/html/itop/env-production/
# chmod 777 /var/www/html/itop/log

– Begin Installation

Let us start the installation by navigating to the URL http://ip-address/itop or http://domain-name/itop.

If everything Ok, you will see the following screen. Click Continue.

Welcome to iTop version 2.0.2 - Mozilla Firefox_001

Select Install a New iTop and click Next.

Install or Upgrade choice - Mozilla Firefox_002

Accept the License agreement.

License Agreement - Mozilla Firefox_003

Create a new database for iTop.

Database Configuration - Mozilla Firefox_005

Enter the password for admin account.

Administrator Account - Mozilla Firefox_006

We’ve reached the end of installation. You’ll be asked to populate some sample data’s into your data. If you directly use it in production environment, then select the second option and Click Next. I want to populate my database with some demo data’s, so checked the first option.

Miscellaneous Parameters - Mozilla Firefox_008

Click Next.

Configuration Management options - Mozilla Firefox_010

Select the best choice of your IT environment and click Next.

Service Management options - Mozilla Firefox_012

Select the type of your Ticket management. If you don’t like to have Ticket management system, you can skip it also.

Tickets Management options - Mozilla Firefox_013

Select the type of tickets you want to use in order to manage changes to the IT infrastructure.

Change Management options - Mozilla Firefox_015

Select the following options if you want to implement any additional ITIL processes.

Additional ITIL tickets - Mozilla Firefox_016

Once you done with configuration, click Install.

Ready to install - Mozilla Firefox_018

Congratulations! We’ve successfully installed iTop. Click on the Link Enter iTop to log in.

Done - Mozilla Firefox_019

This is how my Dashboard looks with demo data.

Welcome to iTop - Mozilla Firefox_020

That’s all now. Start learning iTop with demo data and manage your IT infrastructure like a boss.

Cheer Up!

Reference Links:

iTop Homepage

Thank you for reading this article, Should you have any questions, please have a comment below.

Sophat Saom

Senior System Engineer, VCP

View my other posts

Leave a Reply

Your email address will not be published. Required fields are marked *