Configurations avancées de Quality Insight

Cette section comprend certaines configurations avancées de Quality Insight.

Dans cette rubrique :

Surveiller l’état de l’indexation

La première indexation d’un grand projet peut prendre plusieurs heures. Le changement de l’emplacement des données après l’installation de Quality Insight nécessitera un temps similaire à celui de l’indexation initiale, puisque toutes les données seront ré-indexées et le processus d’indexation recommencera. Vous voudrez peut-être surveiller la progression du processus d’indexation.

Pour surveiller l’état du processus d’indexation :

1. Envoyer une requête HTTP GET à l’URL :

   http://<quality insight server>:<port>/alm-fetcher-service/api/health/

2. Lorsque le processus d’indexation est terminé, le statut passe de « EXÉCUTION » à « EN ATTENTE ». Cela indique que l’indexation est terminée et qu’elle attend la prochaine mise en commun de nouvelles données. Toutes les quelques heures, le système demande s’il y a de nouvelles données à indexer.

   Note : Lorsque _nextRuntime a une valeur autre que « -1 », cela indique que le processus d’indexation est terminé et que les données du projet sont prêtes à être recherchées avec Quality Insight. (Si _nextRuntime affiche « -1 », cela indique que l’indexation n’a pas encore commencé ou est toujours en cours, et n’a pas encore été terminée pour la première fois)

Retour en haut

(Facultatif, pour Windows seulement) Modifier les configurations de Quality Insight

Après l’installation de Quality Insight, vous pouvez modifier les paramètres de configuration, tels que l’emplacement des données ou l’URL du serveur ALM, selon les besoins.

Par exemple, vous pouvez décider de stocker les données dans un emplacement partagé ou dans un dossier situé en dehors du répertoire d’installation pour éviter qu’elles ne soient supprimées lors de la mise à niveau ou de la désinstallation de Quality Insight.

Pour modifier et mettre à jour les configurations de Quality Insight :

1. Dans le menu Démarrer de Windows, sélectionner Tous les programmes > Micro Focus > Quality Insight - Mettre à jour les configurations.

   La page Quality Insight - Configurations s’ouvre.

2. Modifier les paramètres obligatoires.

3. Cliquez sur Enregistrer. Le service Quality Insight redémarre.

   Vous devrez peut-être attendre quelques instants pour que Quality Insight soit disponible. Un message s’affiche, indiquant que le service Quality Insight est prêt.

Retour en haut

Retour en haut

Exécuter Quality Insight sur SSL ou HTTPS

Après avoir installé Quality Insight, vous pouvez configurer la confiance sur le serveur Quality Insight. Ceci est nécessaire lorsque Quality Insight se connecte au serveur ALM via le protocole HTTPs.

Pour exécuter Quality Insight sur SSL ou HTTPS :

1. Préparer le fichier keystore avec votre chaîne de certificats et le placer dans le dossier approprié (par exemple, <quality insight install path>\apache-tomcat-9.0.22\conf). Pour en savoir plus, consulter la documentation sur les Autorités de certification (CA).
2. Configurer Apache Tomcat pour utiliser HTTPS :
   1. Naviguer jusqu’à <quality insight install path>\apache-tomcat-9.0.22\conf et ouvrir server.xml.

   2. Ajouter ce qui suit :

      Copy code

      <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
      maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
      clientAuth="false" sslProtocol="TLS" keystoreFile="conf/keystore.jks" keystorePass="changeit"
      sslEnabledProtocols="TLSv1,TLSv1.1,TLSv1.2"/>

      Le tableau suivant décrit les propriétés ci-dessus :

      Propriété	Description
      port	Le port SSL qui sera utilisé pour se connecter à partir d’ALM
      protocole	Pour plus de détails sur le protocole, voir la documentation Apache Tomcat
      keystoreFile	Le chemin vers votre keystore
      keystorePass	Le mot de passe de votre keystore
      sslEnabledProtocols	Les protocoles SSL autorisés

