4
0 Find and install development files for:
6
g++ >= 3.2 - http://gcc.gnu.org/
7
zlib - http://www.gzip.org/zlib/
8
mimelib (kdenetwork) - ftp://download.uk.kde.org/pub/kde/stable/latest/src
9
xsltproc (libxslt1) - http://xmlsoft.org/XSLT/
11
If you need to, lurker can be built using only g++ 2.95, however 3.2+ is
12
recommended as the resulting binaries are much smaller and faster.
14
If you do not want kdenetwork, you can also download mimelib separately
15
from http://sourceforge.net/project/showfiles.php?group_id=8168 and tell
16
lurker to compile it and statically link to it.
18
xsltproc is not strictly required for lurker. It is not used during compile
19
and is only used if your lurker.conf references it. However, it is the
20
preferred method for rendering html, so we recommend installing it.
22
For debian: apt-get install xsltproc libmimelib1-dev g++ zlib1g-dev
24
1 [flags] ./configure [options]
26
To control the mimelib location, setting these options may help:
27
--with-mimelib-local Use internal lurker/mimelib/*
28
--with-mimelib-include=DIR Location of mimelib/message.h
29
--with-mimelib-libname=LIB Try an alternative library name
31
To control the zlib location, setting these options may help:
32
--with-zlib-include=DIR Location of zlib.h
33
--with-zlib-libname=LIB Try an alternative library name
35
To control the environment, variants of these flags may help:
37
CPPFLAGS="-I/sw/include -DDW_UNIX"
41
3 make install (as root if you don't have permission)
43
You may want to strip the binaries as they can be quite large.
45
This will install these files:
47
/usr/local/lib/cgi-bin/*.cgi
48
- The CGIs which power lurker
49
- These must be placed such that the webserver can run them
50
/usr/local/var/www/lurker/*
51
- The lurker content which must be web accessible
52
- The subdirectories "attach, list, mbox, message, mindex,
53
search, splash, and thread" must all be writeable by
54
whatever user executes lurker.cgi
55
/usr/local/bin/lurker-*
56
- Command-line utilities for importing email, cleaning
57
cached web files, and interfacing with shell scripts
58
/usr/local/var/lib/lurker/*
59
- The lurker database directory where mail is imported to
60
- The directory and its contents must be writeable by the
61
user who runs lurker-index
62
- This must be readable by the user who runs lurker.cgi
64
You must install the file /usr/local/etc/lurker.conf by hand.
65
Then customize it using the provided lurker.conf as a starting point.
67
4 Setup delivery of new mail to lurker-index
71
* ^X-Mailing-List: <debian-japanese@lists.debian.org>.*
72
| lurker-index -c /etc/lurker.conf -l japanese -m
75
5 Feed archived mail through lurker-index.
77
lurker-index -c /etc/lurker.conf -l devel -b 5 < debian-devel.mbox
79
Keep in mind these points:
81
a. Lurker imports benefit primarily from a fast CPU and fast RAM.
82
Lurker rendering of pages benefits from more RAM (for disk cache).
84
b. The lurker database will consume space on the order of 40% of the
85
mailboxes it indexes. You must keep the mbox lurker creates,
86
although the original mbox is not required after lurker-index.
88
c. Nearly all of the processing time lurker spends is on importing
89
messages. Once you have indexed your archive, lurker no longer needs
92
6 Setup a cronjob to update the archive every 15 minutes
94
0,15,30,45 * * * * lurker-prune -c /etc/lurker.conf -d /path/to/www/lurker
96
This must be run with the ability to read and delete files from the
97
web-server cache directory.
99
7 Configure your webserver.
101
You must make certain that .xsl and .xml files have type text/xml.
102
For email reply support .rfc822 must have type message/rfc822.
103
You must set the default charset to UTF-8 for these files.
104
You must make lurker your 404 error handler or another way of creating
105
missing cache files (eg: apache's RewriteRule).
106
You must pass the config file and lurker's document root to lurker.cgi
107
as ? delimited arguments in QUERY_STRING 'cfgfile?docdir'. The docdir
108
is relative to the location of lurker.cgi and cfgfile is relative to
111
NOTE: The docdir here is the location of lurker.docroot.
112
This has nothing at all to do with your webservers document root.
113
Typically this is /usr/local/var/www/lurker or /var/www/lurker.
115
If you run apache with a directory structure like:
133
then .htaccess should contain:
135
AddType text/xml .xsl
136
AddType text/xml .xml
137
AddType message/rfc822 .rfc822
138
AddDefaultCharset UTF-8
139
ErrorDocument 404 /cgi-bin/lurker.cgi?../lurker.conf?../htdocs
141
or, using the Rewite Engine (avoids 404 log messages):
143
AddType text/xml .xsl
144
AddType text/xml .xml
145
AddType message/rfc822 .rfc822
146
AddDefaultCharset UTF-8
148
RewriteCond %{REQUEST_FILENAME} !-s
149
RewriteRule (attach|list|mbox|message|mindex|search|splash|thread)/ /cgi-bin/lurker.cgi?../lurker/lurker.conf?../htdocs [T=application/x-httpd-cgi,L,PT]
151
8 point your browser at the url where lurker is installed