jmeter/xdocs/changes.xml

<?xml version="1.0"?>
<!--
  ~ Licensed to the Apache Software Foundation (ASF) under one or more
  ~ contributor license agreements.  See the NOTICE file distributed with
  ~ this work for additional information regarding copyright ownership.
  ~ The ASF licenses this file to you under the Apache License, Version 2.0
  ~ (the "License"); you may not use this file except in compliance with
  ~ the License.  You may obtain a copy of the License at
  ~
  ~ http://www.apache.org/licenses/LICENSE-2.0
  ~
  ~ Unless required by applicable law or agreed to in writing, software
  ~ distributed under the License is distributed on an "AS IS" BASIS,
  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  ~ See the License for the specific language governing permissions and
  ~ limitations under the License.
  -->

<!DOCTYPE document
[
<!ENTITY hellip   "&#x02026;" >
<!ENTITY rarr     "&#x02192;" >
<!ENTITY vellip   "&#x022EE;" >
<!ENTITY nbsp     "&#x00A0;" >
]>
<document>
<properties>
    <author email="dev AT jmeter.apache.org">JMeter developers</author>
    <title>Changes</title>
</properties>
<body>
<section name="Changes">
<style type="text/css"><!--
h2 { color: #960000; }
h3 { color: #960000; }
--></style>
<note>
<b>This page details the changes made in the current version only.</b>
<br></br>
Earlier changes are detailed in the <a href="changes_history.html">History of Previous Changes</a>.
</note>


<!--  =================== 5.5 =================== -->

<h1>Version 5.5</h1>
<p>
Summary
</p>
<ul>
<li><a href="#New and Noteworthy">New and Noteworthy</a></li>
<li><a href="#Incompatible changes">Incompatible changes</a></li>
<li><a href="#Bug fixes">Bug fixes</a></li>
<li><a href="#Improvements">Improvements</a></li>
<li><a href="#Non-functional changes">Non-functional changes</a></li>
<li><a href="#Known problems and workarounds">Known problems and workarounds</a></li>
<li><a href="#Thanks">Thanks</a></li>

</ul>

<ch_section>New and Noteworthy</ch_section>
<p>JMeter now supports Java 17</p>

<p>JMeter 5.5 ships with log4j2 2.17.2</p>

<p>New component: <code><a href="./usermanual/component_reference.html#Open_Model_Thread_Group">Open Model Thread Group</a></code>
allows creating load profiles with variable load.</p>

<p>For example, if you need to gradually increase load from <code>0/sec</code> to <code>10/sec</code> during <code>minute</code>
you could previously use <code>Thread Group + Timer</code> combinations. However, then you need to compute
the expected number of threads, ensure they are created only when needed, and so on.</p>

<p>With <code>Open Model Thread Group</code> you can configure the same load profile as <code>rate(0/sec) random_arrivals(1 minute) rate(10/sec)</code>.
The thread group would spawn threads as needed to drive the configured load.
The load profile can use properties, so you can launch the same script with slightly different load levels,
however, the profile can't be updated while the test is running.
</p>

<p>The new thread group is experimental in JMeter 5.5, so please feel free to submit your feedback.</p>
<figure width="1398" height="1117" image="open_model_thread_group.png">Open Model Thread Group sample</figure>

<ch_title>Core improvements</ch_title>
<p>Kotlin language is now used in some core classes and tests (e.g. Open Model Thread Group).
    JMeter is compiled with <code>apiTarget=1.5</code>, and it ships with <code>kotlin-stdlib</code> 1.6.
</p>

<p><a href="https://github.com/JetBrains/lets-plot-kotlin">lets-plot-kotlin</a> charting library is added,
    so it will be easier to refine and create new charts in UI in the future.
</p>

<ch_section>Improvements</ch_section>

<h3>Thread Groups</h3>
<ul>
  <li>New component: <code><a href="./usermanual/component_reference.html#Open_Model_Thread_Group">Open Model Thread Group</a></code></li>
</ul>

<h3>HTTP Samplers and Test Script Recorder</h3>
<ul>
  <li><bug>65027</bug>Detect mime-type for files automatically when adding files to HTTP Sampler</li>
  <li><bug>65020</bug>HTTP Sampler/Files upload tab - add missing buttons</li>
  <li><pr>650</pr>HTTP Sampler timestamp fix when exception is caught. Contributed by Konstantin Kalinin (konstantin at kkalinin.pro)</li>
  <li><bug>65328</bug><pr>666</pr>HTTP 308 Permanent Redirect is not supported. Contributed by
    Baptiste Gaillard (baptiste.gaillard at gmail.com)</li>
</ul>

<h3>Other samplers</h3>
<ul>
  <li><bug>65149</bug><pr>644</pr>Encode the personal part of email addresses in SMTP Sampler</li>
  <li><pr>638</pr>Various additions to the Bolt Sampler. Added <code>transaction timeout</code>, <code>database</code>
    option required for Neo4j 4.x (with multi-database support) and <code>access mode</code> option, that allows running
    against a Neo4j Enterprise Causal Cluster. Contributed by David Pecollet (david.pecollet at gmail.com)</li>
</ul>

<h3>Controllers</h3>
<ul>
  <li><pr>665</pr>Increase visible lines of code in <code>IfController</code> and <code>WhileController</code>.
    Based on an idea by David Getzlaff (david.getzlaff at t-systems.com>).</li>
</ul>

<h3>Listeners</h3>
<ul>
  <li><bug>64988</bug>Sort properties and variables in a human expected order for DebugPostProcessor and DebugSampler</li>
  <li><bug>63061</bug>Sort View Results in Table in a human expected order</li>
</ul>

<h3>Timers, Assertions, Config, Pre- &amp; Post-Processors</h3>
<ul>
    <li><pr>638</pr>Bolt Connection Configuration: added <code>ConnectionPoolMaxSize</code> parameter. Contributed by
        David Pecollet (david.pecollet at gmail.com)</li>
    <li><bug>65515</bug>Allow pooling of Prepared Statements in JDBC</li>
    <li><bug>65299</bug>JSONPathAssertion attributes are out of order/Compare JSON objects and
        not their string representations.</li>
</ul>

<h3>Report / Dashboard</h3>
<ul>
  <li><bug>65353</bug>Make the estimator used for calculating percentiles on the dashboard configurable</li>
  <li><bug>65885</bug>HTML Report: Error report displays wrong failure message when Response Assertion checks Ignore Status and response code is not 200</li>
</ul>

<h3>General</h3>
<ul>
  <li><bug>61805</bug><pr>663</pr>Add simple HTTP request template. Contributed by Ori Marko (orimarko at gmail.com)</li>
  <li><bug>65611</bug><pr>673</pr>Add support for IPv6 addresses when specifying a remote worker node. Based on a patch by Peter Wong (peter.wong at csexperts.com)</li>
  <li>Reduce memory consumption by the logging panel (disable undo events for it)</li>
  <li><bug>63620</bug><pr>694</pr>Fix GUI freeze when viewing response body with long line breaks</li>
</ul>

<ch_section>Non-functional changes</ch_section>
<ul>
  <li>Added Kotlin 1.6.0 for JMeter engine implementation (apiVersion=1.5). The set of JSR 223 languages is intact.</li>
  <li><bug>65128</bug><pr>643</pr>Add missing documentation about <code>Same user on each iteration</code> for Thread Groups. Contributed by njkuzas.</li>
  <li><pr>648</pr>Updated xmlgraphics-commons to 2.6 (from 2.3). Contributed by Stefan Seide (stefan at trilobyte-se.de)</li>
  <li><pr>655</pr><pr>667</pr><pr>675</pr><pr>698</pr>Updated x-stream to 1.4.19 (from 1.4.15). Contributed by Stefan Seide (stefan at trilobyte-se.de)</li>
  <li><pr>656</pr><pr>668</pr>Updated json-smart to 2.4.8 (from 2.3), accessors-smart to 2.4.8 (from 1.2) and asm 9.1 (from 9.0). Contributed by Stefan Seide (stefan at trilobyte-se.de)</li>
  <li><bug>64831</bug>Log truststore entries in debug level for logger <code>org.apache.jmeter.util.keystore.JmeterKeyStore</code></li>
  <li><bug>65232</bug>Hide splash screen when an error is displayed because the test plan could not be parsed.</li>
  <li>Updated Groovy to 3.0.9 (from 3.0.7).</li>
  <li>Updated Darklaf to 2.7.3 (from 2.5.4).</li>
  <li>Updated Apache ActiveMQ to 15.6.4 (from 15.6.0).</li>
  <li>Updated Asm to 9.2 (from 9.1).</li>
  <li>Updated Bouncycastle to 1.69 (from 1.67).</li>
  <li>Updated Caffeine to 2.9.3 (from 2.8.8).</li>
  <li>Updated Apache commons-dbcp2 to 2.9.0 (from 2.8.0).</li>
  <li>Updated Apache commons-io to 2.11.0 (from 2.8.0).</li>
  <li>Updated Apache commons-lang3 to 3.12.0 (from 3.11).</li>
  <li>Updated Apache commons-net to 3.8.0 (from 3.7.2).</li>
  <li>Updated Apache commons-pool2 to 2.11.1 (from 2.9.0).</li>
  <li>Updated equalsverifier to 3.9 (from 3.4.2).</li>
  <li>Updated Apache Freemarker to 2.3.31 (from 2.3.30).</li>
  <li>Updated hsqldb to 2.5.2 (from 2.5.0).</li>
  <li>Updated Apache HttpClient to 4.5.13 (from 4.5.12).</li>
  <li>Updated Apache HttpCore to 4.4.15 (from 4.4.13).</li>
  <li>Updated jacoco to 0.8.7 (from 0.8.5).</li>
  <li>Updated json-path to 2.6.0 (from 2.4.0).</li>
  <li>Updated jsoup to 1.14.3 (from 1.13.1).</li>
  <li>Updated JUnit to 4.13.2 and 5.8.2 (from 4.13.1 and 5.7.0).</li>
  <li>Updated Apache log4j2 to 2.17.2 (from 2.13.3).</li>
  <li>Updated Miglayout to 5.3 (from 5.2).</li>
  <li>Updated Neo4j Java driver to 4.4.4 (from 4.2.0).</li>
  <li>Updated Objenesis to 3.2 (from 2.6).</li>
  <li>Updated ktlint to 0.40.0</li>
  <li>Updated PH CSS and PH commons to 6.5.4 and 10.1.6 (from 6.2.3 and 9.5.1).</li>
  <li>Updated RSyntaxTextArea to 3.1.6 (from 3.1.1).</li>
  <li>Updated SLF4J to 1.7.36 (from 1.7.30).</li>
  <li>Updated SvgSalamander to 1.1.2.4 (from 1.1.2.1).</li>
  <li><pr>698</pr>Updated Apache Tika to 1.28.1 (from 1.26).</li>
  <li>Updated WireMock-JRE8 to 2.30.0 (from 2.24.1).</li>
  <li>Updated com.github.vlsi.vlsi-release-plugins 1.76 (from 1.74).</li>
  <li>Updated jackson to 2.13.1 (from 2.10.5)</li>
  <li>Updated jmespath to 0.5.1</li>
  <li>Updated Saxon-HE to 11.2 (from 9.9.1-8)</li>
  <li>Updated Apache xmlgraphics commons to 2.7 (from 2.6)</li>
  <li><pr>671</pr>Move example definition of property <code>jmeter.reportgenerator.statistic_window</code>
     to <code>user.properties</code>, as it is read from that place.
     Contributed by Rithvik Patibandla (rithvikp98 at gmail.com)</li>
  <li><bug>65456</bug>Updated commons-jexl 3 to 3.2.1 (from 3.1). Contributed by Ori Marko (orimarko at gmail.com>)</li>
  <li><pr>654</pr>Try do give better feedback while loading keystores</li>
  <li><pr>672</pr>Add more details to documentation for timeShift function. Contributed by Mariusz (mawasak at gmail.com)</li>
  <li>Updated Gradle to 7.3 (from 7.2)</li>
  <li><pr>689</pr>Code clean up in StringFromFile. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)</li>
  <li><pr>690</pr>Refactor a few unit tests. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)</li>
  <li><pr>692></pr>Fix a few deprecation warnings for Gradle. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)</li>
