204
+ − 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.