Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
T
trackrdrd
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
uplex-varnish
trackrdrd
Commits
0eed3a9d
Commit
0eed3a9d
authored
Nov 20, 2017
by
Geoff Simmons
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add instructions for RPM installs to INSTALL.rst.
parent
de573a12
Pipeline
#389
skipped
Changes
1
Pipelines
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
94 additions
and
0 deletions
+94
-0
INSTALL.rst
INSTALL.rst
+94
-0
No files found.
INSTALL.rst
View file @
0eed3a9d
INSTALLATION
INSTALLATION
============
============
RPMs
~~~~
Binary
,
debuginfo
and
source
RPMs
for
the
Tracking
Reader
are
available
at
packagecloud
:
https
://
packagecloud
.
io
/
uplex
/
varnish
The
packages
are
built
for
Enterprise
Linux
7
(
el7
),
and
hence
will
run
on
compatible
distros
(
such
as
RHEL7
,
Fedora
and
CentOS
7
).
To
set
up
your
YUM
repository
for
the
RPMs
,
follow
these
instructions
:
https
://
packagecloud
.
io
/
uplex
/
varnish
/
install
#
manual
-
rpm
You
will
also
need
these
additional
repositories
:
*
EPEL7
*
``
rpm
-
Uvh
https
://
dl
.
fedoraproject
.
org
/
pub
/
epel
/
epel
-
release
-
latest
-
7.
noarch
.
rpm
``
*
Official
Varnish
packages
from
packagecloud
(
since
version
5.2.0
)
*
Follow
the
instructions
at
:
https
://
packagecloud
.
io
/
varnishcache
/
varnish52
/
install
#
manual
-
rpm
*
Cloudera
CDH5
repository
for
the
zookeeper
-
native
package
:
*
``
yum
install
https
://
archive
.
cloudera
.
com
/
cdh5
/
one
-
click
-
install
/
redhat
/
7
/
x86_64
/
cloudera
-
cdh
-
5
-
0.
x86_64
.
rpm
``
In
addition
to
installing
the
binary
,
libraries
,
man
pages
and
documentation
,
the
RPM
install
does
the
following
:
*
Creates
a
user
``
trackrdrd
``
and
adds
it
to
the
group
``
varnish
``
*
The
``
varnish
``
group
is
created
by
the
varnish
package
.
*
Installs
a
default
configuration
at
``/
etc
/
trackrdrd
.
conf
``,
which
sets
up
the
following
:
*
The
child
process
runs
as
``
trackrdrd
``.
*
The
Kafka
MQ
plugin
is
used
.
*
A
PID
file
is
saved
at
``/
var
/
run
/
trackrdrd
.
pid
``.
*
Installs
a
default
configuration
for
the
Kafka
plugin
at
``/
etc
/
trackrdr
-
kafka
.
conf
``:
*
Defines
a
broker
listening
at
the
default
port
on
the
loopback
address
:
``
127.0.0.1
:
9092
``.
*
Sends
messages
to
the
topic
``
tracking
``.
*
Logs
to
the
file
``/
var
/
log
/
trackrdrd
/
libtrackrdr
-
kafka
.
log
``
*
Installs
a
logrotate
configuration
for
the
Kafka
plugin
's log file
at: ``/etc/logrotate.d/trackrdr-kafka``.
* Installs a systemd unit file for the Tracking Reader. The
``trackrdrd`` service requires that the ``varnish`` service is
running.
If you change the config files in ``/etc``, they are not overwritten
by RPM updates. Changed config files from the package are saved with
the ``.rpmnew`` extension.
To change the broker address in ``/etc/trackrdr-kafka.conf``, specify
either a comma-separated host:port list of initial Kafka brokers with
``metadata.broker.list``, or a comma-separated host:port list of
ZooKeeper servers with ``zookeeper.connect``. See
`libtrackrdrd-kafka(3) <src/mq/kafka/README.rst>`_ for details.
You can, of course, specify another configuration file with the ``-c``
option (modify the systemd unit file to do this with systemd).
The systemd service is *not* started or enabled automatically when the
package is installed, and is not stopped on package update or
removal. This will have to be done with separate ``systemctl``
commands. This is because the Tracking Reader using Kafka is not
fully functional unless the configured brokers are listening, which
cannot be detected with systemd dependencies, and because most
deployments will change the default broker address. It is probably
best to automate package management with a script that issues ``yum``
and ``systemctl`` commands as needed.
The RPM does not support SysV init.
If you have problems or questions concerning the RPMs, post an issue
to one of the source repository web sites, or contact
<varnish-support@uplex.de>.
BUILDING FROM SOURCE
~~~~~~~~~~~~~~~~~~~~
``trackrdrd`` is built against an existing Varnish installation on the
``trackrdrd`` is built against an existing Varnish installation on the
same host, which in the standard case can be found with usual settings
same host, which in the standard case can be found with usual settings
for the ``PATH`` environment variable in the ``configure`` step
for the ``PATH`` environment variable in the ``configure`` step
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment