艰难的一天

艰难的第2天

艰难的第2天是一个应用程序，它允许您压力测试AEM实例的限制。 它可以随默认测试包一起开箱即用，也可以根据您的测试需求对其进行配置。 您可以观看此录制以了解应用程序的演示。

如何运行艰难的第2天

从Adobe存储库下载Tough Day 2的最新版本。 下载应用程序后，您可以通过提供host参数即时运行该应用程序。 在以下示例中， AEM实例在本地运行，以便使用localhost值：

java -jar toughday2.jar --host=localhost

添加参数后运行的默认包名为toughday。 它包含以下用例：

• 为其创建页面和Live Copy（包括转出）
• 获取主页
• 在querybuilder中运行查询
• 创建资产层次结构
• 删除资产

包中包含15%的写入操作和85%的读取操作。

要运行包测试， Tough Day 2将安装其默认内容包。 通过将installsamplecontent参数设置为false可以避免出现这种情况，但请记住，您还应该更改要运行的测试的默认路径。 如果在没有参数的情况下运行jar，则Tough Day 2会显示帮助信息。

通常，您可以通过以下模式使用应用程序：

java -jar toughday2.jar [--help | --help_full | --help_tests | --help_publish]  [<global arguments> | <actions> | --runmode | --publishmode]

获取帮助

艰难的第2天提供了从命令行访问的各种帮助选项。 例如：

java -jar toughday2.jar --help_full

在下表中，您可以找到相关帮助参数。

全局参数

艰难的第2天提供了全局参数，用于设置或更改测试环境。 这包括目标主机、端口号、使用的协议、实例的用户和密码等。 例如：

java -jar toughday2.jar --host=host --protocol=https --port=4502 --duration=30m --dryrun=true 

您可以在以下列表中找到相关参数：

自定义

可通过两种方式实现定制：命令行参数或yaml配置文件。 配置文件通常用于大型自定义包，并将覆盖第2天的严格默认参数。命令行参数覆盖配置文件和缺省参数。

保存测试配置的唯一方法是以yaml格式复制该配置。 有关更多详细信息，请参阅以下部分中的此toughday.yaml配置和yaml配置示例。

添加新测试

如果您不想使用默认的toughday包，可以使用add参数添加您选择的测试。 以下示例显示如何使用命令行参数或yaml配置文件添加CreateAssetTreeTest测试。

使用命令行参数：

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest

使用yaml配置文件：

globals:
  host : localhost
tests:
  - add : CreateAssetTreeTest

添加同一测试的多个实例

您还可以添加和运行同一测试的多个实例，但每个实例必须具有唯一的名称。 以下示例显示如何使用命令行参数或yaml配置文件添加同一测试的两个实例。

使用命令行参数：

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest name=FirstAssetTree --add CreateAssetTreeTest name=SecondAssetTree

使用yaml配置文件：

globals:
  host : localhost
tests:
  - add : CreateAssetTreeTest
    properties:
      name : FirstAssetTree
  - add : CreateAssetTreeTest
    properties:
      name : SecondAssetTree

更改测试属性

如果需要更改一个或多个测试属性，可将该属性添加到命令行或yaml配置文件中。 要查看所有可用的测试属性，请将--help <TestClass/PublisherClass>参数添加到命令行，例如：

java -jar toughday2.jar --help CreatePageTreeTest

请记住，yaml配置文件将覆盖Tough Day 2默认参数，命令行参数将覆盖配置文件和默认参数。

以下示例显示如何使用命令行参数或yaml配置文件更改CreatePageTreeTest测试的template属性。

使用命令行参数：

java -jar toughday2.jar --host=localhost --add CreatePageTreeTest template=/conf/toughday-templates/settings/wcm/templates/toughday-template

使用yaml配置文件：

globals:
  host : localhost
tests:
  - add : CreatePageTreeTest
    properties:
      template : /conf/toughday-templates/settings/wcm/templates/toughday-template

使用预定义的测试包

以下示例显示如何向预定义包添加测试，以及如何从预定义包重新配置和排除现有测试。

您可以使用add参数向预定义包中添加新测试，并指定目标预定义包。

使用命令行参数：

java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest

使用yaml配置文件：

globals:
  host : localhost
  suite : toughday
tests:
  - add : CreatePageTreeTest

给定包中的现有测试也可以使用config* *参数进行重新配置。 请注意，您还必须指定测试的包名称和实际名称（而非测试类名称）。 可以在测试类的name属性中找到测试名称。 有关如何查找测试属性的更多详细信息，请阅读更改测试属性一节。

