home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 13 / CDA13.ISO / DOC / HOWTO / OTHER_FO / SGML / NEWS_HOW.GZ / News-HOWTO.sgml
Encoding:
SGML Document  |  1996-02-11  |  30.4 KB  |  749 lines

  1. <!-- <date>$Id: news-howto,v 1.4 1995/11/29 18:26:58 vince Exp $ -->
  2.  
  3. <!doctype linuxdoc system>
  4. <article>
  5. <title>The Linux News HOWTO
  6. <author>Vince Skahan, <tt><vince@halcyon.com></tt>
  7. <date>v1.4, 29 November 1995
  8. <abstract>
  9. This document describes the setup and care+feeding of USENET News under Linux.
  10. You need to read this if you plan to post or read USENET news either locally
  11. on your site or between your site and other sites.  You probably do *not* need
  12. to read this document if don't plan to provide USENET news as a feature of
  13. your system.
  14.  
  15. </abstract>
  16. <toc>
  17. <sect>Introduction
  18. <p>
  19. The intent of this document is to answer some of the questions and comments
  20. that appear to meet the definition of "frequently asked questions" about
  21. USENET News software under Linux in general, and the version in the Linux
  22. Slackware distribution in particular.
  23.  
  24. This document and the corresponding Mail and UUCP "HOWTO" documents
  25. collectively supersede the UUCP-NEWS-MAIL-FAQ that has previously been posted
  26. to comp.os.linux.announce.
  27.  
  28. <sect1>New versions of this document
  29. <p>
  30. New versions of this document will be periodically posted to
  31. comp.os.linux.announce, comp.answers, and news.answers.  They will also be
  32. added to the various anonymous ftp sites who archive such information
  33. including <tt>sunsite.unc.edu:/pub/Linux/docs/HOWTO</tt>.
  34.  
  35. <p>
  36. In addition, you should be generally able to find this document on the
  37. Linux WorldWideWeb home page at <tt>http://sunsite.unc.edu/mdw/linux.html</tt>.
  38.  
  39. <sect1>Feedback
  40. <p>
  41. I am interested in any feedback, positive or negative, regarding the content
  42. of this document via e-mail.  Definitely contact me if you find errors or
  43. obvious omissions.
  44.  
  45. I read, but do not necessarily respond to, all e-mail I receive.  Requests for
  46. enhancements will be considered and acted upon based on that day's combination
  47. of available time, merit of the request, and daily blood pressure :-)
  48.  
  49. Flames will quietly go to /dev/null so don't bother.
  50.  
  51. In particular, the Linux filesystem standard for pathnames is an evolving
  52. thing.  What's in this document is there for illustration only based on the
  53. current standard at the time that part of the document was written and in
  54. the paths used in the distributions or 'kits' I've personally seen.  Please
  55. consult your particular Linux distribution(s) for the paths they use.
  56.  
  57. Feedback concerning the actual format of the document should go to the HOWTO
  58. coordinator - Greg Hankins (<tt>gregh@sunsite.unc.edu</tt>).
  59.  
  60. <sect1>Copyright Information
  61. <p>
  62. The News-HOWTO is copyrighted (c)1994 Vince Skahan.
  63.  
  64. A verbatim copy may be reproduced or distributed in any medium physical or
  65. electronic without permission of the author.  Translations are similarly
  66. permitted without express permission if it includes a notice on who translated
  67. it.
  68.  
  69. Short quotes may be used without prior consent by the author.  Derivative work
  70. and partial distributions of the News-HOWTO must be accompanied with either a
  71. verbatim copy of this file or a pointer to the verbatim copy.
  72.  
  73. Commercial redistribution is allowed and encouraged; however, the author would
  74. appreciate being notified of any such distributions (as a courtesy).
  75.  
  76. In short, we wish to promote dissemination of this information through as many
  77. channels as possible. However, we do wish to retain copyright on the HOWTO
  78. documents.
  79.  
  80. We further want that ALL information provided in the HOWTOS is disseminated.
  81. If you have questions, please contact Greg Hankins, the Linux HOWTO coordinator,
  82. at <tt>gregh@sunsite.unc.edu</tt>.
  83.  
  84. <sect1>Standard Disclaimer
  85. <p>
  86. Of course, I disavow any potential liability for the contents of this
  87. document.  Use of the concepts, examples, and/or other content of this
  88. document is entirely at your own risk.
  89.  
  90. <sect1>Other sources of information
  91. <p>
  92. <sect2>USENET
  93. <p><verb>
  94.    news.admin.misc         General topics of network news administration.
  95.    news.admin.policy       Policy issues of USENET.
  96.    news.admin.technical    Maintaining network news. (Moderated)
  97.    news.software.b         Discussion about B-news-compatible software.
  98.    news.software.nn        Discussion about the "nn" news reader package.
  99.    news.software.nntp      The Network News Transfer Protocol.
  100.    news.software.readers   Software used to read network news.
  101.    news.sysadmin           Comments directed to system administrators.
  102.    news.announce.newusers  Explanatory postings for new users. (Moderated)
  103.    news.newusers.questions Q & A for users new to the Usenet.
  104. </verb>
  105.  
  106. <sect2>Books
  107. <p>
  108. The following is a non-inclusive set of books that will help
  109.  
  110. <itemize>
  111. <item>"<tt>Managing UUCP and USENET</tt>" published by O'Reilly+Associates is in my
  112. opinion the best book out there for figuring out the programs and protocols
  113. involved in being a USENET site.
  114.  
  115. <item>"<tt>Unix Communications</tt>" published by The Waite Group contains a nice
  116. description of all the pieces (and more) and how they fit together.
  117.  
  118. <item>"<tt>Practical Unix Security</tt>" published by O'Reilly+Associates has a nice
  119. discussion of how to secure UUCP in general.
  120.  
  121. <item>"<tt>The Internet Complete Reference</tt>" from Osborne is a fine reference book
  122. that explains the various services available on Internet and is a great
  123. source for information on news, mail, and various other Internet resources.
  124.  
  125. <item>"<tt>The Linux Networking Administrators' Guide</tt>" from Olaf Kirch of the
  126. Linux DOC Project is available on the net and is also published by (at least) 
  127. O'Reilly and SSC.  It makes a fine <em>one-stop shopping</em> to learn about 
  128. everything you ever imagined you'd need to know about Unix networking.
  129.  
  130. </itemize>
  131.  
  132. <sect1>Where NOT to look for help
  133. <p>
  134. There is nothing "special" about configuring and running USENET news under
  135. Linux (any more).  Accordingly, you almost certainly do *NOT* want to be
  136. posting generic news-related questions to the comp.os.linux.* newsgroups.
  137.  
  138. Unless your posting is truly Linux-specific (ie, "please tell me what patches
  139. are needed to run INN with the bash1.12 in SLS v1.03") you should be asking
  140. your questions in the newsgroups mentioned above.
  141.  
  142. Let me repeat that.
  143.  
  144. There is virtually no reason to post anything news-related in the
  145. comp.os.linux hierarchy any more.  There are existing newsgroups in the news.*
  146. hierarchy to handle *ALL* your questions.
  147. <p>
  148. <em>
  149. IF YOU POST TO COMP.OS.LINUX.* FOR NON-LINUX-SPECIFIC QUESTIONS, YOU ARE
  150. LOOKING IN THE WRONG PLACE FOR HELP.  THE USENET NEWS EXPERTS HANG OUT IN THE
  151. PLACES INDICATED ABOVE AND GENERALLY DO NOT RUN LINUX.
  152. </em>
  153. <p>
  154. <em>
  155. POSTING TO THE LINUX HIERARCHY FOR NON-LINUX-SPECIFIC QUESTIONS WASTES YOUR
  156. TIME AND EVERYONE ELSE'S AND IT FREQUENTLY DELAYS YOU FROM GETTING THE ANSWER
  157. TO YOUR QUESTION.
  158. </em>
  159. <sect>Hardware Requirements
  160. <p>
  161. There are no specific hardware requirements for USENET News under Linux.  The
  162. only requirement of any type is sufficient disk space to hold the software
  163. itself, the threads database(s), and the amount of news you wish to keep on
  164. the system.  Figure on a minimum of 10 MB of disk space for starters.
  165.  
  166. <sect>Getting USENET News software 
  167. <p>
  168. All the software referenced in this "HOWTO" is available on the usual Internet
  169. anonymous ftp sites.
  170.  
  171. Looking in /networking/news on <tt>ftp.uu.net</tt> is usually a good way to start.
  172.  
  173. The newspak-2.4.tar.z distribution contains config files and readme files
  174. related to building uucp, news, and mail software under Linux from the various
  175. freely-available sources.  It can usually be found in 
  176. <tt>sunsite.unc.edu:/pub/Linux/system/Mail/news</tt>.  If you can't find it on
  177. sunsite, please send me mail and I'll make sure you get a copy of it.
  178.  
  179. <sect>News Transport Software
  180. <p>
  181. There are two main sets of news "transport" software for *nix these days,
  182. Cnews and INN.  The old "Bnews" has been declared officially dead and
  183. unsupported by its authors.
  184.  
  185. News "transport" is defined here to be the software that works behind the
  186. scenes to post and propagate the news articles as well as making the articles
  187. available for the newsreaders to access.
  188.  
  189. You can set your paths to anything you like, as long as UUCP has the absolute
  190. path to rnews in the Permissions file and as long as you have your newsreaders
  191. configured so that they can find "inews" and "mail".
  192.  
  193. Important - you're asking for trouble if you try to intermix Cnews and INN.
  194. Pick one or the other.  It's ok to add the NNTP "Reference Release" into Cnews
  195. since they're intended to play well together.
  196.  
  197. <sect1>Cnews Cleanup Release
  198. <p>
  199. The current de-facto standard news software is Cnews.  It has been around for
  200. a number of years, I first saw it sometime around 1988.  The current version
  201. at this writing is called "Cnews Cleanup Release, with patch CR.G".
  202.  
  203. Cnews's main benefit is its maturity.  It runs on about every *nix you can
  204. find and there are literally thousands of systems running it worldwide.
  205.  
  206. Its main disadvantage is that it seems to have been intended for
  207. uucp-over-modem connections between sites and as such requires the addition of
  208. NNTP software to handle realtime Internet feeds and reading.
  209.  
  210. Regardless, the beginning USENET admin should probably run Cnews first since
  211. it's so stable, well documented, and has many thousands of experienced
  212. administrators who can answer questions.
  213.  
  214. The 'Cleanup Release' claims that "Overview support has been fully integrated
  215. and is faster than it used to be."  The result is that you can do things like
  216. use Cnews NOV support rather than running external threading packages for
  217. newsreaders such as nn, tin, and trn.
  218.  
  219. I haven't quite figured how to implement this part yet, since I switched to
  220. INN at home long ago.  If anybody wants to clue me in to update this 
  221. document, please drop me a line via e-mail.
  222.  
  223. The newspak distribution on sunsite contains working config files
  224. for the Cnews Cleanup Release under Linux as well as a couple line patch
  225. you'll need to make to <tt>"doexplode"</tt> to get around some problems with
  226. bash1.12.
  227.  
  228. Basically you run the new 'quiz' script and take the defaults.  You'll have to
  229. refer to your /usr/include tree to answer a number of the questions, but
  230. that's rather straightforward.
  231.  
  232. <sect2>Installing Cnews
  233. <p>
  234. Installing the Cleanup Release of Cnews is absolutely a "rtfm" project.
  235. Just grab the sources, extract them, and follow the instructions.
  236.  
  237. The <tt>quiz.def</tt> in newspak was generated by running "quiz" the first time and
  238. simply looking up the answers by checking out the /usr/include files to get
  239. the right answers.
  240.  
  241. You'll need a recent 'bash' to have C-news pass its self-tests.   Try 'bash -version'
  242. to find which version you have.  Version 1.14.2 is definitely no good.  The current
  243. (at this writing) version of 1.14.5 seems better.
  244.  
  245. Steve Robbins also has determined that the recent 'cleanup release' of Cnews
  246. has found a bug in GNU 'join' from shellutils-1.9.  There are a few patches
  247. needed to the sources for join to deal with the problem.  Steve's put them
  248. on sunsite as I recall.
  249.  
  250. <sect2>Configuring Cnews
  251. <p>
  252. At the very least, you need to edit or at least take a look at
  253. the following files that all should be in /usr/local/lib/news:
  254.  
  255. <verb>
  256. active             - the active file 
  257. batchparms         - batch parameters
  258. explist            - article expiration setup
  259. mailname           - name in headers for mailed replies
  260. mailpaths          - path to mail moderated postings to
  261. organization       - your "org"
  262. sys                - control what you take and feed
  263. whoami             - your hostname for the Path: line
  264. </verb>
  265.  
  266. <sect2>Maintaining a Cnews Site
  267. <p>
  268. First, a significant rule of thumb is to not mess with files by hand that have
  269. utilities that configure them. In particular don't set up newsfeeds manually (run
  270. "<tt>addfeed</tt>" instead) and don't mess with your active file (run "<tt>addgroup</tt>").
  271. When in doubt, read and re-read the docs in the source distribution.
  272.  
  273. Everything else can be done via <tt>cron</tt>.  My crontab for "news" looks like the
  274. following:
  275.  
  276. <verb>
  277.     # take the compressed batches that came in from other systems
  278.     # also, post (locally) articles that originated here
  279.     20 *       * * * /usenet/sw/news/bin/input/newsrun  
  280.  
  281.     # batch 'em up to go out
  282.     0 *       * * * /usenet/sw/news/bin/batch/sendbatches myfeedsite
  283.  
  284.     # expire C-news 
  285.     59 0       * * * /usenet/sw/news/bin/expire/doexpire 
  286.  
  287.     # monitor stuff and report if needed
  288.     10 5       * * * /usenet/sw/news/bin/newsdaily 
  289.     00 5       * * * /usenet/sw/new/bin/newswatch 
  290.  
  291.     # turn processing of incoming news batches off 6:30AM - 4:00 PM
  292.     30 6       * * * /usenet/sw/news/bin/input/newsrunning off 
  293.     00 16       * * * /usenet/sw/news/bin/input/newsrunning on 
  294. </verb>
  295.  
  296. <sect1>InterNetNews (INN)
  297. <p>
  298. INN is the newcomer on the scene, but it's gaining popularity as it matures.
  299. Its main benefit is speed and the fact that it contains an integrated nntp
  300. package.  Its main drawback is that it's new and that it doesn't necessarily
  301. install and run flawlessly on the many "standard *nixes" yet.  In addition, it
  302. operates by having a daemon (the <tt>innd</tt>) always running plus potentially a
  303. overchan daemon to do threading.  The tradeoff seems to be memory vs. speed.
  304.  
  305. I've run up to a 5 MB/night newsfeed incoming over UUCP with INN on a 8 MB
  306. 386-33 (no Xwindows running normally) over a 14.4 KB modem with no problems at all.
  307.  
  308. New USENET admins should probably not try INN until they have experience with
  309. either B-news or Cnews.  While it's fast and reliable under Linux, it's
  310. virtually undocumented for the beginning news administrator (though in
  311. practice it's rather simple to run once you figure it out).
  312.  
  313. INN is very particular about its permissions.  Don't mess with them.
  314.  
  315. INN is also very particular about having a "quality" TCP/IP to work with.
  316. Linux is not necessarily all the way there at this time, so it is recommended
  317. that you grab a Linux-specific INN distribution from one of the usual Linux
  318. archive sites.
  319.  
  320. <sect2>Installing INN
  321. <p>
  322. ( <tt>from Arjan de Vet - devet@info.win.tue.nl</tt> )
  323.  
  324. I've made a patch + config kit for INN 1.4 to get it to run on Linux.  It can
  325. be found at:
  326.  
  327. <tt>ftp.win.tue.nl:/pub/linux/ports/inn-1.4-linux.tar.gz</tt>
  328.  
  329. INN depends heavily on a good /bin/sh substitute. I use a beta version of bash
  330. 1.13 that is now available for Linux on the normal archive sites.  bash 1.12
  331. gives some small problems with newgroups not being handled correctly (maybe
  332. some other problems too, I don't remember).
  333.  
  334. <sect2>Configuring INN
  335. <p>
  336. Basically follow Arjan's instructions and you'll be all set.  Here's the
  337. summary of what to do:
  338.  
  339. <itemize>
  340. <item>In config.data, make sure you have <tt>"HAVE_UNIX_DOMAIN DONT"</tt>
  341. <item>Add the hostname of the system running innd to hosts.nntp
  342. For a uucp-only site, that's your sitename.
  343. <item>Make sure you do not have a line for nntp in <tt>/etc/inetd.conf</tt>
  344. <item>Make sure that you have innshellvars say <tt>"HAVE_UUSTAT DO"</tt>
  345. rather than the "DONT" in his example config.data if you
  346. have uustat from the Taylor UUCP package installed.  If you
  347. have this defined wrong, it'll result in no outgoing news
  348. getting batched.
  349. <item>If you run INN, definitely define the recommended <tt>syslogd</tt>
  350. stuff because it is very, very helpful.
  351. </itemize>
  352. There is a spectacular (!!!!) FAQ for INN that comes out monthly.
  353. Look on <tt>rtfm.mit.edu:/pub/usenet-by-hierarchy/news</tt> for it.  You'll be glad you did.
  354.  
  355. <sect2>Maintaining a INN Site
  356. <p>
  357. I've found that there's essentially zero care-and-feeding of a Linux INN site
  358. other than having a working cron.  Basically you want a crontab that looks
  359. something like the following:
  360.  
  361. <verb>
  362.     # daily maint, also expire the .overview database and articles
  363.     1 0 * * * /usenet/sw/inn/bin/news.daily expireover delayrm < /dev/null
  364.  
  365.     # send 'em out
  366.     5 * * * * /usenet/sw/inn/lib/send-uucp
  367. </verb>
  368.  
  369. ( if you switch to bash1.13, the <tt>"< /dev/null"</tt> above is not needed )
  370.  
  371. <sect1>Other News Transport Agents
  372. <p>
  373. The following is a non-inclusive list of other news transport software known
  374. to work under Linux:
  375. <itemize>
  376. <item>dynafeed
  377. <item>nntp1.5.11
  378. <item>slurp1.05
  379. </itemize>
  380.  
  381. <sect>News Readers
  382. <p>
  383. There is no "one true newsreader".  As a result, there are many well-known
  384. newsreaders that port easily to Linux in particular.  At this writing,
  385. "<tt>tin</tt>", "<tt>trn</tt>", and "<tt>nn</tt>" are in most of the commonly
  386. available distributions of Linux and in newspak.
  387.  
  388. When picking a newsreader, you basically want to find something that is easy
  389. to use, very configurable by the user, with threading and kill files (to
  390. select interesting articles or make the non-interesting ones not appear at
  391. all).
  392.  
  393. You can set your paths to anything you like as long as all the newsreaders can
  394. find "<tt>inews</tt>" from your Cnews or INN installation and a
  395. "<tt>mail</tt>" program to send mail replies to posts.
  396.  
  397. This section will talk briefly about several of the most popular ones.  Before
  398. you ask, I use "<tt>nn</tt>" for lots of reasons :-)
  399.  
  400. <sect1>Tin
  401. <p>
  402. Tin is a threaded newsreader generally intended to be easy for new users.  It
  403. supports kill files and NOV threading.  If you're running INN, it will read
  404. NOV .overview files by default and not write index files.
  405.  
  406. To compile Tin under linux, basically just edit the makefile to set the
  407. locations of the software (especially the location of inews) and type "make
  408. linux".  There are no patches required for tin under Linux.
  409.  
  410. For threading, you can basically just say "tin -u" to update the index files.
  411.  
  412. To enable the ability to read via NNTP, compile with "NNTP_ABLE" defined.
  413. This will result in a file called "tin" for local and one called "rtin" for
  414. NNTP reading.  "tin -r" will also get the same behavior as "rtin".
  415.  
  416. Iain Lea recommends the following crontab entry and says that you need to do a
  417. "make daemon" to make tind.
  418.  
  419. <verb>
  420.     # thread the database
  421.     35 * * * * /usenet/bin/tind -u
  422. </verb>
  423.  
  424. I've run <tt>tin</tt> over a SLIP link as a NNTP-based newsreader.  If you're
  425. connecting to a system that has a full newsfeed, you will grow extremely old
  426. waiting for it to load up the "active" file.
  427.  
  428. <sect1>Trn/Mthreads
  429. <p>
  430. trn is a threaded derivative of the "rn" newsreader.  trn3.2 and newer has the
  431. nice ability to select either the "mthreads" (trn's threading package) or NOV
  432. (threader from INN) threading.
  433.  
  434. To compile it, just run Configure and take the calculated defaults.  You might
  435. need to have lib4.4.1 and bash-1.13 (there is a beta now available on the
  436. various Linux archive sites) to successfully run Configure.  You'll probably
  437. need both bash1.13 and libs4.4.1 to get the new Configure to run properly.
  438.  
  439. The newspak distribution on sunsite contains working config files
  440. for trn under Linux.
  441.  
  442. It's probably unwise to try to edit a trn config.sh by hand unless you're
  443. doing something *VERY* simple like changing the paths to fit your tastes.  If
  444. you do so, you'll need to run "Configure -S" before you "make depend", "make",
  445. and "make install".
  446.  
  447. Although "Configure" fails generally under Linux with bash1.12, "Configure -S"
  448. work fine so if you take the newspak config.sh as a starting point, you'll be
  449. very close.
  450.  
  451. Compiling for NNTP reading is as simple as answering "yes" when Configure asks
  452. you if you want to do so (assuming Configure runs ok on your system).  A
  453. future release of newspak will include a config.sh for NNTP reading as well as
  454. the existing one for local reading for those of us who are still
  455. "bash-impaired" :-)
  456.  
  457. I've run <tt>trn</tt> over a SLIP link as a NNTP-based newsreader.  If you're
  458. connecting to a system that has a full newsfeed, you will grow extremely old
  459. waiting for it to load up the "active" file and to thread the articles.
  460.  
  461. There are dozens of command line switches for trn to get all kinds of
  462. behavior.  Read the "trn" man page for details.  I use a nice feature to set
  463. all the switches easily:
  464.  
  465. <itemize>
  466. <item>make a file with all the settings in a file called ~/.trnrc
  467. <item>export TRNINIT="~/.trnrc"
  468. </itemize>
  469.  
  470. The current newspak has a copy of my .trnrc file as an example.
  471.  
  472. trn3.2 and above has support for NOV or mthreads threading that's
  473. user-selectable.  Accordingly, I recommend building the software to allow both
  474. threading mechanisms (it's a question in Configure).  To pick one at runtime,
  475. try "trn -Zo" for NOV and "trn -Zt" for mthreads.  I do it my aliasing trn to
  476. the right thing.
  477.  
  478. To build the mthreads database, do something like the following in the "news"
  479. crontab:
  480.  
  481. <verb>
  482.     # thread the trn database
  483.     35 * * * * /usenet/bin/mthreads all
  484. </verb>
  485. <sect1>NN
  486. <p>
  487. The newspak distribution on sunsite contains working config files
  488. for nn6.4.18 that you can drop into place and type "make" under Linux. They
  489. also work with the 6.5b3 beta of the coming nn6.5 update.
  490.  
  491. When you're done compiling, you need to do the following:
  492. <itemize>
  493. <item>        - run the "inst" program to install things.  
  494.             (install everything)
  495. <item>        - initialize the database
  496. <item>        - fire up nnmaster
  497. </itemize>
  498.  
  499. See the nn docs for details.  Compiling, configuring, and running nn under
  500. Linux is no different than running nn on any other *nix with the exception
  501. that you may want to run nnmaster as a cron entry rather than as a daemon.  If
  502. you run it as a daemon under linux, it may not tend to wake up properly (the
  503. net effect of running it from cron is the same anyway).
  504.  
  505. Support of "nn" is as simple as the following crontab entries:
  506. <verb>
  507.     # run nnmaster to collect "nn" stuff
  508.     # (not needed if you use NOV from INN in nn-6.5beta3)
  509.     25 * * * * /usenet/sw/nn/lib/nnmaster
  510.  
  511.     # expire the nn database
  512.     # (not needed if you use NOV from INN in nn-6.5beta3)
  513.     0  4       * * * /usenet/sw/nn/bin/nnadmin =EYW 
  514.  
  515.     # stash a copy of the active file for "nngoback" and keep last 7
  516.     0 3 * * * /usenet/sw/nn/lib/back_act 7 
  517. </verb>
  518.  
  519. I've experimented a little with running <tt>nn</tt> as a NNTP-based newsreader
  520. over a SLIP connection.  In this case, you'll want to edit the
  521. <tt>config.h</tt> file slightly.  See the comments in the file for details.
  522. When running as a NNTP-based reader, nn runs a local copy of <tt>nnmaster</tt>
  523. to keep the threads database on the local system so that article selection is
  524. very fast (although you of course wait for the arcticle text a little if
  525. you're running SLIP over a modem).
  526.  
  527. The new version (6.5.x) of <tt>nn</tt> has support for INN's NOV database
  528. which makes it unnecessary for you to run <tt>nnmaster</tt> at all.  This
  529. configuration is <em>highly</em> recommended, since as a result you won't
  530. have to spend the cpu time to run <tt>nnmaster</tt> at all and you won't
  531. get its database and the actual news articles available out of synch.
  532. <sect1>Other newsreaders
  533. <p>
  534. The following is a non-inclusive list of newsreaders said to install and run
  535. under Linux:
  536. <itemize>
  537. <item>tass
  538. <item>xrn
  539. <item>gnus
  540. </itemize>
  541.  
  542. <sect>Acknowledgements
  543. <p>
  544.  
  545. The following people have helped in the assembly of the information (and
  546. experience) that helped make this document possible:
  547.  
  548. Ed Carp, Steve Robbins, Ian Taylor, Greg Naber, Matt Welsh, Iain Lea, Arjan de
  549. Vet
  550.  
  551. If I forgot anybody, my apologies.
  552.  
  553. <sect>Frequently Asked Questions about USENET (in c.o.l.* anyway)
  554. <p>
  555.  
  556. <sect1>Why can't I post to moderated groups ?
  557. <p>
  558. Probably because the newsreader is trying to call /bin/mail to send the mail
  559. and it doesn't like it.  Replace the /bin/mail in old versions of SLS with the port of
  560. mailx-5.5.tar.z from a modern Slackware and use Slackware's <tt>pkgtool</tt> to install
  561. the kit and you'll be all set.
  562.  
  563. Another possibility is that you have a moderated newsgroup set up on your
  564. local system as not-moderated and somebody upstream is quietly deleting the
  565. article (some system's software, not a person).  Make sure you run a
  566. "checkgroups" every now and then when the checkgroups article rolls by in
  567. news.admin every few weeks.
  568.  
  569. <sect1>Why do I have problems that appear to be permission-related ?
  570. <p>
  571. Because they are :-)
  572.  
  573. Check to see that your permissions are right and that you have a "news"
  574. username and group in /etc/passwd and /etc/group that matches the binary
  575. distribution you grabbed.  It seems that there is not yet a Linux-standard for
  576. commonly available accounts.
  577.  
  578. All the stuff in /usr/local/lib/news should be news.news except
  579. /usr/local/lib/news/setnewsids which should be setuid root.
  580.  
  581. You can use whatever UID and GID you want for "news".
  582.  
  583. <sect1>Why can I post articles locally, but they don't show up or get fed downstream ?
  584. <p>
  585. Probably because you didn't call newsrun from cron.  Maybe because you edited
  586. your sys file and messed it up.  Maybe because you don't have a
  587. /usr/spool/news/out.going tree or something.   Maybe because you grabbed a distribution
  588. that has the 'Performance' or 'Cleanup' releases of Cnews, which batch things up
  589. and need 'newsrun' running from cron to process them to feed the other sites and
  590. to have them visible locally.
  591.  
  592. Do not create newsgroups or feeds by editing the active or sys files.  Use the
  593. utilities in /usr/local/lib/news/bin/maint to do it.
  594.  
  595. <sect1>Why doesn't my binary distribution have nntp ?
  596. <p>
  597. Because it's supposed to be plug-n-play under Linux and because I didn't want
  598. to make SLS's news stuff doubly big by having to maintain both nntp and
  599. non-nntp versions of the newsreaders and news transport programs.  Also
  600. because it compiles in localized information that is not overridable at
  601. runtime via a config file.
  602.  
  603. <sect1>Why does doexpire (or relaynews or) say "severe space shortage" when there's lots of room ?
  604. <p>
  605. Because it can't read /etc/mtab.  Make it mode 644.  This happens when you
  606. unmount a mounted filesystem by root with a umask that doesn't permit
  607. world-read of files owned by root.
  608.  
  609. <sect1>Why does everything look normal, but posting doesn't happen ?
  610. <p>
  611. Older versions of Linux had a "broken" sed that Cnews was prone to blow up.
  612. In particular, if you've installed over an old SLS, be sure to check /bin and
  613. /usr/bin to be certain you have only one copy of sed and that it's a modern
  614. one.
  615.  
  616. Because as of the 'Performance Release' in about February 1993, you have to
  617. have 'newsrun' run from cron periodically to process things.  That's a feature
  618. that apparently suprises some people.
  619.  
  620. <sect1>Can I hook the new news overview (NOV) stuff into trn/tin/nn to replace
  621. the various independent thread databases ?
  622. <p>
  623. Yes. <tt>trn</tt>, <tt>tin</tt>, and the beta of <tt>nn</tt> support it now. 
  624.  
  625. You can hook it into the Performance and Cleanup Releases of Cnews and various other
  626. readers as well.
  627.  
  628. The beta copy of nn6.5 I have here has NOV support and it works just
  629. dandy under Linux.  I run it here and have nn running without having to
  630. run nnmaster (!).  Look on uniwa.uwa.edu.au for a copy of it.
  631.  
  632. <sect1>Why can't we have a binary distribution of NNTP ?
  633. <p>
  634. Because significant local-only information is compiled-in and 
  635. cannot be determined auto-magically at runtime.  If you're that into things,
  636. please grab INN rather than rolling your own with Cnews plus NNTP.
  637.  
  638. <sect1>How do I set up NNTP to allow read/post across the network while *not*
  639. storing any news articles or databases locally.
  640. <p>
  641.     ( mdw@sunsite.unc.edu (Matt Welsh) )
  642. <itemize>
  643. <item>    1) Grab the "reference implementation" of nntp and a copy or rn
  644.         from your local archive site.  If you connect to ftp.uu.net
  645.         you'd grab:
  646.  
  647.         nntp.1.5.11.tar.Z from ftp.uu.net:/networking/news/nntp
  648.  
  649. <item>    2) compile nntp as follows:
  650. <p>
  651.         copy common/conf.h.dist to common/conf.h. 
  652. <p>        Edit common/conf.h to set certain options: 
  653.         The only ones I set were: 
  654. <p>
  655.         DOMAIN: undefine it (i.e. change the line to <tt>#undef DOMAIN</tt>).
  656. <p>        REALDOMAIN: Define this. It looks up the domain using 
  657.                 the libraries. 
  658. <p>
  659.         SERVER_FILE: Set this to the name of the file which will
  660.             contain the hostname of the news server (i.e. the
  661.             machine you'll read and post news through). I use
  662.             "/usr/local/lib/news/server".
  663. <p>
  664.         PASSFILE: If your news server requires authorization (i.e.
  665.             some kind of username/password) to post, set this to
  666.             the name of the file which contains the username and
  667.             password (described below).  I use
  668.             "/usr/local/lib/news/nntppass".
  669. <p>
  670.     I decided to keep all of the other news stuff in /usr/local/lib/news.
  671.     So I set all of the rest of the pathnames in the file (i.e.
  672.     ACTIVE_FILE, NEWSGROUPS_FILE, etc.) to use /usr/local/lib/news.  Many
  673.     of these files are only used by the NNTP server, not the client, but
  674.     to be safe I changed them all to point to the right directory. You can
  675.     of course use the default pathnames; just make sure you create the
  676.     directory accordingly.
  677. <p>
  678.     3) Create the user "usenet" if you haven't already. The inews program
  679.     runs as this user. All you need is a userid; you don't need a home
  680.     directory or shell or anything for the user. Just plop the following
  681.     line into your /etc/passwd:
  682. <verb>
  683.                 usenet:*:13:1::/:
  684. </verb>
  685.     Make sure you set the userid ("13", above) to something unique. The
  686.     group can be anything; I use "daemon" (gid 1).
  687. <item>    4) Create the SERVER_FILE, above. For example, my news server is
  688.     "wonton.tc.cornell.edu", so I created the file
  689.     /usr/local/lib/news/server which contained one line:
  690. <verb>
  691.          wonton.tc.cornell.edu
  692. </verb>
  693. <item>    5) Create the PASSFILE. This file contains lines of the form
  694. <verb>        <server name> <username> <password>
  695. </verb>
  696.     Let's say that your news server (the one in SERVER_FILE, above) is
  697.     "shoop.vpizza.com", and to post on that machine you need to be
  698.     authorized as the user "news" with a password of "floof". Thus, in the
  699.     PASSFILE (I use /usr/local/lib/news/nntppass), you need the line
  700. <verb>        shoop.vpizza.com news floof
  701. </verb>
  702. <item>    6) Make this file secure! The inews program runs as the user "usenet",
  703.     so make this news directory owned by that user and the nntppass file
  704.     as well.
  705. <verb>
  706.     chown usenet /usr/local/lib/news 
  707.     chmod 755 /usr/local/lib/news 
  708.     chown usenet /usr/local/lib/news/nntppass 
  709.     chmod 600 /usr/local/lib/news/nntppass 
  710. </verb>
  711.     So nobody else can read this file. No, the passwords in it are not
  712.     encrypted.
  713.  
  714. <item>    7) Go back to the nntp.1.5.11 source directory; issue "make client".
  715.     At this point you'll build the NNTP version of inews, which is the
  716.     only software used by the NNTP client.
  717.  
  718.     When I built inews, there was a bug in the library which caused the
  719.     function uname() in uname.c to call itself eternally. This should be
  720.     gone now; however, if inews seems to hang and your system starts
  721.     slowing down *a lot* you should rename the function "uname()" in
  722.     uname.c to something like "my_uname()", and change the calls to it (in
  723.     inews.c) to call my_uname() instead. Mail me if you run into this
  724.     problem. 
  725. <verb>        (VDS note - this means mail to Matt-not me :-) )
  726. </verb>
  727. <item>    8) Issue "make install_client". This will install the inews stuff.
  728.     Also link /usr/local/lib/news/inews to /usr/local/bin/inews
  729.  
  730.     Now you should be able to happily post (by hand). Try something like
  731.     the following:
  732. <verb>
  733.         $ inews -h << EOF
  734.         Newsgroups: misc.test
  735.         From: me@foo.bar.com
  736.         Subject: Testing
  737.         Reply-To: my-real-address@wherever.edu
  738.  
  739.         This is a test.
  740.         EOF
  741. </verb>
  742. If this works, inews should post the article. You'll know because
  743. test-responders on misc.test will reply to the address on the Reply-To
  744. line, above. Please don't do test postings on real groups, like c.o.l.
  745. :)
  746.  
  747. </itemize>
  748. </article>
  749.