Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

debian files and doc update

SVN Revision: 211
  • Loading branch information...
commit 3b06cb4bee29ae988bdf5ee8d3bbd7e13bd4a905 1 parent 748e9e0
@nniclausse nniclausse authored
View
9 CHANGES
@@ -1,4 +1,11 @@
-0.2.1 -> 1.0.beta1: Major Feature Enhancements (3 Jan 2004)
+1.0.beta1 -> 1.0.beta2: Minor feature enhancements (11 Feb 2004)
+ - reorganise the sources
+ - add tools to build a debian package
+ - fix documentations
+ - add minimalistic man page
+ - syntax change: GETIMS +date replace by GET +'if_modified_since'
+
+0.2.1 -> 1.0.beta1: Major Feature Enhancements (3 Feb 2004)
- rewrite the configuration engine. Now use an XML file.
- add recording application: use as a HTTP proxy to record session into XML
format
View
34 LISEZMOI
@@ -61,7 +61,7 @@
d�termine le taux d'arriv�e des clients sur le syst�me (ie. le
nombre de clients arrivant sur le syst�me -- d�marrant leur session -- par
unit� de temps). Plusieurs phases peuvent �tre d�finies pour un
- tests, chaque phase injectant des utilisateur � un taux donn�.
+ tests, chaque phase injectant des utilisateurs � un taux donn�.
Dans l'impl�mentation actuelle, la taux d'arriv�e des clients et le
temps entre message d'un m�me client ("think time") sont mod�lis�s
@@ -69,8 +69,12 @@
d'arriv�e est un processus de Poisson).
Le trafic peut �tre "dump�" dans un fichier, afin de pouvoir
- effectuer toutes sortes de calculs (temps de r�ponse) apr�s coup
- (option 'umptrafic' dans le fichier de configuration XML)
+ effectuer toutes sortes d'analyse apr�s coup (option 'dumptrafic'
+ dans le fichier de configuration XML). Attention, cette option peux
+ ralentir consid�rablement les injecteurs en cas de tr�s forte
+ charge.
+
+ Voir �galement le site http://tsunami.idealx.org/
2. Installation
@@ -78,7 +82,13 @@
- n�cessite Erlang/OTP R9C-0 (http://www.erlang.org/download.html)
- - xmerl-0.19 (http://sowap.sourceforge.net/download.html)
+ - xmerl-0.19 (http://sowap.sourceforge.net/download.html). Un paque
+ debian binaire est disponible � l'adresse
+ http://tsunami.idealx.org/dist/
+
+ xmerl-0.15 devrait fonctionner, mais la notation <tag/> n'est pas
+ support� par cette version de xmerl (il faut utiliser � la place
+ la notation <tag></tag> )
- gnuplot et perl5 (optionel, utilis� pour les sorties graphiques du script
analyse_msg.pl)
@@ -90,25 +100,21 @@
2.2. Compilation et Installation
�diter les fichiers Makefile si vous voulez changer le chemin par
- d�faut (/usr/local/idx-tsunami/).
-
- �diter src/tsunami.rel.src si votre version d'Erlang n'est pas R9C-0
- (les num�ros de version des modules erts, kernel, stdlib et ssl sont
- diff�rents d'une version d'Erlang � l'autre).
+ d�faut (/usr/lib/erlang/ ...).
make
make install
Comment l'utiliser:
- 1a/ �diter le fichier etc/idx-tsunami.xml (toutes les options sont
- d�crites en commentaires dans le fichier d'exemple
- etc/idx-tsunami_default.xml).
+ 1a/ �diter un fichier ~/.idx-tsunami/idx-tsunami.xml (toutes les
+ options sont d�crites en commentaires dans le fichier d'exemple
+ /usr/share/doc/idx-tsunami/examples/idx-tsunami.xml).
1b/ Lire le fichier doc/Jabber.txt pour des informations sp�cifiques �
Jabber.
2/ utilisez le script "idx-tsunami --start" pour d�marrer le
- test de charge.
+ test de charge (man idx-tsunami pour avoir les options disponibles)
3/ Lorsque c'est termin� (idx-tsunami --stop pour forcer l'arr�t), le
script analyse_msg.pl g�n�re une synth�se des temps de r�ponses;
@@ -150,7 +156,7 @@
2.3. Probl�mes/Bugs
- Envoyez vos questions/rapports de bugs � nicolas.niclausse@IDEALX.com
+ Envoyez vos questions/rapports de bugs � nicolas.niclausse@IDEALX.com
2.4. Portabilit�
View
18 README
@@ -61,12 +61,14 @@
(therefore, the arrival process is a Poisson process). The thinktime
can also be fixed (determinist).
- The traffic can be logged to a file andthis file can be analyzed by
+ The traffic can be logged to a file and this file can be analyzed by
scripts to get useful measurements of responses time.
Since v0.2.0, these stats are also be computed in real-time. A
script is provided to print graphics using gnuplot.
+ For a list of features, see http://tsunami.idealx.org/features.en.html
+
2. Getting Things Installed
2.1. Dependencies
@@ -90,20 +92,18 @@
(/usr/lib/erlang/... by default for beam files). Default
configuration and log files are saved in ~/.idx-tsunami/ )
- Edit src/tsunami.rel.src and src/tsunami_controller.rel.src if your
- Erlang version is not R9C-0 and set erts, kernel, ssl and stdlib
- version according to your Erlang distribution.
-
make
make install
How to use it:
- 1a/ Edit $prefix/etc/idx-tsunami.xml file (read the comments for explanation
- on the parameters, there is a sample file etc/idx-tsunami_default.xml)
+ 1a/ Edit ~/.idx-tsunami/idx-tsunami.xml file (read the comments
+ for explanation on the parameters, there is a sample file
+ /usr/share/doc/idx-tsunami/examples/idx-tsunami.xml)
1b/ Read the doc/Jabber.txt file for Jabber-specific information.
- 2/ use "idx-tsunami start" to launch the simulated clients.
+ 2/ use "idx-tsunami start" to launch the simulated clients (man
+ idx-tsunami for available options)
3/ When it's finished, or during the test, you can use analyse_msg.pl to get
statistical results from the logfile.
@@ -139,7 +139,7 @@
2.3. Problems/Bugs
- Submit bug reports/ask questions to nicolas.niclausse@IDEALX.com
+ Submit bug reports/ask questions to nicolas.niclausse@IDEALX.com
2.4. Platform Issues
View
6 debian/changelog
@@ -0,0 +1,6 @@
+idx-tsunami (1.0.beta2-1) unstable; urgency=low
+
+ * Initial Release.
+
+ -- Nicolas Niclausse <nicolas.niclausse@IDEALX.com> Tue, 10 Feb 2004 12:09:23 +0100
+
View
1  debian/compat
@@ -0,0 +1 @@
+4
View
21 debian/control
@@ -0,0 +1,21 @@
+Source: idx-tsunami
+Section: net
+Priority: optional
+Maintainer: Nicolas Niclausse <nicolas.niclausse@IDEALX.com>
+Build-Depends: debhelper (>= 4.0.0), erlang (>= 9.2-1)
+Standards-Version: 3.6.0
+
+Package: idx-tsunami
+Architecture: all
+Depends: erlang (>= 9.2-1), libxmerl-erlang (>= 0.19-1)
+Recommends: gnuplot, perl, ssh
+Description: A distributed multi-protocol load testing tool.
+ IDX-Tsunami is a distributed load testing tool.
+ It is protocol-independent and can currently be used to stress and
+ benchmark HTTP and Jabber servers.
+ It simulates user behaviour using an XML description file, reports
+ many measurements in real time (statistics can be customized with
+ transactions, and graphics generated using gnuplot).
+ For HTTP, it supports 1.0 and 1.1, has a proxy mode to record
+ sessions, supports GET and POST methods, Cookies, and Basic
+ WWW-authentication. It also has support for SSL.
View
20 debian/copyright
@@ -0,0 +1,20 @@
+This package was debianized by Nicolas Niclausse <nicolas.niclausse@IDEALX.com> on
+Tue, 10 Feb 2004 12:09:23 +0100.
+
+It was downloaded from http://tsunami.idealx.org/
+
+Upstream Author(s): Nicolas Niclausse <nicolas.niclausse@IDEALX.com>
+
+Copyright:
+
+ IDX-Tsunami is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ IDX-Tsunami is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ See /usr/share/common-licenses/GPL
View
4 debian/docs
@@ -0,0 +1,4 @@
+FAQ
+CONTRIBUTORS
+README
+TODO
View
3  debian/idx-tsunami.dirs
@@ -0,0 +1,3 @@
+usr/bin/
+usr/lib/erlang/lib
+usr/lib/idx-tsunami/bin
View
69 debian/rules
@@ -0,0 +1,69 @@
+#!/usr/bin/make -f
+# Sample debian/rules that uses debhelper.
+# GNU copyright 1997 to 1999 by Joey Hess.
+
+# Uncomment this to turn on verbose mode.
+#export DH_VERBOSE=1
+
+# This is the debhelper compatibility version to use.
+export DH_COMPAT=4
+
+
+configure: configure-stamp
+configure-stamp:
+ dh_testdir
+ # Add here commands to configure the package.
+
+ touch configure-stamp
+
+
+build: build-stamp
+
+build-stamp: configure-stamp
+ dh_testdir
+
+ # Add here commands to compile the package.
+ $(MAKE)
+ touch build-stamp
+
+clean:
+ dh_testdir
+ dh_testroot
+ rm -f build-stamp configure-stamp
+
+ # Add here commands to clean up after the build process.
+ -$(MAKE) clean
+
+ dh_clean
+
+install: build
+ dh_testdir
+ dh_testroot
+ #dh_clean -k
+ dh_installdirs
+
+ # Add here commands to install the package into debian/idx-tsunami
+ make install DESTDIR=$(CURDIR)/debian/idx-tsunami
+
+
+# Build architecture-independent files here.
+binary-indep: build install
+# We have nothing to do by default.
+ dh_testdir
+ dh_testroot
+ dh_installdocs
+ dh_installchangelogs
+ dh_link
+ dh_strip
+ dh_compress
+ dh_fixperms
+# dh_makeshlibs
+ dh_installdeb
+# dh_perl
+ dh_shlibdeps
+ dh_gencontrol
+ dh_md5sums
+ dh_builddeb
+
+binary: binary-indep
+.PHONY: build clean binary-indep install configure
Please sign in to comment.
Something went wrong with that request. Please try again.