Configuration et démarrage de l'adaptateur de ligne de commande

Avec l'adaptateur de ligne de commande, vous pouvez utiliser une machine de test cible pour l'exécution à partir de la ligne de commande. Vous devez enregistrer l'adaptateur sur la machine de test cible afin de pouvoir exécuter des scripts de ligne de commande.

Avant de commencer

Important : Vous pouvez exécuter plusieurs adaptateurs sur une machine de test cible, mais chaque adaptateur doit constituer un processus distinct et avoir un nom unique qui est spécifié dans l'option -adapterName.

Pourquoi et quand exécuter cette tâche

L'adaptateur de ligne de commande doit être configuré et démarré sur la machine de test cible.
Configuration de l'exécution à partir de la ligne de commande

Procédure

Effectuez les étapes suivantes sur la machine de test cible :

  1. Procurez-vous le fichier emplacement-install\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip à partir de la machine d'installation. Il se peut qu'un administrateur de serveur disposant des droits d'accès en lecture sur le serveur doive obtenir le fichier compressé pour vous.
  2. Procédez à l'extraction du fichier RQMCommmandLineAdapter.zip dans un dossier sur la machine de test cible.
  3. Facultatif : Personnalisez les résultats de test réels qui apparaissent dans l'enregistrement d'exécution de scénario de test ou l'enregistrement d'exécution de suite de tests. Pour plus d'informations, voir Personnalisation de l'adaptateur de ligne de commande.
  4. Si vous utilisez la version 5.0 ou une version ultérieure et voulez que les adaptateurs de ligne de commande traitent plusieurs demandes parallèlement, vous pouvez activer cette fonction, qui est désactivée par défaut. Pour activer la fonction, vous ajoutez une propriété. Si vous n'ajoutez pas la propriété ou si vous l'associez à une valeur non valide, lorsque plusieurs tests sont envoyés à un adaptateur, ils sont placés en file d'attente et sont exécutés dans l'ordre de réception.
    Conseil : L'utilisation de l'adaptateur de ligne de commande pour exécuter des tests parallèlement est la méthode recommandée pour les tests à exécution longue. L'adaptateur sélectionne les tests un par un en fonction de sa capacité à exécuter chaque test. Il sélectionne un script, commence à l'exécuter, puis sélectionne un autre script à exécuter. Si les scripts sont courts, vous pouvez avoir l'impression qu'ils s'exécutent séquentiellement.
    Pour activer l'exécution de test parallèle dans un adaptateur de ligne de commande :
    1. Sur la machine de test cible, ouvrez le fichier CommandLine.properties ou un fichier de préférences équivalent.
    2. Ajoutez la propriété suivante au fichier : com.ibm.rqm.commandline.maxservedrequests=N

      où N est le nombre maximal de test à exécuter simultanément.

    3. Si l'adaptateur de ligne de commande est actif, redémarrez-le.
    Lorsque le nombre maximal spécifié est atteint, les tests qui sont envoyés à l'adaptateur sont placés en file d'attente en vue de leur exécution dès qu'un espace devient disponible.
  5. Démarrez l'adaptateur de ligne de commande.
    • Pour démarrer l'adaptateur de ligne de commande pour la première fois :
      Icône Windows
      Exécutez le fichier de commandes avec les arguments de ligne de commande conformément à l'exemple suivant :
      C:\ start.bat -repository  https://qmserver:port/qm -user ID_utilisateur -password mot_de_passe [-adapterName nom_adaptateur] [-projectArea zone_projet] [-sleepTime veille][-configFile fichier_configuration]
      Pour plus d'informations, voir Personnalisation de l'adaptateur de ligne de commande.
      Icône Linux
      Icône Unix
      Exécutez le script de shell avec les arguments de ligne de commande conformément à l'exemple suivant :
       $ start.sh -repository  https://qmserver:port/qm -user ID_utilisateur -password mot_de_passe [-adapterName nom_adaptateur] [-projectArea zone_projet] [-sleepTime veille][-configFile fichier_configuration]
      où :
      • qmserver est le nom d'hôte ou l'adresse IP du serveur Quality Management.
      • port est le port sur lequel le serveur Quality Management s'exécute.
      • userid est un ID utilisateur enregistré pour Quality Management et qui possède la licence permettant d'exécuter un adaptateur.
      • password est le mot de passe de l'ID utilisateur indiqué.
      • adapter-name est un nom d'adaptateur que l'utilisateur a attribué.
      • project area est le nom du projet auquel vous vous connectez.
      • sleep time est l'intervalle d'interrogation pour les tâches. Le paramètre par défaut est de 5 secondes.
      • configuration file est le fichier de stockage et de lecture des paramètres pour cet adaptateur. Le nom de fichier par défaut est config.ini.

      L'adaptateur génère un fichier de configuration devant contenir les informations d'enregistrement. Il s'agit du fichier config.ini ou du fichier qui est spécifié dans l'option -configFile. Ces informations sont réutilisées au redémarrage de l'adaptateur.

    • Pour redémarrer l'adaptateur de ligne de commande depuis un fichier config.ini :
      Icône Windows
      : Exécutez le fichier de commandes sans argument :
      C:\ start.bat
      Icône Linux
      Icône Unix
      : Exécutez le script de shell sans argument de ligne de commande :
      $ start.sh
      Remarque : Le fichier de configuration doit se trouver dans le répertoire à partir duquel l'adaptateur est démarré.

Résultats

Le système génère un message semblable au suivant :
Lancement de l'adaptateur...
Le fichier de configuration adapterConfig.ini n'existe pas ; l'adaptateur va utiliser les arguments transmis
La création d'un client HTTP a abouti
L'adaptateur est maintenant connecté
L'adaptateur de ligne de commande a été créé

Que faire ensuite

Vous pouvez vérifier l'état de l'adaptateur dans l'application de gestion de la qualité sur la machine de test en cliquant sur Exécution > Console de l'adaptateur. Avant d'essayer d'exécuter à nouveau un test dans l'adaptateur de ligne de commande, vérifiez que le statut est vert.

icône vidéo Regarder des vidéos

Liste de diffusion de CLM
Chaîne Jazz.net
Chaîne de formation des utilisateurs

icône En savoir plus En savoir plus

Cercle d'apprentissage CLM
Cercle d'apprentissage Agile
Cercles d'apprentissage

icône Poser des questions Poser des questions

Forum Jazz.net
Forums developerWorks

icône Aide Obtenir de l'aide

Portail de support
Wiki de déploiement
Blogue de support