Running Tsung against opentaps server - Revision history

Jwickers at 12:03, 24 November 2009

2009-11-24T12:03:30Z

Jwickers at 07:22, 24 November 2009

2009-11-24T07:22:47Z

Gkfabs: /* Graphics */

2008-03-07T23:43:09Z

‎Graphics

Gkfabs at 23:26, 7 March 2008

2008-03-07T23:26:33Z

Gkfabs: /* Logs, Reports and Graphics generated */

2008-03-07T23:13:31Z

‎Logs, Reports and Graphics generated

Gkfabs at 23:03, 7 March 2008

2008-03-07T23:03:32Z

Gkfabs at 17:57, 7 March 2008

2008-03-07T17:57:55Z

Gkfabs at 17:35, 7 March 2008

2008-03-07T17:35:33Z

Gkfabs: Protected "Running Tsung against opentaps server": Sysop page [edit=sysop:move=sysop]

2008-03-07T00:40:56Z

Protected "Running Tsung against opentaps server": Sysop page [edit=sysop:move=sysop]

Gkfabs: New page: This is a page to assist with running tsung against opentaps server. TOC == Installing tsung == * Homepage http://tsung.erlang-projects.org/ * Download page http://tsung.erlang-proj...

2008-03-07T00:40:56Z

New page: This is a page to assist with running tsung against opentaps server. __TOC__ == Installing tsung == * Homepage http://tsung.erlang-projects.org/ * Download page http://tsung.erlang-proj...

New page

This is a page to assist with running tsung against opentaps server.

__TOC__

== Installing tsung ==

* Homepage http://tsung.erlang-projects.org/
* Download page http://tsung.erlang-projects.org/dist/
* Documentation http://tsung.erlang-projects.org/user_manual.html

Tsung needs the erlang platform to be installed. We will not extend over it, because rpm or deb versions just runs fine. http://www.erlang.org/

Tsung is a tool only available for linux platform under binary form. Maybe it could be runned against windows with the erlang windows version and the cygwin platform.

We used Tsung with erlang 5.6.1 The version 1.2.2 has some problem linked to xml parsing, so we prefer the version 1.2.0

You may want to modify tsung-1.2.0/src/tsung_controller/ts_os_mon.erl, depending on which platform you are running the opentaps server. The scripts which do the os monitoring (cpu, memory and network graphs) may not be convenient for your platform.

Compilation

* For debian users, just type fakeroot debian/rules binary.
* For the others a ./configure, make, make install will do it.

To run the client with the configuration file tsung.xml, just have

<pre>
$ tsung -f tsung.xml start
</pre>

== Explanation of the configuration file ==

@@ Line 20: / Line 20: @@
 Compilation
-* For debian users, just type fakeroot debian/rules binary.
+* For debian users, just type <code>fakeroot debian/rules binary</code>.
-* For the others a ./configure, make, make install will do it.
+* For the others a <code>./configure, make, make install</code> will do it.
 == Quick start ==
@@ Line 30: / Line 30: @@
 $ tsung -f tsung.xml start
 </pre>
 == Configuration file ==
-The configuration file and all the file needed to do a tsung stress testing are available in the directory hot-deploy/opentaps-tests/scripts/tsung/
+The configuration file and all the file needed to do a tsung stress testing are available in the directory <code>hot-deploy/opentaps-tests/scripts/tsung/</code>
 * readcsv.erl a small erlang script used to generate the login string from the user and password read
@@ Line 148: / Line 153: @@
 * tsung.xml is the configuration file
-To generate the reports and graphics, just execute /usr/lib/tsung/bin/tsung_stats.pl in the directory of logs.
+To generate the reports and graphics, just execute <code>/usr/lib/tsung/bin/tsung_stats.pl</code> in the directory of logs.
 You can then open the generated ''report.html'' in a web browser.
@@ Line 269: / Line 274: @@
 different http code returned

@@ Line 13: / Line 13: @@
 Tsung is a tool only available for linux platform under binary form. Maybe it could be runned against windows with the erlang windows version and  the cygwin platform.
-We used Tsung with erlang 5.6.1 The version 1.2.2 has some problem linked to xml parsing, so we prefer the version 1.2.0
+We used Tsung with erlang 5.6.1 or 13.2.2. The version 1.2.2 has some problem linked to xml parsing, newer version like 1.3.1 should work as well.
 You may want to modify tsung-1.2.0/src/tsung_controller/ts_os_mon.erl, depending on which platform you are running the opentaps server. The scripts which do the os monitoring (cpu, memory and network graphs) may not be convenient for your platform.
@@ Line 22: / Line 23: @@
 * For the others a ./configure, make, make install will do it.
-To run the client with the configuration file tsung.xml, just have
+== Quick start ==
 <pre>
 $ tsung -f tsung.xml start
 </pre>
@@ Line 50: / Line 53: @@
 </pre>
-You will get a file called readcsv.beam, which you have to copy in the tsung binary directory. In our case it is
+You will get a file called readcsv.beam, which you have to copy in the tsung binary directory (note: no longer necessary when running tsung from the same directory in newer versions). In our case it is
 <pre>
@@ Line 146: / Line 149: @@
 To generate the reports and graphics, just execute /usr/lib/tsung/bin/tsung_stats.pl in the directory of logs.
 === Reports ===

@@ Line 203: / Line 203: @@
 [[Image:graphes-Transactions-mean.png]]
 page correspond to the mean time to charge one page
@@ Line 208: / Line 210: @@
 [[Image:graphes-Perfs-mean.png]]
 connect correpond to the mean time to do a tcp connect
