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
- 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.
- 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. |
- Des messages indiquant à quel moment le test ou le planning est lancé et terminé
s'affichent, sauf si vous précisez l'option –quiet.
- 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.
- 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 .
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.