</ul>

 <!-- =================== Bug fixes =================== -->

<ch_section>Bug fixes</ch_section>

<h3>HTTP Samplers and Test Script Recorder</h3>
<ul>
  <li><bug>65310</bug>Don't let users override <code>multipart/form-data</code> <code>content-type</code>
    header in HC4 sampler.</li>
  <li><bug>65363</bug><code>NullPointerException</code> in <code>HTTPHC4Impl$ManagedCredentialsProvider.getAuthorizationForAuthScope</code> when <code>401</code> response from remote and <code>httpclient4.auth.preemptive=false</code></li>
  <li><bug>65692</bug>HTTP(s) Test Script Recorder: Enable setting enabled cipher suite and enabled protocols on SSLContext/ Align ssl properties between Java and HC4 impl</li>
  <li><bug>65108</bug>Support JMeter variables in <a href="./usermanual/component_reference.html#HTTP_Request">GraphQL HTTP Request</a></li>
  <li><bug>65864</bug>Catch NullPointerException from JSoup when recording a test plan</li>
</ul>

<h3>Other Samplers</h3>
<ul>
  <li><bug>65152</bug>OS Process Sampler - Cannot <code>Add from Clipboard</code> Command parameters</li>
  <li><pr>638</pr>Bolt Sampler: fixed error displaying results when "Record Query Results" is enabled. Contributed by
        David Pecollet (david.pecollet at gmail.com)</li>
