要初始化 XML 文件中的测试变量,您可以从命令行界面使用 varfile 选项来运行测试。
开始之前
- 使用 IBM® Rational® Performance Tester 来声明变量。
在您尝试从命令行运行调度或测试之前,请先验证支持的 Java 可执行文件 (
java.exe) 位于您的路径中。支持的 Java 可执行文件随本产品提供:
- 在 UNIX 操作系统上,缺省情况下,该可执行文件位于 /opt/IBM/SDP/jdk/bin/ 安装目录。
- 在 Windows 操作系统上,缺省情况下,该可执行文件位于 C:\Program
Files\IBM\SDP\jdk\bin\ 安装目录。
- 在 Linux 上,X 服务器必须可用,即使从命令行运行时也是如此。
有关更多信息,请参阅在 Linux 上从命令行运行测试。
- 创建包含了具有值的变量的 XML 文件。此 XML 文件的结构将类似于下图
过程
- 要从命令行运行调度或测试,请转至包含 cmdline.bat 和 cmdline.sh 文件的目录。
在 Windows 操作系统上,该目录通常是 C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecuteversion_date。
- 发出以下命令:
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 |
可选。完整路径,指向包含用于调度或测试运行的参数的文件。每个参数都必须位于单个行上。要创建配置文件,请使用不自动换行的编辑器。可在配置文件中设置任何参数(必需或可选均可)。命令行参数将覆盖该文件中的值。 注: 请勿在该文件中使用引号,即使对于包含空格的值也是如此。
|
-results |
可选。结果文件的名称。缺省结果文件是附加了时间戳记的调度或测试名称。 |
-overwrite |
可选。确定是否将覆盖具有相同名称的结果文件。缺省值 true 意味着将覆盖此结果文件。 |
-quiet |
可选。关闭来自启动程序的任何消息输出,并在运行或尝试完成时返回到命令 shell。 |
-users |
可选。覆盖运行中虚拟用户的缺省数量。对于调度,缺省值为在调度编辑器中指定的用户数。对于测试,缺省值为一个用户。该选项用于创建调度的包含指定数量用户的新副本。 |
-vmargs |
可选。要传入的 Java 虚拟机参数。例如,-vmargs "-debug
-Xmx512m"。值包含在引号中,因为它们包含空格。 |
-exportlog |
可选。完整路径,指向要在其中存储所导出 HTTP 测试日志的文件。 |
-exportstats |
可选。完整路径,指向要在其中存储所导出统计报告数据的目录。统计报告数据以逗号分隔值 (CSV) 格式进行存储,其文件名派生自报告名称。如果未指定 -exportstatreportlist 选项,那么将导出在“性能测试报告”首选项的“导出报告”页面上指定的报告。 |
-exportstatreportlist |
可选。绝对路径的逗号分隔列表,这些路径指向要在通过 -exportstats 选项导出统计报告数据时使用的定制报告格式文件(.view 文件)。此参数将覆盖工作空间首选项。例如,-exportstatreportlist
c:/customreport.view,c:/customreport2.view。 |
-usercomments |
可选。在双引号内添加文本以将其显示在报告的“用户注释”行中。 |
注: - 除非包含 -quiet 选项,否则将显示消息以指示测试或调度何时启动以及何时完成。
- 发出此命令将锁定工作空间。要在运行期间检查调度或测试的进度,请调用另一个工作空间并通过该工作空间打开项目。
示例
cmdline -workspace C:/RPTWorkspace -project testProj -eclipsehome C:\Program
Files\IBM\SDP\eclipse.exe -schedule MySchedule -varfile
C:/Assets/testProjVar.xml