$ 			DNEWS Installation, a brief guide$ 			---------------------------------  ? DNEWS is a dynamic news server system, it is not a news reader!   N Distributed by EGLE Magic emagic@world.std.com, it is not freeware, please see license.txt for details.  L These instructions describe how to setup a sucking news feed, see the manual/ for setting up a traditional feeding mechanism. M ----------------------------------------------------------------------------- & Installation VMS: (see below for UNIX)> 	1) FTP the files from ftp.std.com ftp/vendors/emagic/dnews... 		extract.com	(ascii)  		install.txt	(ascii)  		dnews.bck_z	(binary); 	2) @extract  	Extracts the required files from the saveset = 	3) Modify REGISTER_USER.COM to register a user DNEWS$SERVER   	4) @REGISTER_USER.COM? 	5) Modify DNEWS_START.COM to define the disks news should use.  	   (don't run it yet!) H 	6) $ edit sys$manager:systartup_v5.com    Add a call to dnews_start.comE 	7) $ edit sys$sylogin:           Add the symbol, see dnews_login.com # 	8) $ edit dnews_top:dnews.conf     - 		Modify the file DNEWS.CONF to describe your ,   		system by defining the following symbols 			SYMBOL		EXAMPLE 			manager		system  	 % 					(email address or user@site.com)  			nntp_feeder	news.feeder.site  			myname		news.this.place 			timezone	nzst  					(new zealand standard time) 			diskspace	100# 					(space available in megabytes) 
 			mail		smtp & 					(the foreign email protocol name)3 			confirm		*.this.place  Enable email confirmation - 					when item is passed up to a feeder site. @ 	9) If your news feeder stamps news items with a name other thanB 	    the ip name you specified above, then you will need to add anD 	    exclude field to the file newsfeeds.conf to prevent your system+ 	    echoing all news back to the feeder!!! ? 	    (check the path header of an item to see what it is doing) H 	10) $ edit access.conf          Grant an ip range access to your users. 					by name or number, e.g. 			*.this.place:read,post:::*  			161.23.4.*:read,post:::*        + 	11) $ @dnews_start	       Start the system 6  	    $ @dnews_login 		(to define the symbol tellnews)A 	 The system will now try and get a list of news groups from your F   	 feeder site, while this is happenning it will not respond, but you 	 can check it's progress by:  	    $ type dnews.infoA 	 When it has finished (give it 10-20 minutes), you can then try:  	    $ tellnews status  > 	12) Go to a PC and try out your news reader software pointed  	    at the new system. M ----------------------------------------------------------------------------- & Installation for UNIX:  (Sucking feed)> 	1) FTP the files from ftp.std.com ftp/vendors/emagic/dnews... 		dnews_MACHINE.tar.Z		(binary)  		(e.g. dnews_linux.tar.Z	) 8 	2) Extract to a temporary directory in your own account 		uncompress dnews_linux.tar 		tar -xvf dnews_linux.tar 	3) EDIT dnews.conf - 		Modify the file DNEWS.CONF to describe your ,   		system by defining the following symbols 			SYMBOL		EXAMPLE 			manager		system  	 % 					(email address or user@site.com)  			nntp_feeder	news.feeder.site  			myname		news.this.place 			diskspace	100# 					(space available in megabytes)   			df		The path and flags for df+ 			sendmail	The path and flags for sendmail 3 			confirm		*.this.place  Enable email confirmation - 					when item is passed up to a feeder site. 8 	4) Edit your system startup script, the name will vary: 		On LINUX /etc/rc.d/rc.local 
 		Add a line: " 			/usr/local/dnews/dnews_start.sh@ 	5) If your news feeder stamps news items with a name other thanB 	    the ip name you specified above, then you will need to add anD 	    exclude field to the file newsfeeds.conf to prevent your system+ 	    echoing all news back to the feeder!!! ? 	    (check the path header of an item to see what it is doing) > 	6) Edit access.conf 		Grant an ip range access to your users. 					by name or number, e.g. 			*.this.place:read,post:::*  			161.23.4.*:read,post:::* A 	7) If you have changed any of the default directories, then edit / 	   all the .sh scripts to reflect the changes.  	8) Run the installation script < 		su root   (You need priv to install the files start dnews) 		./install.sh 	9) Start the system 		./dnews_start.shA 	 The system will now try and get a list of news groups from your F   	 feeder site, while this is happenning it will not respond, but you 	 can check it's progress by:  		more dnews.info A 	 When it has finished (give it 10-20 minutes), you can then try:  	    	> tellnews status   > 	10) Go to a PC and try out your news reader software pointed  	    at the new system. M -----------------------------------------------------------------------------  Installing a full feed:   F In access.conf, give your feed site access to send you ihave messages: 	my.feeder.site.com:ihave:::* 6 In dnews.conf, comment out the nntp_feeder definition. In newsfeeds.conf  	Replace 		site $NNTP_FEEDER  			groups * 
 			builtin
 			posting 	With  		site my.feeder.site  			groups * 
 			builtin  0 Copying important files from an existing system:9 	With a sucking system you can do this with the commands:  		tellnews getnames / 	The active file will be fetched automatically.   9 	However if you are replacing a news system then you want 8 	the active file from the one you replace, not from your
 	feeder site:   ! 	You can safely copy these files:    	active		-> active.dat 	active.times	-> active.times 8 	newsgroups 	-> active.names  (may be changed in future) 	 7 	If you copy the active file, you must reset it so that < 	it doesn't think it has any items, do this with the command 		tellnews resetall  	  Renaming a volume (on unix):8 	You may wish to rename a current volume /var/spool/news$ 	to be /var/spool/dnews, to do this:   	cd /var/spool/news 
 	mkdir OLD	 	mv * OLD  	umount /var/spool/news " 	emacs /etc/vfstab (or /etc/fstab) 		(change /news into /dnews) 	mount /var/spool/dnews  	 ? 	When you are happy with the new system, or you need the space:    		rm -r /var/spool/dnews/OLD 	 M -----------------------------------------------------------------------------  Recommended news readers: 	 	For PC's  		Netscape's built in reader.  		WINVN 4 		Trumpet (old versions are slow, get a new version) 	For VMS 		FNEWS   ; Testing DNEWS or your FEEDER site or your OWN site by hand: " VMS	$ telnet feeder.site /port=119 UNIX	> telnet feeder.site 119 # 	group comp.os.vms	(select a group)  	head			(display the header) 	body			(display the body) 	next			(next item please) 	help			(show valid commands)  	quit			(exit the connection)  	$   	 M -----------------------------------------------------------------------------   FAQ and What if it doesn't work:M ----------------------------------------------------------------------------- 1 FTP the complete manual in MS word 6 format from: 2 	ftp.std.com ftp/vendors/emagic/dnews/dnewsdoc.zip  3 Can't BIND, and tellnews sais "I can't talk to you" L 	LINUX slackware: Comes with a dummy nntp daemon installed, you must remove & 	this so dnews can bind to the socket. 		edit /etc/inetd.conf 		(comment out the NNTP line) " 		kill -HUP <pid of inetd process> TELLNEWS fails  D 	The DNEWS process may take 1-2 minutes to initialize, so wait a bit 	before panicking.    	Check if the process is running 		ps -axl | grep dnews	(linux) 		ps -ef | grep dnews	(sunos)  	  	Check the log files+ 		more /usr/local/dnews/dnews.error (.info)  	 C 	If it gets started up with the wrong PID you will get all sorts of ' 	protection problems,  all the files in 3 		/var/spool/dnews/...  (including var/spool/dnews) 0 	must be owned by the same user, normally 'news' 	Also all the files in:  		/var/local/dnews/*$ TELLNEWS gives unusual error messageC 	On vms, if the symbol tellnews is not defined, it will try and run ' 	telnet instead, this can be confusing.   M -----------------------------------------------------------------------------  Using other TCPIP stacks on VMS  ------------------------------- C 	Only the multinet driver has been tested.  The ucx driver has been 9 	compiled and will probably work with very little effort.    To build a new TCPIP driver: 	$ edit nntp.c< 	(Add a section to include the header files for your version. 	of tcpip, ifdef it in some obvious way). e.g. 		#ifdef MULTINET : 			#include "multinet_root:[multinet.include.sys]socket.h" 			... 		#endif  
 	$ edit n.com ; 	(Change the compile line so it defines the symbol that you = 	used above to distinguish your tcpip software AND change the " 	name of the object file too) e.g.= 		$ cc nntp.c /define=("MULTINET"="TRUE") /obj=nntp_multi.obj  	 
 	$ edit l.com D 	(Add a section to link to your tcpip stack, you will need to changeG 	the name of the nntp_XXX.obj file name and probably the socket library  	name.)     	Try and compile it and link it: 		$ @N 		$ @l multinet all   @ 	Most likely it will fail because of some conflict between namesA 	e.g. socket_close(), or simply close(),  add ifdefs to NNTP.C to  	correct for this.  E 	Once you have it working, email the files nntp.c and l.com and n.com D 	to egle magic and we will maintain and distribute these changes for 	others. 				emagic@world.std.comM -----------------------------------------------------------------------------  Mailing list ------------= 	You can join the dnews mailing list by sending a message to:  		maiser@emagic.co.nz  	Containing one line:  		subscribe dnews   G This is a moderated mailing list, it's only function is to announce new K versions of dnews and to disseminate up to date information on installation C problems, bugs, new features etc to people who manage news systems.   J You will not be flooded with mail from this mailing list, it will probably average 1-2 messages a month.   M ----------------------------------------------------------------------------- + Notes on compiling and porting DNEWS (unix) $ ------------------------------------  	Uncompess and untar the savesetE 	Copy a config file which matches your machine, if one does not match ( 	then find the closest one you can. e.g.) 	(for SunOS)	> cp config.solaris config.i ' 	(for LINUX)	> cp config.linux config.i  	 ' 	Edit and modify config.i as necessary.  	Type in make all.
 			> make all 1 	Now follow the normal installation instructions.   C 	If you have to make changes to the config.i file, then email it to B 	EGLE Magic, specifying what type of machine & OS it is for and we* 	will include it in the next distribution.  @ 	If you change source code then email us the entire source files? 	that were changes, please don't send diff or patch files these 8 	are extremely difficult to merge from multiple sources.  = 	When making machine specific changes, IFDEF all the changes  : 	and where possible use 'feature' like ifdefs rather than  	'machine' related ifdefs, e.g.    		#ifdef NEEDS_STRDUP  			... 		#endif0 	(then define NEEDS_STRDUP in the config.i file)
 	Rather than:  		#ifdef LINUX 			... 		#endif 	 M ----------------------------------------------------------------------------- J Updates, List of bugs fixed for each version.  Recent versions at the top.M -----------------------------------------------------------------------------  0.9d  (Wide BETA release 2) F 	+ Fixed embarassing bug which prevented news groups from being added.5 	+ Added missing nocached.body file to distribution.	  0.9c  (Wide BETA release) A 	+ Socket error's trapped correctly, this was causing the process E 	  to dissappear when a connection was badly closed at the other end. D 	+ New articles added after an expire run were indexed incorrectly.  	+ Messages tidied up < 	+ Control mail messages now contain "done" or "logged only"1 	+ Pause message now contains status information. B 	+ Inactive sockets closed even when data still pending on output. 0.9b   	First ALPHA testing release 	   