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
|
Last edited: $Date: 2002/10/28 09:55:37 $
Basic Installation Instructions
===============================
1. Preparations
---------------
The following libraries are used by modlogan:
Required libs
- 1. libz
- 2. libpcre >= 3.1
- 3. expat
Highly Recommend libs
- 4. libgd >= 1.7.x (2.0.1 is ok, too)
- 5. libpng
Optional libs
- 6. libadns
- 7. dmalloc (optional for debugging purposes only)
Required software
- 1. gmake
NOTE: the configure script will check for all those libraries and will
notify you if neccasary.
If no packages are available for your platform you have to compile the
libraries by yourself:
- 1. libz (??)
- 2. libpcre from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/
- 3. libgd from http://www.boutell.com/gd/
(if generated libgd is shared use the patched libgd from
http://www.kneschke.de/projekte/modlogan/download/)
- 4. expat (http://expat.sf.net/)
- 5. libpng (ftp://ftp.libpng.org/pub/png/src/)
- 6. libadns (http://www.chiark.greenend.org.uk/~ian/adns/)
- 7. dmalloc (optional for debugging purposes only)
1.1 Introduction
----------------
The 'Mod' in the word ModLogAn stands for 'modular' which means that the
input section, processing section and the output section are seperated
in modules which can be loaded at runtime. The modules are selected by
the config-file and are working transparently for the user.
To compile the 'dynamic' version you have pass some special requirements.
EVERY library that is used by modlogan and its plugins has to be available
in a SHARED version (<libname>.so). Most important are libgd and libpcre.
If you install both packages on a Linux system make sure that they are
available in a shared version. Some distribution are only providing static
versions of these libraries.
1.1.1 Extracting the sources
----------------------------
If all the libraries are installed, you have to check if you have everything
in place which is required by modlogan itself:
required:
- modlogan-<version>.tar.gz (the sources of this package)
optional
- modlogan-themes-<version>.tar.gz (the themes for the output plugin
"output_template")
- modlogan-config-<version>.tar.gz (a configfile wizzard)
If yes, unpackage everthing:
$ gzip -cd modlogan-<version>.tar.gz | tar xf -
$ gzip -cd modlogan-themes-<version>.tar.gz | tar xf -
$ gzip -cd modlogan-config-<version>.tar.gz | tar xf -
1.1.2 Preparing compilation
---------------------------
This step is handled by the configure script.
Type:
$ cd modlogan-<version>
$ ./configure
Please note:
The output modules will only be build with graphics support if you have
shared version of libgd !!
2. compilation
--------------
configure modlogan according to the step 1.1.2 and type the
following:
$ make
$ make install
3. configuration
----------------
Either you use the configfile-wizzard 'modlogan-config' or you setup
modlogan yourself based on the config-file in ./doc/modlogan.conf-dist.
4. Running modlogan
-------------------
- execute modlogan:
$ ... ./modlogan -c <configfilename>
In most cases modlogan is started the following way:
$ bzip2 -cd access.log.<current-date>.bz2 | /usr/local/bin/modlogan -c \
<configfile-host>
------------------------------------------------------------------------------
If you've found a bug, need a special feature or just want to tell me how
you like this piece of software, send your mail to:
Jan Kneschke <jan@kneschke.de> || modlogan@lists.netuse.de
(subscribtion required)
------------------------------------------------------------------------------
|
