You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: site/dat/repo/various.json
+4Lines changed: 4 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -3190,6 +3190,10 @@
3190
3190
"2.0.0": {
3191
3191
"changes": "Added headless CLI mode for CI/CD pipelines and GitHub Actions. Added P95 metric column. Auto-creates output directory if missing. Empty prefix now includes all transactions.",
"changes": "Baseline JTL comparison support. The Excel report now contains three sheets: Current, Baseline, and Comparison. Added 'Baseline Directory' field in the GUI listener.",
Copy file name to clipboardExpand all lines: site/dat/wiki/HttpSimpleTableServer.md
+55-52Lines changed: 55 additions & 52 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,8 @@ Unfortunately the dataset and csv files aren't transferred from the controller t
9
9
10
10
The main idea is to use a tiny http server in JMeter Plugins to manage the dataset files with simple commands to get / find / add rows of data in files.
11
11
12
-
An article about this tool : https://dzone.com/articles/jmeter-plugin-http-simple-table-server <br/>
12
+
A dzone.com article about this tool : [https://dzone.com/articles/jmeter-plugin-http-simple-table-server](https://dzone.com/articles/jmeter-plugin-http-simple-table-server) <br/>
13
+
13
14
"Take an in-depth look to discover some of the possibilities of using the HTTP Simple Table Server a JMeter Plugin in this short manual."
@@ -66,7 +68,9 @@ There are different ways to start the STS:
66
68
67
69

68
70
69
-
2. With <code>simple-table-server.cmd</code> (.sh for UNIX) script located in your <code>JMETER_HOME/bin</code> directory. Parameters are read in the jmeter.properties or you could also set parameters like <code>simple-table-server.cmd -DjmeterPlugin.sts.addTimestamp=true -DjmeterPlugin.sts.datasetDirectory=D:/jmeter/dataset</code>, set jmeterPlugin.sts.daemon=true when you want launch the STS with the nohup linux command like process daemon, the STS will not waiting the <ENTER> key to stop.
71
+
72
+
2. With <code>simple-table-server.cmd</code> (.sh for UNIX) script located in your <code>JMETER_HOME/bin</code> directory. Parameters are read in the jmeter.properties or you could also set parameters like <code>simple-table-server.cmd -DjmeterPlugin.sts.addTimestamp=true -DjmeterPlugin.sts.datasetDirectory=D:/jmeter/dataset</code>, set <code>jmeterPlugin.sts.daemon=true</code> when you want launch the STS with the nohup linux command like process daemon, the STS will not waiting the <ENTER> key to stop.
73
+
70
74
3. On JMeter CLI startup (Windows : <code>jmeter-n.cmd</code> or Linux <code>jmeter -n</code>) following properties in jmeter.properties file or in user.properties :
71
75
72
76
```text
@@ -89,7 +93,7 @@ http://hostname:port/sts/
89
93
```
90
94
When the STS is running go to `http://<HOST>:<PORT>/sts/` to **see all available commands** and a short help.
91
95
92
-
Usually `http://localhost:9191/sts/`
96
+
Usually Help at [http://localhost:9191/sts/](http://localhost:9191/sts/)
93
97
94
98
## INITFILE
95
99
@@ -161,7 +165,7 @@ read all csv files in the dataset directory the jmeterPlugin.sts.initFileAtStart
161
165
162
166
**Get one line from list**
163
167
164
-
The charset use in the response is jmeterPlugin.sts.charsetEncodingHttpResponse=<charset>, default value = JMeter property : sampleresult.default.encoding
168
+
The charset use in the response is jmeterPlugin.sts.charsetEncodingHttpResponse=<charset>, default value = JMeter property : sampleresult.default.encoding
165
169
166
170
```
167
171
http://hostname:port/sts/READ?READ_MODE={FIRST, LAST, RANDOM}&KEEP={TRUE, FALSE}&FILENAME=logins.csv
@@ -177,10 +181,10 @@ HTML format:
177
181
178
182
Available options:
179
183
- READ_MODE=FIRST => login1;password1
180
-
- READ_MODE=LAST => login5;password5
181
-
- READ_MODE=RANDOM => login?;password?
182
-
- KEEP=TRUE => the data is kept and put to the end of list
183
-
- KEEP=FALSE => the data is removed
184
+
- READ_MODE=LAST => login5;password5
185
+
- READ_MODE=RANDOM => login?;password?
186
+
- KEEP=TRUE => the data is kept and put to the end of list
187
+
- KEEP=FALSE => the data is removed
184
188
185
189
KEEP=TRUE, READ_MODE=FIRST => login1;password1
186
190
@@ -256,12 +260,12 @@ login5;password5
256
260
**Get multi lines from list in one request**
257
261
258
262
Available options:
259
-
- NB_LINES=Number of lines to read : 1 \<= Nb lines (Integer) and Nb lines \<= list size
260
-
- READ_MODE=FIRST =>start to read at the first line
261
-
- READ_MODE=LAST => start to read at the last line (reverse)
262
-
- READ_MODE=RANDOM => read n lines randomly
263
-
- KEEP=TRUE => the data is kept and put to the end of list
264
-
- KEEP=FALSE => the data is removed
263
+
- NB_LINES=Number of lines to read : 1 \<= Nb lines (Integer) and Nb lines \<= list size
264
+
- READ_MODE=FIRST =>start to read at the first line
265
+
- READ_MODE=LAST => start to read at the last line (reverse)
266
+
- READ_MODE=RANDOM => read n lines randomly
267
+
- KEEP=TRUE => the data is kept and put to the end of list
268
+
- KEEP=FALSE => the data is removed
265
269
266
270
GET Protocol
267
271
@@ -332,11 +336,11 @@ HTML format:
332
336
```
333
337
334
338
Available options:
335
-
- ADD_MODE=FIRST => add to the top
336
-
- ADD_MODE=LAST => add to the end
337
-
- FILENAME=dossier.csv => if doesn't already exist it creates a LinkedList in memory
338
-
- LINE=1234;98763 => the line to add
339
-
- UNIQUE=TRUE => do not add line if the list already contains such line (if already exits then return title KO and don't add the same line)
339
+
- ADD_MODE=FIRST => add to the top
340
+
- ADD_MODE=LAST => add to the end
341
+
- FILENAME=dossier.csv => if doesn't already exist it creates a LinkedList in memory
342
+
- LINE=1234;98763 => the line to add
343
+
- UNIQUE=TRUE => do not add line if the list already contains such line (if already exits then return title KO and don't add the same line)
340
344
341
345
POST Protocol with parameters
342
346

@@ -346,10 +350,10 @@ POST Protocol with parameters
346
350
**Find a line in a file (GET OR POST HTTP protocol)**
347
351
348
352
The LINE to find is for FIND_MODE :
349
-
- A string this SUBSTRING (Default, ALineInTheFile contains the stringToFind ) or EQUALS (stringToFind == ALineInTheFile)
350
-
- A regular expression with REGEX\_FIND (contains) and REGEX\_MATCH (entire region the pattern)
351
-
- KEEP=TRUE => the data is kept and put to the end of list
352
-
- KEEP=FALSE => the data is removed
353
+
- A string this SUBSTRING (Default, ALineInTheFile contains the stringToFind ) or EQUALS (stringToFind == ALineInTheFile)
354
+
- A regular expression with REGEX\_FIND (contains) and REGEX\_MATCH (entire region the pattern)
355
+
- KEEP=TRUE => the data is kept and put to the end of list
356
+
- KEEP=FALSE => the data is removed
353
357
354
358
GET Protocol
355
359
@@ -421,13 +425,13 @@ dossier.csv = 1<br />
421
425
422
426
**Save the specified linked list in a file to the specified location**
423
427
424
-
The charset use to write the file is set with jmeterPlugin.sts.charsetEncodingWriteFile=\<charset>, default value = System property : file.encoding
428
+
The charset use to write the file is set with jmeterPlugin.sts.charsetEncodingWriteFile=<charset>, default value = System property : file.encoding
425
429
426
430
```
427
431
http://hostname:port/sts/SAVE?FILENAME=logins.csv
428
432
```
429
433
430
-
If jmeterPlugin.sts.addTimestamp is set to true then a timestamp will be add to the filename,<br/>
434
+
If jmeterPlugin.sts.addTimestamp is set to true then a timestamp will be added to the filename,<br/>
431
435
the file is stored in the custom directory specified by editing the jmeterPlugin.sts.datasetDirectory property or in JMETER_HOME/bin directory by default:
432
436
433
437
```
@@ -473,7 +477,7 @@ Always returns title OK even if the file did not exist
473
477
http://hostname:port/sts/STOP
474
478
```
475
479
476
-
When the jmeterPlugin.sts.daemon=true, you need to call `http://hostname:port/sts/STOP` or kill the process to stop the STS
480
+
When the <code>jmeterPlugin.sts.daemon=true</code>, you need to call `http://hostname:port/sts/STOP` or kill the process to stop the STS
477
481
478
482
## CONFIG
479
483
@@ -524,12 +528,12 @@ else {
524
528
525
529
## Examples
526
530
527
-
- Put the logins.csv file in your JMETER_HOME/bin directory:
531
+
- Put the logins.csv file in your JMETER_HOME/bin directory:
- Run the Simple Table Server manually with the simple-table-server.cmd file or automatically with groovy configuration.
532
-
- Run one of the following scripts:
535
+
- Run the Simple Table Server manually with the simple-table-server.cmd file or automatically with groovy configuration.
536
+
- Run one of the following scripts:
533
537
534
538
In a loop, read random values from a file containing a login and a password at each row:
535
539
@@ -548,26 +552,25 @@ Add rows in a new linked list and save it in a file when the test is done:
548
552
549
553
550
554
551
-
Read in a random mode a dataset located on the controller machine with severals slaves.
552
-
The first injector loads the dataset in memory while the other injectors are waiting few seconds (you could also use jmeterPlugin.sts.initFileAtStartup=file1.csv,file2.csv and jmeterPlugin.sts.initFileAtStartupRegex=false to read files when STS startup)
553
-
The different injectors read randomly the data containing logins and passwords.
554
-
When the test is done the first injector save the values in a file with a timestamp as prefix:
555
+
Read in a random mode a dataset located on the controller machine with severals slaves.<br/>
556
+
The first injector loads the dataset in memory while the other injectors are waiting few seconds (you could also use jmeterPlugin.sts.initFileAtStartup=file1.csv,file2.csv and jmeterPlugin.sts.initFileAtStartupRegex=false to read files when STS startup)<br/>
557
+
The different injectors read randomly the data containing logins and passwords.<br/>
558
+
When the test is done the first injector save the values in a file with a timestamp as prefix:<br/>
555
559
556
560
[Download Example Test Plan 4](/img/examples/demo_sts_read_random_for2slaves.jmx) Multi JMeter injectors and save list examples
557
561
558
562
You can override STS settings using command-line options:
0 commit comments