@@ Line 215: / Line 219: @@
 [[Image:graphes-Transactions-rate.png]]
 [[Image:graphes-Perfs-rate.png]]
 [[Image:graphes-Size-rate.png]]
 [[Image:graphes-Users_Arrival-rate.png]]
 * Simultaneous Users
 [[Image:graphes-Users-simultaneous.png]]
 [[Image:graphes-Match-rate.png]]
 * Server OS monitoring
 [[Image:graphes-cpu-mean.png]]
 [[Image:graphes-freemem-mean.png]]
 * HTTP return code Status (rate)
 [[Image:graphes-HTTP_CODE-rate.png]]

@@ Line 196: / Line 196: @@
 [[Image:httpReturnCode.png]]
-The apparition of the different http code.
+The apparition of the different http code. We observe 200, which is the normal http back code, and 302, which is received sometimes. This is normal I observe both during the building of the scenario.
 === Graphics ===

← Older revision		Revision as of 23:13, 7 March 2008
Line 152:		Line 152:

	[[Image:mainStatistic.png]]		[[Image:mainStatistic.png]]
		+
		+	connect is the time to make a tcp connect
		+	page is the time to download a whole page
		+	request is the time to send a request
		+	session is the time to get through a scenario node in the configuration file (in our case, to create and approve an order)
		+
		+	* Transactions Statistics
		+
		+	[[Image:transactionsStatistic.png]]
		+
		+	tr_approveSalesOrder is the time to get through the transaction node in the configuration file called approveSalesOrder
		+	tr_createSalesOrder is the time to get through the transaction node in the configuration file called createSalesOrder
		+	tr_login is the time to get through the transaction node in the configuration file called login
		+
		+	* Network Throughput
		+
		+	[[Image:networkThroughput.png]]
		+
		+	size_rcv is the quantity of bits received
		+	size_sent is the quantity of bits sent
		+
		+	* Counters Statistics
		+
		+	[[Image:countersStatistics.png]]
		+
		+	finish_users_count
		+	match is the quantity of verification done by the match node, which success
		+	newphase
		+	nomatch is the quantity of verification done by the match node, which fails
		+	users_count is the quantity of users generated
		+
		+	* Server monitoring
		+
		+	[[Image:serverMonitoring.png]]
		+
		+	cpu is the consumption of cpu
		+	freemem is the free memory available
		+	recvpackets is the quantity of bits received
		+	sentpackets is the quantity of bits sent
		+
		+	* HTTP return code
		+
		+	[[Image:httpReturnCode.png]]
		+
		+	The apparition of the different http code.

	=== Graphics ===		=== Graphics ===

@@ Line 106: / Line 106: @@
 ==== The different options ====
-You can change the user_agent.
+* user_agent UserAgent string to use
 <pre>
@@ Line 135: / Line 137: @@
 === Logs ===
 === Reports ===
 === Graphics ===

@@ Line 57: / Line 57: @@
 === tsung.xml ===
 === userlist.csv ===
-== Graphics generated ==
+It is a basic csv file which associate on one line a user and a password separated by a ; ie

← Older revision		Revision as of 17:35, 7 March 2008
Line 28:		Line 28:
	</pre>		</pre>

−	== ~~Explanation~~ of the ~~configuration~~ file ==	+	== Configuration file ==
		+
		+	The configuration file and all the file needed to do a tsung stress testing are available in the directory hot-deploy/opentaps-tests/scripts/tsung/
		+
		+	* readcsv.erl a small erlang script used to generate the login string from the user and password read
		+	* tsung.xml the configuration file for tsung
		+	* userlist.csv the list of the users which will be used successively to login
		+
		+	=== readcsv.erl ===
		+
		+	In this file, there is only one function called user. The step done are:
		+
		+	* ts_file_server:get_next_line() to read one line in the file
		+	* string:tokens(Line,";") to separate the user and the password
		+	* "USERNAME=" ++ Username ++"&PASSWORD=" ++ Passwd to return the login string
		+
		+	You have to compile this file
		+
		+	<pre>
		+	$ erlc readcsv.erl
		+	</pre>
		+
		+	You will get a file called readcsv.beam, which you have to copy in the tsung binary directory. In our case it is
		+
		+	<pre>
		+	/usr/lib/erlang/lib/tsung-1.2.0/ebin/
		+	</pre>
		+
		+	=== tsung.xml ===
		+
		+	=== userlist.csv ===
		+
		+	== Graphics generated ==

← Older revision	Revision as of 00:40, 7 March 2008
(No difference)

Running Tsung against opentaps server - Revision history

Jwickers at 12:03, 24 November 2009

Jwickers at 07:22, 24 November 2009

Gkfabs: /* Graphics */

Gkfabs at 23:26, 7 March 2008

Gkfabs: /* Logs, Reports and Graphics generated */

Gkfabs at 23:03, 7 March 2008

Gkfabs at 17:57, 7 March 2008

Gkfabs at 17:35, 7 March 2008

Gkfabs: Protected "Running Tsung against opentaps server": Sysop page [edit=sysop:move=sysop]

Gkfabs: New page: This is a page to assist with running tsung against opentaps server. __TOC__ == Installing tsung == * Homepage http://tsung.erlang-projects.org/ * Download page http://tsung.erlang-proj...

Gkfabs: New page: This is a page to assist with running tsung against opentaps server. TOC == Installing tsung == * Homepage http://tsung.erlang-projects.org/ * Download page http://tsung.erlang-proj...