Aller au contenu principal

Pré-requis

Une instance iTop 3.*

Avant tout chose : vous devez posséder une instance de iTop (3.2 par exemple).

Avant de configurer le Portail iTop, assurez-vous que votre environnement répond aux exigences suivantes. Cette section détaille les logiciels et outils nécessaires pour installer et exécuter le portail avec succès.

Exigences de l’environnement​

Le Portail iTop est conçu pour fonctionner sur un serveur avec les spécifications suivantes :

  • PHP 8.2 : L’application nécessite PHP version 8.2 ou supérieure. Assurez-vous que votre serveur dispose de cette version, ainsi que des extensions courantes comme php-mbstring, php-xml, et php-mysql pour une compatibilité totale avec Laravel.
  • Apache : Un serveur web tel qu’Apache est requis pour héberger l’application. Vérifiez que le module mod_rewrite est activé pour un routage URL correct.
  • MariaDB : Le portail utilise MariaDB comme système de gestion de base de données. La version 10.6 ou ultérieure est recommandée pour des performances et une compatibilité optimales.

Note : Bien qu’Apache et MariaDB soient recommandés, des alternatives comme Nginx ou MySQL peuvent fonctionner avec une configuration supplémentaire. Consultez la documentation de Laravel pour plus de détails sur les environnements pris en charge.

Outils de développement​

Pour installer les dépendances et gérer le projet, les outils suivants doivent être disponibles sur votre système :

  • npm : Le gestionnaire de paquets de Node.js (version 16.x ou ultérieure recommandée) est requis pour installer et construire les ressources front-end, y compris celles utilisées par Docusaurus pour cette documentation.
  • Composer : Le gestionnaire de dépendances de PHP (version 2.x ou ultérieure recommandée) est nécessaire pour installer Laravel et les autres dépendances PHP du Portail iTop.

Vérification de l’installation​

Pour confirmer que votre environnement est prêt, exécutez les commandes suivantes :

  • Vérifiez la version de PHP : php -v
  • Vérifiez l’état d’Apache : Assurez-vous que votre serveur est actif (par ex., sudo systemctl status apache2 sur les systèmes basés sur Debian).
  • Vérifiez MariaDB : Confirmez qu’il est installé et en cours d’exécution (par ex., mysql --version).
  • Vérifiez npm : npm -v
  • Vérifiez Composer : composer --version

Si l’un de ces outils est manquant ou obsolète, installez-le ou mettez-le à jour avant de passer aux étapes d’installation.

Utilisation du Webservice de iTop​

Le portail utilise le webservice de iTop pour interagir avec celui-ci. Il est donc absolument nécessaire de creer dans iTop un utilisateur spécifique ayant le rôle REST Service User et Admistrator comme ci-dessous : utilisateur webservice Ce compte (associé à son contact) aura un login et un mot de passe que vous devrez ensuite spécifier dans la configuration du portail, cf. Installation, configurer l'environnement.

Deux rôles sont nécessaires

Le role REST Service User est indispensable pour pouvoir utiliser le webservice fourni par iTop. Le rôle Administrator permet au portail d'effectuer toutes les opérations nécessaires.