设置和启动命令行适配器

使用命令行适配器,您可以将目标测试机器用于命令行执行。必须在目标测试机器上注册该适配器,才能运行命令行脚本。

开始之前

要点: 您可能在目标测试机器上运行多个适配器,但每个适配器必须是具有唯一名称(在 -adapterName 选项中指定)的单独进程。

关于此任务

必须在目标测试机器上设置和启动命令行适配器。
命令行执行设置

过程

对目标测试机器完成以下步骤:

  1. 从安装机器上获取 install-location\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip 文件。 对服务器具有读访问权的服务器管理员可能需要为您取得该压缩文件。
  2. 将 RQMCommmandLineAdapter.zip 文件解压缩至目标测试机器上的某个文件夹。
  3. 可选: 定制显示在测试用例执行记录或测试套件执行记录中的实际脚本结果。有关更多信息,请参阅定制命令行适配器。
  4. 如果您使用 V5.0 或更高版本并且希望命令行适配器并行服务多个请求,那么可启用该功能(缺省情况下会禁用该功能)。 可通过添加属性来启用该功能。如果您不添加属性或者如果您将该属性设置为无效值,那么向适配器发送多个测试时,会按照接收到这些测试的顺序排队运行。
    提示: 使用命令行适配器来并行运行测试是长时间运行测试的最佳方式。适配器将根据其容量依次选择测试,以运行每个测试。它将选择脚本,开始运行该脚本,然后选择要运行的其他脚本。如果脚本简短,那么可能会按顺序运行。
    要对命令行适配器启用并行测试执行,请执行以下步骤:
    1. 在测试目标机器上,打开 CommandLine.properties 文件或同等首选项文件。
    2. 将以下属性添加至文件:com.ibm.rqm.commandline.maxservedrequests=N

      其中 N 是要同时运行的最大测试数。

    3. 如果命令行适配器处于活动状态,请将其重新启动。
    当达到所指定的最大值时,那么将对发送给适配器的测试进行排队以在空间可用时运行。
  5. 启动命令行适配器。
    • 要首次启动命令行适配器,请执行以下步骤:
      Windows 图标
      使用如下所示的命令行参数来运行批处理文件:
      C:\ start.bat -repository  https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
      [-projectArea project area] [-sleepTime sleep
      time]	[-configFile configuration file]
      有关更多信息,请参阅定制命令行适配器。
      Linux 图标
      Unix 图标
      使用如下所示的命令行参数来运行 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 文件重新启动命令行适配器,请执行以下步骤:
      Windows 图标
      :不带任何参数地运行批处理文件:
      C:\ start.bat
      Linux 图标
      Unix 图标
      :不带命令行参数地运行 shell 脚本:
      $ start.sh
      注: 配置文件预期位于从中启动适配器的目录中。

结果

系统会生成一则像此消息一样的消息:
正在启动适配器…
配置文件 adapterConfig.ini 不存在,适配器将使用所传递的参数
已成功地创建 HTTP 客户机
适配器现在已连接
已创建命令行适配器

下一步做什么

您可以通过单击执行 > 适配器控制台来验证测试程序机器中质量管理应用程序上的适配器状态。在尝试对正在运行的命令行适配器运行测试之前,请确保状态呈绿色。

视频图标 观看视频

CLM 播放列表
Jazz.net 频道
用户培训频道

学习图标 学习更多

CLM 学习周期
Agile 学习周期
学习周期

提问图标 提问

Jazz.net 论坛
developerWorks 论坛

支持图标 获取支持

Support Portal
Deployment wiki
Support 博客