1 NewsStats 0.1 (c) 2010-2013 Thomas Hochstein <thh@inter.net>
3 NewsStats is a software package used to gather statistical information
4 from a live Usenet feed and for its subsequent examination.
6 This script package is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Public License as published by
8 the Free Software Foundation.
10 ---------------------------------------------------------------------
12 INSTALLATION INSTRUCTIONS
14 1) Install the scripts
16 * Get INN, mysql, Perl, and the necessary modules installed (see README).
18 * Download the current version of NewsStats from
19 <http://th-h.de/download/scripts.php>.
21 * Untar it into a directory of your choice:
23 # tar -xzf newsstats-nn.tar.gz
25 Scripts in this path - at least feedlog.pl - should be executable by the
30 * Copy the sample configuration file newsstats.conf.sample to
31 newsstats.conf and modify it for your purposes:
33 # cp newsstats.conf.sample newsstats.conf
36 a) Mandatory configuration options
39 Database driver used; currently only mysql is supported.
42 The host your mysql server is running on.
45 The username to connect to the database server.
48 Matching password for your username.
50 * DBDatabase = newsstats
53 NewsStats will use those credentials to connect to your mysql
57 Table holding raw statistical data.
59 * DBTableGrps = groups_de
60 Table holding data on postings per group.
62 b) Optional configuration options
65 Limit examination to that top-level hierarchy.
67 3) Database (mysql) setup
69 * Setup your database server with a username, password and
70 database matching the NewsStats configuration (see 2 a).
72 * Start the installation script:
76 It will setup the necessary database tables and display some
77 information on the next steps.
81 You have to setup an INN feed to feedlog.pl.
83 * Edit your 'newsfeeds' file and insert something like
85 ## gather statistics for NewsStats
88 :Tc,WmtfbsPNH,Ac:/path/to/feedlog.pl
90 * You should only feed that hierarchy (those hierarchies ...) to
91 feedlog.pl you'll want to cover with your statistical
92 examination. It may be a good idea to setup different feeds (to
93 different databases ...) for different hierarchies.
95 * Please double check that your path to feedlog.pl is correct and
96 feedlog.pl can be executed by the news user
98 * Check your 'newsfeeds' syntax:
102 * Reload 'newsfeeds':
104 # ctlinnd reload newsfeeds 'Adding newsstats! feed'
106 * Watch your 'news.notice' and 'errlog' files:
108 # tail -f /var/log/news/news.notice
110 # tail -f /var/log/news/errlog
112 Everything should be going smoothly now.
114 * If INN is spewing error messages to 'errlog' or reporting
115 continous respawns of feedlog.pl to 'news.notice', stop your feed:
117 # ctlinnd drop 'newsstats!'
119 and investigate. 'errlog' may be helpful here.
121 * You can restart the feed with
123 # ctlinnd begin 'newsstats!'
127 You should be done now.
129 Just have a look at your raw data (DBTableRaw). It should now start to