home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1996 May / PCOnline_05_1996.bin / linux / source / n / inn / faq-inn-.001 / faq-inn-2
Internet Message Format  |  1993-12-05  |  8KB
  1. Path: uunet!news.mentorg.com!sdl!not-for-mail
  2. From: tal@Warren.MENTORG.COM (Tom Limoncelli)
  3. Newsgroups: news.software.nntp,news.software.b,news.answers
  4. Subject: INN FAQ Part 2/3: Tutorial on installing
  5. Supersedes: <inn-faq-2-752475605@Warren.MENTORG.COM>
  6. Followup-To: news.software.nntp
  7. Date: 20 Nov 1993 05:00:13 -0000
  8. Organization: Mentor Graphics - IC Group, Warren, NJ, USA
  9. Lines: 177
  10. Sender: tal@Warren.MENTORG.COM
  11. Approved: news-answers-request@MIT.Edu
  12. Distribution: world
  13. Expires: 12/05/93
  14. Message-ID: <inn-faq-2-753771605@Warren.MENTORG.COM>
  15. References: <inn-faq-1-753771605@Warren.MENTORG.COM>
  16. Reply-To: Tom_Limoncelli@Warren.MENTORG.COM (Tom Limoncelli)
  17. NNTP-Posting-Host: sdl.warren.mentorg.com
  18. X-Summary-1: Part 1: Common questions about INN itself, and some advice when compiling it and installing it.
  19. X-Summary-2: Part 2: This assumes that you've successfully compiled the software.  This is a tutorial that takes you through configuration and setting up feeds.  It ends with common questions about INN configuration.
  20. X-Summary-3: Part 3: Norman's quick guide to getting started (assumes SunOS and other things), and misc. other things.)
  21. Xref: uunet news.software.nntp:6505 news.software.b:15173 news.answers:14978
  22.  
  23. Posted-By: auto-faq 2.4
  24. Archive-name: inn-faq/part2
  25.  
  26. Last Changed: $Id: FAQ-inn.2,v 1.12 1993/09/21 16:01:30 tal Exp $
  27.  
  28. This is a separate guide to installing INN.  It is written for INN 1.4,
  29. but should work on any version.  It is written and maintained by Norman
  30. J.  Pieniazek (norman@giardia.pdb.cdc.gov).  Please send updates and
  31. corrections to him.
  32.  
  33.  
  34.  
  35. INSTALLATION AND MAINTENANCE OF INN 1.4
  36.  
  37.  
  38. I. INSTALLATION
  39.  
  40.  
  41.  
  42. 1. Get: inn1.4.tar.Z from ftp.uu.net (192.48.96.9).  This file is in
  43.    the directory: /networking/news/nntp/inn
  44.  
  45. 2. Get: patch.tar.Z from ftp.uu.net.  This file is in the directory /pub.
  46.    Compile and install patch in the directory: /usr/local/bin.
  47.  
  48. 3. If you don't have any gnu software, ftp to aeneas.mit.edu (18.71.0.38), go to directory
  49.    /pub/gnu and get the following files.
  50.  
  51.    fgrep        current version: fgrep-1.1
  52.    gawk            current version: gawk-2.15.2
  53.    gcc            current version: gcc-2.4.2
  54.    grep            current version: grep-1.6
  55.    make            current version: make-3.65
  56.    sed            current version: sed-1.14
  57.  
  58. Compile and install these programs starting with make and gcc.  Some
  59. people have reported problems with gnu sed 2.02.  If people want to
  60. help me maintain a list of which GNU replacements are required on
  61. certain OS's, please send me the data.  I'll keep the list up to date.
  62.  
  63. 4. Get perl-4.0.36.tar.gz from ftp.uu.net - directory: /archive/systems/gnu.
  64.    Compile and install in /usr/bin.
  65.  
  66. 5. As root, create directories:    /usr/local/inn (this is your $INN directory)
  67.                 /usr/local/news
  68.                 /news/bin
  69.                 /news/lib
  70.  
  71. 6. Move inn1.4.tar.Z to $INN.  Change directory to $INN  
  72.    Type: "zcat inn1.4.tar.Z | tar xvf -".  This will install
  73.    inn files for compilation.
  74.  
  75. 7. Change directory to $INN/config and follow the instructions
  76.    in R. Salz's INN nstallation manual.  At least, change
  77.    the compiler from cc to gcc. (If you have Solaris 2.1 - see changes
  78.    made to the config files in Daniel Rich's letter).
  79.  
  80. 8. Change directory to $INN.  Type: "make world install".
  81.  
  82. 9. If you get no fatal errors from make, check the /usr/local/news
  83.    directory for history* files.  Remove or rename them.  Go back
  84.    to the $INN directory and type: "BUILD" to run the final
  85.    installation script.
  86.  
  87. 10. Read Part 3 of this FAQ.
  88.     Follow the instructions to set up at least your newsfeeds, hosts.nntp,
  89.     and nnrp.access files.  Get the active file from your newsfeed and
  90.     edit it to your taste. Remember to include the control and junk
  91.     newsgroups.
  92.  
  93. 11. Type: "/usr/bin/perl /usr/local/news/bin/inncheck" and correct
  94.     any errors reported by inncheck.
  95.  
  96. 12. Type: "sh /usr/local/etc/rc.news".  Look in syslog
  97.     for any errors.  Type: "ps -aux" and check, if innd owner
  98.     is news.
  99.  
  100. 13. In /etc/aliases create an entry: "usenet: <you, or root>". 
  101.     Reboot, change directory to /var/yp, type: "make".  From the same
  102.     directory, type: "/usr/etc/yp/ypinit -m".  Restart innd (see #12).
  103.  
  104. 14. Type: "/bin/crontab -e news" and insert the following line:
  105.     40 23 * * * /usr/local/news/bin/news.daily delayrm
  106. if you are using overchan (in newsfeeds):
  107.     40 23 * * * /usr/local/news/bin/news.daily delayrm expireover
  108.  
  109. 15. Run tests from your machine to the server (your machine at telnet
  110.     port 119).  See Tom Limoncelli's manual (Part 3 of the FAQ) for details.
  111.  
  112. 16. After completing the test, be sure to delete the entry for your
  113.     machine from the hosts.nntp file.  If you will not do it, your
  114.     machine will be treated as a "feeder" and not as a "reader".
  115.  
  116. 17. Watch the news.daily reports in your mail for any
  117.     additional errors.
  118.  
  119. 18. Adding new groups - see Part II, Section 2.b, or:
  120.     a. Type: "ctlinnd pause 'edit active'"
  121.     b. Edit the active file.  Format is: groupname himark lomark flag.
  122.        Set himark to 0000000000 and lomark to 0000000001.
  123.     c. Run inncheck (see #11) to check the new active file for errors.    
  124.     d. Type: "ctlinnd reload active 'new active'".
  125.     e. Type: "ctlinnd go 'edit active'".
  126.  
  127. 19. Set posting. 
  128.      a. Edit the /usr/local/news/newsfeeds file and add:
  129.     <alias for your feed>/<full address of feed\
  130.         :*\    (for all local postings)
  131.         :Tf,Wnm:    (standard entry)
  132.      b. Edit /usr/local/news/nntpsend.ctl file and add:
  133.         <alias for your feed>:<full address of feed>::-T1800 -t300
  134.      c. Type: "/bin/crontab -e news" and insert a line:
  135.     0,10,20,30,40,50 * * * * /usr/local/news/bin/nntpsend
  136.      d. Run inncheck (see #11).
  137.      e. Post to misc.test and include reply in the Subject line,
  138.         automatic responses will be mailed to usenet (see 13) within
  139.         a few minutes.
  140.  
  141. 20. To start innd automatically at bootup, include at the end of
  142.     your rc.local the following lines:
  143.  
  144.     #
  145.     # Start INN news service - Internet News Daemon (innd)
  146.     #
  147.     if [ -f /usr/local/etc/rc.news ]; then
  148.            /usr/local/etc/rc.news; echo "Starting INN news service"
  149.     fi
  150.  
  151.   
  152.  
  153. II. MAINTENANCE
  154.  
  155. 1. Newgroups are sometimes added automatically through a control message.
  156.    A mail message to usenet will alert to such an automatic change
  157.    to the active file.  If you do not want to subscribe to a news group,
  158.    change directory to /usr/local/news and type:
  159.    
  160.     ctlinnd rmgroup xx.xxx.xx
  161.  
  162. 2. Sometimes, a mail message will arrive for usenet with a checkgroups
  163.    file.  Remove header, save the body of the message in:
  164.    
  165.    /usr/local/news/bin/control/news_control/news_control_todaysdate
  166.    
  167.    cd to that directory and type:
  168.    "../docheckgroups <news_control_todaysdate >todaysdate_pre"
  169.    
  170.    Read the output file (todaysdate_pre) and carry out all the instructions
  171.    that you think pertain to your situation.  You will have to change
  172.    directory to /usr/local/news and:
  173.     
  174.     a. remove some discontinued groups:
  175.         type: "ctlinnd rmgroup xx.xxx.xxxx"
  176.  
  177.     b. add a group:
  178.         type: "ctlinnd newgroup xx.xxx.xxxx flag ''"
  179.  
  180.     c. mark a group correctly:
  181.         type: "ctlinnd changegroup xx.xxx.xxxx flag"
  182.  
  183.   Run inncheck and repeat the docheckgroups command:
  184.    "../docheckgroups <news_control_todaysdate >todaysdate_after"
  185.    Check for any problems.  
  186.  
  187.    Also, edit the /usr/local/news/newsgroups file to reflect any
  188.    changes you introduced.
  189.  
  190. 3. IMPORTANT!!! Never run fsck on the drive where the /spool/news
  191.    files are located.  Innd has a lot of active disk I/O going on
  192.    and fsck will show a lot of errors.  Use ctlinnd to throttle,
  193.    pause, or shotdown innd - see the manual page for ctlinnd.
  194.  
  195. -- 
  196. Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play)
  197. "Psst!  Hey, Anthony!  Y'know what I        | Disclaimer:  I do not
  198. like about existing?"  "Uh... uh... what?"  | speak for Mentor Graphics.
  199. "Possessing a physical extension."  -TSA    |
  200.