Comment installer Mantis Bug Tracker sur Linux

"Installer Mantis Bug Tracker sur Linux Ubuntu Centos RHEL debian

Mantis Bug Tracker est un système de suivi des bogues populaire, open source et basé sur le web. Il est écrit en PHP et utilise une base de données MySQL/MariaDB pour stocker les données. Mantis Bug Tracker est un excellent outil pour les développeurs et les chefs de projet afin de suivre les problèmes, les bogues et les tâches dans les projets de développement logiciel. Dans cet article, nous passerons en revue les étapes d’installation de Mantis Bug Tracker sur un système Linux.

Prérequis

Avant de commencer le processus d’installation, nous devons nous assurer que notre système répond aux prérequis suivants :

  1. Serveur Web: Vous aurez besoin d’un serveur web installé sur votre système Linux. Le serveur HTTP Apache est un choix populaire, et nous l’utiliserons dans ce guide.
  2. PHP: Mantis Bug Tracker est écrit en PHP, vous devrez donc avoir PHP installé sur votre système. Nous vous recommandons d’utiliser la dernière version stable de PHP, qui au moment de l’écriture est PHP 8.1.
  3. Serveur de base de données: Mantis Bug Tracker nécessite une base de données MySQL ou MariaDB pour stocker ses données. Nous utiliserons MariaDB dans ce guide.
  4. Extensions PHP supplémentaires: Mantis Bug Tracker nécessite l’installation et l’activation de plusieurs extensions PHP, notamment :
    • php-gd (pour le traitement d’images)
    • php-mbstring (pour la gestion des chaînes de caractères multi-octets)
    • php-curl (pour la fonctionnalité de client HTTP)

Une fois que vous avez vérifié que votre système répond à ces prérequis, vous pouvez procéder au processus d’installation.

Étape 1 : Installer le serveur HTTP Apache

Si vous n’avez pas encore installé le serveur HTTP Apache sur votre système Linux, vous pouvez l’installer en utilisant le gestionnaire de paquets de votre distribution. Par exemple, sur Ubuntu/Debian, vous pouvez utiliser la commande suivante :

$ sudo apt-get install apache2

Sur CentOS/RHEL, vous pouvez utiliser :

$ sudo yum install httpd

Après avoir installé Apache, assurez-vous de démarrer le service et de l’activer pour qu’il démarre automatiquement au démarrage du système :

$ sudo systemctl start apache2    # Sur Ubuntu/Debian et CentOS/RHEL
$ sudo systemctl enable apache2   # Sur Ubuntu/Debian et CentOS/RHEL

Étape 2 : Installer MariaDB

Ensuite, nous devons installer le serveur de base de données MariaDB. Sur Ubuntu/Debian, vous pouvez utiliser la commande suivante :

$ sudo apt-get install mariadb-server

Sur CentOS/RHEL, vous pouvez utiliser :

$ sudo yum install mariadb-server

Après avoir installé MariaDB, sécurisez l’installation en exécutant la commande suivante et en suivant les instructions à l’écran :

$ sudo mysql_secure_installation

Étape 3 : Installer PHP et les extensions requises

Mantis Bug Tracker nécessite PHP et plusieurs extensions PHP supplémentaires. Sur Ubuntu/Debian, vous pouvez installer PHP et les extensions requises en utilisant la commande suivante :

$ sudo apt-get install php php-gd php-mbstring php-curl

Sur CentOS/RHEL, vous pouvez utiliser :

$ sudo yum install php php-gd php-mbstring php-curl

Après avoir installé PHP et les extensions requises, redémarrez le serveur web Apache pour que les changements prennent effet :

$ sudo systemctl restart apache2   # Sur Ubuntu/Debian
$ sudo systemctl restart httpd     # Sur CentOS/RHEL

Étape 4 : Télécharger Mantis Bug Tracker

Maintenant que nous avons installé toutes les dépendances requises, nous pouvons télécharger la dernière version de Mantis Bug Tracker depuis le site officiel. Au moment de l’écriture, la dernière version stable est la 2.26.2.

Vous pouvez télécharger le package Mantis Bug Tracker depuis le site officiel en utilisant la commande suivante :

$ wget https://sourceforge.net/projects/mantisbt/files/mantis-stable/2.26.2/mantisbt-2.26.2.tar.gz

Une fois le téléchargement terminé, extrayez le package en utilisant la commande suivante :

$ tar -xvzf mantisbt-2.26.2.tar.gz

Cela créera un nouveau répertoire appelé mantisbt-2.26.2.

Étape 5 : Configurer Apache pour Mantis Bug Tracker