在以下示例中， CreatePageTreeTest（名为UploadAsset）的默认资产标题将更改为“NewAsset”。

使用命令行参数：

java -jar toughday2.jar --host=localhost --suite=toughday --config UploadAsset title=NewAsset

使用yaml配置文件：

globals:
  host : localhost
  suite : toughday
tests:
  - config : UploadAsset
    properties :
      title : NewAsset 

此外，您还可以使用exclude参数从默认配置中删除预定义包或发布者的测试。 请注意，您还必须指定测试的包名称和实际名称（而不是测试C lass名称）。 可以在测试类的name属性中找到测试名称。 在以下示例中，将从toughday包中删除CreatePageTreeTest（名为UploadAsset）测试。

使用命令行参数：

java -jar toughday2.jar --host=localhost --suite=toughday --exclude UploadAsset

使用yaml配置文件：

globals:
  host : localhost
  suite : toughday
tests:
  - exclude : UploadAsset 

运行模式

艰难的第2天可以在以下模式之一中运行：normal​和​常量负载。

normal​运行模式具有两个参数：

• concurrency — 并发表示Tough第2天为测试执行创建的线程数。在这些线程上，将执行测试，直到持续时间耗尽或不再执行测试为止。

• waittime — 在同一线程上连续执行两次测试之间的等待时间。值必须以毫秒为单位表示。

以下示例显示如何使用命令行添加参数：

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest --runmode=normal concurrency=20

或者使用yaml配置文件：

runmode:
  type : normal
  waittime : 300
  concurrency : 200

恒定负载​运行模式与正常运行模式不同，它生成的是启动测试执行的恒定数量，而不是恒定数量的线程。 可以使用具有相同名称的运行模式参数来设置负载。

测试选择

两种运行模式的测试选择过程相同，其方式如下：所有测试都具有weight属性，该属性可确定线程中执行的可能性。 例如，如果我们有两个测试，一个测试的权重为5，另一个测试的权重为10，则执行后者的可能性是前者的两倍。

此外，测试可以具有count属性，该属性将执行次数限制为给定数量。 在传递此数字后，将不再执行测试。 所有已运行的测试实例都将按照配置的方式完成运行。 以下示例显示如何在命令行中或使用yaml配置文件添加这些参数。

java -jar toughday2.jar --host=localhost --add CreateAssetTreeTest weight=5 --add CreatePageTreeTest weight=10 count=100 --runmode=normal concurrency=20 

或

- add : CreateAssetTreeTest
    properties :
      name : UploadAsset
      weight : 5
      base : 3
      foldertitle : IAmAFolder
      assettitle : IAmAnAsset
      count : 100

练习

练习将解析所有给定输入（命令行参数或配置文件），并将其与默认值合并，然后输出结果。 它不执行任何测试。

java -jar toughday2.jar --host=localhost --suite=toughday --add CreatePageTreeTest --dryrun=true

输出

Tough Day 2可输出测试量度和日志。 有关更多详细信息，请阅读以下章节。

测试量度

艰难的第2天当前报告了9个可评估的测试量度。 只有在成功运行后，才会报告具有​*​符号的量度：

这些量度是在发布者的帮助下编写的，发布者可以使用add参数进行添加（与添加测试类似）。 目前有两个选项：

• CSVPublisher — 输出是CSV文件。
• ConsolePublisher — 输出将显示在控制台中。

默认情况下，两个发布者均处于启用状态。

此外，还有两种报告量度的模式：

• simple​发布模式 — 报告从执行开始到发布点的结果。
• intervals​发布模式 — 报告给定时间范围内的结果。 可以使用​interval​发布模式参数设置时间范围。

以下示例显示如何在命令行中或使用yaml配置文件来配置intervals参数。

使用命令行参数：

java -jar toughday2.jar --host=localhost --add CreatePageTreeTest --publishmode type=intervals interval=10s 

使用yaml配置文件：

publishmode:
     type : intervals 
     interval : 10s 
     tests: 
        -add : CreatePageTreeTest

记录

Tough Day 2会在运行Tough Day 2的同一目录中创建日志文件夹。 此文件夹包含两种类型的日志：

• toughday.log:包含与应用程序状态、调试信息和全局消息相关的消息。
• toughday_<testname>.log:与指定测试相关的消息。

日志不会被覆盖，后续运行会将消息附加到现有日志。 日志具有多个级别，有关详细信息，请参阅 [loglevel parameter](/docs/experience-manager-64/sites-developing/tough-day.md#global-parameters)。