Exécution d'un test à partir de la ligne de commande

Vous pouvez exécuter un test à partir de la ligne de commande, hors de l'espace de travail Eclipse, et exporter automatiquement les résultats.

Avant de commencer

L'exécution d'un test sous Linux nécessite un serveur X Windows, même si le test est lancé à partir de ligne de commande. Pour plus d'informations, voir Running tests from the command line on LinuxLinux.

Pourquoi et quand exécuter cette tâche

Pour surveiller le test, vous pouvez accéder aux rapports à partir d'un navigateur Web. Voir Evaluation des rapports à distance.

Remarque : La ligne de commande ne permet pas d'indiquer le mot de passe de stockage sécurisé pour la surveillance de ressource. Vous devez indiquer le mot de passe dans le plan de travail et vous assurer qu'il est stocké et conservé dans le planning avant de tenter d'exécuter ce dernier à partir de la ligne de commande.

Procédure

Pour exécuter un test à partir de la ligne de commande, placez-vous dans le répertoire qui contient les fichiers cmdline.bat et cmdline.sh. Sous un système d'exploitation Windows, ce répertoire est généralement productInstallationDirectory/cmdline, par exemple, C:\Program Files\IBM\SDP\cmdline.

Exécutez la commande suivante :

Remarque : L'émission de cette commande verrouille l'espace de travail. Pour vérifier l'avancement du test lors de son exécution, accédez à un autre espace de travail et ouvrez le projet dans celui-ci.

cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -suite suite_rel_path -varfile variable_file_full_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite {"true" | "false"} -quiet -users nn -vmargs JVM_args -rate RateRunnerGroupName=iterationNumber/duration, iterationNumber/duration -duration Stage1=durationOfStage; Stage2=durationOfStage -exportlog log_full_path -exportstats local_dir_path -exportstatshtml local_dir_path -compare "result_path1, result_path2"-exportstatreportlist stats_list -execsummary local_dir_path-timerange "all, 5 Users, 10 Users"-usercomments "any user comment"

Remarque : Sur Linux, la commande doit commencer par cmdline.sh.

Si une valeur contient des espaces, placez-la entre guillemets. Pour afficher l'aide en ligne de cette commande, entrez cmdline -help quand vous vous trouvez dans le répertoire qui contient le fichier .bat.

Le tableau suivant décrit chaque option.

Option	Description
-workspace	Obligatoire. Chemin d'accès complet à l'espace de travail Eclipse.
-project	Obligatoire. Chemin (incluant le nom de fichier) du projet relatif à l'espace de travail.
-eclipsehome	Obligatoire. Chemin complet d'accès au répertoire qui contient eclipse.exe.
-plugins	Obligatoire. Chemin complet du dossier qui contient les plug-ins. Sur un système Windows, il s'agit généralement du dossier C:\Program Files\IBM\IBMIMShared\plugins.
-suite	Facultatif. Cependant, dans une commande, il est obligatoire d'utiliser l'une des options ci-dessous. -suite -schedule -aftsuite -servicename Vous ne devez pas utiliser l'option -suite avec les autres options. Le chemin inclut le nom de fichier de la suite à exécuter spécifiée relativement au projet. A partir de la version 9.2.1.1, vous pouvez exécuter plusieurs tests d'un coup. Par exemple, `-suite` test1:test2:test3.
-aftsuite	Facultatif. Cependant, dans une commande, il est obligatoire d'utiliser l'une des options ci-dessous. -suite -aftsuite -servicename Vous ne devez pas utiliser l'option -aftsuite avec les autres options. L'option -aftsuite accepte aft xml comme valeur du paramètre. Elle prend uniquement en charge une entrée aft xml. Par exemple, `-aftsuite` aftinput
-importzip	Pour importer le projet en tant qu'actifs de test avec des dépendances dans votre espace de travail, utilisez l'option -importzip. Cette commande est disponible à partir de la version 9.2.1.1 et des versions ultérieures. Facultatif. Vous pouvez exécuter des actifs de test à partir du fichier zip importé, mais vous devez spécifier l'option -importzip, ainsi que l'option -schedule ou l'option -suite. Par exemple, `-importzip` script.zip -schedule sch1:sch2:sch3.
-varfile	Facultatif. Chemin complet d'accès au fichier XML qui contient les paires de nom et valeur de variable. Pour exécuter un test d'interface Web sur un autre navigateur que celui utilisé pour l'enregistrement, spécifiez la variable prédéfinie telle que mentionnée dans cette rubrique.
-servicename	Facultatif. Cependant, dans une commande, il est obligatoire d'utiliser l'une des options ci-dessous. -suite -schedule -aftsuite -servicename Vous ne devez pas utiliser l'option -servicename avec les autres options. Le chemin inclut le nom de fichier du service à exécuter spécifié relativement au projet. Au lieu d'un test de performances, le service spécifié est exécuté lorsqu'il devient disponible.
-serviceargs	Facultatif. Série d'arguments à passer au service spécifié par l'option -servicename. Par exemple, `-serviceargs`"-myserviceparm1 myserviceparm1value". Les valeurs sont placées entre guillemets, car elles contiennent des espaces.
-configfile	Facultatif. Chemin complet d'accès à un fichier qui contient les paramètres pour une exécution de test . Chaque paramètre doit figurer sur une ligne à part. Pour créer un fichier de configuration, utilisez un éditeur qui ne force pas le retour à la ligne. Tous les paramètres, qu'ils soient obligatoires ou facultatifs, peuvent être définis dans le fichier de configuration. Les paramètres de ligne de commande remplacent les valeurs figurant dans ce fichier. Remarque : Le fichier doit être au format UTF-8. N'utilisez pas de guillemets dans ce fichier, même pour les valeurs qui contiennent des espaces.
-results	Facultatif. Nom du fichier de résultats. Par défaut, il s'agit du nom du test , complété d'un horodatage. Indiquez un nom de dossier en rapport avec le projet pour stocker les résultats de test. Par exemple, `-results folder/resultname`.
-overwrite	Facultatif. Détermine si un fichier de résultats portant le même nom sera remplacé. La valeur par défaut, `false`, indique que le nouveau fichier de résultats est créé. Si la valeur est `true`, le fichier est remplacé et conserve le même nom de fichier. Utilisez des guillemets pour les valeurs "true" et "false".
-quiet	Facultatif. Désactive l'émission de messages par le programme de lancement et revient à l'interpréteur de commandes une fois l'exécution ou la tentative d'exécution terminée.

