The ``trackrdrd`` demon reads from the shared memory log of a running
The ``trackrdrd`` demon reads from the shared memory log of a running
instance of Varnish and collects data relevant to tracking for the
instance of Varnish, collects data relevant to tracking for the Otto
Otto project.
project, and forwards the data to ActiveMQ message brokers.
OPTIONS
OPTIONS
=======
=======
...
@@ -40,11 +40,16 @@ The source repository for ``trackrdrd`` is in the subdirectory
...
@@ -40,11 +40,16 @@ The source repository for ``trackrdrd`` is in the subdirectory
git@repo.org:trackrdrd
git@repo.org:trackrdrd
The build requires a source directory for Varnish in which sources
The build requires a source directory for Varnish in which sources
have been compiled. Varnish sources with features added for Otto are
have been compiled. Varnish sources with custom features for Otto
in::
are in::
git@repo.org:varnish-cache
git@repo.org:varnish-cache
``trackrdrd`` must link with the CMS or ActiveMQ-CPP library
(``libactivemq-cpp``) at runtime. The sources can be obtained from::
http://activemq.apache.org/cms/
Building Varnish
Building Varnish
----------------
----------------
...
@@ -77,6 +82,15 @@ build::
...
@@ -77,6 +82,15 @@ build::
$ CFLAGS=-m64 ./configure
$ CFLAGS=-m64 ./configure
$ make
$ make
Building and installing ActiveMQ-CPP
------------------------------------
``trackrdrd`` has been tested with versions 3.4.4 and 3.5.0 of
ActiveMQ-CPP. If the library ``libactivemq-cpp`` is already installed
on the platform where ``trackrdrd`` will run, then no further action
is necessary. To build the library from source, follow the
instructions in the ``README.txt`` file of its source distribution.
Building and installing trackrdrd
Building and installing trackrdrd
---------------------------------
---------------------------------
...
@@ -87,14 +101,19 @@ on the same platform as the Varnish build, all requirements are
...
@@ -87,14 +101,19 @@ on the same platform as the Varnish build, all requirements are
fulfilled.)
fulfilled.)
The steps to build ``trackrdrd`` are very similar to those for
The steps to build ``trackrdrd`` are very similar to those for
building Varnish. The only difference is that in the ``configure``
building Varnish. The only difference is in the ``configure``
step, the path to the Varnish source directory must be given in the
step:
variable ``VARNISHSRC``::
* The path to the Varnish source directory must be given in the variable ``VARNISHSRC``.
* The flag ``CXXFLAGS``, like ``CFLAGS``, must also be set to ``-m64``, because C++ code is also compiled. It may be necessary to add additional ``CXXFLAGS`` to compile the ActiveMQ API calls, for example as obtained from ``pkg-config --cflags apr-1``.