Ejecución de una planificación desde la línea de mandatos

Puede ejecutar una planificación o prueba desde la línea de mandatos fuera del espacio de trabajo de Eclipse y exportar automáticamente los resultados.

Antes de empezar

Verifique que hay un archivo ejecutable Java™ (java.exe) soportado en la vía de acceso antes de intentar ejecutar una planificación o prueba desde la línea de mandatos. Se proporciona un archivo ejecutable Java soportado con el producto. En sistemas operativos UNIX, el archivo ejecutable está instalado de forma predeterminada en el directorio /opt/IBM/SDP/jdk/bin/. En sistemas operativos Windows, el archivo ejecutable está instalado de forma predeterminada en el directorio C:\Archivos de programa\IBM\SDP\jdk\bin\. En Linux, debe estar disponible un servidor X, incluso cuando se ejecuta desde una línea de mandatos. Consulte Ejecución de pruebas a partir de líneas de mandato en Linux para obtener más información.

Procedimiento

  1. Para ejecutar una planificación o prueba desde la línea de mandatos, vaya al directorio que contiene los archivos cmdline.bat y cmdline.sh. En sistemas operativos Windows, este directorio está normalmente en C:\Archivos de programa\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecuteversion_date.
  2. Emita el siguiente mandato:

    cmdline -workspace vía_acceso_completa_espacio_trabajo -project vía_acceso_rel_proyecto -eclipsehome vía_acceso_completa_eclipse -plugins vía_acceso_completa_conector -schedule vía_acceso_rel_planif -suite vía_acceso_rel_suite -servicename service -serviceargs args_servicio -configfile vía_acceso_completa_archivo -results archivo_resultado -overwrite {true | false} -quiet -users nn -vmargs args_JVM -exportlog Vía_acceso_completa_registro -exportstats vía_acceso_completa_estadísticas -exportstatreportlist lista_estadísticas

    Si un valor contiene espacios, escriba el valor entre comillas. Para ver la ayuda en línea para este mandato, mientras esté en el directorio que contiene el archivo .bat escriba cmdline -help.

    En la tabla siguiente se explica cada opción:

    Opción Descripción
    -workspace Necesario. La vía de acceso completa al espacio de trabajo de Eclipse.
    -project Necesario. La vía de acceso, incluido el nombre de archivo, del proyecto relativa al espacio de trabajo.
    -eclipsehome Necesario. La vía de acceso completa del directorio que contiene eclipse.exe.
    -plugins Necesario. La vía de acceso completa de la carpeta que contiene los conectores. Normalmente, en sistemas operativos Windows, la ubicación de esta carpeta es C:\Archivos de programa\IBM\IBMIMShared\plugins.
    -schedule Opcional, pero debe especificar las opciones -schedule, -suite o -servicename. La vía de acceso, incluido el nombre de archivo, de la planificación que se ejecutará relativa al proyecto.
    -suite Opcional, pero debe especificar las opciones -schedule, -suite o -servicename. La vía de acceso, incluido el nombre de archivo, de la prueba que se ejecutará relativa al proyecto.
    -servicename Opcional, pero debe especificar las opciones -schedule, -suite o -servicename. El nombre del servicio para ejecutar. En vez de ejecutar una programación o una prueba de rendimiento, el servicio especificado se ejecuta al estar disponible.
    -serviceargs Opcional. Las series de argumentos para pasar al servicio especificado por la opción -servicename. Por ejemplo, -serviceargs "-myserviceparm1 myserviceparm1value". Los valores están entre comillas porque contienen espacios.
    -configfile Opcional. La vía de acceso completa de un archivo que contiene los parámetros para una ejecución planificada o de prueba. Cada parámetro debe estar en una línea. Para crear un archivo de configuración, utilice un editor que no ajuste líneas. Cualquier parámetro, ya sea necesario u opcional, se puede establecer en el archivo de configuración. Los parámetros de línea de mandatos sobrescriben los valores de este archivo. No utilice comillas en este archivo, incluso para valores que contengan espacios.
    -results Opcional. El nombre del archivo de resultados. El archivo de resultados predeterminado es el nombre de la planificación o prueba con una indicación de fecha y hora añadida.
    -overwrite Opcional. Determina si se debe sobrescribir un archivo de resultados que tenga el mismo nombre. El valor predeterminado, true, significa que el archivo de resultados se sobrescribe.
    -quiet Opcional. Desactiva la salida de mensajes del iniciador y devuelve el shell de mandatos cuando la ejecución o el intento ha terminado.
    -users Opcional. Altera temporalmente el número predeterminado de usuarios virtuales en la ejecución. En una planificación, el valor predeterminado es el número de usuarios especificados en el editor de planificación. En una prueba, el valor predeterminado es un usuario. Esta opción crea una nueva copia de la planificación que contiene el número especificado de usuarios.
    -vmargs Opcional. Los argumentos de Java Virtual Machine que vayan a pasar. Por ejemplo, -vmargs "-debug -Xmx512m". Los valores están entre comillas porque contienen espacios.
    -exportlog Opcional. La vía de acceso completa a un archivo en el que se almacena el registro de pruebas HTTP exportado.
    -exportstats Opcional. La vía de acceso completa a un directorio en el que se almacenan datos de informe estadístico exportados. Los datos de informe estadísticos se almacenan en formato de valores separados por com (CSV), con el nombre del archivo que deriva del nombre de informe. Si no se especifica la opción -exportstatreportlist, se exportarán los informes especificados en la página Exportar informes de las preferencias Informe de las pruebas de rendimiento.
    -exportstatreportlist Opcional. Una lista separada por comas de las vías de acceso absolutas a los archivos de formato de informe personalizado (archivos .view) para utilizar al exportar datos de informe estadísticos con la opción -exportstats. Este parámetro altera temporalmente las preferencias del espacio de trabajo. Por ejemplo, -exportstatreportlist c:/customreport.view,c:/customreport2.view.
  3. Se visualizan mensajes para indicar cuándo se inicia la prueba o la planificación y cuándo se completa, a menos que incluya la opción -quiet.
  4. Al emitir el mandato se bloquea el espacio de trabajo. Para comprobar el progreso de la planificación, invoque otro espacio de trabajo y abra el proyecto mediante dicho espacio de trabajo.
  5. Cuando vuelva al indicador de mandatos, la ejecución habrá finalizado. Opcionalmente, inicie el Verificador de rendimiento para revisar los resultados. Para exportar automáticamente los resultados una vez que la ejecución haya finalizado desde la línea de mandatos, pulse Ventana > Preferencias > Prueba > Informes de las pruebas de rendimiento > Exportar informes.

Ejemplo

Nota: El archivo de configuración debe contener información en los pares opción=valor. Aunque las vías de acceso que contienen espacios deben ir entre comillas en la línea de mandatos, no incluya los espacios entre comillas en el archivo de configuración. Un archivo de configuración de ejemplo tiene el aspecto siguiente:
workspace=D:\Mi espacio de trabajo
eclipsehome=C:\Archivos de programa\IBM\SDP
plugins=C:\Archivos de programa\IBM\IBMIMShared\plugins
project=miProyecto
schedule=miPlanificación.testsuite

Qué hacer a continuación

Tras ejecutar la planificación, puede exportar los resultados. Para obtener más información, consulte el apartado Exportación automática de contadores de informes.

Comentarios