home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / faq / news / inn_faq / part4 < prev   
Encoding:
Text File  |  1994-04-04  |  20.0 KB  |  528 lines
  1. Path: bloom-beacon.mit.edu!news.media.mit.edu!uhog.mit.edu!sgiblab!swrinde!cs.utexas.edu!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 4/4: Appendix A: Norman's install guide
  5. Supersedes: <inn-faq-4-764139607@Warren.MENTORG.COM>
  6. Followup-To: news.software.nntp
  7. Date: 5 Apr 1994 04:00:15 -0000
  8. Organization: Mentor Graphics - IC Group, Warren, NJ, USA
  9. Lines: 504
  10. Sender: tal@Warren.MENTORG.COM
  11. Approved: news-answers-request@MIT.Edu
  12. Distribution: world
  13. Expires: 04/20/94
  14. Message-ID: <inn-faq-4-765518407@Warren.MENTORG.COM>
  15. References: <inn-faq-1-765518407@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, useful to people that do not currently run INN.  Also, some advice specific to certain operating systems.
  19. X-Summary-2: Part 2: Read this AFTER you've read and followed the directions in Install.ms.  Help with getting innd to start.  A tutorial on debugging posting/access problems.  A list of error messages and what they mean.
  20. X-Summary-3: Part 3: Day-to-day operational questions.  General questions asked once INN is running for a while.  Some big changes you can make.  Bug warnings for 1.4, 1.3, 1.2.
  21. X-Summary-4: Part 4: Norman's quick guide to getting started (assumes SunOS and other things), and misc. other things.
  22. Xref: bloom-beacon.mit.edu news.software.nntp:5483 news.software.b:4164 news.answers:17690
  23.  
  24. Posted-By: auto-faq 2.4
  25. Archive-name: inn-faq/part4
  26.  
  27. Last Changed: $Id: FAQ-inn.4,v 1.2 1994/02/04 16:20:28 tal Exp $
  28.  
  29. This is a separate guide for installing INN addressed to 
  30. UNIX and System Administration novices.  It is written for 
  31. installation of INN 1.4 on a Sun SPARCstation 10/30 running 
  32. Solaris 1.1 (SunOS 4.1.3).  This guide is maintained by 
  33. Norman J. Pieniazek (norman@giardia.pdb.cdc.gov).  Please 
  34. send updates and corrections to him.
  35.  
  36. This guide is composed of following parts:
  37.  
  38.   I. SYSTEM REQUIREMENTS
  39.  II. INSTALLATION OF INN 1.4
  40. III. UPGRADING FROM INN 1.3 TO INN 1.4
  41.  IV. MAINTENANCE OF INN
  42.   V. INSTALLATION OF XVNEWS, A SUN OPENWINDOWS
  43.      NEWSREADER
  44.  
  45.  
  46.  
  47. I. SYSTEM REQUIREMENTS
  48.  
  49.   1. INN will not install nor run on Sun SPARCstation under
  50.      plain Solaris 1.1 unless you install some software
  51.      packages and utilities.  Also, your machines IP number
  52.      has to be entered in a Domain Name Service database
  53.      (DNS) to be resolvable.  Ask your Network Administrator
  54.      about DNS or read the O'Reilly & Associates, Inc.
  55.      book: "DNS and BIND by Paul Albitz & Cricket Liu,
  56.      ISBN 1-56592-010-4.
  57.      
  58.      Further, test the resolver on your machine by
  59.      pinging a hostname not entered in your /etc/hosts file.
  60.      For example, type: 
  61.       ping ncbi.nlm.nih.gov
  62.      The response should be:  "ncbi.nlm.nih.gov is alive".
  63.      If you get: "unknown host", consult the O'Reilly book.
  64.    
  65.   2. Be sure to su to root before performing tasks
  66.      outlined below.  Next, check if you have a directory
  67.      /usr/local and about 90 Mb of space in the partition
  68.      where this directory is located.  Create directories:
  69.      /usr/local/bin, /usr/local/lib and /usr/local/man if
  70.      you do not have them.  Add /usr/local/bin to your path
  71.      and /usr/local/man to your MANPATH. 
  72.          
  73.   3. INN uses gnu versions of grep, awk and sed.  Moreover,
  74.      it is  recommended to compile INN with the gnu
  75.      versions of make and the gnu gcc compiler instead of
  76.      the Sun's unbundled cc compiler.  If you don't have
  77.      the gnu software package, create a directory
  78.      /usr/local/gnu, cd to this directory and ftp to
  79.      aeneas.mit.edu (18.71.0.38). Go to
  80.      directory /pub/gnu and get the following files
  81.      (versions as of February 4, 1994):
  82.  
  83.       bison      bison-1.22.tar.gz    
  84.       gawk       gawk-2.15.4.tar.gz
  85.       gcc        gcc-2.5.8.tar.gz
  86.       grep       grep-2.0.tar.gz
  87.       gzip       gzip-1.2.4.tar
  88.       make       make-3.70.tar.gz
  89.       patch      patch-2.1.tar.gz
  90.       perl      perl-4.036.tar.gz
  91.       sed        sed-2.03.tar.gz
  92.       texinfo    texinfo-3.1.tar.gz
  93.  
  94.      Installation of these programs is quite complicated,
  95.      but is really beneficial.  After you complete the
  96.      installation, check if older versions of these programs
  97.      are not present somewhere in your path.  Delete or
  98.      rename these old versions.
  99.  
  100.    a. Start with gzip.  In /usr/local/gnu type:
  101.       "tar xvf gzip-1.2.4.tar".  A directory gzip-1.2.4 will
  102.       be created.  Change to this directory and type:
  103.       "sh ./configure".  Next, edit the Makefile
  104.       with the vi editor and change the line starting with
  105.       "CC" to read: "CC = cc". Then, type: "make".
  106.       Compilation should complete without errors.  Finally,
  107.       type: "make install" to complete installation of gzip,
  108.       gunzip, and other utilities in /usr/local/bin.     
  109.   
  110.    b. Compile and install texinfo - info, makeinfo, the GNU
  111.       hypertext system.  Makeinfo is needed for successful
  112.       installation of many GNU programs and utilities.
  113.       In /usr/local/gnu type: "gunzip texinfo-3.1.tar.gz".
  114.       Next, type: "tar xvf texinfo-3.1.tar".  A directory
  115.       texinfo-3.1 will be created.  Cd to this directory
  116.       and type: "sh ./configure".  Next, edit the Makefile
  117.       as described above for gzip.  Now, type: "make"
  118.       and ignore any non-fatal errors.  Finally, type:
  119.       "make install".
  120.  
  121.    c. Uncompress, compile and install gnu make.  Follow the
  122.       steps described for texinfo.  Gnu make will install in
  123.       /usr/local/bin.  To disable Sun's make, cd to /usr/bin
  124.       and type: "mv make make.sun".
  125.  
  126.    d. Compile and install bison following the procedure
  127.       described for texinfo.
  128.  
  129.    e. Uncompress gcc.  Cd to /usr/local/gnu/gcc-2.5.8 and
  130.       type:
  131.         sh ./configure --target=sparc-sun-sunos4.1
  132.       Next type:
  133.         make LANGUAGES=c
  134.       This step will take about 17 minutes to complete.
  135.       Ignore warnings reported for insn-emit.c.  Next, type:
  136.         make stage1
  137.       Ignore reported non-fatal errors.  Next, type:
  138.         make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O"\
  139.         LANGUAGES=c
  140.       This step will take about 19 minutes to complete.
  141.       Next, type:
  142.         make stage2
  143.       Ignore reported non-fatal errors.  Next, type:
  144.         make CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O"\
  145.         LANGUAGES=c
  146.       In this step, which lasts about 13 minutes, you will
  147.       make the final stage 3 compiler.  Now type: "make
  148.       compare". No errors should be reported here.  Finally,
  149.       type:
  150.         make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g\
  151.         -O" LANGUAGES=c
  152.       to install the gcc compiler.  It is advisable to
  153.       recompile patch, gzip, texinfo, make and bison with
  154.       gcc.  It will be a good test for proper gcc
  155.       functionality.
  156.  
  157.    f. Uncompress gawk. Cd to directory gawk-2.15.4 and type:
  158.         ./configure sunos41
  159.       Next type: "make".  When gawk will compile, type:
  160.         make install
  161.       Finally, disable Sun's awk by typing:
  162.         mv /usr/bin/awk /usr/bin/awk_sun
  163.       and create a link to gawk for awk by typing:
  164.         ln -s /usr/local/bin/gawk /usr/bin/awk
  165.  
  166.    g. Uncompress grep.  Cd to directory grep-2.0 and type:
  167.         ./configure
  168.       Next type: "make" and "make install".  Grep will
  169.       also be installed in /usr/local/bin as fgrep
  170.       and egrep.  Finally, as some programs expect to find
  171.       grep, egrep and fgrep in /usr/bin, disable Sun's grep
  172.       and create appropriate links, just like described
  173.       for awk.  INN expects to find a program "egnugrep" in
  174.       /usr/local/bin.  Create it by typing:
  175.          cp /usr/local/bin/egrep /usr/local/bin/egnugrep
  176.  
  177.    h. Uncompress sed and patch.  Compile and install these
  178.       utilities following the instructions for grep.
  179.  
  180.  
  181.    i. INN comes with some scripts written in the perl
  182.       language.  Uncompress perl, cd to directory perl-4.036
  183.       and type:
  184.        sh ./Configure -d
  185.       and hit Return for default answers to all questions.
  186.       Next, type: "make depend", then "make".  Now type:
  187.        make test
  188. inally,
  189.       type:
  190.        make install
  191.       to complete installation of perl.
  192.  
  193.  
  194.  
  195. II. INSTALLATION OF INN 1.4
  196.  
  197.  
  198.   1. As root, create directories: /usr/local/inn1.4 (this
  199.      will be your $inn directory) and /usr/local/news.
  200.  
  201.   2. Cd to $inn. Get: inn1.4sec.tar.Z from ftp.uu.net
  202.      (192.48.96.9).  This file is in the directory:
  203.      /networking/news/nntp/inn.   As for all files, please
  204.      remember to set the file type in ftp to binary.
  205.  
  206.   3. From the same source and directory get the Frequently
  207.      Asked Questions (FAQ) files:
  208.        faq-inn-1.Z
  209.        faq-inn-2.Z
  210.        faq-inn-3.Z
  211.        faq-inn-4.Z (this file)
  212.        faq-nov.Z
  213.  
  214.   4. To uncompress the FAQ files type: "uncompress faq-*.
  215.      Print the FAQs and read them before proceeding further.
  216.  
  217.   6. In $inn type: "zcat inn1.4sec.tar.Z | tar xvf -".  This
  218.      will install inn files for compilation.
  219.  
  220.   7. Change directory to $inn/config, and type:
  221.        cp config.dist config.data
  222.        chmod 644 config.data
  223.      Now use the vi editor to edit config.data.  You should
  224.      select gcc as the compiler by changing the line that
  225.      starts with "CC" to read "CC   gcc".  Many lines in
  226.      config.data define the location of various files
  227.      and directories.  It's OK to leave defaults, but
  228.      check if you have ample space in the partition
  229.      where the articles will be stored (/var/spool).  More
  230.      information on where INN expects to find certain files
  231.      is in: $inn/samples/innshellvars.  If necessary, edit
  232.      the config.data and innshellvars to reflect your
  233.      configuration.  Please make sure that specified
  234.      directories and utilities exist on your system.
  235.     
  236.   8. Change directory to $inn.  Type: "make world".  Now
  237.      type:
  238.        cat */lint
  239.      Here, you will get a list of compiler warnings and
  240.      errors.  In addition, "make" created in this step
  241.      a file:  "$inn/Install.ms".  Print it by typing:
  242.        nroff -ms Install.ms | lpr
  243.      Install.ms is a manual for installation of INN written
  244.      by Rich Salz, the author of INN.  There is a lot of
  245.      important and interesting information in his manual.
  246.  
  247.   9. If you got no fatal errors from make, go to the
  248.      $inn/site directory
  249.      and type: "make all".
  250.  
  251.  10. There are some scripts and control files listed in
  252.      inn-faqs and Install.ms that may be modified at this
  253.      point.  For most installations, the default settings
  254.      are OK.
  255.  
  256.  11. Now cd to $inn and type: "make install" to complete
  257.      basic installation of INN.
  258.  
  259.  12. To finish installation of INN, run the BUILD script
  260.      in the $inn directory by typing "sh BUILD".  This
  261.      script will ask a series of configuration questions
  262.      that are easy to answer.  Please note that if your have
  263.      "history.*" files in your /usr/local/news directory
  264.      from a previous or failed installation of INN, the
  265.      BUILD script will not complete.  Rename them to
  266.      "old.history.*" and re-run the BUILD script.
  267.  
  268.  13. You need a site that will feed news to you.
  269.      This will depend on your geographic location and
  270.      organization.  Ask a System Administrator of a site
  271.      close to you for hints.
  272.  
  273.  14. Ftp to your newsfeeding site and get the "active" file
  274.      from there.  Place this file in your /usr/local/news
  275.      directory and edit it to your taste.  Remember to
  276.      include the "control" and "junk" newsgroups.  Also, you
  277.      have to edit the following files in /usr/local/news:
  278.      newsfeeds, hosts.nntp and nnrp.access.
  279.  
  280.  15. To check for syntax errors in INN control files,
  281.      file ownership, permissions and other things type:
  282.        /usr/bin/perl /usr/local/news/bin/inncheck
  283.      and correct any errors reported by inncheck.
  284.  
  285.  16. Look at the file "rc.news" in /usr/local/etc.
  286.      It's advisable to enable the innwatch utility.
  287.      Innwatch will throttle the newsserver when your disk
  288.      will get full and prevent crashes.  Change the line
  289.      starting with "DOINNWATCH" to read "DOINNWATCH=true".
  290.      Now type: "sh /usr/local/etc/rc.news"
  291.      and look in /var/log/syslog for errors.  Also, type:
  292.        ps -aux| grep news
  293.      and check, if the innd process owner is news.
  294.  
  295.  17. In /etc/aliases create an entry: "usenet: <you, or
  296.      root>".  Next type: "/usr/ucb/newaliases" to inform the
  297.      sendmail program that the aliases file has changed.
  298.      If you are running YP (NIS) on your network, you may
  299.      optionally add the "usenet" alias to your YP aliases
  300.      file.  If the machine you are installing INN on is the
  301.      YP master and the file "/etc/aliases" is the source of
  302.      the YP aliases map, you should type: "cd /var/yp"
  303.      followed by "make".  Reboot and restart innd (see #16). 
  304.    
  305.  
  306.  18. To get daily reports on the newsserver activity from
  307.      the "news.daily" script and to enable the "expire"
  308.      utility type: "/bin/crontab -e news" and insert the
  309.      following line:
  310.        40 23 * * * /usr/local/news/bin/news.daily delayrm
  311.      or, if you are using overchan (in newsfeeds):
  312.        40 23 * * * /usr/local/news/bin/news.daily delayrm\
  313.        expireover
  314.  
  315.  19. To set-up complete logging of the server activities
  316.      and have them ready for a report by the "news.daily"
  317.      script, you have to edit your /etc/syslog.conf file.
  318.      Insert at the end of this file the content of
  319.      the syslog.conf file written by Rich Salz.  This file
  320.      is in: $inn/syslog.  Please check, if you have the
  321.      directories and files mentioned in Rich's syslog.conf.
  322.  
  323.  20. Run tests from your machine to the server (to your
  324.      machine at telnet port 119).  See inn-faqs for details.
  325.  
  326.  21. After completing these test, be sure to delete the
  327.      entry for your machine from the hosts.nntp file.  If
  328.      you will not do it, your machine will be treated as a
  329.      "feeder" and not as a "reader".
  330.  
  331.  22. Set posting. 
  332.  
  333.       a. Edit the /usr/local/news/newsfeeds file and add:
  334.            <alias for your feed>/<full address of feed\
  335.            :*\ (for all local postings)
  336.            :Tf,Wnm: (standard entry)
  337.  
  338.       b. Edit /usr/local/news/nntpsend.ctl file and add:
  339.            <alias for your feed>:<full address of feed>::\
  340.            -T1800 -t300
  341.  
  342.       c. Type: "/bin/crontab -e news" and insert a line:
  343.            0,10,20,30,40,50 * * * *\
  344.             /usr/local/news/bin/nntpsend
  345.   
  346.       d. Run inncheck (see #15).
  347.  
  348.       e. Post to misc.test and include "reply" in the
  349.          Subject line, automatic responses will be mailed to
  350.          usenet (see #17) within a few minutes.
  351.  
  352.  23. To start innd automatically at bootup, include at the
  353.      end of your rc.local the following lines:
  354.  
  355.       #
  356.       # Start INN news service - Internet News Daemon (innd)
  357.       #
  358.       if [ -f /usr/local/etc/rc.news ]; then
  359.          /usr/local/etc/rc.news; echo "Starting INN news
  360.                  service"
  361.       fi
  362.  
  363.  24. Watch the news.daily reports in your mail for any
  364.      additional errors.  To run the news.daily script
  365.      at any time manually, FIRST SU FROM ROOT TO "news"
  366.      and type: "/usr/local/news/news.daily".  A mail to
  367.      "usenet" should arrive within a couple of minutes
  368.      and may report important configuration problems.
  369.  
  370.  
  371. III. UPGRADING FROM INN 1.3 TO INN 1.4
  372.  
  373.   1. Stop the server.  Type:
  374.        ctlinnd shutdown "upgrade"
  375.  
  376.   2. Create a directory /usr/local/inn1.4, this will be
  377.      your $inn directory.  cd to $inn.  Next, ftp to
  378.      ftp.uu.net, cd to directory: /networking/news/nntp/inn
  379.      and get the following files:
  380.  
  381.         inn1.4sec.tar.Z
  382.         faq-inn-1.Z
  383.         faq-inn-2.Z
  384.         faq-inn-3.Z
  385.         faq-inn-4.Z (this file)
  386.         faq-nov.Z
  387.      Uncompress and print the FAQs.  Next, type:
  388.         zcat inn1.4sec.tar.Z | tar xvf -
  389.  
  390.      Print the README file.  To print the Install file,
  391.      type: "make Install.ms" followed by:
  392.         nroff -ms Install.ms | lpr
  393.  
  394.   3. Now, cd to $inn/config and type the following commands:
  395.         make subst
  396.         cp config.dist config.data
  397.         ./subst -f {OLDFILE} config.data
  398.      where {OLDFILE} is the location of config.data in your
  399.      INN 1.3 directory.  Be sure to check, if in your old
  400.      config.data the "CC" line reads "CC  gcc".
  401.      Ignore warnings about new lines.  Next, type:
  402.         make sedtest
  403. hould be reported here.  Now, cd to $inn
  404.      and type this series of commands:
  405.         make quiet
  406.         cd ../lib
  407.         make libinn.a lint
  408.         cd ../frontends
  409.         make all
  410.         cd ../innd
  411.         make all
  412.         cd ../nnrpd
  413.         make all
  414.         cd ../backends
  415.         make all
  416.         cd ../expire
  417.         make all
  418.         cd ../site
  419.         make all
  420.         cd ..
  421.         make update
  422.  
  423.   4. Restart innd.
  424.  
  425.  
  426. IV. MAINTENANCE OF INN
  427.  
  428.  1. Adding new groups - see also Part IV, Section 3.b,:
  429.  
  430.      a. Type: "ctlinnd pause 'edit active'"
  431.  
  432.      b. Edit the active file.  The format is:
  433.           groupname himark lomark flag.
  434.         Set himark to 0000000000 and lomark to 0000000001.
  435.  
  436.     c. Run inncheck (see #11) to check the new active file
  437.        for errors. 
  438.   
  439.     d. Type: "ctlinnd reload active 'new active'".
  440.  
  441.     e. Type: "ctlinnd go 'edit active'".
  442.  
  443.  
  444.  2. New groups are sometimes added automatically through
  445.     a control message.  A mail message to usenet will alert
  446.     to such an automatic change to the active file.  If you
  447.     do not want to subscribe to a particular news group,
  448.     change directory to /usr/local/news and type:
  449.       ctlinnd rmgroup <group name>
  450.  
  451.  3. Sometimes, a mail message will arrive for usenet with
  452.     a checkgroups file.  Remove header, save the body of
  453.     the message in:
  454.       /usr/local/news/bin/control/news_control/news_control_
  455.                     todaysdate
  456.     cd to that directory and type:
  457.       ../docheckgroups <news_control_todaysdate
  458.              >todaysdate_pre
  459.     Read the output file (todaysdate_pre) and carry out all 
  460.     the instructions that you think pertain to your
  461.     situation.  Read the man pages for "active" and "ctlinnd"
  462.     for more info.  To implement the changes, you will have to
  463.     change to the directory: /usr/local/news and:  
  464.     
  465.      a. remove a discontinued group:
  466.           type: "ctlinnd rmgroup <group name>"
  467.  
  468.      b. add a group:
  469.         type: "ctlinnd newgroup <group name> flag <creator
  470.                                            name>"
  471.  
  472.      c. mark a group correctly:
  473.         type: "ctlinnd changegroup <group name> flag"
  474.  
  475.     Run inncheck and repeat the docheckgroups command from
  476.     the /usr/local/bin/control/news_control directory
  477.     by typing:
  478.       ../docheckgroups <news_control_todaysdate
  479.                                 >todaysdate_after
  480.     Correct any reported problems.  Also, you may have to
  481.     edit the /usr/local/news/newsgroups file to reflect
  482.     any changes you introduced.
  483.  
  484.  4. Subscribe to and read the following newsgroups:
  485.       news.software.nntp
  486.       news.software.readers
  487.       
  488.  
  489.  5. IMPORTANT!!! Never run fsck on the drive where the
  490.     /spool/news files are located while running INN.  Innd
  491.     has a lot of active disk I/O going on and fsck will show
  492.     a lot of errors.
  493.     Use ctlinnd to throttle,  pause, or shutdown innd first
  494.     - see the manual page for ctlinnd.
  495.  
  496.  
  497.   V. INSTALLATION OF XVNEWS, A SUN OPENWINDOWS
  498.      NEWSREADER
  499.  
  500.    1. Create a directory /usr/local/xvnews2.1 and cd to this
  501.       directory.
  502.  
  503.    2. Ftp to dutiws.twi.tudelft.nl and get the file
  504.       xvnews.tar.gz from directory /pub/news.
  505.  
  506.    3. Ungzip and untar xvnews.
  507.  
  508.    4. Use your vi editor and edit the file xvnews.h
  509.       You will need to enter your settings for:
  510.         DOMAIN         (on my machine: "pdb.cdc.gov")
  511.         ORGANIZATION   (on my machine: "Centers for Disease
  512.                           Control Atlanta, GA, USA")
  513.         NNTPSERVER     (on my machine:
  514.                                "giardia.pdb.cdc.gov")
  515.       These defaults can be overridden by environment
  516.       variables (see the xvnews man page).
  517.  
  518.    5. Compile xvnews by typing: "make".  I get some errors
  519.       on my system, but the program runs OK.  Copy xvnews
  520.       to /usr/local/bin and xvnews.man to directory:
  521.       /usr/local/man/man1 as xvnews.1
  522.  
  523. -- 
  524. Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play)
  525. "Psst!  Hey, Anthony!  Y'know what I        | Disclaimer:  I do not
  526. like about existing?"  "Uh... uh... what?"  | speak for Mentor Graphics.
  527. "Possessing a physical extension."  -TSA    |
  528.