</ul>

<h3>Controllers</h3>
<ul>
</ul>

<h3>Listeners</h3>
<ul>
  <li><bug>64962</bug>Save CSV sub-results recursively from View Results Tree</li>
  <li><bug>65784</bug>No Graphs displayed in Aggregate Report/Response Time Graph</li>
  <li><bug>65884</bug>GUI doesn't display response for multipart request <em>manually</em> encoded</li>
</ul>

<h3>Timers, Assertions, Config, Pre- &amp; Post-Processors</h3>
<ul>
  <li><bug>65257</bug>JMESPathExtractor writes error log entries if JMESPath filter returns empty result</li>
  <li><bug>65259</bug>JMESPathExtractor Attribute <code>Match No.</code> Required</li>
  <li><bug>65269</bug>JSON Extractor and JSON JMESPath Extractor ignore sub-samples</li>
  <li><bug>65352</bug>Warning logged when Boundary Extractor doesn't find any match</li>
  <li><bug>65681</bug>Use default values for null values when extracting with JSONPostProcessor</li>
  <li>Allow setters in ConstantThroughputTimer to updating the values during the run time</li>
  <li><bug>65782</bug>Use correct message format for MessageFormat in HTMLAssertion</li>
  <li><bug>65794</bug>JSON Assertion always successful with indefinite paths</li>
