Using your own user.properties file with JMeter
Using your own custom Jmeter system properties file can be extremely useful and powerful for running a test with non-default properties and advanced scenarios.
A large amount of settings are controlled by the jmeter.properties configuration file included in the JMeter application distribution.
On Flood, we DO NOT recommend uploading your own jmeter.properties file. Instead, please use a user.properties file with only the specific properties you would like to change.
The reasons for changing a default property in Jmeter can be due to intended modifications in the following areas:
Language
XML Parser
SSL Configuration
Look and Feel configuration
Toolbar display
JMX Backup configuration
Remote hosts and RMI configuration
Include Controller
HTTP Java configuration
Apache HttpClient common properties
Kerberos properties
Apache HttpClient logging examples
Apache HttpComponents HTTPClient configuration (HTTPClient4)
HTTP Cache Manager configuration
Results file configuration
Settings that affect SampleResults
Upgrade properties
JMeter Test Script recorder configuration
Test Script Recorder certificate configuration
JMeter Proxy configuration
HTML Parser configuration
Remote batching configuration
JDBC Request configuration
OS Process Sampler configuration
TCP Sampler configuration
Summariser - Generate Summary Results
Aggregate Report and Aggregate Graph - configuration
BackendListener - configuration
BeanShell configuration
MailerModel configuration
CSVRead configuration
__time() function configuration
CSV DataSet configuration
LDAP Sampler configuration
Miscellaneous configuration
Classpath configuration
Reporting configuration
Additional property files to load
Thread Group Validation feature
Timer related feature
Naming Policy
Help
Some of these won't apply to Flood as we take care of many User Interface, reporting, and result metrics related functionality.
For further information about any of the above properties - please refer to the official documentation at the Apache JMeter website here: http://jmeter.apache.org/usermanual/properties_reference.html
To use and upload your custom user.properties file - simply undertake the following steps:
Ensure you include the user property you would like to overwrite within a plaintext file called user.properties as follows:
In this example we would like to enable the https.socket.protocols property.
Save the file with the properties you wish to use and and zip it using the following file structure.
Placing the file under the bin folder will ensure when the file is extracted on the Flood nodes before a test - it gets placed into the correct directory.
Archive the folder structure into a ZIP file.
When creating a new Flood - under the Test Scripts section - simply upload the above zip archive along with your JMeter script as follows:
The user property setting will overwrite the default jmeter property accordingly for your next Flood to use.
That's It!
