Plugin Mantis

Fayçal SOUGRATI

For giving the possibility to track bugs in Salomé-TMF, we developed a plugin for the open source bug-tracking tool Mantis.

Table des matières

Installation of the Mantis plugin

For installing the Mantis plugin, follow the steps:

Install Mantis (www.mantisbt.org).
Install the Mantis plugin (see the documentation on Salomé-TMF installation and plugins).
Copy the file "view_salome_bug_page.php" (which is in the installation directory of the Mantis plugin) in the root directory of the Mantis installation.
Create a distant user of the Mantis database forSalomé-TMF :
- Connect to the MySQL server (command line as follows):
  
  > mysql -u root -p;
- Create the user:
  
  mysql> GRANT SELECT, INSERT, UPDATE, DELETE, REFERENCES
  ON <mantis_db>.* TO <salomeTMF_user>@'%' IDENTIFIED BY '<salomeTMF_password>';
  
  Where:
  - <mantis_db>: Mantis database.
  - <salomeTMF_user>: distant user login.
  - <salomeTMF_password>: distant user password.
Open the file "CfgMantis.properties" in the cfg/ directory of the Mantis plugin, and define the following variables:
- MANTIS_URL_DB: URL for the Mantis database.
- MANTIS_USER_LOGIN: login of the distant user of the Mantis database which has been created for Salomé-TMF.
- MANTIS_USER_PWD: distant user password.
- MANTIS_URL_HTTP: Mantis URL.
- JDBC_DRIVER: just guess what it can be.

First step: project and user creation inside Mantis

The first step for activating the Mantis plugin inside Salomé-TMF consists in creating the project and the user inside Mantis.

Those features are in the "Tools" menu, as shown in the following figure:

After creating the project and the user inside Mantis, a message asks the user to quit and restart Salomé-TMF for the changes to take effect.

Entering a bug

During a campaign execution, as shown in the next figure, you can add a bug with the sub-menu "Mantis" inside the menu "Add a bug" in the test execution window:

Another window pops up, with pre-defined informations in the "Description" field for the bug. The user can modify those pre-defined infos:

Next, click on the button "Send" for saving the bug in Mantis. The user is then sent to a page confirming the creation of the bug in Mantis. This is purely informative, there is no action to take at this point.
After the bug creation, a link is added as an attachment to the test execution result, as shown in the following figure:

The link (in red in the figure) opens the Mantis page which corresponds to the bug.

Note: The user can also enter a bug when reading the execution result through the menu emphasized in blue in the previous screenshot.

Reading bugs linked to an execution environment

Another feature brought by the Mantis plugin is the possibility to view all bugs linked to a given execution environment. This feature can be accessed through the sub-menu "Show bugs" in the tab "Environments" in the dataset, as shown by the following screenshot:

Remark: As shown in the previous screenshot, the Mantis plugin enables to compute the ICAL number (Indicateur de Correction Avant Livraison, an indicator specific of France Telecom processes). Those features are detailed in the Salomé-TMF user guide.

You can look the bugs linked to the environment through Mantis:

Remark 1: As shown in green in the screenshot, the cnnected user, the project and the environment are the same that those in Salomé-TMF.

Remark 2: For more infos on Mantis, you can check the user manual here.

À propos de ce document...

Plugin Mantis

This document was generated using the LaTeX2HTML translator Version 2002-2-1 (1.71)

The command line arguments were:
latex2html -split 1 -no_navigation -dir ../.././src_mantis/plugins/mantis/docs/html/en -no_footnode en/mantis.tex

The translation was initiated by on 2006-06-26

2006-06-26