/usr/share/doc/lire/user-manual/ch02s04.html is in lire-doc 2:2.1.1-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Responder Installation</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Lire User's Manual"><link rel="up" href="ch02.html" title="Chapter 2. Installing Lire"><link rel="prev" href="ch02s03.html" title="Anonymized Client Installation"><link rel="next" href="ch03.html" title="Chapter 3. Running Lire"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Responder Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s03.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installing <span class="application">Lire</span></th><td width="20%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr></table><hr></div><div class="section" title="Responder Installation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sect:responder-install"></a>Responder Installation</h2></div></div></div><p>When you want to generate reports for several servers,
it is best to install <span class="application">Lire</span> as a responder on one system to
which to other systems can send their log files. This section
describes how to setup <span class="application">Lire</span> as a responder.
</p><div class="section" title="Requirements"><div class="titlepage"><div><div><h3 class="title"><a name="sect:responder-install-req"></a>Requirements</h3></div></div></div><p>Responder installation has the same requirements as
the standalone installation (see <a class="xref" href="ch02s02.html" title="Standalone Installation">the section called “Standalone Installation”</a>).
</p><p>There is the following additional requirement:
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>The <code class="systemitem">MIME-Tools</code>
perl module (available from any CPAN mirror, <a class="ulink" href="http://www.cpan.org/modules/by-module/MIME/" target="_top">http://www.cpan.org/modules/by-module/MIME/</a>.</p></li></ul></div><p>
</p></div><div class="section" title="Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id380989"></a>Installation</h3></div></div></div><p>Basic installation procedure is the same as a
standalone installation (see <a class="xref" href="ch02s02.html" title="Standalone Installation">the section called “Standalone Installation”</a>). You might want to
change the <code class="option">--with-spooldir</code> option to
<span class="command"><strong>configure</strong></span> (the default is
<code class="filename"><em class="replaceable"><code>prefix</code></em>/var/spool/lire</code>:
</p><pre class="screen">
<code class="prompt">$ </code>./configure [<span class="optional"><code class="option">--prefix</code>=<em class="replaceable"><code>path</code></em> <code class="option">--with-spooldir</code>=<em class="replaceable"><code>path_to_spooldir</code></em></span>]
</pre><p>
</p><p><span class="application">Lire</span> in a responder setup runs the
<span class="command"><strong>lr_spoold</strong></span> daemon which scans maildirs
where requests are delivered. Consequently, to finish the
responder installation you have to create a maildir for
each service you want to support and setup delivery to
those maildirs.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>A <em class="firstterm">maildir</em> is a mailbox format
first developed as part of <span class="productname">Qmail</span>™ where messages are
stored in a directory hierarchy instead of a single
file. You can find more informations about the maildir
format at <a class="ulink" href="http://www.courier-mta.org/maildirmake.html" target="_top">http://www.courier-mta.org/maildirmake.html</a>.
</p><p>As far as <span class="application">Lire</span> is concerned, a maildir is a subdirectory
<code class="filename"><em class="replaceable"><code>service</code></em>/Maildir/new</code>
which contains email messages in separate files.
</p></div><p>The <code class="filename"><em class="replaceable"><code>sysconfdir</code></em>/lire/address.cf</code>
contains the name of the maildirs that are to be scanned
and the type of log files that the emails should contain.
</p><p>Refer to your MTA's documentation for notes on
how to setup delivery to maildir. We give some notes on
how to do this in the following sections.
</p><p>The <span class="command"><strong>lr_setup_responder</strong></span> script can be used to
setup some required infrastructure for the responder. Alternatively,
one can execute the setup manually: One can create the maildirs by
doing e.g.
</p><pre class="screen">
<code class="prompt">$ </code>cd ~/lire
<code class="prompt">$ </code>mkdir -p var/spool/lire/common
<code class="prompt">$ </code>maildirmake var/spool/lire/common/Maildir
<code class="prompt">$ </code>cd ~/lire/var/spool/lire
<code class="prompt">$ </code>mkdir bind8_query postfix qmail sendmail
<code class="prompt">$ </code>maildirmake bind8_query/Maildir
<code class="prompt">$ </code>maildirmake postfix/Maildir
<code class="prompt">$ </code>maildirmake qmail/Maildir
<code class="prompt">$ </code>maildirmake sendmail/Maildir
</pre><p>
<span class="command"><strong>maildirmake</strong></span> gets distributed with qmail and
with the Courier Mail Server <a class="ulink" href="http://www.courier-mta.org" target="_top">http://www.courier-mta.org</a>.
If you haven't set up delivery to maildirs yet, doing a
</p><pre class="screen">
<code class="prompt">$ </code>maildirmake foo
</pre><p>
is about the same as doing
</p><pre class="screen">
<code class="prompt">$ </code>mkdir foo
<code class="prompt">$ </code>mkdir foo/cur foo/new foo/tmp
<code class="prompt">$ </code>chmod og-rwx foo foo/*
</pre><p>
</p></div><div class="section" title="Installing Under MTA's using procmail as their MDA"><div class="titlepage"><div><div><h3 class="title"><a name="sect:responder-install.procmail"></a>Installing Under MTA's using procmail as their MDA</h3></div></div></div><p>On many systems, procmail is used as the default Mail Delivery
Agent. For instance, sendmail very often is configured to use
procmail. If your MTA is configured like this, you can use procmail
to take care of delivering to the right Maildir. We give some hints
on how to get this done.</p><p>
In Lire's <code class="filename">$HOME/.procmailrc</code> you can put
</p><pre class="programlisting">
:0:
* ^To:.*combined-log@
<LR_SPOOLDIR>/combined/Maildir/new
:0:
* ^To:.*sendmail-log@
<LR_SPOOLDIR>/sendmail/Maildir/new
</pre><p>
etc.
Make sure to replace <em class="replaceable"><code><LR_SPOOLDIR></code></em>
by the appopriate path. After that, you'll only have to make sure
that the addresses combined-log, sendmail-log, etc. are aliases for
the Lire user. You can then run lr_spoold to monitor the spool
archives.</p></div><div class="section" title="Installing Under Exim"><div class="titlepage"><div><div><h3 class="title"><a name="sect:responder-install.exim"></a>Installing Under Exim</h3></div></div></div><p>There is more than one way to setup maildir delivery
on a system running exim <a class="ulink" href="http://www.exim.org/" target="_top">http://www.exim.org/</a>.
We show only one.
</p><p>Be sure to have "maildir_format" enabled in the
address_directory: section, e.g.
</p><pre class="screen">
address_directory:
driver = appendfile
no_from_hack
prefix = ""
suffix = ""
maildir_format
</pre><p>
in your exim.conf's transport configuration. Furthermore,
have "directory_transport" transport in the userforward
driver set to "address_directory", e.g.
</p><pre class="screen">
userforward:
driver = forwardfile
file_transport = address_file
pipe_transport = address_pipe
reply_transport = address_reply
directory_transport = address_directory
no_verify
check_ancestor
check_local_user
file = .forward
modemask = 002
filter
</pre><p>
in your <code class="filename">exim.conf</code>'s directors configuration.
Create a maildir, e.g.
<code class="filename">~/.lire/var/spool/combined/</code>.
(See the qmail section for how to do this.) Finally, do
e.g.
</p><pre class="screen">
<code class="prompt">$ </code> cat <<EOT > .forward
> # Exim filter
> save \$home/.lire/var/spool/combined/
> EOT
</pre><p>
One could create more than one maildir, and configure the
useraccount to store email messages for different services in
different maildirs. We wont go into this such detail here
though.
</p></div><div class="section" title="Installing Under qmail"><div class="titlepage"><div><div><h3 class="title"><a name="sect:responder-install.qmail"></a>Installing Under qmail</h3></div></div></div><p>
Suppose your configure-time prefix was $HOME/lire.
</p><pre class="screen">
<code class="prompt">$ </code>cd ~/lire/var/spool/lire/postfix
<code class="prompt">$ </code>maildirmake Maildir
<code class="prompt">$ </code>echo './lire/var/spool/lire/postfix/Maildir/' > .qmail-postfix
</pre><p>
Get mail to postfix@yourhost delivered to
hibou-postfix@yourhost, and controlled by
<code class="filename">~hibou/.qmail-postfix</code>:
</p><pre class="screen">
<code class="prompt">$ </code>su
<code class="prompt"># </code>cd /var/qmail/control/users
<code class="prompt"># </code>vi assign
=postfix:hibou:1028:1028:/home/hibou:-:postfix:
</pre><p>
Get mail to anybody@postfix.yourdomain delivered to the
local postfix mailbox:
</p><pre class="screen">
<code class="prompt"># </code>vi virtualdomains
postfix.yourdomain:postfix
</pre><p>
Now send your qmail-send process a SIGHUP.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Anonymized Client Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Running <span class="application">Lire</span></td></tr></table></div></body></html>
|