annotate docs/testing.txt @ 386:278a03a392b1 noffle

[svn] * src/client.c: Return correct status from Client_postArt() and add function comment detailing what return code should be, because it's not obvious that the return code should report success when the posting failed for reasons other than connection problems. This should fix problem with failing posting stopping fetches. Thanks to Dan Jacobson for spotting this. * src/client.c: Fix problemette with filter discards not updating remote group article count and so the overview being refetched until and article appears that doesn't fall foul of the filter and thus does update the remove group 'next article' marker. Thanks to Dan Jacobson for spotting this.
author bears
date Thu, 22 May 2003 09:23:33 +0100
parents 8bb62a391b83
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
204
mirkol
parents:
diff changeset
1 SETTING UP A TEST ENVIRONMENT
mirkol
parents:
diff changeset
2
mirkol
parents:
diff changeset
3 last update: $Id: testing.txt 323 2001-11-11 04:20:28Z mirkol $
mirkol
parents:
diff changeset
4 written by: Mirko Liß, Nov 2001
mirkol
parents:
diff changeset
5
mirkol
parents:
diff changeset
6
mirkol
parents:
diff changeset
7 This document describes how to set up a testing environment for the unstable
mirkol
parents:
diff changeset
8 developer version of NOFFLE on a linux box.
mirkol
parents:
diff changeset
9
mirkol
parents:
diff changeset
10 You might not want to connect to the outside world with your newest hack.
mirkol
parents:
diff changeset
11 It's much better to install a stable version of NOFFLE and let it feed
mirkol
parents:
diff changeset
12 postings to the developer version.
mirkol
parents:
diff changeset
13
mirkol
parents:
diff changeset
14 The procedure step-by-step:
mirkol
parents:
diff changeset
15
mirkol
parents:
diff changeset
16 1. Install a stable version of noffle as usual. Or INN, if you have to
mirkol
parents:
diff changeset
17 blemish your soul by straying from the flock. Use this server to get
mirkol
parents:
diff changeset
18 articles from the common usenet and to act as an upstream server for
mirkol
parents:
diff changeset
19 your hacked version of noffle.
mirkol
parents:
diff changeset
20
mirkol
parents:
diff changeset
21 2. Install your hack with:
mirkol
parents:
diff changeset
22 ./configure --enable-debug=yes --with-spooldir=$ANYWHERE/spool/noffle \
mirkol
parents:
diff changeset
23 --with-configfile=$ANYWHERE/etc/noffle.conf \
mirkol
parents:
diff changeset
24 --with-docdir=$ANYWHERE/doc \
mirkol
parents:
diff changeset
25 --prefix=$ANYWHERE/usr/local --program-suffix=hack
mirkol
parents:
diff changeset
26 make
mirkol
parents:
diff changeset
27 make install
mirkol
parents:
diff changeset
28 Now the binary should be installed at:
mirkol
parents:
diff changeset
29 $ANYWHERE/local/bin/nofflehack
mirkol
parents:
diff changeset
30 Create a link to inews if you want to test that mode as well.
mirkol
parents:
diff changeset
31
mirkol
parents:
diff changeset
32 3. Edit $ANYWHERE/etc/noffle.conf:
mirkol
parents:
diff changeset
33 server localhost
mirkol
parents:
diff changeset
34 log-debug all
mirkol
parents:
diff changeset
35 If you changed the syslog ident or the facility (to LOG_USER)
mirkol
parents:
diff changeset
36 ( see: grep Log_init src/noffle.c ), you have to edit
mirkol
parents:
diff changeset
37 /etc/syslog.conf and eventually create new empty logfiles.
mirkol
parents:
diff changeset
38
mirkol
parents:
diff changeset
39
mirkol
parents:
diff changeset
40 4. If you have to delete the database, just type:
mirkol
parents:
diff changeset
41 make install-data-local
mirkol
parents:
diff changeset
42 to get rid of the strange error messages.
mirkol
parents:
diff changeset
43
mirkol
parents:
diff changeset
44 5. If you want to use nofflehack in server mode, just add another port
mirkol
parents:
diff changeset
45 entry to /etc/services. Assigned Port numbers are listed at:
mirkol
parents:
diff changeset
46 http://www.iana.org/assignments/port-numbers
mirkol
parents:
diff changeset
47 Then add another line to /etc/inetd.conf (or whatever you use).
mirkol
parents:
diff changeset
48 Don't forget to tell your newsreader about the port number you chose.
mirkol
parents:
diff changeset
49
mirkol
parents:
diff changeset
50 If you want to tamper with the article database, there are various nice
mirkol
parents:
diff changeset
51 gdbm tools available for Perl or Python. I often prefer shell-scripts
mirkol
parents:
diff changeset
52 and used gdbm-primitive-1.15.tar.gz listed at http://freshmeat.net.
mirkol
parents:
diff changeset
53 Be careful with file locking, though.