3. Ajoutez les certificats primaires, intermédiaires et d’Autorité de certification utilisés dans ALM au keystore de Quality Insight. L’emplacement par défaut est <JDK install path>\jre\lib\security\cacerts.

   • Windows

     Copy code

     "%JAVA_HOME%\bin\keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK install path>\jre\lib\security\cacerts"

   • Linux

     Copy code

     "%JAVA_HOME%/bin/keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK install path>\jre\lib\security\cacerts"

4. Redémarrer Quality Insight et vérifier l’installation :

   https://<quality_insight_server>:<PORT>/iris-service/

   Un message s’affiche, confirmant que la configuration est correcte.

5. Ajouter les certificats primaires, intermédiaires et d’Autorité de certification utilisés dans Quality Insight au keystore ALM. L’emplacement par défaut est <JDK install path>\jre\lib\security\cacerts.

   • Windows

     Copy code

     "%JAVA_HOME%\bin\keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK install path>\jre\lib\security\cacerts"

   • Linux

     Copy code

     "%JAVA_HOME%/bin/keytool" -import -trustcacerts -alias mydomain -file certificate.crt -keystore "<JDK install path>\jre\lib\security\cacerts"

6. Redémarrer ALM et configurer Quality Insight en utilisant SSL.

   Pour plus de détails, voir https://tomcat.apache.org/tomcat-8.0-doc/ssl-howto.html.

Retour en haut

Modifier l’heure de début de synchronisation de Quality Insight

Seules les données dont la date de dernière modification est postérieure à l’heure de début de synchronisation de Quality Insight seront synchronisées du serveur ALM vers le serveur Quality Insight et seront ensuite récupérées par Quality Insight. Par défaut, l’heure de synchronisation de départ est 2020-01-01 00:00:00.

Pour modifier l’heure de synchronisation de Quality Insight :

1. Mettre à jour alm.fetch.initial.date dans le fichier alm-fetcher-service.properties, qui se trouve dans le répertoire {installation path}\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF\classes.

   Le nouveau format de date doit être le même que celui de la date par défaut : AAAA-MM-JJ HH:MM:SS.

2. Pour Windows : Ouvrir les services Windows, et redémarrer le service MF Quality Insight.

   Pour Linux : Arrêter et démarrer le service Quality Insight en utilisant la commande suivante :

   Copy code

   service <MF_QI> <start / stop>

Retour en haut

Modifier le port du serveur de Quality Insight

Après l’installation, le port du serveur de Quality Insight est 8080. Si 8080 est déjà occupé, vous devez changer le port du serveur de Quality Insight.

Pour Windows :

1. Mettre à jour le numéro de port dans le fichier alm-fetcher-service.properties, qui se trouve dans le répertoire {chemin d’installation}\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF\classes.

   Copy code

   <Server port="8005" shutdown="SHUTDOWN">
      <Service name="Catalina">
        <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
          redirectPort="8443" />

   Par défaut, le chemin est C:\Program Files\MicroFocus\QualityInsight\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF\classes\alm-fetcher-service.properties.

2. Mettre à jour le numéro de port dans le fichier server.xml, qui se trouve dans le répertoire {chemin d’installation}\apache-tomcat-9.0.22\conf.

   Copy code

   iris.server.url=http://localhost:8080

   Par défaut, le chemin est C:\Program Files\MicroFocus\QualityInsight\apache-tomcat-9.0.22\conf\server.xml.

Pour Linux :

1. Mettre à jour le numéro de port dans le fichier alm-fetcher-service.properties, qui se trouve dans le répertoire {installation path}/apache-tomcat-9.0.22/webapps/alm-fetcher-service/WEB-INF/classes.

   Copy code

   Server port="8005" shutdown="SHUTDOWN">
      <Service name="Catalina">
        <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
          redirectPort="8443" />

   Par défaut, le chemin est /var/opt/MicroFocus/QualityInsight/apache-tomcat-9.0.22/webapps/alm-fetcher-service/WEB-INF/classes/alm-fetcher-service.properties.

