home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / inn-faq / part8 < prev    next >
Encoding:
Internet Message Format  |  1997-12-13  |  25.7 KB
  1. From: hwr@pilhuhn.de (Heiko W.Rupp)
  2. Newsgroups: news.software.nntp,news.software.b,news.answers
  3. Subject: INN FAQ Part 8/9: Appendix A: Norman's install guide
  4. Supersedes: <faq.p8_881029525@pilhuhn.de>
  5. Followup-To: news.software.nntp
  6. Date: 9 Dec 1997 03:25:50 +0100
  7. Organization: The Home Of The Pilhuhn
  8. Lines: 649
  9. Approved: hwr@pilhuhn.de
  10. Expires: 26 Dec 1997 02:25:25 GMT
  11. Message-ID: <faq.p8_881634325@pilhuhn.de>
  12. NNTP-Posting-Host: snert.pilhuhn.de
  13. Summary: This article is part 8 of a multi-part FAQ:
  14.     Part 8: Norman's quick guide to getting started (assumes SunOS and other things), and misc. other things.
  15. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news.starnet.net!news.dra.com!nntp.news.xara.net!xara.net!news.maxwell.syr.edu!fu-berlin.de!news.belwue.de!news.uni-ulm.de!rz.uni-karlsruhe.de!pilhuhn.de!snert!news
  16. Xref: senator-bedfellow.mit.edu news.software.nntp:43939 news.software.b:22601 news.answers:118602
  17.  
  18. Posted-By: post_faq 2.10
  19. Archive-name: usenet/software/inn-faq/part8
  20. Last Changed: $Date: 1996/01/30 21:44:45 $ $Revision: 2.3 $
  21.  
  22.         Part 8 of 9
  23.  
  24. INN FAQ Part 1: General and questions from people that don't (yet) run INN
  25. INN FAQ Part 2: Specific notes for specific operating systems
  26. INN FAQ Part 3: Reasons why INN isn't starting
  27. INN FAQ Part 4: The debugging tutorial (setup of feeds etc.)
  28. INN FAQ Part 5: Other error messages and what they mean
  29. INN FAQ Part 6: Day-to-day operation and changes to the system
  30. INN FAQ Part 7: Problems with INN already running
  31. INN FAQ Part 8: Appendix A: Norman's install guide
  32. INN FAQ Part 9: Appendix B: Configurations for certain systems
  33.  
  34.  
  35. This is a separate guide for installing INN addressed to 
  36. UNIX and System Administration novices.  It is written for 
  37. installation of INN 1.4 on a Sun SPARCstation running 
  38. SunOS 4.1.x with some additional comments
  39. for Solaris 2.x.  This guide is maintained by 
  40. Norman J. Pieniazek (norman@giardia.pdb.cdc.gov).  Please 
  41. send updates and corrections to him.
  42.  
  43. This guide is composed of following parts:
  44.  
  45.   I. SYSTEM REQUIREMENTS
  46.  II. INSTALLATION OF INN 1.4
  47. III. UPGRADING FROM INN 1.3 TO INN 1.4
  48.  IV. MAINTENANCE OF INN
  49.   V. INSTALLATION OF XVNEWS, A SUN OPENWINDOWS
  50.      NEWSREADER
  51.  
  52.  
  53.  
  54. I. SYSTEM REQUIREMENTS
  55.  
  56.   1. INN will not install nor run on Sun SPARCstation under
  57.      plain Solaris 1.1  or 2.x unless you install some
  58.      additional software packages and utilities
  59.      (fortunately, they are free).  Also, your machine's IP
  60.      number (of the news server) has to be entered in a
  61.      Domain Name Service database (DNS) to be resolvable.
  62.      Ask your Network Administrator about DNS or read the
  63.      O'Reilly & Associates, Inc. book: "DNS and BIND" by Paul
  64.      Albitz & Cricket Liu, ISBN 1-56592-010-4.
  65.      
  66.      Further, test the resolver on your machine by
  67.      pinging a hostname not entered in your /etc/hosts file.
  68.      For example, type: 
  69.       "ping ftp.uu.net"
  70.      The response should be: "ftp.uu.net is alive".
  71.  
  72.      If you get: "unknown host ftp.uu.net", consult the
  73.      O'Reilly's book.
  74.  
  75.      (Solaris 2.x - the most common problem with DNS 
  76.      results from not switching on DNS support.  Check
  77.      the line "hosts:" in the /etc/nsswitch.conf file.
  78.      It should read: "hosts:   files dns").
  79.    
  80.   2. Be sure to su to root before performing tasks
  81.      outlined below.  Next, check if you have a directory
  82.      /usr/local and about 90 Mb of space in the partition
  83.      where this directory is located.  Create directories:
  84.      /usr/local/bin, /usr/local/lib and /usr/local/man if
  85.      you do not have them.  Add /usr/local/bin to your path
  86.      and /usr/local/man to your MANPATH.  On Solaris 2.x,
  87.      create /opt/local tree and make a symbolic link
  88.      from /usr ("ln -s /opt/local /usr/local").
  89.          
  90.   3. INN uses gnu versions of grep, awk and sed.  Moreover,
  91.      it is  recommended to compile INN with the gnu
  92.      versions of make and the gnu gcc compiler instead of
  93.      the Sun's Solaris 1.x unbundled cc compiler. (C
  94.      compiler is not included with Solaris 2.x.  The cc in
  95.      /usr/ucb is bad.  Be sure to remove it from path.)  If you
  96.      don't have the gnu software package, create a directory
  97.      /usr/local/gnu, cd to this directory and ftp to
  98.      prep.ai.mit.edu (18.71.0.38). Go to directory /pub/gnu
  99.      and get the newest version of the following programs:
  100.  
  101.       bison      bison-x.x.tar.gz    
  102.       flex       flex-x.x.x.tar.gz 
  103.       gawk       gawk-x.x.x.tar.gz
  104.       gcc        gcc-x.x.x.tar.gz
  105.       grep       grep-x.x.tar.gz
  106.       gzip       gzip-x.x.x.tar (Note: no .gz)
  107.       make       make-x.x.tar.gz
  108.       patch     patch-x.x.tar.gz
  109.       perl     perl-x.x.tar.gz
  110.       sed        sed-x.x.tar.gz
  111.       tar        tar-x.x.x.tar.gz
  112.       texinfo    texinfo-x.x.tar.gz
  113.  
  114.      Installation of these programs is not complicated,
  115.      and is really beneficial both for Solaris 1.x and
  116.      Solaris 2.x users.  After you complete the
  117.      installation, check if older versions of these programs
  118.      are not present somewhere in your path.  Delete or
  119.      rename these old versions.
  120.  
  121.      Solaris 2.x: First, after connecting through ftp
  122.      to prep.ai.mit.edu, cd to directory:
  123.        /pub/gnu/sparc-sun-solaris2
  124.      and get the file INSTALL.gcc.  Follow the instructions
  125.      for installing binaries for gcc and gzip (installed
  126.      in /opt/gnu).  Next, follow the instructions for
  127.      Solaris 1.1, but read the doc file for gcc-x.x.x.
  128.      To avoid problems, rename /usr/ucb/cc to something 
  129.      else, or remove it from path.  Make a symbolic link
  130.      in the /opt/gnu/bin directory from gcc to cc.    
  131.     When you finish the installation, the new utilities
  132.      will be installed in the /usr/local tree.  Delete and
  133.      remove from path the /opt/gnu tree.  As the binaries
  134.      you downloaded are pretty old, it is advisable to
  135.      start with the new gcc and to compile all the
  136.      gnu utilities with this new gcc.  NOTE: it makes
  137.      no difference, if you install gnu stuff in /opt/gnu
  138.      or in /usr/local.  The installation scripts for gnu
  139.      utilities default to the /usr/local directory tree,
  140.      so I find it simple to use this path.  Whatever
  141.      you do, be sure to have the gnu utilities in
  142.      your path before /usr/bin and /usr/ccs/bin.
  143.  
  144.      Solaris 2.x: be sure to include /usr/ccs/bin
  145.      and /usr/ccs/lib in your path.  Important
  146.      utilities (e.g. - ar, cpp) are located there.
  147.      Please note, that the /usr/ccs stuff is only
  148.      installed, when you do a full install of Solaris.
  149.      If you do not have e.g. - /usr/ccs/bin/ar, re-install
  150.      Solaris 2.x!
  151.  
  152.    a. Start with gzip.  In /usr/local/gnu type:
  153.       "tar xvf gzip-x.x.x.tar".  A directory gzip-x.x.x will
  154.       be created.  Change to this directory and type:
  155.       "sh ./configure".  Next, edit the Makefile
  156.       with the vi editor and change the line starting with
  157.       "CC" to read: "CC = cc". Then, type: "make".
  158.       Compilation should complete without errors.  Finally,
  159.       type: "make install" to complete installation of gzip,
  160.       gunzip, and other utilities in /usr/local/bin.     
  161.   
  162.    b. Compile and install texinfo - info, makeinfo, the GNU
  163.       hypertext system.  Makeinfo is needed for error-free
  164.       installation of many GNU programs and utilities.
  165.       In /usr/local/gnu type: "gunzip texinfo-x.x.tar.gz".
  166.       Next, type: "tar xvf texinfo-x.x.tar".  A directory
  167.       texinfo-x.x will be created.  Cd to this directory
  168.       and type: "sh ./configure".  Next, edit the Makefile
  169.       as described above for gzip.  Now, type: "make"
  170.       and ignore any non-fatal errors.  Finally, type:
  171.       "make install".  With newer versions of texinfo,
  172.       you will get a lot of messages about "emacs",
  173.       "*.elc", and "*.el" files.  Just ignore these
  174.       messages.
  175.  
  176.    c. Installation of the gnu version of tar is
  177.       beneficial.  You will be able to use
  178.       "tar -Zxvf <file name>.tar.Z" or
  179.       "tar -zxvf <file name>.tar.gz" to uncompress
  180.       and untar files in one step.  Uncompress, compile
  181.       and install tar as above.  Be sure that /usr/local/bin
  182.       is the first directory in your path.
  183.  
  184.    d. Uncompress, compile and install gnu make.  Follow the
  185.       steps described for texinfo.  Gnu make will install in
  186.       /usr/local/bin.  To disable Sun's make, cd to /usr/bin
  187.       (/usr/ccs/bin for Solaris 2.x) and type:
  188.        
  189.        "mv make make.sun".
  190.  
  191.    e. Compile and install bison following the procedure
  192.       described for texinfo.
  193.  
  194.    f. Uncompress gcc.  Cd to /usr/local/gnu/gcc-x.x.x and
  195.       type:
  196.  
  197.          sh ./configure
  198.  
  199.       Next type:
  200.         make
  201.       This step will take about 17 minutes to complete.
  202.       Ignore warnings reported for insn-emit.c.  Next, type:
  203.         make stage1
  204.       Ignore reported non-fatal errors.  Next, type:
  205.         make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O"
  206.       This step will take about 19 minutes to complete.
  207.       Next, type:
  208.         make stage2
  209.       Ignore reported non-fatal errors.  Next, type:
  210.         make CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O"
  211.       In this step, which lasts about 13 minutes, you will
  212.       make the final stage 3 compiler.  Now type: "make
  213.       compare". No errors should be reported here.  Finally,
  214.       type:
  215.         make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g\
  216.         -O"
  217.       (NOTE: backslash "\" is used in this FAQ to break the
  218.       line for formatting purposes.  You can use the 
  219.       backslash for the same purpose in a command line.
  220.       Please read Sun documentation, if you need more
  221.       information.) 
  222.       to install the gcc compiler.  It is advisable to
  223.       recompile patch, gzip, texinfo, make and bison with
  224.       gcc.  It will be a good test for proper gcc
  225.       functionality.
  226.  
  227.    g. Uncompress gawk. Cd to directory gawk-x.x.x and type:
  228.        sh ./configure sunos41
  229.         (for Solaris 2.x: sh ./configure solaris2.cc)     
  230.     Next type: "make".  When gawk will compile, type:
  231.         make install
  232.       Finally, disable Sun's awk by typing:
  233.         mv /usr/bin/awk /usr/bin/awk_sun
  234.       and create a link to gawk for awk by typing:
  235.         ln -s /usr/local/bin/gawk /usr/bin/awk
  236.  
  237.    h. Uncompress grep.  Cd to directory grep-x.x and type:
  238.         ./configure
  239.       Next type: "make" and "make install".  Grep will
  240.       also be installed in /usr/local/bin as fgrep
  241.       and egrep.  Finally, as some programs expect to find
  242.       grep, egrep and fgrep in /usr/bin, disable Sun's grep
  243.       and create appropriate links, just like described
  244.       for awk.  INN expects to find a program "egnugrep" in
  245.       /usr/local/bin.  Create it by typing:
  246.          cp /usr/local/bin/egrep /usr/local/bin/egnugrep
  247.  
  248.    i. Uncompress sed and patch.  Compile and install these
  249.       utilities following the instructions for grep.
  250.  
  251.  
  252.    j. INN comes with some scripts written in the perl
  253.       language.  Uncompress perl, cd to directory perl-x.xxx
  254.       and type:
  255.        sh ./Configure
  256.       and hit Return for default answers to all questions.
  257.       Next, type: "make depend", then "make".  Now type:
  258.        make test
  259.       to check, if perl works without errors.  Finally,
  260.       type:
  261.        make install
  262.       to complete installation of perl.
  263.       
  264.       Solaris 2.x: answer "none" for -I/usr/ucbinclude
  265.       and add libraries: -lm -lnsl -lsocket
  266.  
  267. II. INSTALLATION OF INN 1.4
  268.  
  269.  
  270.   1. As root, create directories: /usr/local/inn1.4 (this
  271.      will be your $inn directory) and /usr/local/news.
  272.      (Solaris 2.x, you have to create a user "news",
  273.      good choice is UID=6, GID=13, home
  274.      directory=/var/spool/news, shell /bin/csh, no password
  275.      - account is locked, * in password field in /etc/shadow.
  276.      Be sure, to create a new group in /etc/group "news"
  277.      with GID=13.)
  278.  
  279.   2. Cd to $inn. Get the newest version of inn from:
  280.      ftp.uu.net (192.48.96.9).  This file is in the
  281.      directory: /networking/news/nntp/inn.   As for all
  282.      binary files, please remember to set the file type in
  283.      ftp to binary.
  284.  
  285.   3. From the same source and directory get the Frequently
  286.      Asked Questions (FAQ) files:
  287.        faq-inn-1.Z
  288.        faq-inn-2.Z
  289.        faq-inn-3.Z
  290.        faq-inn-4.Z (this file)
  291.        faq-nov.Z
  292.      and any other files that may contain patches or 
  293.      information.
  294.  
  295.   4. To uncompress the FAQ files type: "uncompress faq-*.Z.
  296.      Print the FAQs and read them before proceeding further.
  297.  
  298.   6. In $inn type (with gnu tar):
  299.      "tar -Zxvf innx.x.tar.Z
  300.      This will extract inn files for compilation.
  301.  
  302.   7. Change directory to $inn/config, and type:
  303.        cp config.dist config.data
  304.        chmod 644 config.data
  305.      Now use the vi editor to edit config.data.  You should
  306.      select gcc as the compiler by changing the line that
  307.      starts with "CC" to read "CC   gcc".  Many lines in
  308.      config.data define the location of various files
  309.      and directories.  It's OK to leave defaults, but
  310.      check if you have ample space in the directory
  311.      where the articles will be stored (/var/spool).  More
  312.      information on where INN expects to find certain files
  313.      is in: $inn/samples/innshellvars.  If necessary, edit
  314.      the config.data and innshellvars to reflect your
  315.      configuration.  Please make sure that specified
  316.      directories and utilities exist on your system.
  317.   
  318.   
  319.   8. Change directory to $inn.  Type: "make world".  Now
  320.      type:
  321.        cat */lint
  322.      (Solaris 2.x - there is not lint included with
  323.      Solaris 2.x.  One way to get Solaris 2.x version
  324.      of lint suggested to me, is to get a 30 day trial
  325.      package of the SunPro C compiler from Sun.  However,
  326.      lint is not really needed, except for testing new
  327.      code.  You can make a symbolic link from /bin/echo
  328.      to lint.)
  329.      lint will give you a list of compiler warnings and
  330.      errors.  In addition, "make" creates in this step
  331.      a file:  "$inn/Install.ms".  Print it by typing:
  332.        nroff -ms Install.ms | lpr
  333.      Install.ms is a manual for installation of INN written
  334.      by Rich Salz, the author of INN.  There is a lot of
  335.      important and interesting information in his manual.
  336.  
  337.   9. If you got no fatal errors from make, go to the
  338.      $inn/site directory
  339.      and type: "make all".
  340.  
  341.  10. There are some scripts and control files listed in
  342.      inn-faqs and Install.ms that may be modified at this
  343.      point.  For most installations, the default settings
  344.      are OK.
  345.  
  346.  11. Now cd to $inn and type: "make install" to complete
  347.      basic installation of INN.
  348.  
  349.  12. To finish installation of INN, run the BUILD script
  350.      in the $inn directory by typing "sh BUILD".  This
  351.      script will ask a series of configuration questions
  352.      that are easy to answer.  Please note that if your have
  353.      "history.*" files in your /usr/local/news directory
  354.      from a previous or failed installation of INN, the
  355.      BUILD script will not complete.  Rename them to
  356.      "old.history.*" and re-run the BUILD script.
  357.  
  358.  13. You need a site that will feed news to you.
  359.      This will depend on your geographic location and
  360.      organization.  Ask a System Administrator of a site
  361.      close to you for hints.
  362.  
  363.  14. Ftp to your newsfeeding site and get the "active" file
  364.      from there.  Place this file in your /usr/local/news
  365.      directory and edit it to your taste.  Remember to
  366.      include the "control" and "junk" newsgroups.  Also, you
  367.      have to edit the following files in /usr/local/news:
  368.      newsfeeds, hosts.nntp, nnrp.access, inn.conf.
  369.      Be careful with editing the "active" file
  370.      with vi or textedit.  A common error is to leave a
  371.      blank line at the top.  This error causes INN to
  372.      crash with the message: "ME bad_active".  Depending
  373.      on your setup, you will get this message in the syslog
  374.      or on the console.
  375.  
  376.  15. To check for syntax errors in INN control files,
  377.      file ownership, permissions and other things type:
  378.        /usr/local/bin/perl /usr/local/news/bin/inncheck
  379.      and correct any errors reported by inncheck.
  380.      If your paths are set, it is sufficient to
  381.      change to the /usr/local/news/bin directory and type:
  382.        "perl ./inncheck" or "./inncheck".
  383.  
  384.  16. Look at the file "rc.news" in /usr/local/etc.
  385.      It's advisable to enable the innwatch utility.
  386.      Innwatch will throttle the newsserver when your disk
  387.      will get full and prevent crashes.  Change the line
  388.      starting with "DOINNWATCH" to read "DOINNWATCH=true".
  389.      (Solaris 2.x: edit the innwatch.ctl file and replace
  390.      df with /usr/ucb/df.  Default Solaris 2.x
  391.      /usr/sbin/df doesn't understand the -i option.)
  392.      Now type: "sh /usr/local/etc/rc.news"
  393.      and look in /var/log/syslog for errors.  Also, type:
  394.        ps -aux| grep news
  395.      and check, if the innd process owner is news.
  396.      
  397.      On Solaris 2.x, the syntax is a bit different:
  398.        ps -fu news
  399.  
  400.  17. In /etc/aliases create an entry: "usenet: <you, or
  401.      root>".  Next type: "/usr/ucb/newaliases" to inform the
  402.      sendmail program that the aliases file has changed.
  403.      If you are running YP (NIS) on your network, you may
  404.      optionally add the "usenet" alias to your YP aliases
  405.      file.  If the machine you are installing INN on is the
  406.      YP master and the file "/etc/aliases" is the source of
  407.      the YP aliases map, you should type: "cd /var/yp"
  408.      followed by "make".  Reboot and restart innd (see #16). 
  409.    
  410.  
  411.  18. To get daily reports on the newsserver activity from
  412.      the "news.daily" script and to enable the "expire"
  413.      utility type: "/bin/crontab -e news" and insert the
  414.      following line:
  415.        40 23 * * * /usr/local/news/bin/news.daily delayrm
  416.      or, if you are using overchan (in newsfeeds):
  417.        40 23 * * * /usr/local/news/bin/news.daily delayrm\
  418.        expireover
  419.  
  420.  19. To set-up complete logging of the server activities
  421.      and have them ready for a report by the "news.daily"
  422.      script, you have to edit your /etc/syslog.conf file.
  423.      Insert at the end of this file the content of
  424.      the syslog.conf file written by Rich Salz.  This file
  425.      is in: $inn/syslog.  Please check, if you have the
  426.      directories and files mentioned in Rich's syslog.conf.
  427.  
  428.  20. Run tests from your machine to the server (to your
  429.      machine at telnet port 119).  See inn-faqs for details.
  430.  
  431.  21. After completing these test, be sure to delete the
  432.      entry for your machine from the hosts.nntp file.  If
  433.      you will not do it, your machine will be treated as a
  434.      "feeder" and not as a "reader".
  435.  
  436.  22. Set posting. 
  437.  
  438.       a. Edit the /usr/local/news/newsfeeds file and add:
  439.            <alias for your feed>/<full address of feed>\
  440.            :*\ (for all local postings)
  441.            :Tf,Wnm: (standard entry)
  442.  
  443.       b. Edit /usr/local/news/nntpsend.ctl file and add:
  444.            <alias for your feed>:<full address of feed>::\
  445.            -T1800 -t300
  446.  
  447.       c. Type: "/bin/crontab -e news" and insert a line:
  448.            0,10,20,30,40,50 * * * *\
  449.             /usr/local/news/bin/nntpsend
  450.   
  451.       d. Run inncheck (see #15).
  452.  
  453.       e. Post to misc.test and include "reply" in the
  454.          Subject line, automatic responses will be mailed to
  455.          usenet (see #17) within a few minutes.
  456.  
  457.  23. To start innd automatically at bootup, include at the
  458.      end of your rc.local the following lines:
  459.  
  460.       #
  461.       # Start INN news service - Internet News Daemon (innd)
  462.       #
  463.       if [ -f /usr/local/etc/rc.news ]; then
  464.          /usr/local/etc/rc.news; echo "Starting INN news
  465.                  service"
  466.       fi
  467.      
  468.     (In Solaris 2.x there is no rc.local.  If you want
  469.      to start INN automatically, you should create a
  470.      script in /etc/rc2.d).
  471.  
  472.      NOTE: Please send me your solutions for boot time
  473.      starting and shutdown closing of INN on Solaris!
  474.  
  475.  24. Watch the news.daily reports in your mail for any
  476.      additional errors.  To run the news.daily script
  477.      at any time manually, first su from root to "news"
  478.      and type: "/usr/local/news/news.daily".  A mail to
  479.      "usenet" should arrive within a couple of minutes
  480.      and may report important configuration problems.
  481.  
  482.  
  483. III. UPGRADING FROM INN 1.3 TO INN 1.4
  484.  
  485.   1. Stop the server.  Type:
  486.        ctlinnd shutdown "upgrade"
  487.  
  488.   2. Create a directory /usr/local/inn1.4, this will be
  489.      your $inn directory.  cd to $inn.  Next, ftp to
  490.      ftp.uu.net, cd to directory: /networking/news/nntp/inn
  491.      and get the following files:
  492.  
  493.         inn1.4sec.tar.Z
  494.         faq-inn-1.Z
  495.         faq-inn-2.Z
  496.         faq-inn-3.Z
  497.         faq-inn-4.Z (this file)
  498.         faq-nov.Z
  499.      Uncompress and print the FAQs.  Next, type
  500.      (with gnu tar):
  501.         tar -Zxvf inn1.4sec.tar.Z
  502.  
  503.      Print the README file.  To print the Install file,
  504.      type: "make Install.ms" followed by:
  505.         nroff -ms Install.ms | lpr
  506.  
  507.   3. Now, cd to $inn/config and type the following commands:
  508.         make subst
  509.         cp config.dist config.data
  510.         ./subst -f {OLDFILE} config.data
  511.      where {OLDFILE} is the location of config.data in your
  512.      INN 1.3 directory.  Be sure to check, if in your old
  513.      config.data the "CC" line reads "CC  gcc".
  514.      Ignore warnings about new lines.  Next, type:
  515.         make sedtest
  516.      No errors should be reported here.  Now, cd to $inn
  517.      and type this series of commands:
  518.         make quiet
  519.         cd ../lib
  520.         make libinn.a lint
  521.         cd ../frontends
  522.         make all
  523.         cd ../innd
  524.         make all
  525.         cd ../nnrpd
  526.         make all
  527.         cd ../backends
  528.         make all
  529.         cd ../expire
  530.         make all
  531.         cd ../site
  532.         make all
  533.         cd ..
  534.         make update
  535.  
  536.   4. Restart innd.
  537.  
  538.  
  539. IV. MAINTENANCE OF INN
  540.  
  541.  1. Adding new groups - see also Part IV, Section 3.b,:
  542.  
  543.      a. Type: "ctlinnd pause 'edit active'"
  544.  
  545.      b. Edit the active file.  The format is:
  546.           groupname himark lomark flag.
  547.         Set himark to 0000000000 and lomark to 0000000001.
  548.         For detailed description of flags, read the man
  549.         page for active.  Editing the active file by hand
  550.         is easy, but will not update the information in
  551.         that file active.times that some newsreaders
  552.         require to trace new newsgroups.  Using ctlinnd
  553.         command "newgroup" takes care of this problem
  554.         (see below).  Editing the active file with an
  555.         editor has one drawback - the file active.times
  556.         is not automatically updated.  This creates problems
  557.         for some newsreader (Trumpet being one of them) 
  558.         that use this file to alert users to new groups.
  559.         Using ctlinnd command "newgroup" (see Part IV.3.b)
  560.         corrects this problem. 
  561.  
  562.     c. Run inncheck (see #11) to check the new active file
  563.        for errors. 
  564.   
  565.     d. Type: "ctlinnd reload active 'new active'".
  566.  
  567.     e. Type: "ctlinnd go 'edit active'".
  568.  
  569.  
  570.  2. New groups are sometimes added automatically through
  571.     a control message.  A mail message to usenet will alert
  572.     to such an automatic change to the active file.  If you
  573.     do not want to subscribe to a particular news group,
  574.     change directory to /usr/local/news and type:
  575.       ctlinnd rmgroup <group name>
  576.  
  577.  3. Sometimes, a mail message will arrive for usenet with
  578.     a checkgroups file.  Remove header, save the body of
  579.     the message in:
  580.       /usr/local/news/bin/control/news_control/news_control_
  581.                     todaysdate
  582.     cd to that directory and type:
  583.       ../docheckgroups <news_control_todaysdate
  584.              >todaysdate_pre
  585.     Read the output file (todaysdate_pre) and carry out all 
  586.     the instructions that you think pertain to your
  587.     situation.  Read the man pages for "active" and
  588.     "ctlinnd" for more info.  To implement the changes, you
  589.     will have to change to the directory: /usr/local/news
  590.     and:  
  591.     
  592.      a. remove a discontinued group:
  593.           type: "ctlinnd rmgroup <group name>"
  594.  
  595.      b. add a group:
  596.         type: "ctlinnd newgroup <group name> flag <creator
  597.                                            name>"
  598.  
  599.      c. mark a group correctly:
  600.         type: "ctlinnd changegroup <group name> flag"
  601.  
  602.     Run inncheck and repeat the docheckgroups command from
  603.     the /usr/local/bin/control/news_control directory
  604.     by typing:
  605.       ../docheckgroups <news_control_todaysdate
  606.                                 >todaysdate_after
  607.     Correct any reported problems.  Also, you may have to
  608.     edit the /usr/local/news/newsgroups file to reflect
  609.     any changes you introduced.
  610.  
  611.  4. Read the reports mailed to usenet (you) by the
  612.     news.daily script.  Most errors are reported here and
  613.     should be easy to fix.
  614.  
  615.  5. Subscribe to and read the following newsgroups:
  616.       news.software.nntp
  617.       news.software.readers
  618.       
  619.  
  620.  6. IMPORTANT!!! Never run fsck on the drive where the
  621.     /spool/news files are located while running INN.  Innd
  622.     has a lot of active disk I/O going on and you could
  623.     corrupt your drive. Use ctlinnd to throttle, pause, or
  624.     shutdown innd first - see the manual page for ctlinnd.
  625.  
  626.  
  627.   V. INSTALLATION OF XVNEWS, A SUN OPENWINDOWS
  628.      NEWSREADER
  629.  
  630.    1. Create a directory /usr/local/xvnews and cd to this
  631.       directory.
  632.  
  633.    2. Ftp to ftp.twi.tudelft.nl and get the file
  634.       xvnews.tar.gz from directory /pub/news.
  635.  
  636.    3. Ungzip and untar xvnews.  With gnu tar type:
  637.         tar -zxvf xvnews.tar.gz
  638.  
  639.    4. Use your vi editor and edit the file xvnews.h
  640.       You will need to enter your settings for:
  641.         DOMAIN         (on my machine: "pdb.cdc.gov")
  642.         ORGANIZATION   (on my machine: "Centers for Disease
  643.                           Control Atlanta, GA, USA")
  644.         NNTPSERVER     (on my machine:
  645.                                "giardia.pdb.cdc.gov")
  646.       Preferred method is to override these defaults
  647.       by specifying environment variables DOMAIN, ORGANIZATION,
  648.       and NNTPSERVER in your .cshrc or .profile files
  649.       (see the xvnews man page).  In this way, you will be able
  650.       to change default settings quickly.
  651.  
  652.    5. Compile xvnews by typing:
  653.       "make -f Makefile.dist"
  654.       This command will show you, how to enter defaults
  655.       for your operating system (e.g. - "sunos5" for Solaris 2.x,
  656.       "sunos4" for SunOS 4.1.x).  I get some compilations
  657.       warnings on my system, but the program runs OK.  Copy xvnews
  658.       to /usr/local/bin and xvnews.man to directory:
  659.       /usr/local/man/man1 as xvnews.1.  
  660.  
  661.  
  662.  
  663. -- 
  664.           See <a href="http://www.netbsd.org">NetBSD</a> for a multiplatform OS
  665. What would you call a BBS run by a mom?
  666.    A "mother board".
  667.