Install and Upgrade your iTop

Intended audience

This document is targeted towards system administrators in charge of installing and/or upgrading the iTop application.

This document assumes that you have at least a basic knowledge about:

configuring your web server (Apache Httpd, IIS, NGINX, …),
PHP installation and configuration,
MySQL and the SQL language in general.

Prerequisites

iTop is an app based on PHP and MySQL or MariaDB.
Users will only need a web browser with JavaScript enabled.
All details about each required component can be found below !

If you already have a LAMP or a WAMP platform running, you can skip this part and go directly to the next chapter !
Actually you will just need to get and unzip the iTop package, then access it though your browser : this will launch the iTop setup, which will check for all the requirements.

Get iTop package

iTop Community : download the iTop package from SourceForge.
iTop Professional or Essential: for Combodo clients, download your package from the ITSM Designer :
1. in the Designer home screen, click on your instance's version
2. in the displayed dialog select the version you need
3. click download

The source code can be downloaded or cloned from the iTop repository on GitHub
Warning : this should be done by developers only !

Install iTop

TL;DR Quick install on Ubuntu 20.04

(Commands on other environments)

Run the following commands to install iTop on Ubuntu 20.04, with PHP 7.4 and MariaBD:

install.sh

sudo apt-get update
sudo apt-get install apache2 mariadb-server php7.4 php7.4-mysql php7.4-ldap php7.4-cli php7.4-soap php7.4-json graphviz php7.4-xml php7.4-gd php7.4-zip php7.4-fpm php7.4-mbstring acl
 
wget https://sourceforge.net/projects/itop/files/latest/download -O /tmp/itop.zip
sudo unzip /tmp/itop.zip "web/*" -d /var/www/html/itop
sudo mv /var/www/html/itop/web/*  /var/www/html/itop
sudo rmdir /var/www/html/itop/web
sudo setfacl -dR -m u:"www-data":rwX /var/www/html/itop/data /var/www/html/itop/log
sudo setfacl -R -m u:"www-data":rwX /var/www/html/itop/data /var/www/html/itop/log
sudo mkdir /var/www/html/itop/conf /var/www/html/itop/env-production /var/www/html/itop/env-production-build
sudo chown www-data: /var/www/html/itop/conf /var/www/html/itop/env-production /var/www/html/itop/env-production-build

Launch installation from a web browser by pointing to this url : https://myserver.mydomain.com/itop/setup and follow the Wizard

After installation :

Ensure the application is accessible and discover the user interface: Your first connection to iTop.
Create the minimum set of objects for the iTop application to be usable by your users: Follow the Implementation Guide.

Install extensions or additional modules

Each iTop Community package can be customized by adding extensions. This can be done :

Automatically using iTop hub : in iTop admin console, simply open “iTop Hub / Connect to iTop Hub” menu.
Manually:
1. Copy the modules files to the /extensions iTop subdirectory
2. Make sure that the iTop configuration file (config-itop.php in conf/production) is not read-only,
3. Point your web browser to http(s)://location_of_itop/setup and follow the on-screen instructions.

Finetune the system

Check the multiple User Authentication Options: integration with LDAP/Active Directory, single sign-on,…
Connect to MySQL using TLS
iTop and reverse proxies
Protect iTop setup
Secure your iTop instance
Tuning iTop Performance
Understand the possible profiles and manage user accounts
Schedule background tasks. Mandatory for asynchronous email, scheduled backups, SLA computation…

And then check how to integrate iTop with other applications.

Sidebar