Requirements & Installation
Minimum Hardware requirement
Your needs | Our recommendation | |||||
---|---|---|---|---|---|---|
Ticket created per month | Console Users | CMDB: CIs | Servers | CPU | Memory | Disk for MySQL |
< 200 | < 20 | < 50k | An all in one server | 2vCPU | 4Gb | 10Gb |
< 5000 | < 50 | < 200k | Two servers: Web + MySQL | 4vCPU | 8Gb | 20Gb |
> 5000 | > 50 | > 200k | Two servers: Web + MySQL | 8vCPU | 16Gb | 50Gb |
The minimum screen size for using iTop is 1024*768 pixels, but the higher resolution the better.
We recommend to use virtual machines running Debian 9 or Ubuntu 20.04 LTS
Software requirements
iTop server
iTop is based on MySQL and PHP.
-
Plus of-course a web server: Apache and IIS have built in configuration, other web server require extra work (eg. with NGINX).
-
Graphviz is needed to display the impact analysis graph.
-
required PHP extensions : ctype, dom, iconv, json, mbstring, mysqli, soap
-
php-gd is optionnal but required to be able to add images with CKEditor and resize automatically images within HTML fields.
-
fileinfo is usually present, but if missing you must add it, for attachment type identification, so preview can be proposed when pertinent.
-
Check Encrypted data for what to install to managed
EncryptedString
attribute -
To select a database version, check MariaDB release notes by version and MySQL release notes
iTop compatibility list
iTop | Min required → Max supported | Known Limitations | ||
---|---|---|---|---|
PHP | MySQL | MariaDB | ||
2.3.x | 5.3.6 | 5.0 | ||
2.4.x | 5.3.6 | 5.5.3 | ||
2.5.x | 5.3.6 | 5.5.3 | 5.5 | |
2.6.0 2.6.1+ |
5.6 →
7.2 5.6 → 7.3 |
5.6 | 10.1 | MySQL 8 not working, PHP 7.4 not working PHP 7.3 supported from 2.6.1 |
2.7.x 2.7.7 - 2.7.8 |
7.0.8 →
7.4 7.1.3 → 7.4 |
5.6 → 5.7 | 10.1 → 10.4 | MySQL 8 supported (not recommended for large
databases !), PHP 7.4 recommanded IE9 no more supported PHP 5.6 and 7.0.8 can work but not with all extensions PHP 7.1.3 min is required if you use oAuth2 or extension Brute Force Protection |
2.7.9+ | 7.1.3 → 7.4 | 5.6 → 5.7 | 10.1 → 10.6 | PHP 7.1.3 min is required |
3.0.x 3.0.2 |
7.1.3 →
7.4 7.1.3 → 8.0 |
5.7+ | 10.3 → 10.6 | MariaDB is now
preferred to MySQL IE11 no more supported PHP 8.0 supported only since 3.0.2 PHP 8.1+ not supported |
3.1.x | 7.4 → 8.1 | 5.7+ | 10.3.7 → 10.6 | PHP 8.1 supported |
3.2.x | 8.1 → 8.3 | 5.7+ | 10.6 → 10.11 | PHP 8.2 and PHP 8.3 supported |
Legend:
-
in bold: when the min or max version has changed since the previous iTop version
-
in italique: the highest version supported, when it is known
GET_LOCK
MySQL
function (for more information: Galera cluster known limitations).Recommended configuration
-
MySQL / MariaDB parameters
-
PHP parameters
Optional requirements:
-
For LDAP authentication iTop requires the PHP LDAP module. If this PHP module is not present iTop will not support LDAP or Active Directory identification.
Web Browser
Latest version of Chrome is recommended (Firefox is safe to).
-
Since 2.7.0, IE9 is no more supported
-
Following versions of iTop will no longer supports any Internet Explorer versions
Architecture constraints
Allow to pass OQL queries as parameters
In iTop, lots of pages are sending OQL queries as parameters. This is risk-free
as queries are interpreted and customized by iTop before being
transformed in a single Select
only SQL query and sent
to the DB server, so iTop :
-
check syntax and classes validity
-
adds appropriate filters according to user rights
-
protects against injections
As OQL syntax is close to SQL, this may be blocked by a security system like mod_security. You must allow those in order to use iTop. For example with mod_security :
SecRule REQUEST_URI "@beginsWith /pages/UI.php" \ "id:'000013', \ phase:1, \ t:none, \ nolog, \ pass, \ ctl:ruleRemoveById=942190, \ ctl:ruleRemoveById=942360"
APCu
We strongly recommend to enable APCu. For more details, read Tuning iTop Performance
However, if you are using APCu on mutiple instances, after a Move To Production, the cache must be cleared on all instances. As we have no tools for doing this, practically speaking this means:
-
either restart all web servers
-
or do not use APCu
Downloading iTop
You can download iTop from SourceForge: https://sourceforge.net/projects/itop/files/itop
Installing the Prerequisites on Debian or Ubuntu
To install the required software on Ubuntu, run the following commands (as root):
- PHP 7.2+ MariaDB
-
apt-get install apache2 apt-get install mariadb-server apt-get install php7.2 php7.2-mysql php7.2-ldap php7.2-cli php7.2-soap php7.2-json graphviz apt-get install php7.2-xml php7.2-gd php7.2-zip libapache2-mod-php php7.2-mbstring
- PHP 7.1 and MySQL
-
apt-get install apache2 apt-get install mysql-server apt-get install php php-mysql php-ldap php-cli php-soap php-json graphviz apt-get install php-xml php-gd php-zip libapache2-mod-php php-mbstring
root
user has no explicit password in MySQL, so you
will have to create a user account with a password for installing
iTop. The commands below create a user iTop
with all
privileges. This is useful for testing but is not
the best configuration for use in production
(because security matters):
sudo mysql
Once logged in MySQL, execute the following commands:
GRANT ALL PRIVILEGES ON *.* TO 'iTop'@'%' IDENTIFIED BY 'some_password'; FLUSH PRIVILEGES;
Installing the Prerequisites on Redhat, CentOS or Fedora
To install the required software on Redhat / CentOS / Fedora, run the following commands (as root):
yum install httpd yum install mysql mysql-server yum install php php-mysql php-xml php-cli php-soap php-ldap php-gd php-zip php-json php-mbstring graphviz
For example on Centos 8,
php-mysql
was replaced by
php-mysqlnd
.Installing the Prerequisites on Windows
Installing PHP on IIS
Check this page : iTop and IIS
Installing MySQL
If you do not already have a MySQL database server, you can install it on the same system as the rest of the application.
-
Go to MySQL's download site: http://www.mysql.com/downloads/mysql/
-
Download the installer suitable for your system: select package named “MSI Installer” either the 32 or 64-bit version.
-
Launch the installation, by opening the downloaded .msi file.
-
Follow the instructions of the installation wizard
Other dependency: graphviz
iTop relies on Graphviz to produce graphical representations of the object's life-cycle as well as the impact analysis graph.
On Linux, graphviz is already part of the prerequisites defined above, so there is nothing additionnal to do.
On Windows: download Graphviz from the web site and install it.
dot
executable
(named dot.exe
on Windows). For example
/user/bin/dot
on Linux and C:\Program files
(x86)\Graphviz 2.68\bin\dot.exe
on Windows.