Ensuite, nous devons configurer Apache pour servir l’application Mantis Bug Tracker. Nous allons créer un nouveau fichier de configuration de virtual host pour Mantis Bug Tracker.

  • Créez un nouveau fichier de configuration pour Mantis Bug Tracker :
$ sudo nano /etc/apache2/sites-available/mantis.conf
  • Ajoutez le contenu suivant au fichier, en remplaçant /path/to/mantis par le chemin réel du répertoire Mantis Bug Tracker extrait :
<VirtualHost *:80>
      ServerName mantis.example.com
      DocumentRoot /path/to/mantis
      <Directory /path/to/mantis>
         Options FollowSymLinks
         AllowOverride All
         Require all granted
      </Directory>
      ErrorLog ${APACHE_LOG_DIR}/mantis_error.log
      CustomLog ${APACHE_LOG_DIR}/mantis_access.log combined
</VirtualHost>

Cette configuration indique à Apache de servir l’application Mantis Bug Tracker depuis le répertoire spécifié et configure un hôte virtuel pour mantis.example.com. Vous pouvez remplacer mantis.example.com par le domaine ou l’adresse IP que vous souhaitez utiliser pour accéder à Mantis Bug Tracker.

  • Enregistrez et fermez le fichier.
  • Activez la nouvelle configuration de l’hôte virtuel :
$ sudo a2ensite mantis.conf
  • Désactivez la configuration de l’hôte virtuel Apache par défaut (si nécessaire) :
$ sudo a2dissite 000-default.conf
  • Redémarrez Apache pour appliquer les modifications :
$ sudo systemctl restart apache2

Étape 6 : Créer une base de données pour Mantis Bug Tracker

Mantis Bug Tracker nécessite une base de données MySQL/MariaDB pour stocker ses données. Nous devons créer une nouvelle base de données et un utilisateur avec les permissions appropriées pour Mantis Bug Tracker.

  • Connectez-vous à l’interpréteur de commandes MariaDB :
$ sudo mysql -u root -p

Entrez le mot de passe root lorsque vous y êtes invité.

  • Créez une nouvelle base de données pour Mantis Bug Tracker :
CREATE DATABASE mantisdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • Créez un nouvel utilisateur et accordez-lui les privilèges sur la nouvelle base de données :
CREATE USER 'mantisuser'@'localhost' IDENTIFIED BY 'VotreMotDePasseRobuste';
GRANT ALL PRIVILEGES ON mantisdb.* TO 'mantisuser'@'localhost';

Remplacez VotreMotDePasseRobuste par un mot de passe robuste de votre choix.

  • Actualisez les privilèges pour appliquer les modifications :
FLUSH PRIVILEGES;
  • Quittez l’interpréteur de commandes MariaDB :
EXIT;

Étape 7 : Configurer Mantis Bug Tracker

Maintenant que nous avons configuré la base de données, nous pouvons procéder à la configuration de Mantis Bug Tracker.

  • Accédez au répertoire Mantis Bug Tracker :
$ cd /path/to/mantis
  • Copiez le fichier de configuration d’exemple :
$ cp config_defaults_inc.php.sample config_inc.php
  • Ouvrez le fichier config_inc.php pour le modifier :
$ nano config_inc.php
  • Localisez les lignes suivantes dans le fichier et mettez-les à jour avec vos identifiants de base de données :
$g_database_type = 'mysqli';
$g_hostname      = 'localhost';  
$g_db_username   = 'mantisuser';
$g_db_password   = 'VotreMotDePasseRobuste';
$g_database_name = 'mantisdb';

Remplacez VotreMotDePasseRobuste par le mot de passe que vous avez défini pour l’utilisateur mantisuser précédemment.

  • Enregistrez et fermez le fichier.

Étape 8 : Installer Mantis Bug Tracker

Maintenant que nous avons configuré la base de données et mis à jour le fichier de configuration, nous pouvons procéder à l’installation de Mantis Bug Tracker.

  • Ouvrez votre navigateur web et accédez à l’URL suivante, en remplaçant mantis.example.com par le domaine ou l’adresse IP que vous avez configuré précédemment :
http://mantis.example.com/admin/install.php
  • Vous devriez voir la page d’installation de Mantis Bug Tracker. Suivez les instructions à l’écran pour terminer le processus d’installation.
  • Pendant le processus d’installation, vous serez invité à entrer les identifiants de la base de données que vous avez configurés précédemment.
  • Après avoir terminé l’installation, on vous demandera de créer un compte administrateur.
  • Une fois l’installation terminée, vous pouvez vous connecter au panneau d’administration de Mantis Bug Tracker avec le compte administrateur que vous venez de créer.

Étape 9 : Configurer Mantis Bug Tracker (Optionnel)

