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

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

Avant de commencer

Vérifiez qu'un fichier exécutable Java pris en charge (java.exe) se trouve dans votre chemin avant de tenter d'exécuter un planning ou un test depuis la ligne de commande. Un fichier exécutable Java pris en charge est fourni avec le produit. Sous les systèmes d'exploitation UNIX, il se trouve dans le répertoire .../jdk/bin/java. Sous les systèmes d'exploitation Windows, il se trouve dans le répertoire ...\jdk\bin\java.exe. Sous Linux, un serveur X doit être disponible, même pour une exécution à partir de la ligne de commande. Pour plus d'informations, voir Running tests from the command line on Linux.

Procédure

  1. Pour exécuter un planning ou un test à partir de la ligne de commande, placez-vous dans le répertoire qui contient les fichiers cmdline.bat et cmdline.sh. Il s'agit généralement de C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecutedate_version.
  2. Entrez la commande suivante :

    cmdline -workspace chemin_complet_plan_de_travail -project chemin_proj -schedule chemin_plann -eclipsehome chemin_complet_eclipse -plugins chemin_complet_plug-in -configfile chemin_complet_fichier -results fichier_résultat -overwrite {true | false} -quiet -users nn -vmargs args_JVM

    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 Requis. Chemin d'accès complet à l'espace de travail Eclipse.
    -project Requis. Chemin (incluant le nom de fichier) du projet relatif à l'espace de travail.
    -eclipsehome Requis. Chemin complet du répertoire qui contient eclipse.exe.
    -plugins Requis. Chemin complet d'accès au répertoire qui contient les plug-ins. En général, l'emplacement de ce dossier est le suivant : C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Facultatif, mais vous devez obligatoirement indiquer soit -schedule, soit-suite. Chemin (incluant le nom de fichier) du planning relatif au projet.
    -suite Facultatif, mais vous devez obligatoirement indiquer soit -suite, soit-schedule. Chemin (incluant le nom de fichier) du test relatif au projet.
    -configfile Facultatif. Chemin complet d'accès à un fichier qui contient les paramètres pour une exécution de planning ou de test. Chaque paramètre doit figurer sur une seule ligne ; utilisez un éditeur qui ne va pas à la ligne automatiquement. 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. 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. Le nom du fichier de résultats par défaut correspond au nom du planning ou du test auquel est ajouté un horodatage.
    -overwrite Facultatif. Détermine si un fichier de résultats portant le même nom sera remplacé. La valeur par défaut, true, indique que le fichier de résultats est remplacé.
    -quiet Facultatif. Désactive la sortie des messages du programme de lancement et renvoie simplement au shell de commandes lorsque l'exécution ou la tentative d'exécution est terminée.
    -users Facultatif. Remplace le nombre d'utilisateurs virtuels dans l'exécution. Pour un planning, la valeur par défaut correspond au nombre d'utilisateurs spécifié dans l'éditeur de planning. Pour un test, la valeur par défaut est un utilisateur. Cette option crée une nouvelle copie du planning qui contient le nombre indiqué d'utilisateurs.
    -vmargs Facultatif. Arguments de la machine virtuelle Java à transmettre. Par exemple : -vmargs "-debug -Xmx512m". Les valeurs sont placées entre guillemets car elles contiennent des espaces.
  3. Des messages indiquant à quel moment le test ou le planning est lancé et terminé s'affichent, sauf si vous précisez l'option –quiet.
  4. L'émission de cette commande verrouille l'espace de travail. Pour vérifier l'avancement du planning ou du test lors de son exécution, accédez à un autre espace de travail et ouvrez le projet dans celui-ci.
  5. Lorsque l'invite de commande réapparaît, l'exécution est terminée. Il est possible de démarrer Performance Tester pour consulter les résultats. Pour automatiquement exporter les résultats après une exécution à partir de la ligne de commande, cliquez sur Fenêtres > Préférences > Test > Rapport de test de performances > Exportation de rapports.

Exemple

Remarque : Le fichier de configuration doit présenter les informations sous forme de paires option=valeur. 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=monProjet
schedule=monPlanning.testsuite

Que faire ensuite

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

Retour d'informations