File: README

package info (click to toggle)
pflogsumm 1.1.0-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 180 kB
  • ctags: 30
  • sloc: perl: 1,017; makefile: 41; sh: 6
file content (51 lines) | stat: -rw-r--r-- 1,708 bytes parent folder | download | duplicates (2)
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

Pflogsumm README

There's not much to installing pflogsumm, so it's all manual.

    1. Unpack the distribution (if you're reading this, you've already
       gotten that far)

    2. Copy or move pflogsumm.pl to some directory from which you'll
       want to execute it.  Maybe rename it to just "pflogsumm."
       Watch the ownerships and permissions.  Make sure it's executable.

       E.g.:

	    cp pflogsumm.pl /usr/local/bin/pflogsumm
	    chown bin:bin /usr/local/bin/pflogsumm
	    chmod 755 /usr/local/bin/pflogsumm

    3. If there's a manual page available (pflogsumm.1), copy that to
       /usr/local/man/man1 or wherever you stash local manpages.  Make
       sure it's world-readable.

       E.g.:

	    cp pflogsumm.1 /usr/local/man/man1/pflogsumm.1
	    chown bin:bin /usr/local/man/man1/pflogsumm.1
	    chmod 644 /usr/local/man/man1/pflogsumm.1

    4. Read the man page (or the top of pflogsumm itself) for usage.

    5. Check the FAQ (pflogsumm-faq.txt)

    6. Configure your cron jobs if you're going to run pflogsumm on an
       automatic, scheduled basis.  There are tips in the manpage and
       the FAQ.

That's about it.

As the manpage and FAQ both note: pflogsumm requires the Date::Calc
Perl module.  If you don't have Date::Calc, don't want to bother
installing it and don't care about smtpd stats, you can remove the
code in pflogsumm that requires it.  For your convenience a Perl
script, "rem_smtpd_stats_supp.pl", has been provided that will do
this.  Simply run it in the directory in which pflogsumm was
unpacked *before* installing pflogsumm.  E.g.:

    perl rem_smtpd_stats_supp.pl

The script will tell you what it's done, if there were any problems,
etc.