loading table of contents...

4.3.5.1. Running performance tests

In order to make performance testing as easy as possible, the workspace includes a module with a preconfigured JMeter test, cae-performance-test.

Module description

An example module for a ready-to-run performance test for CAE web applications.

It uses JMeter as well as a Maven plugin for analyzing and providing results. To keep the example as simple as possible, it is designed to run against the Preview CAE. Typically, Live CAEs running against a Replication Live Server are performance tested on appropriate (live) hardware from a remote machine. Also, plugin configuration and executions are configured in a profile performance so that no performance test is executed when building the workspace with mvn package or mvn install.

The module uses the jmeter-maven-plugin to run the JMeter test and the jmeter-analysis-maven-plugin to analyze the results. It can analyze JMeter result files and produces a result HTML, easy to read images with result data and summary CSV files.

Prerequisites

If the performance test is used as is, the following prerequisites must be fulfilled:

  • The Content Management Server must be started

  • The Preview CAE must be started

Execution

To execute the performance test, run

$ mvn verify -Pperformance
Configuration

If you want to know more about configuration possibilities,

  • Have a look at the pom.xml file where every used configuration element is fully documented

  • If you want to run your tests against another host and port just override the properties webapp.host and webapp.port, for example mvn verify -Pperformance -Dwebapp.host=myHost -Dwebapp.port=4711

  • To use individual URLs for the performance test, you can provide an arbitrary file with URL lists and configure the test plan to use it with the property webapp.uris, for example mvn verify -Pperformance -Dwebapp.uris=path-to-uri-file. The file contains a list of URI paths; that is without protocol, host and port information.

Test URLs

To automatically generate test URLs for the CAE, the SiteMapController can be used. See section Sitemap in the [Blueprint Concepts Guide].

To manually generate a list of test URLs, spider the site you want to test and save the URIs.