</ul>

<h3>Functions</h3>
<ul>
</ul>

<h3>I18N</h3>
<ul>
</ul>

<h3>Report / Dashboard</h3>
<ul>
</ul>

<h3>Documentation</h3>
<ul>
</ul>

<h3>General</h3>
<ul>
  <li><bug>64318</bug>DNS Cache Manager - custom DNS resolver does not use system resolver by default</li>
  <li><pr>641</pr><pr>698</pr>Updated xercesImpl to 2.12.2 (from 2.12.0). Based on patch by Stefan Seide (stefan at trilobyte-se.de).</li>
  <li><pr>645</pr>Add escaping for new lines in <code>AbstractInfluxdbMetricsSender</code>. Contributed by David Getzlaff (david.getzlaff at t-systems.com>)</li>
  <li><bug>65198</bug>Can't copy generated function from FunctionHelper</li>
  <li><pr>658</pr>Improve javadoc. Contributed by Ori Marko (orimarko at gmail.com)</li>
  <li><pr>661</pr>Fix wording in doc. Contributed by BugKing (wangzhen at fit2cloud.com)</li>
  <li><pr>664</pr>Allow whitespace in path. Contributed by Till Neunast (github.com/tilln)</li>
  <li><bug>65270</bug>POST <code>application/x-www-form-urlencoded</code> cURL code generated from Postman is not imported correctly</li>
  <li>Silence warnings of missing font Arial on startup under linux</li>
  <li><bug>65300</bug>IllegalAccessError when opening file dialog with Java 16</li>
  <li><bug>65336</bug>Blank labels when different elements had the same name</li>
  <li><bug>65522</bug>Restart doesn't work, when parameters contain spaces</li>
  <li><bug>63914</bug>Simplify :src:dist:clean configuration, ensure /lib/junit/test.jar is removed on clean</li>
