home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / news / cnews.tar / README.install < prev   
Text File  |  1994-11-27  |  5KB  |  110 lines
  1. The installation procedure has changed, a lot.  It relies much more on
  2. makefiles now.  Thusly:
  3.  
  4. 1. Run "quiz".  This replaces "build".  One caution:  quiz says that a
  5.     reasonable place to put NEWSCTL is /etc/news... this is doubtful
  6.     advice because at least three of the files in there (headers,
  7.     history, log) can get large and /etc is usually on a not-large
  8.     root filesystem.
  9.  
  10. 2. "make".  This will build all the software.  If you asked for the stdio
  11.     speedups, it will check them out before actually deciding to rely
  12.     on them; don't panic if you see a messy-looking failure but make
  13.     charges onward -- it knows what it's doing.  Note:  getting the
  14.     command search path set up properly for compiling is up to you --
  15.     the search path which quiz asks about is used only for *running*
  16.     the software.  Also, you need to get the umask set up so that the
  17.     compiled binaries will have the right permissions -- again, the
  18.     umask quiz asks about is used only for *running* the software.
  19.  
  20. 3. (optional but recommended) "make r".  This will run regression tests.
  21.     They take a while.  Errors that don't cause make to stop are not
  22.     serious; ones that do, are.
  23.  
  24. 4. Create the NEWSARTS, NEWSOV, NEWSBIN, and NEWSCTL directories, and set
  25.     their ownerships correctly.  The makefiles won't do this for you.
  26.     NEWSBIN can be owned by most anyone; the rest should be owned
  27.     by the news-database owner.
  28.  
  29. 5. Running as the NEWSBIN owner, "make install".  Note:  getting the
  30.     umask set up properly for installation is up to you -- the umask
  31.     which quiz asks about is used only for *running* the software.
  32.  
  33. 6. Running as the news-database owner, "make setup".  These makes, by the
  34.     way, are generally fairly careful not to step on existing files
  35.     that should not be changed.
  36.  
  37. 7. Running as whoever owns /usr/bin (or wherever you've decided to put
  38.     inews etc.), "make ui".
  39.  
  40. 8. (optional) If you want our readnews, postnews, and checknews, then
  41.     running as whoever owns /usr/bin (or wherever you've decided to
  42.     put inews etc.), "make readpostcheck".
  43.  
  44. 9. Change NEWSBIN/input/newsspool to be owned (including group) by the
  45.     news-database owner, and mode rwsr-sr-x (both s's are mandatory).
  46.  
  47. 10. Go to NEWSCTL and edit some control files, at least:  batchparms,
  48.     controlperm, explist, mailname, mailpaths, organization,
  49.     postdefltgroup, readnews.ctl, sys, whoami.  Notably, editing mailname
  50.     (to the name appropriate in From headers) and whoami (to the news
  51.     name of the system) is MANDATORY at this point, unless you're
  52.     updating an old system (in which case the old ones will still
  53.     be there).
  54.  
  55. 11. Back in the source directory, "make cmp".  If this finishes with a
  56.     "no worrisome differences" message, it looks like everything is
  57.     installed right.
  58.  
  59. 12. Make any mail aliases necessary for trouble reporting, e.g. "newsmaster"
  60.     and "newscrisis" if you used quiz's suggestions about reporting
  61.     addresses.  Also, unless your site is engaged in network mapping,
  62.     you should arrange for mail to "newsmap" to be discarded (not
  63.     returned, not forwarded, just discarded) to minimize the effects
  64.     of "sendsys bombing" by practical jokers.  We suggest you also
  65.     arrange that mail to "news", "usenet", "newsmaster", and the
  66.     news-database owner gets sent somewhere where it will be looked
  67.     at regularly.
  68.  
  69. 13. Put conf/crontab, or something like it, in as the news-database
  70.     owner's crontab.
  71.  
  72. 14. Arrange to have NEWSBIN/maint/newsboot run (as the news-database
  73.     owner) when your system boots, to clear out any debris left
  74.     around by crashes.
  75.  
  76. 15. Install the manual pages, from man/, and perhaps the documentation,
  77.     from doc/, as you wish.  This is too system-specific for the
  78.     makefiles to attempt it.
  79.  
  80. 16. Create a local newsgroup, if you don't have one already --
  81.     "cnewsdo addgroup mysite.general y" will do the job -- and
  82.     then run postnews and post an article to it.
  83.  
  84. 17. It should show up, with headers spruced up, in NEWSARTS/in.coming.
  85.  
  86. 18. The next time newsrun runs -- see the crontab -- the article should
  87.     appear in the newsgroup, the history file, the log file, and
  88.     NOT in the errlog file.  Run readnews (or some other reader) and
  89.     try to read it.  If you can, then you did most everything right.
  90.  
  91. 19. Get a feed from somebody, somehow, and see if batches from them are
  92.     arriving in NEWSARTS/in.coming properly and being processed okay.
  93.     Don't forget to add them to your sys file, and set up anything
  94.     needed to feed your postings to them (e.g., batchparms).
  95.  
  96. 20. Post a test article to a regional test newsgroup and see if it goes
  97.     out to your feed site.
  98.  
  99. 21. "make tidy" will get rid of most of the debris in the sources, leaving
  100.     the C News library intact.  "make clean" will also get rid of the
  101.     library.  "make veryclean" will also get rid of everything that any
  102.     of the makes did (except that some changed files will remain changed).
  103.     Going farther than this is NOT RECOMMENDED for normal cleanup.  If
  104.     you must...  "make spotless" will also get rid of everything quiz
  105.     did except for its recorded-answers file (which it will use as
  106.     defaults next time you run it), and "make sterile" will get rid
  107.     of even that.  Note that doing "make spotless" will disable most
  108.     of the makefiles (until you run quiz again) by removing the header
  109.     file that they rely on.
  110.