Back to files

feedbackd-master
version 0.3.1

Copyright (C) 2002 Jeremy Kerr, released under the terms of the GNU General Public License. See the file COPYING for details.

General

feedbackd-master is part of the feedbackd package, a system to provide dynamic feedback to the Linux Virtual Server project. The feedbackd-master program is run on the director node and requests server health information from feedbackd-agent processes installed on the server nodes.

Website

feedbackd has a project homepage at:

http://www.redishsoftware.com.au/projects/feedbackd/

Compiling and Installing:

A detailed guide to setting up feedbackd is available in the feedbackd HOWTO

http://www.redishsoftware.com.au/projects/feedbackd/howto/

For the impatient:

./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var make
make install

Requirements

libxml2 (http://www.xmlsoft.org)
perl

feedbackd-master uses the libipvs.a library (provided with ipvsadm) to interface with the Linux Virtual Server software. As of ipvsadm version 1.21, these files are not installed by default. You have two options:

($ipvsadm_root is the directory created by untarring ipvsadm*.tar.gz)

• Copy the files manually from the ipvsadm distribution:

         cd $ipvsadm_root
         cp libipvs/libipvs.a /usr/lib
         mkdir /usr/include/ipvs
         cp libipvs/libipvs.h /usr/include/ipvs/ipvs.h
    
     o Apply the ipvsadm-1.21.libinstall.diff to ipvsadm - this will make
       ipvsadm install the library files for you when you 'make install'.
       This patch is provided with feedbackd-master.
        
        cd $ipvsadm_root
        patch -p1 < /path/to/feedbackd-master-0.2.0/ipvsadm-1.21.libinstall.diff
        make
        make install

      In later versions of ipvsadm, these files may be installed already.

Additionally, the ipvs.h header file requires ip_vs.h, which is in the kernel source tree (after patching with ipvs*.patch). The --with-linux-dir option is provided to allow the installer to find this file.

Configure arguments:

--with-ipvs [default]
--without-ipvs

      Specify --without-ipvs to build a binary not linked to libipvs.a,
      useful for testing without installing ipvs. A binary built with this
      option will neither update the kernel ipvs tables nor try to retrieve
      a server connection count (0 is always returned - quiesced servers will
      be removed immediately).

      To disable ipvs table updates at runtime, use the -n argument. This will
      still retrieve the server connection counts, but no changes will be made
      to the ipvs tables.

--with-linux-dir=[PATH]

      Specify the path to the linux source - libipvs.h requires the net/ip_vs.h
      file to compile.

      A typical value for path is /usr/src/linux (this is the default), or
      /usr/src/linux-2.4.20. Configure looks for a include/net/ip_vs.h at this
      location

      The kernel includes are not required if --without-ipvs is present.

--with-xml-config=PATH

      location of the xml-config (or xml2-config) program, used to find
      the libxml2 library

Running

the feedback-master process needs to be run as root to alter ipvs tables.

'feedbackd-master --usage' gives runtime configuration flags.

The feedbackd- man page gives configuration and running help.

Code Documentation:

The feedbackd-agent source has inline doxygen comments. To generate (html) code documentation, cd to doc/ and run doxygen.

The default configuration requires the 'dot' utility to generate dependency graphs.

Bug Reports/Feature requests:

Any bug reports/feature requests/comments are welcome. Send to:

jeremy@redfishsoftware.com.au