home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume30 / tin / part14 / INSTALL.NNTP < prev    next >
Text File  |  1992-05-20  |  3KB  |  89 lines
  1. This document explains the install procedure for the supplied patch to the
  2. NNTP server nntpd & to the TIN newsreader to retrieve index files from the
  3. NNTP server. 
  4.  
  5. NNTP server
  6. -----------
  7. 1) Copy the following files to <nntp-source-dir>/server
  8.      cp xindex.c <nntp-source-dir>/server
  9.      cp xuser.c <nntp-source-dir>/server
  10.  
  11. 2) Copy the following files to <nntp-source-dir>
  12.      cp server.patch <nntp-source-dir>
  13.      cp common.patch <nntp-source-dir>
  14.  
  15. 3) Patch the files in <nntp-source-dir>/common & <nntp-source-dir>/server
  16.      cd <nntp-source-dir>
  17.      patch < common.patch
  18.      patch < server.patch
  19.  
  20. 4) Copy <nntp-source-dir>/common/conf.h.dist to <nntp-source-dir>/common/conf.h
  21.      cd <nntp-source-dir>/common
  22.      cp conf.h.dist conf.h
  23.  
  24. 5) Edit <nntp-source-dir>/common/conf.h to suit your sites needs. The XINDEX
  25.    & XUSER are #defined by default. You may need to change the path for
  26.    the #define SUBSCRIBTIONS. The default is /usr/lib/news/subscriptions.
  27.      cd <nntp-source-dir>/common
  28.      [vi|emacs] conf.h
  29.  
  30. 6) Recompile & install the NNTP server nntpd
  31.      cd  <nntp-source-dir>
  32.      make server
  33.      make install_server
  34.  
  35. TIN client
  36. ----------
  37. 1) Edit tin Makefile to enable XINDEX & XUSER functionality.
  38.      cd <tin-dir>
  39.      [vi|emacs] Makefile
  40.      Add -DNNTP_XINDEX to CFLAGS if you want tin to retrieve index files 
  41.      from the server.
  42.      Add -DNNTP_XUSER to CFLAGS if you want tin to log the username to
  43.      the NNTP logfile.
  44.      Add -DNNTP_EXTS to CFLAGS if you want both NNTP_XINDEX & NNTP_XUSER
  45.      enabled.
  46.  
  47. 2) Recompile & install tin.
  48.      cd <tin-dir>
  49.      make <system>
  50.      make install
  51.  
  52. TIN daemon (on NNTP server)
  53. ---------------------------
  54. 1) Edit tin Makefile to enable index daemon functionality.
  55.      cd <tin-dir>
  56.      [vi|emacs] Makefile
  57.      Add -DINDEX_DAEMON to CFLAGS to create a version of tin 'tind' to
  58.      create & update index files on the NNTP server.
  59.  
  60. 2) Compile & install tind.
  61.      cd <tin-dir>
  62.      make <system>
  63.      make install_daemon
  64.  
  65. 3) Add entry to crontab to start 'tind' index daemon every so often.
  66.      cd /usr/spool/cron/crontabs
  67.      [vi|emacs] root
  68.      Add following line to run tind every 30 minutes: 
  69.        0,30 * * * * su news -c '/usr/lib/news/tind'
  70.  
  71. OK. If you have gotten this far you will have the following configuration:
  72.   o  tind will run every 30 minutes to update a central directory (usually
  73.      /usr/spool/news/.index) of tin index files for all groups in the active
  74.      file. The directory can be changed by 'tind -I dir' if so desired.
  75.  
  76.   o  The NNTP server nntpd will service all requests for tin index files
  77.      from tin clients. It will do this by returning the contents of the
  78.      group index file in the index directory (ie. /usr/spool/news/.index/*)
  79.  
  80.   o  The tin client will issue requests for index files to the NNTP server
  81.      therefore saving space on the client machine and ensuring that there
  82.      are only one copy of index files on the whole network.  Also clients
  83.      will not have to wait while index files are built locally as the index
  84.      daemon tind runs frequently on the news server.
  85.              
  86. Enjoy & happy newsreading
  87.  
  88.   Iain
  89.