Test Execution Agent (TEA)

Test Execution Agent (TEA) vous permet de déclencher des tests d’automatisation s’exécutant depuis Client Web.

À propos des hôtes TEA et des identifiants d’hôtes TEA

Voici une brève introduction aux hôtes TEA, aux identifiants d’hôte TEA et au fonctionnement de TEA avec Client Web.

Hôte TEA

Vous installez et configurez TEA sur une machine de test utilisée pour exécuter des tests d’automatisation. Les machines de test sur lesquelles TEA est installé sont des hôtes TEA.
Identifiant d’hôte TEA

À chaque démarrage, TEA vérifie votre identifiant d’hôte TEA. Si l’identifiant n’est pas valide ou est pris par un autre hôte TEA, l’authentification échoue. Chaque identifiant ne peut être utilisé que par un seul hôte TEA à la fois.
Fonctionnement de TEA avec Client Web

Lorsque vous lancez un test d’automatisation exécuté dans Client Web, Client Web vérifie si votre machine de test est enregistrée et si elle prend en charge l’exécution des tests d’automatisation sélectionnés. Si la vérification est réussie, TEA extrait le test d’automatisation à partir du serveur et indique à l’hôte de test d’exécuter les tests d’automatisation.

Vous pouvez surveiller les services hôte TEA depuis l’Administration du site. Pour plus d’informations, voir Contrôler les services d’hôte TEA.

Retour en haut

Flux de travail TEA

Les étapes suivantes illustrent comment utiliser TEA pour exécuter des tests d’automatisation dans Client Web :

  1. Téléchargez TEA.

    Pour plus d’informations, voir Télécharger TEA.

  2. Créer un identifiant d’hôte TEA pour votre machine de test dans l’Administration du site. L’identifiant est utilisé lors du premier démarrage de TEA pour authentifier l’hôte auprès du serveur.

    Pour plus d’informations, voir Contrôler les services d’hôte TEA.

  3. Démarrez TEA en exécutant start-agent.bat.

    Pour plus d’informations, voir Démarrer TEA.

  4. Déclencher des tests d’automatisation exécutés à partir de Client Web

    Pour plus d’informations, voir Exécuter les tests automatiquement.

  5. (Facultatif) Modifiez les configurations de TEA.

    Pour plus d’informations, voir (Facultatif) Modifier les configurations de TEA.

Retour en haut

Télécharger TEA

Vous pouvez télécharger TEA depuis la page qcbin.

