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
|
This is the README for the Debian version of diablo.
0. INTRODUCTION
This file needs some more work. There is not much documentation for
diablo anyway.
1. LOCATION OF FILES
Diablo `as-is' places everything under /news. For Debian, Diablo has been
converted to the File System Standard (FSSTND).
o Configuration files: /etc/news
o Spool: /var/spool/news
o History files, precommit cache, dynamic feeds subscription: /var/lib/news
o Binaries: /usr/sbin/diablo, the rest in /usr/lib/news/dbin
o Admin scripts: /usr/lib/news/adm
o Log files: /var/log/news
2. DOCUMENTATION
Read everything in /usr/doc/diablo. Read the manpages: you can get a
list of manpages by using "dpkg -L diablo | grep man".
3. CONFIGURATION AND STARTUP
Diablo will not start when it's not configured. For this it checks the
file /etc/news/diablo.pathname, which initially contains the word
"unconfigured". This file should contain the news-pathname of your system.
Take a look at the example configuration files in /usr/doc/diablo/examples.
The most important configuration files are:
o dhosts.nntp: Give access to remote NNTP servers for feeding you
o dnewsfeeds: Outgoing newsfeeds. This file controls the creation of
spoolfiles in /var/spool/news/dqueue by diablo.
o dspoolout.ctl: Every 5 minutes `dspoolout' runs. This process takes the
spool files created by diablo and sends the news to
the destination sites.
If you were running INN before, you can roughly convert (editting needed)
the `newsfeeds' and `hosts.nntp' file to the three diablo counterparts
by running the perl script /usr/doc/diablo/examples/inn2diablo.pl
4. CAVEATS.
The `GLOBAL' entry makes global entries for the "alias" and "delspam"
keywords but NOT for newsgroups - don't ask me why. Do not try to
use the `GLOBAL' entry as newsgroup-pattern-template or you'll just end
up with a very large spool file for the site labeled `GLOBAL' ...
Instead, you can create a `groupdef' entry - see the sample dnewsfeeds file.
This is also what the inn2diablo script does for you if needed.
5. LIES, DAMNED LIES, AND STATISTICS.
There is a good statistics program for diablo called diablo-stats. It was
written by Iain Lea and you can find it on
ftp://ftp.ecrc.de/pub/news/servers/diablo-utils/
To use this you need to edit /etc/syslog.conf to log some more info to
/var/log/news/news.notice, to be exact everything from the info level.
So that line in /etc/syslog.conf should look like this:
BEFORE:
news.notice -/var/log/news/news.notice
AFTER:
news.info -/var/log/news/news.notice
Ofcourse, you can also just add the news.info line and change the
diablo-stats configuration to look for news.info instead of news.notice.
Maybe some day I'll fix diablo to log the stuff needed for diablo-stats
by default, and provide diablo-stats as a Debian package.
6. MORE INFO.
Diablo is being discussed on Usenet in `news.software.nntp'. The home site
of diablo is http://www.backplane.com/diablo/ .
|
