Install and Upgrade your iTop

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.

• Hardware & Software requirements
• How to install prerequisites, on various environments
• Configure PHP, Web Server and DB...

• 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

(Commands on other environments)

• Run the following commands to install iTop on Ubuntu with Apache and MariaBD:

install.sh

sudo apt-get update
apt-get install mariadb-server libapache2-mod-php php php-mysql php-cli php-json graphviz php-xml php-gd php-zip php-curl php-soap php-mbstring php-apcu php-ldap php-imap
 
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 setfacl -m u:"www-data":rwX /var/www/html/itop/
sudo mkdir /var/www/html/itop/env-production /var/www/html/itop/env-production-build /var/www/html/itop/env-test /var/www/html/itop/env-test-build
sudo chown www-data: /var/www/html/itop/conf /var/www/html/itop/env-production /var/www/html/itop/env-production-build /var/www/html/itop/env-test /var/www/html/itop/env-test-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.

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.

• 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.

• Upgrade iTop
• Changing iTop location