从命令行运行测试或调度

您可以从 Elcipse 工作空间之外的命令行运行测试或调度并自动导出结果。

开始之前

在 Linux 上,X 服务器必须可用,即使从命令行运行时也是如此。 有关更多信息,请参阅在 Linux 上从命令行运行测试

注: 您不能在 Mac OS X 上从命令行运行测试。

过程

  1. 要从命令行运行测试或调度,请转至包含 cmdline.batcmdline.sh 文件的目录。 在 Windows 操作系统上,该目录通常是 productInstallationDirectory/cmdline 您可以将自动化测试脚本指向该文件以运行测试或调度
  2. 发出以下命令:

    cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -schedule sched_rel_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 -exportlog log_full_path -exportstats stats_full_path -exportstatreportlist stats_list -usercomments "any user comment"

    如果值包含空格,请在值的两边加上引号。要查看该命令的联机帮助,请在您位于包含 .bat 文件的目录中时,输入 cmdline -help

    下表说明了每个选项:

    选项 描述
    -workspace 必需。指向 Eclipse 工作空间的完整路径。
    -project 必需。与工作空间相关的项目路径(包含文件名)。
    -eclipsehome 必需。指向包含 eclipse.exe 的目录的完整路径。
    -plugins 必需。指向包含插件的文件夹的完整路径。通常情况下,在 Windows 操作系统上,该文件夹位置为 C:\Program Files\IBM\IBMIMShared\plugins
    -schedule 可选,但您必须指定 -schedule 选项、-suite 选项或 -servicename 选项。 所要运行调度的与项目相关的路径(包含文件名)。
    -suite 可选,但您必须指定 -schedule 选项、-suite 选项或 -servicename 选项。 所要运行测试的与项目相关的路径(包含文件名)。
    -varfile 可选。指向包含变量名称-值对的 XML 文件的完整路径。
    -servicename 可选,但您必须指定 -schedule 选项、-suite 选项或 -servicename 选项。 要运行的服务的名称。将运行指定的服务(当它变得可用时)而不是运行性能测试。
    -serviceargs 可选。要传递到 -servicename 选项所指定的服务的参数序列。例如,-serviceargs "-myserviceparm1 myserviceparm1value"。值包含在引号中,因为它们包含空格。
    -configfile 可选。完整路径,指向包含用于测试或调度运行的参数的文件。每个参数都必须位于单个行上。要创建配置文件,请使用不自动换行的编辑器。可在配置文件中设置任何参数(必需或可选均可)。命令行参数将覆盖该文件中的值。
    注: 该文件必须为 UFT-8 格式。 请勿在该文件中使用引号,即使对于包含空格的值也是如此。
    -results 可选。结果文件的名称。缺省结果文件是附加了时间戳记的测试或调度名称。
    -overwrite 可选。确定是否将覆盖具有相同名称的结果文件。缺省值 true 意味着将覆盖此结果文件。
    -quiet 可选。关闭来自启动程序的任何消息输出,并在运行或尝试完成时返回到命令 shell。
    -users 可选。覆盖运行中虚拟用户的缺省数量。对于调度,缺省值为在调度编辑器中指定的用户数。对于测试,缺省值为一个用户。该选项用于创建调度的包含指定数量用户的新副本。
    -vmargs 可选。要传入的 Java 虚拟机参数。例如,-vmargs "-debug -Xmx512m"。值包含在引号中,因为它们包含空格。要捕获源监视数据,请使用 -vmargs "-Drm.collect=true -Drm.collect.interval=numeric value more than 1000"
    -exportlog 可选。完整路径,指向要在其中存储所导出 HTTP 测试日志的文件。
    -exportstats 可选。完整路径,指向要在其中存储所导出统计报告数据的目录。统计报告数据以逗号分隔值 (CSV) 格式进行存储,其文件名派生自报告名称。如果未指定 -exportstatreportlist 选项,那么将导出在“性能测试报告”首选项的“导出报告”页面上指定的报告。
    -exportstatreportlist 可选。绝对路径的逗号分隔列表,这些路径指向要在通过 -exportstats 选项导出统计报告数据时使用的定制报告格式文件(.view 文件)。此参数将覆盖工作空间首选项。例如,-exportstatreportlist c:/customreport.view,c:/customreport2.view
    -usercomments 可选。在双引号内添加文本以将其显示在报告的“用户注释”行中。
    注:
    • 除非包含 -quiet 选项,否则将显示消息以指示测试或调度何时启动以及何时完成。
    • 发出此命令将锁定工作空间。要在运行期间检查测试或调度的进度,请调用另一个工作空间并通过该工作空间打开项目。

示例

注: 配置文件必须通过 option=value 对来包含信息。 虽然在命令行上,必须在包含空格的路径两边加上引号,但请勿在配置文件中在空格两边加上引号。样本配置文件如下所示:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

下一步做什么

运行测试或调度后,您可能要导出结果。有关更多信息,请参阅自动导出报告计数器

反馈