</ul>

 <!--  =================== Thanks =================== -->

<ch_section>Thanks</ch_section>
<p>We thank all contributors mentioned in bug and improvement sections above:
</p>
<ul>
  <li>Stefan Seide (stefan at trilobyte-se.de)</li>
  <li>njzukas (github.com/njzukas)</li>
  <li>David Getzlaff (david.getzlaff at t-systems.com>)</li>
  <li>Konstantin Kalinin (konstantin at kkalinin.pro)</li>
  <li>David Pecollet (david.pecollet at gmail.com)</li>
  <li>Ori Marko (orimarko at gmail.com)</li>
  <li>BugKing (wangzhen at fit2cloud.com)</li>
  <li>Till Neunast (github.com/tilln)</li>
  <li>Baptiste Gaillard (baptiste.gaillard at gmail.com)</li>
  <li>Rithvik Patibandla (rithvikp98 at gmail.com)</li>
  <li>Mariusz (mawasak at gmail.com)</li>
  <li>peter.wong@csexperts.com</li>
  <li>Woonsan Ko (woonsan.ko at bloomreach.com)</li>
  <li>Chromico Rek (atech5122 at gmail.com)</li>
  <li>Magnus Spångdal (magnus.spangdal as avanza.se)</li>
  <li>Piotr Smietana (piotrsmietana1998 at gmail.com)</li>
  <li>Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)</li>
</ul>
<p>We also thank bug reporters who helped us improve JMeter.</p>
<ul>
  <li>Nikola Aleksic (nalexic at gmail.com)</li>
  <li>Vladimir Rosu (rosuvladimir at gmail.com)</li>
</ul>
<p>
Apologies if we have omitted anyone else.
</p>
 <!--  =================== Known bugs or issues related to JAVA Bugs =================== -->

<ch_section>Known problems and workarounds</ch_section>
<ul>
<li>The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).</li>

<li>
The numbers that appear to the left of the green box are the number of active threads / total number of threads,
the total number of threads only applies to a locally run test, otherwise it will show <code>0</code> (see <bugzilla>55510</bugzilla>).
</li>

<li>
Note that under some windows systems you may have this WARNING:
<source>
java.util.prefs.WindowsPreferences
WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs at root 0
x80000002. Windows RegCreateKeyEx(&hellip;) returned error code 5.
</source>
The fix is to run JMeter as Administrator, it will create the registry key for you, then you can restart JMeter as a normal user and you won't have the warning anymore.
</li>

<li>
You may encounter the following error:
<source>java.security.cert.CertificateException: Certificates does not conform to algorithm constraints</source>
 if you run a HTTPS request on a web site with a SSL certificate (itself or one of SSL certificates in its chain of trust) with a signature
 algorithm using MD2 (like <code>md2WithRSAEncryption</code>) or with a SSL certificate with a size lower than 1024 bits.
