haproxy public development tree
Go to file
Krzysztof Piotr Oledzki 2c6962c3c0 [MAJOR] proto_uxst rework -> SNMP support
Currently there is a ~16KB limit for a data size passed via unix socket.
It is caused by a trivial bug ttat is going to fixed soon, however
in most cases there is no need to dump a full stats.

This patch makes possible to select a scope of dumped data by extending
current "show stat" to "show stat [<iid> <type> <sid>]":
 - iid is a proxy id, -1 to dump all proxies
 - type selects type of dumpable objects: 1 for frontend, 2 for backend, 4 for
   server, -1 for all types. Values can be ORed, for example:
     1+2=3   -> frontend+backend.
     1+2+4=7 -> frontend+backend+server.
 - sid is a service id, -1 to dump everything from the selected proxy.

To do this I implemented a new session flag (SN_STAT_BOUND), added three
variables in data_ctx.stats (iid, type, sid), modified dumpstats.c and
completely revorked the process_uxst_stats: now it waits for a "\n"
terminated string, splits args and uses them. BTW: It should be quite easy
to add new commands, for example to enable/disable servers, the only problem
I can see is a not very lucky config name (*stats* socket). :|

During the work I also fixed two bug:
 - s->flags were not initialized for proto_uxst
 - missing comma if throttling not enabled (caused by a stupid change in
     "Implement persistent id for proxies and servers")

Other changes:
 - No more magic type valuse, use STATS_TYPE_FE/STATS_TYPE_BE/STATS_TYPE_SV
 - Don't memset full s->data_ctx (it was clearing s->data_ctx.stats.{iid/type/sid},
    instead initialize stats.sv & stats.sv_st (stats.px and stats.px_st were already
    initialized)

With all that changes it was extremely easy to write a short perl plugin
for a perl-enabled net-snmp (also included in this patch).

29385 is my PEN (Private Enterprise Number) and I'm willing to donate
the SNMPv2-SMI::enterprises.29385.106.* OIDs for HAProxy if there
is nothing assigned already.
2008-03-04 06:32:16 +01:00
contrib/netsnmp-perl [MAJOR] proto_uxst rework -> SNMP support 2008-03-04 06:32:16 +01:00
doc [MAJOR] proto_uxst rework -> SNMP support 2008-03-04 06:32:16 +01:00
examples [MINOR] report correct section type for unknown keywords. 2008-01-22 16:44:08 +01:00
include [MAJOR] proto_uxst rework -> SNMP support 2008-03-04 06:32:16 +01:00
src [MAJOR] proto_uxst rework -> SNMP support 2008-03-04 06:32:16 +01:00
tests [TESTS] add test-pollers.cfg to easily report pollers in use 2008-02-16 20:02:48 +01:00
.gitignore [BUILD] updated .gitignore 2006-12-19 18:03:12 +01:00
CHANGELOG [RELEASE] Released version 1.3.14 2007-12-06 01:25:44 +01:00
CONTRIB [DOC] Update a "contrib" file with a hint about a scheme used for formathing subjects 2008-02-04 21:34:59 +01:00
LICENSE [LICENSE] licensing clarifications 2006-06-15 21:48:13 +02:00
Makefile [BUILD] ensure that makefile understands USE_DLMALLOC=1 2008-02-19 10:53:32 +01:00
Makefile.bsd [MINOR] store the build options to report with -vv 2007-12-02 11:28:59 +01:00
Makefile.osx [BUILD] update MacOS Makefile to build on newer versions 2008-02-10 17:00:13 +01:00
README Separated OpenBSD build from the main Makefile into a new one. 2006-03-19 20:56:52 +01:00
ROADMAP [MEDIUM] implemented the 'monitor-uri' keyword. 2006-07-09 17:01:40 +02:00
SUBVERS [BUILD] centralize version and date into one file for each 2007-09-09 23:31:11 +02:00
TODO [MEDIUM] Implement "track [<backend>/]<server>" 2008-02-27 10:39:53 +01:00
VERDATE [RELEASE] Released version 1.3.14 2007-12-06 01:25:44 +01:00
VERSION [RELEASE] Released version 1.3.14 2007-12-06 01:25:44 +01:00

                           -------------------
                             H A - P r o x y
                             How to build it
                           -------------------
                              version 1.2.7
                              willy tarreau
                                2005/10/25


To build haproxy, you will need :
  - GNU make. Neither Solaris nor OpenBSD's make work with this makefile.
  - GCC between 2.91 and 3.4. Others may work, but not tested.
  - GNU ld

Also, you might want to build with libpcre support, which will provide a very
efficient regex implementation and will also fix some badness on Solaris's one.

To build haproxy, you have to choose your target OS amongst the following ones
and assign it to the TARGET variable :

  - linux24  for Linux 2.4 and above (default)
  - linux24e for Linux 2.4 with support for epoll
  - linux26  for Linux 2.6 and above
  - linux22  for Linux 2.2
  - solaris  for Solaris 8 or 10 (others untested)
  - openbsd  for OpenBSD 3.1 to 3.7 (others untested)
  - generic  for any other OS.

You may also choose your CPU to benefit from some optimizations. This is
particularly important on UltraSparc machines. For this, you can assign
one of the following choices to the CPU variable :

  - i686 for intel PentiumPro, Pentium 2 and above, AMD Athlon
  - i586 for intel Pentium, AMD K6, VIA C3.
  - ultrasparc : Sun UltraSparc I/II/III/IV processor
  - generic : any other processor or no specific optimization. (default)

If your system supports PCRE (Perl Compatible Regular Expressions), then you
really should build with libpcre which is between 2 and 10 times faster than
other libc implementations. Regex are used for header processing (deletion,
rewriting, allow, deny). The only inconvenient of libpcre is that it is not
yet widely spread, so if you build for other systems, you might get into
trouble if they don't have the dynamic library. In this situation, you should
statically link libpcre into haproxy so that it will not be necessary to
install it on target systems. Available options for the REGEX variable are :

  - libc to use your OS libc's standard regex implemntation (default).
    Warning! group references on Solaris seem broken. Use static-pcre whenever
    possible.

  - pcre to use libpcre, in whatever form it is available on your system
    (shared or static)

  - static-pcre to use a static version of libpcre even if the dynamic one is
    available. This will enhance portability.

By default, the DEBUG variable is set to '-g' to enable debug symbols. It is
not wise to disable it on uncommon systems, because it's often the only way to
get a complete core when you need one. Otherwise, you can set DEBUG to '-s' to
strip the binary.

For example, I use this to build for Solaris 8 :

    $ make TARGET=solaris CPU=ultrasparc REGEX=static-pcre

And I build it this way on OpenBSD :

    $ make -f Makefile.bsd REGEX=pcre DEBUG= COPTS.generic="-Os -fomit-frame-pointer -mgnu"

If you need to pass other defines, includes, libraries, etc... then please
check the Makefile to see which ones will be available in your case, and
use the ADDINC, ADDLIB, and DEFINE variables for this.

-- end