1TSUNG(1)                                                              TSUNG(1)
2
3
4

NAME

6       tsung - A distributed multi-protocol load testing tool.
7

SYNOPSIS

9       tsung  [ -f configuration file ]  [ -l log dir ]  [ -m filename ]  [ -r
10       command ]  [ -X directory ]  [ -w delay ]  [ -L lifetime ]  [ -s  ]   [
11       -n ]  [ -k ]  [ -v ]  [ -6 ]  [ -h ]  [ start|stop|debug|status ]
12

DESCRIPTION

14       tsung  is  a  distributed load testing tool. It is protocol-independent
15       and can currently be used to stress and benchmark HTTP,  WebDAV,  LDAP,
16       PostgreSQL, MySQL and Jabber/XMPP servers.
17
18       It simulates user behaviour using an XML description file, reports many
19       measurements in real time (statistics can be customized  with  transac‐
20       tions, and graphics generated using gnuplot).
21
22       For HTTP, it supports 1.0 and 1.1, has a proxy mode to record sessions,
23       supports GET and POST methods, Cookies, and  Basic  WWW-authentication.
24       It also has support for SSL.
25
26       Several config examples can be found in /usr/share/doc/tsung/examples/.
27
28       start  start tsung load testing
29
30       debug  start tsung with an interactive erlang shell
31
32       stop   stop tsung
33
34       status print current status of a running instance of tsung (must be run
35              on the controller host)
36

MANUAL

38       A manual should be available at  /usr/share/doc/tsung/user_manual.html.
39       It is also available online at
40
41
42              http://tsung.erlang-projects.org/user_manual.html
43
44
45

OPTIONS

47       -f filename
48              specifies  the  configuration file to use. The default file name
49              is ~/.tsung/tsung.xml. Use - for standard input
50
51       -l logdir
52              Specifies the log directory to use. The default log dir name  is
53              ~/.tsung/log/YYYYMMDD-HHMM/
54
55       -m monitoring_file
56              Specifies  the  monitoring log file name to use. The default log
57              file name is tsung.log. Use - for standard output
58
59       -r command
60              Specifies an alternative to ssh (rsh for  ex.)  for  starting  a
61              slave node on a remote host
62
63       -i id  set  controller  id  (default is empty). Needed to start several
64              controllers on the same host.
65
66       -F     Use long names for erlang nodes (FQDN)
67
68       -s     Enable erlang smp on client nodes
69
70       -p     set maximum erlang processes per vm (default is 250000)
71
72       -X directory
73              add additional erlang load paths (multiple -X arguments allowed)
74
75       -L lifetime
76              SSL session lifetime in seconds (600 sec by default)
77
78       -w delay
79              warmup delay in seconds (1 sec by default)
80
81       -v     Show version
82
83       -n     disable web GUI
84
85       -k     keep web GUI (and controller) alive after the test has finished
86
87       -6     Use IPv6 for tsung internal communications
88
89       -h     Show usage
90

BUGS

92       Please reports bugs to the mailing list  <tsung-users@process-one.net>,
93       see
94
95
96              https://lists.process-one.net/mailman/listinfo/tsung-users
97
98
99       for archives. You can also use the issue tracker
100
101
102              https://github.com/processone/tsung/issues
103
104
105

SEE ALSO

107       erlang(3)
108

AUTHORS

110       Tsung  is  written by Nicolas Niclausse <nicolas@niclux.org>. Contribu‐
111       tors list is available in /usr/share/doc/tsung/CONTRIBUTORS
112
113
114
115                                 January 2004                         TSUNG(1)