Pour télécharger TEA :

  1. Sur la page qcbin (http://<serveur>:<numéro de port>/qcbin/), cliquez sur le lien Tools (Outils) pour ouvrir la page homonyme.

  2. Cliquez sur le lien Test Execution Agent.

  3. Au bas de la page TEST Execution Agent, cliquez sur Download Test Execution Agent (Télécharger Test Execution Agent).

Retour en haut

Démarrer TEA

Avant d’exécuter des tests d’automatisation à partir de Client Web, démarrez TEA dans la machine de test où vous souhaiter exécuter des tests d’automatisation.

Conditions préalables :

JDK/JRE 17 64 bits

Installez le JDK/JRE 17 64 bits sur la machine de test sur laquelle TEA a été installé.

Remarque : TEA ne fonctionne pas avec le JDK/JRE 32 bits. Si vous utilisiez TEA avant la version 24.1, après la mise à niveau vers la version 24.1, vous devez installer le JDK/JRE 17 64 bits. Sans cela, vous ne pouvez pas démarrer TEA.
Enregistrer les composants du client 64 bits

Enregistrez le client (64 bits) sur votre ordinateur de test à l’aide de l’outil Client Registration. Pour plus d’informations, voir Outils.

Remarque : TEA ne fonctionne pas avec les composants clients 32 bits. Si vous utilisiez TEA avant la version 24.1, après la mise à niveau vers la version 24.1, vous devez enregistrer les composants du client 64 bits. Sans cela, vous ne pouvez pas démarrer TEA.
Créer une clé API

Créez une clé API pour vous (le propriétaire de la machine de test). Assurez-vous que l’utilisateur associé à la clé est inclus dans le projet. Notez la clé API du client et le secret de la clé API.

Pour plus de détails sur l’authentification par clé API, voir Gestion des clés API.
Importer le certificat

Ceci est nécessaire uniquement si le protocole sécurisé est utilisé.

Importer le certificat dans le magasin de Java en exécutant la commande suivante dans le répertoire jre/bin :

  • Oracle JDK 

    keytool -import -keystore "{Java_home}\jre\lib\security\cacerts" -storepass 
changeit -keypass changeit -alias <file_alias> -file <file_name>

  • Ouvrir le JDK 

    keytool -keystore {Java_home}\jre\lib\security-importcert -file 
<certificate_file_name>-alias <file_alias> -storepass changeit -keypass changeit

{Java_home} correspond à l’emplacement dans lequel vous déployez le JDK/JRE 64 bits.

Pour démarrer TEA :

  1. Dans le répertoire où vous avez installé TEA, exécuter start-agent.bat.

  2. Les informations suivantes s’affichent :

    Champ Description
    Port Numéro de port HTTP pour exécuter TEA.
    Serveur URL URL du serveur au format http://<serveur>:<numéro_port>/qcbin.

    Client de clé API

    Secret de clé API

    ID de client et secret de clé API utilisés pour accéder au serveur.
    Jeton

    Identifiant de l’hôte TEA utilisé pour enregistrer l’hôte.

    Pour plus d’informations sur les identifiants d’hôte TEA, voir Contrôler les services d’hôte TEA.
    est partagé (O/N)

    Cette fonction prend en charge les deux options suivantes :

    • Y. L’hôte TEA peut être utilisé par toute personne déclenchant des tests d’automatisation dans Client Web.

    • N. L’hôte TEA ne peut être utilisé que par le propriétaire de l’hôte.
    Bin de Java Chemin d’installation du JDK (64 bits) où se trouve le fichier java.exe.

Une fois TEA démarré avec succès :

Une fois qu’il a été démarré avec succès, TEA envoie une requête ping à OpenText Application Quality Management toutes les minutes. Assurez-vous que les conditions suivantes sont remplies lors de l’exécution de tests d’automatisation :

  • La fenêtre de commande TEA est ouverte.

  • Vous ne déplacez pas le curseur lorsque TEA est en cours d’exécution.

Retour en haut

(Facultatif) Modifier les configurations de TEA

Après le premier démarrage de TEA, les deux fichiers de configuration suivants sont automatiquement créés.

Pour modifier les configurations de TEA, modifiez les fichiers, puis redémarrez TEA en exécutant start-agent.bat.

Fichier Configuration
agent.conf

Vous pouvez modifier les informations suivantes dans ce fichier :

  • Port

  • Serveur URL

  • Clé API du client et secret de la clé API

  • Jeton

  • est partagé
agent.ini Vous pouvez modifier la configuration du Bin de Java dans ce fichier.

Retour en haut

Dépannage

Le tableau suivant répertorie les problèmes que vous pouvez rencontrer lors de l’utilisation de TEA et vous indique comment les résoudre :

Problème Solution
Échec de la vérification de l’existence et de la compatibilité de la plateforme OTA.

Ce problème indique peut-être que vous n’avez pas enregistré les composants du client.

Enregistrez les composants du client sur votre ordinateur de test à l’aide de l’outil Client Registration. Pour plus d’informations, voir Outils.
Échec du démarrage de TEA avec affichage du message « Press any key to continue » (Appuyez sur une touche pour continuer). Faites défiler les lignes de commande pour voir si des erreurs ont été signalées. Corrigez les erreurs et redémarrez TEA.
TEA cesse d’envoyer une requête Ping lorsque vous cliquez dans une zone après avoir supprimé le curseur dans la ligne de commande. Cliquez avec le bouton droit dans la ligne de commande.

Retour en haut

Voir aussi :