You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by je...@apache.org on 2001/08/29 22:35:41 UTC
cvs commit: httpd-site/test/flood building.html index.html
jerenkrantz 01/08/29 13:35:41
Modified: test/flood index.html
Added: test/flood building.html
Log:
Add quickie instructions on how to checkout, build, and run flood.
Revision Changes Path
1.4 +6 -0 httpd-site/test/flood/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/httpd-site/test/flood/index.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.html 2001/08/28 00:15:01 1.3
+++ index.html 2001/08/29 20:35:41 1.4
@@ -28,6 +28,12 @@
<HR>
<P>Flood is a profile-driven HTTP load tester.
+<H2>Getting and using flood</H2>
+
+<UL>
+<LI><A HREF="building.html">Building flood</A>
+</UL>
+
<H2>Example profiles</H2>
<P>Flood's configuration is XML-based. Some of the links below showcase some
1.1 httpd-site/test/flood/building.html
Index: building.html
===================================================================
<HTML>
<HEAD>
<TITLE>Compiling and running Flood</TITLE>
</HEAD>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#000080"
ALINK="#FF0000"
>
<DIV ALIGN=CENTER>
<H2>Compiling and running Flood</H2>
</DIV>
<center>
<FORM ACTION="http://search.apache.org/" METHOD="POST">
<INPUT TYPE="text" NAME="keyword" SIZE=40>
<input type=hidden name="results" value=20>
<input type=hidden name="what" value="httpd.apache.org">
<input type=hidden name="version" value="2">
<INPUT TYPE="submit" VALUE="Search Site">
</FORM>
</center>
<HR>
<P>This document explains how to compile and run flood.
<H2>Overview</H2>
<P>Flood is built around
<A HREF="http://apr.apache.org/">Apache Portable Runtime</A> - specifically
apr and apr-util. For some arcane unknown reason (probably laziness on
our part - patches welcomed), flood also requires the httpd-2.0 source
directory to build.</P>
<P>Flood has been primarily developed on Linux and Solaris. FreeBSD is also
known to work. Since flood is build around APR, any APR-supported platform
should work without too much hassle. We expect Win32 would work with some
additional magic provided someone has the time and inclination to do so.
APR has completed most of the dirty work, but none of the current flood
developers use Win32.</P>
<H2>Checking out flood</H2>
<P>The current copy of flood is available via anonymous CVS access (via
pserver). "anoncvs" is the password. Flood also depends on the apr
and apr-util packages available from the same CVS site. (Again, if
someone wants to strip out the httpd-2.0 specific parts of our build,
please by our guest and submit patches to us for this. Until then,
you need to also checkout httpd-2.0.)</P>
<PRE>
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co httpd-2.0
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co httpd-test
% cd httpd-2.0/srclib
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co apr
% cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co apr-util
</PRE>
<H2>Configuring flood and its dependencies</H2>
<P>Now that you have all of the required modules checked out, you now
need to generate the configure scripts and execute them for your
platform. Note that the httpd-2.0 configure will run the apr and apr-util
configuration scripts.</P>
<PRE>
% cd httpd-2.0
% ./buildconf
% ./configure
% cd ../httpd-test/flood
% ./buildconf
% ./configure --with-httpd=<I><absolute path to httpd-2.0></I>
</PRE>
<H2>Compiling flood and its dependencies</H2>
<P>At this time, flood does not use an installed version of apr or
apr-util. So, you just need to compile apr and apr-util and then
flood will use the built libraries.</P>
<PRE>
% cd httpd-2.0
% make all
% cd ../httpd-test/flood
% make all
</PRE>
<H2>Running flood</H2>
<P>By default, flood is a static executable, so the executable is
relocatable. There are some example flood profiles in the examples/
directory.</P>
<PRE>
% ./flood examples/round-robin.xml > foo.out
</PRE>
<H2>Analyzing flood output</H2>
<P>The foo.out file generated above is in a simple easy-to-parse format.
There are some included shell and awk scripts in the examples directory
that provide some easy mechanisms to extract info from the flood output
files.</P>
<PRE>
% ./examples/analyze-relative foo.out
</PRE>
<P>If you have any questions, please email the test-dev@httpd.apache.org
list.</P>
</BODY>
</HTML>