annotate docs/testing.txt @ 414:898c744a63ca noffle

[svn] fixed lost gdbm transition
author godisch
date Thu, 19 Jun 2003 23:37:47 +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.