This error is related to increased security in Java 8+.
<br></br>
To allow you to perform your HTTPS request, you can downgrade the security of your Java installation by editing
the Java <code>jdk.certpath.disabledAlgorithms</code> property. Remove the MD2 value or the constraint on size, depending on your case.
<br></br>
This property is in this file:
<source>JAVA_HOME/jre/lib/security/java.security</source>
See  <bugzilla>56357</bugzilla> for details.
</li>

<li>
Under Mac OSX Aggregate Graph will show wrong values due to mirroring effect on numbers.
This is due to a known Java bug, see Bug <a href="https://bugs.openjdk.java.net/browse/JDK-8065373" >JDK-8065373</a>
The fix is to use JDK8_u45 or later.
</li>

<li>
View Results Tree may fail to display some HTML code under HTML renderer, see <bugzilla>54586</bugzilla>.
This is due to a known Java bug which fails to parse "<code>px</code>" units in row/col attributes.
See Bug <a href="https://bugs.openjdk.java.net/browse/JDK-8031109" >JDK-8031109</a>
The fix is to use JDK9 b65 or later.
</li>

<li>
JTable selection with keyboard (<keycombo><keysym>SHIFT</keysym><keysym>up/down</keysym></keycombo>) is totally unusable with Java 7 on Mac OSX.
This is due to a known Java bug <a href="https://bugs.openjdk.java.net/browse/JDK-8025126" >JDK-8025126</a>
The fix is to use JDK 8 b132 or later.
</li>

<li>
Since Java 11 the JavaScript implementation <a href="https://openjdk.java.net/jeps/335">Nashorn has been deprecated</a>.
Java will emit the following deprecation warnings, if you are using JavaScript based on Nashorn.
<source>
Warning: Nashorn engine is planned to be removed from a future JDK release
</source>
To silence these warnings, add <code>-Dnashorn.args=--no-deprecation-warning</code> to your Java arguments.
That can be achieved by setting the enviroment variable <code>JVM_ARGS</code>
<source>
export JVM_ARGS="-Dnashorn.args=--no-deprecation-warning"
</source>
</li>

<li>
With Java 15 the JavaScript implementation <a href="https://openjdk.java.net/jeps/372">Nashorn has been removed</a>. To add back a JSR-223 compatible JavaScript engine you have two options:
  <dl>
    <dt>Use Mozilla Rhino</dt>
    <dd>Copy <a href="https://github.com/mozilla/rhino/releases/download/Rhino1_7_13_Release/rhino-engine-1.7.13.jar">rhino-engine-1.7.13.jar</a> into <code>$JMETER_HOME/lib/ext</code>.</dd>
    <dt>Use OpenJDK Nashorn</dt>
    <dd>
      The OpenJDK Nashorn implementation comes as a module. To use it, you will have to download it and add it to the module path. A hacky way to download the version 15.0 (or later) and its dependencies and set the module path is outlined below:
      <source>
mkdir lib/modules
pushd lib/modules
wget https://repo1.maven.org/maven2/org/openjdk/nashorn/nashorn-core/15.3/nashorn-core-15.3.jar
wget https://repo1.maven.org/maven2/org/ow2/asm/asm/9.2/asm-9.2.jar
wget https://repo1.maven.org/maven2/org/ow2/asm/asm-commons/9.2/asm-commons-9.2.jar
wget https://repo1.maven.org/maven2/org/ow2/asm/asm-util/9.2/asm-util-9.2.jar
wget https://repo1.maven.org/maven2/org/ow2/asm/asm-tree/9.2/asm-tree-9.2.jar
wget https://repo1.maven.org/maven2/org/ow2/asm/asm-analysis/9.2/asm-analysis-9.2.jar
popd
export JVM_ARGS="--module-path $PWD/lib/modules"
./bin/jmeter
      </source>
    </dd>
  </dl>
</li>

</ul>

</section>
</body>
</document>