Skip to content
Newer
Older
100644 117 lines (75 sloc) 3.51 KB
da16c35 @nniclausse import version publique du client de test de mont�e en charge.
nniclausse authored May 30, 2001
1 # $Id$
2
3 IDX-TSUNAMI README
4 IDEALX
5 ____________________________________________________________
6
7 Table of Contents
8
9
10 1. Introduction
11
12 1.1 General
13 1.2 What This Package Is
14
15 2. Getting Things Installed
16
17 2.1 Dependencies
18 2.2 Compilation and Installation
19 2.3 Problems/Bugs
20 2.4 Platform Issues
21
22 ______________________________________________________________________
23
24 1. Introduction
25
26 1.1. General
27
28 This document gives pointers for information on this package.
29
30 Copyright information can be found in the file "COPYING."
31
32 1.2. What This Package Is
33
34 The purpose of this package is to simulate users in order to test
35 the scalability and performances of IP based client/server
36 applications. Currently, only the Jabber protocol has been
37 implemented and tested, but it can be easily extended (see
38 doc/Design.txt). IDX-TSUNAMI use the Erlang language.
39
40 This tool can simulate thousands of users concurrently, and can be
41 distributed on several client machines. Up to 10000 users can be
42 simulated on a single machine (the limit depends on the hardware and
43 also on the activity of the simulated clients).
44
45 The idea is to simulate the behavior of a real world client using a
46 stochastic model, in order to achieve a more realistic traffic than
47 other simple models (deterministics).
48
49 In this context, a client is characterize by:
50 - the time elapsed between each request ("think time")
51 - the number of requests during a session
52 - the type and parameters of requests (including, for example,
53 message size for Jabber)
54
55 Another key parameter is the arrival rate of clients.
56
57 In the current implementation, the client arrival rate and the user
58 "think time" are represented by an exponential distribution
59 (therefore, the arrival process is a Poisson process)
60
61 The traffic can be logged to a file and, after completion of
62 all the clients, these files can be analyzed by scripts to get
63 useful measurements of responses time. An small script is furnished
64 for the Jabber protocol (mean, median, standard variation, and so on
65 are computed, for different types of messages: authentication,
66 chat, offline messages ...)
67
68 This software is currently under development and can be enhanced
69 in many ways (see TODO file).
70
71 2. Getting Things Installed
72
73 2.1. Dependencies
74
75 - requires Erlang/OTP R7B-0 or up (tested with R7B-2)
76 (http://www.erlang.org/download.html)
77
78 - perl5 (if you want tu use the scripts)
79
80 - gnuplot (optional; for graphical output with analyse_msg.pl script)
81
82 2.2. Compilation and Installation
83
84 Edit Makefile and idx-tsunami.pl if you want to change the install
85 path (/usr/local/idx-tsunami by default)
86
87 Edit src/tsunami.rel.src if your Erlang version is not R7B-2 and set
88 erts, kernel and stdlib version according to your Erlang
89 distribution.
90
91 make
92 make install
93
94 How to use it:
95 1a/ Edit etc/idx-tsunamirc file (read the comments for explanation on
96 the parameters)
97
98 1b/ Read the doc/Jabber.txt file for Jabber-specific information.
99
100 2/ use the script "idx-tsunami.pl --start" to launch the simulated clients.
101
102 3/ When it's finished, you can use analyse_msg.pl to get
103 statistical results from the logfiles (require at least 'light'
104 monitoring, see comments in 'idx-tsunamirc' )
105
106 2.3. Problems/Bugs
107
108 Submit bug reports/ask questions to the authors (see CONTRIBUTORS)
109
110 2.4. Platform Issues
111
112 This package has only be tested on Linux. It should work
113 on Erlang supported platforms (Solaris, *BSD)
114
115
116
Something went wrong with that request. Please try again.