Mercurial > noffle

comparison docs/testing.txt @ 204:8bb62a391b83 noffle

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[svn] my not quite useless testbench. Useless for most developers, but hopefully usefull for beginners.
author mirkol
date Sun, 11 Nov 2001 04:20:28 +0000
parents
children
comparison
equal deleted inserted replaced
203:5b23ec777ae6 204:8bb62a391b83
1 SETTING UP A TEST ENVIRONMENT
2
3 last update: $Id: testing.txt 323 2001-11-11 04:20:28Z mirkol $
4 written by: Mirko Liß, Nov 2001
5
6
7 This document describes how to set up a testing environment for the unstable
8 developer version of NOFFLE on a linux box.
9
10 You might not want to connect to the outside world with your newest hack.
11 It's much better to install a stable version of NOFFLE and let it feed
12 postings to the developer version.
13
14 The procedure step-by-step:
15
16 1. Install a stable version of noffle as usual. Or INN, if you have to
17 blemish your soul by straying from the flock. Use this server to get
18 articles from the common usenet and to act as an upstream server for
19 your hacked version of noffle.
20
21 2. Install your hack with:
22 ./configure --enable-debug=yes --with-spooldir=$ANYWHERE/spool/noffle \
23 --with-configfile=$ANYWHERE/etc/noffle.conf \
24 --with-docdir=$ANYWHERE/doc \
25 --prefix=$ANYWHERE/usr/local --program-suffix=hack
26 make
27 make install
28 Now the binary should be installed at:
29 $ANYWHERE/local/bin/nofflehack
30 Create a link to inews if you want to test that mode as well.
31
32 3. Edit $ANYWHERE/etc/noffle.conf:
33 server localhost
34 log-debug all
35 If you changed the syslog ident or the facility (to LOG_USER)
36 ( see: grep Log_init src/noffle.c ), you have to edit
37 /etc/syslog.conf and eventually create new empty logfiles.
38
39
40 4. If you have to delete the database, just type:
41 make install-data-local
42 to get rid of the strange error messages.
43
44 5. If you want to use nofflehack in server mode, just add another port
45 entry to /etc/services. Assigned Port numbers are listed at:
46 http://www.iana.org/assignments/port-numbers
47 Then add another line to /etc/inetd.conf (or whatever you use).
48 Don't forget to tell your newsreader about the port number you chose.
49
50 If you want to tamper with the article database, there are various nice
51 gdbm tools available for Perl or Python. I often prefer shell-scripts
52 and used gdbm-primitive-1.15.tar.gz listed at http://freshmeat.net.
53 Be careful with file locking, though.