Instalación de iTop sobre servidor Linux (Debian/Ubuntu)

Este documento describe de forma técnica y detallada el procedimiento de instalación de iTop (IT Operations Portal) sobre un servidor Linux basado en Debian/Ubuntu, incluyendo la preparación del entorno, instalación de dependencias, despliegue de la aplicación web y configuración de permisos necesarios para su correcto funcionamiento.

El procedimiento está orientado a entornos on‑premise o cloud, y asume un escenario estándar con servidor web Apache y base de datos MariaDB.

Alcance

El script cubre:

Actualización del sistema operativo.
Instalación de MariaDB, Apache y extensiones PHP requeridas por iTop.
Descarga e instalación de la aplicación iTop.
Configuración de permisos y ACLs sobre directorios críticos.
Preparación de entornos de ejecución (producción y test).

No incluye:

Configuración avanzada de Apache (VirtualHost, SSL, hardening).
Configuración inicial de la base de datos de iTop vía instalador web.
Medidas de seguridad adicionales (firewall, SELinux, backups).

Requisitos previos

Sistema operativo

Debian 10/11 o Ubuntu 20.04/22.04
Acceso root o usuario con privilegios sudo

Servicios

Apache instalado y operativo
Conectividad a Internet para descarga de paquetes

Script de instalación

A continuación se muestra el script completo de instalación utilizado como base para el procedimiento descrito en este documento:

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
sudomv /var/www/html/itop/web/* /var/www/html/itop
sudormdir /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/
sudomkdir /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
sudochown 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

Descripción del procedimiento

Actualización del sistema

Se actualiza el índice de paquetes del sistema para garantizar la instalación de versiones disponibles en los repositorios configurados:

apt-get update

Esto reduce problemas de dependencias y asegura compatibilidad con las librerías requeridas.

Instalación de dependencias

Se instalan los componentes necesarios para ejecutar iTop:

Base de datos

mariadb-server: motor de base de datos compatible con MySQL, requerido por iTop.

Servidor web y PHP

libapache2-mod-php: integración de PHP con Apache.
php: intérprete principal de PHP.

Extensiones PHP requeridas

php-mysql: conexión con MariaDB/MySQL.
php-cli: ejecución de scripts PHP en línea de comandos.
php-json: manejo de estructuras JSON.
php-xml: procesamiento XML.
php-gd: tratamiento de imágenes.
php-zip: manejo de archivos comprimidos.
php-curl: soporte para peticiones HTTP.
php-soap: servicios web SOAP.
php-mbstring: soporte de cadenas multibyte.
php-apcu: caché de objetos en memoria.
php-ldap: integración con LDAP/Active Directory.
php-imap: gestión de correo IMAP.

Dependencias adicionales

graphviz: generación de diagramas gráficos usados por iTop.

Estas extensiones son obligatorias o altamente recomendadas por el fabricante para garantizar todas las funcionalidades de la herramienta.

Descarga de iTop

La aplicación se descarga desde el repositorio oficial de SourceForge:

El archivo ZIP se almacena temporalmente en /tmp/itop.zip.
Se utiliza la opción -O para renombrar el fichero y facilitar su gestión.

Esto permite mantener el sistema limpio y separar ficheros temporales de los definitivos.

Despliegue de la aplicación

Se extrae únicamente el contenido del directorio web/ dentro del ZIP.
Los ficheros se copian al directorio web definitivo:
- /var/www/html/itop
Se reorganiza la estructura eliminando el subdirectorio web, ya que iTop espera los ficheros en la raíz del proyecto.

Este paso es crítico para que Apache pueda servir correctamente la aplicación.

Configuración de permisos mediante ACL

iTop requiere permisos de escritura dinámicos sobre ciertos directorios, incluso en entornos con permisos restrictivos.

Se configuran ACLs (Access Control Lists) para el usuario del servidor web (www-data):

Directorios críticos

/var/www/html/itop/data
/var/www/html/itop/log

Acciones realizadas

Permisos recursivos de lectura y escritura.
Permisos por defecto para nuevos archivos y directorios.

Esto garantiza que Apache pueda escribir logs, caché, archivos temporales y configuraciones sin comprometer la seguridad global del sistema.

Preparación de entornos de ejecución

Se crean los siguientes directorios:

env-production
env-production-build
env-test
env-test-build

Estos directorios son utilizados por iTop para separar entornos de ejecución y compilación de configuración.

Posteriormente:

Se asigna la propiedad al usuario www-data sobre estos directorios y el directorio conf.

Esto evita errores de permisos durante la instalación web y en futuras actualizaciones.

Resultado esperado

Al finalizar el procedimiento:

El entorno LAMP queda preparado para iTop.
La aplicación está desplegada en /var/www/html/itop.
Apache puede escribir correctamente en los directorios requeridos.
El sistema está listo para continuar con el instalador web de iTop desde el navegador.