使用命令行适配器,您可以将机器用作命令行执行的目标测试机器。必须在目标测试机器上注册该适配器,才能运行命令行脚本。
开始之前
命令行适配器将在任何至少支持
Java V1.5 或更高版本的平台上运行。必须可以访问目标测试机器上的路径中的可执行文件
java.exe。还必须知道下列信息,才能启动适配器:
- Jazz 存储库 URL,通常为 https://qmserver:port/qm
- 具有相应许可证的用户标识,以作为适配器进行登录
- 此用户的密码
- 项目区域的名称(如果这不是缺省的 Quality Manager 项目区域)
最后,质量管理应用程序必须正在服务器上运行。
注: 您可能有多个适配器运行在目标测试机器上,但每个适配器必须是具有唯一名称(在 -adapterName 选项中指定)的单独进程。
关于此任务
必须在目标测试机器上设置和启动命令行适配器。
在目标测试机器上完成此任务。
过程
- 从安装机器上获取 install-location\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip 文件。
注: 对服务器具有读访问权的服务器管理员可能需要为您取得该压缩文件。
- 将 RQMCommmandLineAdapter.zip 文件解压缩至目标测试机器上的某个文件夹。
- 可选: 按照定制命令行适配器描述的方式,定制出现在测试用例执行记录或测试套件执行记录中的实际脚本结果。
- 启动命令行适配器。
如果是首次启动命令行适配器,请执行下列操作:
利用如下所示的命令行参数来运行批处理文件:
C:\ start.bat -repository https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
[-projectArea project area] [-sleepTime sleep
time] [-configFile configuration file]
定制命令行适配器
利用如下所示的命令行参数来运行 shell 脚本:
$ start.sh -repository https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
[-projectArea project area] [-sleepTime sleep
time] [-configFile configuration file]
其中:
- qmserver:质量管理服务器的主机名或 IP 地址。
- port:用于运行质量管理服务器的端口。
- userid:具有许可证(用于运行适配器)的质量管理的注册用户标识。
- password:所提交的用户标识的密码。
- adapter-name:用户已指定的适配器名称。
- project area:正在登录的项目的名称。
- sleep time:任务轮询之间的轮询时间间隔。缺省设置是 5 秒钟。
- configuration file:用于存储和读取此适配器设置的文件。缺省文件名为 config.ini。
该适配器会生成一个配置文件(
config.ini 文件或
-configFile 选项中所指定的文件)以包含注册信息。当适配器重新启动时,会复用此信息。
如果要从 config.ini 文件重新启动命令行适配器,请执行下列操作:
:不带任何参数地运行批处理文件:
C:\ start.bat
:不带命令行参数地运行 shell 脚本:
$ start.sh
注: 配置文件预期位于从中启动适配器的目录中。
结果
系统会生成一则类似于此消息的消息:
正在启动适配器…
配置文件 adapterConfig.ini 不存在,适配器将使用所传递的参数
已成功地创建 HTTP 客户机
适配器现在已连接
已创建命令行适配器
下一步做什么
您可以通过单击来验证测试程序机器中质量管理应用程序上的适配器状态。请先确保状态为“绿色”,然后再尝试对运行中的命令行适配器运行测试。