2. Mettre à jour le numéro de port dans le fichier server.xml, qui se trouve dans le répertoire {chemin d’installation}/apache-tomcat-9.0.22/conf.

    

   Copy code

   iris.server.url=http://localhost:8080

   Par défaut, le chemin est /var/opt/MicroFocus/QualityInsight/apache-tomcat-9.0.22/conf/server.xml.

Retour en haut

Configurer les champs d’entité synchronisés avec Quality Insight

Vous pouvez définir quels champs d’entité sont synchronisés du serveur ALM au serveur Quality Insight. Par défaut, certains champs d’exigences et tous les champs des autres types d’entités sont synchronisés.

Pour définir quels champs d’entité sont synchronisés :

1. Ouvrir le fichier alm-fetcher-service-application-context.xml qui se trouve dans le répertoire {chemin d’installation}\apache-tomcat-9.0.22\webapps\alm-fetcher-service\WEB-INF.

2. Localiser l’élément <util:list> pour le type d’entité dont vous voulez spécifier les champs.

   Example: Si vous voulez spécifier des champs pour le type d’entité par défaut, localiser l’élément suivant.

   <util:list id="defect-alm-fields" list-class="java.util.ArrayList" value-type="java.lang.String">    
   </util:list>

3. Dans l’élément cible <util:list> ajouter les noms des champs que vous souhaitez synchroniser avec Quality Insight.

   Note : Les noms des champs de l’entité ne sont pas nécessairement les mêmes que les étiquettes du champ. Pour obtenir les noms des champs :

   1. Appeler l’API REST : GET/qcbin/rest/domains/{domain}/projects/{project}/customization/entities/{entity name}/fields.

   2. Le nom d’un champ est la valeur de l’attribut Nom de l’élément Champ.

      Par exemple, <Field Label="Author" Name="owner" PhysicalName="RQ_REQ_AUTHOR">. Le nom de champ Auteur est propriétaire.

   Example: Si vous voulez synchroniser les champs par défaut tels que Heure de réparation actuelle, Affecté à, Date de fermeture, et Détecté par avec Quality Insight, vous devez ajouter les valeurs suivantes à l’élément <util:list> pour le type d’entité par défaut.

   <util:list id="defect-alm-fields" list-class="java.util.ArrayList" value-type="java.lang.String">
     <value>actual-fix-time</value>
     <value>owner</value>
     <value>closing-date</value>
     <value>detected-by</value>
   </util:list>

4. Redémarrer le service MF Quality Insight.

   Pour Windows : Ouvrir les services Windows, et redémarrer le service MF Quality Insight.

   Pour Linux : Arrêter et démarrer le service Quality Insight en utilisant la commande suivante :

   Copy code

   service <MF_QI> <start / stop>

5. Réindexer les données en reconstruisant les cartes du tableau de bord. Voir Recompiler les cartes du tableau de bord.

Retour en haut

Définir le nombre maximum de cartes KPI

Vous pouvez définir le nombre maximum de cartes KPI que chaque utilisateur peut créer dans Quality Insight > Executive Dashboard. Par défaut, un utilisateur peut créer jusqu’à 100 cartes KPI.

Pour définir le nombre maximum de cartes KPI :

1. Ouvrir le fichier iris.properties qui se trouve dans le répertoire {chemin d’installation}\apache-tomcat-9.0.22\webapps\iris-service\WEB-INF\classes.

2. Mettre à jour la valeur du paramètre iris-service.search.page-size.limit.

3. Redémarrer le service MF Quality Insight.

   Pour Windows : Ouvrir les services Windows, et redémarrer le service MF Quality Insight.

   Pour Linux : Arrêter et démarrer le service Quality Insight en utilisant la commande suivante :

   Copy code

   service <MF_QI> <start / stop>

Retour en haut

Voir aussi :

• Désinstaller Quality Insight