-vmargs	Facultatif. Pour définir la taille de segment Java™ maximale pour le processus Java qui contrôle la lecture de la ligne de commande, utilisez l'option `-vmargs` avec l'argument `-Xmx`. Par exemple, lorsque vous utilisez `-vmargs -Xmx4096m`, vous définissez une taille de segment maximale de 4 096 m. Cette méthode revient à définir `-Xmx4096m` dans le fichier eclipse.ini pour le plan de travail lors de la lecture du test à partir de l'interface utilisateur. Pour capturer des données de surveillance des ressources, utilisez `-vmargs "-Drm.collect=true -Drm.collect.interval=numeric value more than 1000"`. Pour recueillir les temps de réponse de l'appli elle-même ainsi que du serveur et du réseau, et pour les faire figurer dans des graphiques à barres différents, utilisez `-vmargs "-De2e.collect=true"`. Dans le cas des applications Web pour ordinateur de bureau (type PC), les temps de réponse sont capturés et affichés par défaut. Pour exécuter des tests en parallèle sur tous les périphériques mobiles qui sont en mode passif, connectés au plan de travail et prêts à la lecture, utilisez `-vmargs "-Dall.available.targets.in.parallel=true"`. Pour exécuter des tests en parallèle sur tous les navigateurs d'ordinateur de bureau pris en charge et les périphériques mobiles connectés, utilisez `-vmargs "-Dall.available.targets.in.parallel=all"`. Pour exécuter des tests en parallèle sur des navigateurs d'ordinateur de bureau sélectionnés et les périphériques mobiles connectés, utilisez `-vmargs "-Dall.available.targets.in.parallel=browser1,browswer2,browser3"`. Séparez les noms de navigateur à l'aide d'une virgule, par exemple `firefox, ff, chrome, ie, ie64, safari, edge`.
- protocolinput	Facultatif. Utilisez cet argument pour exécuter plusieurs tests d'interface Web en parallèle dans différents navigateurs. `-protocolinput "all.available.targets.in.parallel=all"` `-protocolinput "all.available.targets.in.parallel=chrome,ff,ie"` Remarque : Si vous utilisez l'argument `-protocolinput`, vous ne devez pas utiliser les arguments -vmargs équivalents : `-vmargs "-Dall.available.targets.in.parallel=all" -vmargs "-Dall.available.targets.in.parallel=browser1,browswer2,browser3"`
-publish	Facultatif : Utilisez cet argument pour publier les résultats de test sur le serveur de rapports unifiés. Les paramètres que vous pouvez utiliser avec celui-ci sont les suivants : `unifiedReportingURL`#project.name=`projectName` Si le nom du projet n'est pas spécifié, le nom du projet en cours est alors utilisé. no - Utilisez cette option si vous ne souhaitez pas publier les résultats de test après l'exécution. Cette option est utile si les préférences du plan de travail sont définies de manière à publier les résultats et que vous ne souhaitez toutefois pas les publier.
-publish_for	Utilisez cette option pour publier les résultats de test sur la base de l'état d'achèvement du test. ALL - Il s'agit de l'option par défaut. Utilisez cette option pour publier les résultats de test pour tout verdict d'exécution de test. PASS - Utilisez cette option pour publier les résultats des tests réussis. FAIL - Utilisez cette option pour publier les résultats des tests échoués. ERROR - Utilisez cette option pour publier les résultats des tests qui ont rencontré des erreurs. INCONCLUSIVE - Utilisez cette option pour publier les résultats des tests qui ne se sont pas révélés concluants. Vous pouvez ajouter plusieurs paramètres séparés par une virgule.
-exportlog	Facultatif. Chemin complet d'un fichier dans lequel stocker le journal de test HTTP exporté.
-exportstats	Facultatif. N'utilisez cette option que si vous voulez exporter des rapports au format CSV (comma-separated values), avec le nom de fichier tiré du nom du rapport. Ce répertoire peut être un relatif au projet ou un répertoire de votre système de fichiers. Si l'option -exportstatreportlist n'est pas spécifiée, les rapports exportés sont ceux qui sont indiqués sur la page Exportation de rapports des préférences Rapport de test de performances.
-timerange	Facultatif. Utilisez cette option avec -exportstats, -exportstatshtml, -execsummary pour exporter des résultats de test sur une ou plusieurs plages de temps. La valeur correspond à l'intervalle de temps que vous avez indiqué dans le planning. Par exemple, "tous, 5 utilisateurs,10 utilisateurs". Séparez les intervalles de temps par une virgule et utilisez des guillemets lorsqu'un intervalle de temps comporte un espace.
-exportstatshtml	Utilisez -exportstatshtml uniquement si vous voulez exporter les résultats d'analyse Web. Les résultats sont exportés dans le répertoire spécifié. Vous pouvez alors analyser les résultats sur un navigateur Web sans à avoir à utiliser le plan de travail de test.
-compare	Utilisez cet argument avec -exportstatshtml et -execsummary pour exporter le résultat dans le mode comparaison. La valeur peut correspondre à des chemins d'accès aux exécutions qui sont relatifs à l'espace de travail. Séparez les chemins à l'aide d'une virgule.
-exportstatreportlist	Facultatif. Liste d'ID de rapport séparés par des virgules. Utilisez cette option avec exportstats ou exportstatshtml pour indiquer les rapports que vous voulez exporter à la place des rapports par défaut ou des rapports sélectionnés dans les Préférences (Fenêtre > Préférences > Test > Rapports de test de performances > Exporter des rapports). Pour exporter des rapports avec cette option, vous devez spécifier les ID de rapport. Vous pouvez utiliser le bouton Copier l'ID dans le presse-papiers de Fenêtre > Préférences > Test > Rapports de test de performances > Exporter des rapports pour copier la liste d'ID de rapport sur la ligne de commande. Sélectionnez vos rapports en utilisant la sélection multiple (et non la sélection par case à cocher) et cliquez sur le bouton. Collez le contenu du presse-papiers dans votre éditeur de ligne de commande.
-execsummary	Utilisez cette option pour exporter, sur l'ordinateur local, tous les rapports de l'exécution du test dans un format imprimable, également appelé récapitulatif exécutif. Indiquez le chemin de l'emplacement dans lequel le récapitulatif exécutif doit être stocké.
-execsummaryreport	Utilisez cette option pour exporter, sur l'ordinateur local, un rapport spécifique en tant que récapitulatif exécutif de l'exécution du test. Spécifiez l'ID du rapport à exporter. Par exemple, pour exporter un rapport de performance HTTP, spécifiez http. Vous devez utiliser cette option conjointement avec -execsummary. Pour copier les ID des rapports, cliquez sur Fenêtre > Préférences > Test > Rapport de test de performances > Exportation de rapports et, dans la section Sélectionner les rapports à exporter, sélectionnez les rapports et cliquez sur Copier l'ID dans le presse-papiers. Vous pouvez maintenant coller les ID sur votre ligne de commande.
-usercomments	Facultatif. Ajoutez du texte entre guillemets pour l'afficher sur la ligne Commentaires de l'utilisateur du rapport. Remarque : Sous Windows, pour ajouter des commentaires dans une langue qui ne prend pas en charge les caractères Unicode, exécutez la commande à l'aide du fichier CommandLine.exe.

Pour arrêter l'exécution du test, vous pouvez ouvrir une autre fenêtre d'invite de commande et utiliser l'un des arguments suivants avec l'option cmdline :

Commande	Description
-stoprun	Facultatif : Arrête l'exécution du test après le nombre de secondes indiqué. Le bloc Finally est exécuté et le journal de test est transféré avant l'arrêt de l'exécution. Vous devez utiliser la commande -wokspace et spécifier l'emplacement de l'espace de travail.
-abandonrun	Facultatif : Arrête immédiatement l'exécution du test. Vous devez utiliser la commande -wokspace et spécifier l'emplacement de l'espace de travail.

Remarque :

Des messages indiquant à quel moment le test est lancé et terminé s'affichent, sauf si vous précisez l'option –quiet.

Exemple

Remarque : Le fichier de configuration doit présenter les informations sous forme de paires option=value. Bien que les chemins contenant des espaces doivent être placés entre guillemets sur la ligne de commande, vous ne devez pas utiliser d'espaces entre guillemets dans le fichier de configuration. Un fichier de configuration se présente par exemple ainsi :

workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

Que faire ensuite

Après l'exécution du test , vous pouvez éventuellement exporter ses résultats. Pour plus d'informations, voir Exportation automatique de compteurs de rapports.