L'adaptateur de ligne de commande permet d'utiliser une machine comme machine de test cible pour l'exécution 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
L'adaptateur de ligne de commande s'exécute sur toute plateforme prenant en charge
Java version 1.5 ou ultérieure au moins.
Le fichier exécutable
java.exe doit être accessible dans le chemin sur la machine de test cible. Vous devez aussi disposer des informations permettant de démarrer l'adaptateur :
- URL du référentiel jazz, généralement https://qmserver:port/qm
- ID utilisateur avec les licences adéquates pour se connecter en tant qu'adaptateur
- Le mot de passe de cet utilisateur
- Le nom de la zone de projet, s'il ne s'agit pas de la zone de projet par défaut de l'application Quality Management
Enfin, l'application de gestion de la qualité doit être démarrée sur le serveur.
Remarque : Plusieurs adaptateurs peuvent être exécutés sur une machine de test cible ; toutefois, chaque adaptateur doit constituer un processus distinct associé à un nom unique 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.
Effectuez cette tâche sur la machine de test cible.
Procédure
- Procurez-vous le fichier emplacement-install\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip à partir de la machine d'installation.
Remarque : Il se peut que vous deviez demander à un administrateur de serveur disposant de l'accès en lecture sur le serveur d'obtenir le fichier compressé.
- Procédez à l'extraction du fichier RQMCommmandLineAdapter.zip dans un dossier sur la machine de test cible.
- Facultatif : Personnalisez les résultats des scripts réels (qui apparaissent dans l'enregistrement d'exécution de scénario ou de suite de tests) comme décrit dans Personnalisation de l'adaptateur de ligne de commande.
- Démarrez l'adaptateur de ligne de commande.
Pour démarrer l'adaptateur de ligne de commande la première fois :
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]
Personnalisation de l'adaptateur de ligne de commande
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 : nom d'hôte ou adresse IP du serveur de gestion de la qualité.
- port : port sur lequel le serveur de gestion de la qualité est exécuté.
- id_utilisateur : ID utilisateur enregistré pour la gestion de la qualité et disposant de la licence permettant d'exécuter un adaptateur.
- mot_de_passe : mot de passe de l'ID utilisateur indiqué.
- nom_adaptateur : nom de l'adaptateur que l'utilisateur a affecté.
- zone_projet : nom du projet auquel la connexion est établie.
- veille : intervalle d'interrogation pour les tâches. Le paramètre par défaut est de 5 secondes.
- fichier_configuration : 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 (le fichier
config.ini ou le fichier qui est spécifié dans l'option
-configFile) devant contenir les informations d'enregistrement. Ces informations sont réutilisées au redémarrage de l'adaptateur.
Pour redémarrer l'adaptateur de ligne de commande à partir d'un fichier config.ini :
: Exécutez le fichier de commandes sans argument :
C:\ start.bat
: 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 similaire 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 . Assurez-vous que le statut est VERT avant de tenter d'exécuter un test pour un adaptateur de ligne de commande en cours d'exécution.