Après l’installation, vous voudrez peut-être configurer Mantis Bug Tracker selon vos besoins. Voici quelques options de configuration courantes :

  • Notifications par e-mail : Mantis Bug Tracker peut envoyer des notifications par e-mail pour divers événements, tels que les nouveaux problèmes, les mises à jour et les commentaires. Pour configurer les paramètres e-mail, accédez au panneau d’administration et naviguez vers “Gérer” > “Configuration” > “Notifications par e-mail”.
  • Gestion des utilisateurs : Vous pouvez créer et gérer des comptes utilisateurs, attribuer des rôles d’utilisateur et contrôler les autorisations d’accès. Accédez à “Gérer” > “Gérer les utilisateurs” dans le panneau d’administration.
  • Gestion des projets : Mantis Bug Tracker vous permet de créer et de gérer plusieurs projets. Vous pouvez configurer les paramètres des projets, attribuer des utilisateurs aux projets et personnaliser les flux de travail spécifiques aux projets. Accédez à “Gérer” > “Gérer les projets” dans le panneau d’administration.
  • Configuration du flux de travail : Mantis Bug Tracker fournit un système de flux de travail flexible qui vous permet de définir des statuts de problèmes, des priorités et des résolutions personnalisés. Vous pouvez personnaliser ces paramètres en accédant à “Gérer” > “Gérer la configuration” > “Flux de travail”.
  • Personnalisation : Mantis Bug Tracker offre diverses options de personnalisation, telles que des thèmes, des plugins et des traductions de langues. Vous pouvez explorer ces options en naviguant dans les sections respectives du panneau d’administration.

N’oubliez pas de consulter attentivement la documentation de Mantis Bug Tracker et les ressources communautaires pour plus d’options de configuration avancées et les meilleures pratiques.

Étape 10 : Sécuriser Mantis Bug Tracker

Après avoir installé et configuré Mantis Bug Tracker, il est important de prendre des mesures pour sécuriser votre installation. Voici quelques mesures de sécurité recommandées :

  1. Mettez à jour régulièrement : Gardez Mantis Bug Tracker, PHP et les autres dépendances à jour avec les derniers correctifs de sécurité et mises à jour.
  2. Configurez les autorisations d’accès : Restreignez l’accès au répertoire d’installation de Mantis Bug Tracker et aux fichiers de configuration sensibles en définissant correctement les autorisations.
  3. Activez HTTPS : Configurez Apache pour servir Mantis Bug Tracker via HTTPS afin de chiffrer les communications entre le serveur et les clients.
  4. Mettez en place l’authentification : Envisagez de mettre en place des mesures d’authentification supplémentaires, comme l’authentification à deux facteurs ou l’intégration avec un système d’authentification centralisé comme LDAP ou Active Directory.
  5. Restreignez l’accès au panneau d’administration : Limitez l’accès au panneau d’administration de Mantis Bug Tracker aux utilisateurs autorisés uniquement.
  6. Surveillez les journaux : Surveillez régulièrement les journaux Apache et Mantis Bug Tracker pour détecter toute activité suspecte ou erreur.
  7. Sauvegardez les données : Mettez en place une stratégie de sauvegarde régulière pour votre base de données Mantis Bug Tracker et vos fichiers de configuration afin de pouvoir récupérer les données en cas de problème.
  8. Désactivez les fonctionnalités inutilisées : Désactivez toutes les fonctionnalités ou plugins inutilisés dans Mantis Bug Tracker pour réduire la surface d’attaque.
  9. Suivez les meilleures pratiques : Adhérez aux meilleures pratiques de sécurité standard de l’industrie, telles que l’utilisation de mots de passe robustes, la limitation des autorisations système et la mise à jour régulière des logiciels.

En suivant ces mesures de sécurité, vous pouvez aider à protéger votre installation Mantis Bug Tracker et assurer la confidentialité, l’intégrité et la disponibilité de vos données de suivi de bogues.

Conclusion

Mantis Bug Tracker est un système de suivi des bogues puissant et riche en fonctionnalités qui peut grandement améliorer l’efficacité et l’organisation de vos projets de développement logiciel. En suivant les étapes décrites dans cet article, vous devriez maintenant avoir une installation fonctionnelle de Mantis Bug Tracker sur votre système Linux.

N’oubliez pas de mettre régulièrement à jour Mantis Bug Tracker, PHP et les autres dépendances pour assurer la sécurité et la stabilité. De plus, profitez des différentes options de configuration et des fonctionnalités de personnalisation offertes par Mantis Bug Tracker pour adapter le système à vos besoins spécifiques.

Si vous rencontrez des problèmes pendant le processus d’installation ou de configuration, consultez la documentation officielle de Mantis Bug Tracker ou demandez de l’aide sur les forums communautaires actifs et les canaux d’assistance.

Laisser un commentaire