home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / innd_faq.zip / PART3 < prev    next >
Internet Message Format  |  1994-05-20  |  35KB

  1. Path: bloom-beacon.mit.edu!hookup!usc!howland.reston.ans.net!europa.eng.gtefsd.com!MathWorks.Com!news.duke.edu!convex!cnn.exu.ericsson.se!ericom!eua.ericsson.se!sunic!EU.net!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 3/4: Operational and Misc. Questions
  5. Supersedes: <inn-faq-3-766814410@Warren.MENTORG.COM>
  6. Followup-To: news.software.nntp
  7. Date: 5 May 1994 04:00:17 -0000
  8. Organization: Mentor Graphics - IC Group, Warren, NJ, USA
  9. Lines: 896
  10. Sender: tal@Warren.MENTORG.COM
  11. Approved: news-answers-request@MIT.Edu
  12. Distribution: world
  13. Expires: 05/20/94
  14. Message-ID: <inn-faq-3-768110411@Warren.MENTORG.COM>
  15. References: <inn-faq-1-768110411@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:5944 news.software.b:4450 news.answers:19148
  23.  
  24. Posted-By: auto-faq 2.4
  25. Archive-name: inn-faq/part3
  26.  
  27. Last Changed: $Id: FAQ-inn.3,v 1.65 1994/04/25 05:16:26 tal Exp $
  28.  
  29.                   Part 3 of 4
  30.  
  31. INN FAQ Part 1/4: General Information
  32. INN FAQ Part 2/4: Debugging Guide & Tutorial
  33. INN FAQ Part 3/4: Operational and Misc. Questions
  34.                     Day-to-day operational questions
  35.                     INN is running, but i have this small problem...
  36.                     How do i... (Big changes you can make to the system)
  37.                     Bugs in INN 1.4:
  38.                     Bugs in INN 1.3:
  39.                     Bugs in INN 1.2:
  40. INN FAQ Part 4/4: Appendix A: Norman's install guide
  41.  
  42.  
  43. ------------------------------
  44.  
  45. Subject:  Table Of Contents for Part 3/4
  46.  
  47. =====================================================================
  48.   TABLE OF CONTENTS FOR PART 3/4:  Operational and Misc. Questions
  49. =====================================================================
  50.  
  51. DAY-TO-DAY OPERATIONAL QUESTIONS:
  52.     How do I create all those directories in the newsspool?
  53.     Safe way to edit the "active" file?
  54.     What's the best way to upgrade to a new version of INN?
  55.     How do I talk to innd from C or Perl?
  56.     After a crash.
  57. INN IS RUNNING, BUT I HAVE THIS SMALL PROBLEM...:
  58.     Suddenly my active and history files are owned by root!
  59.     How come my host name comes out twice in the Path line?
  60.     Expire had problems last night, and while I fixed the problem,
  61.     expire reports "Group not matched (removed?) --
  62.         Using default expiration"
  63.     Why doesn't this newsfeeds entry do what I want?
  64.     Why am I forwarding cancel messages for articles in comp.foo
  65.     Debugging someone that is feeding you.
  66.     Feeds suddenly can't connect anymore!
  67.     I'm getting groups sent to me that I don't want.
  68.     When my feeder connects, I get articles but they don't take
  69.         what's waiting for them.
  70.     Directories are being created with wrong permissions.
  71.     Why am I getting alt.sex.pictures even though I have
  72.     More about the "to.*" groups
  73.     What's a decent syslog.conf configuration?
  74.     INN batcher writing "#!rnews 0" separators
  75.     Posting while throttled doesn't work
  76.     "innd: overview! spooling" and the file "overview!" in /usr/spool/news/out.going
  77.     "newgroup" control messages aren't being executed
  78. HOW DO I... (Big changes you can make to the system):
  79.     How do I set up a delayed IHAVE/SENDME over NNTP?
  80.     Can I use gzip with INN?
  81.     What do I do if /var/spool/news is set up over many partitions?
  82.     archiving expired articles
  83. BUGS IN 1.4:
  84.     Security Patch
  85.     Looping Select Patch
  86. BUGS IN 1.3:
  87.     7-bit encoded batches are not correctly processed. Why is this?
  88.     NOV (overchan) doesn't work well.
  89. BUGS IN 1.2:
  90.     Why doesn't nntpget work?
  91.  
  92.  
  93. =====================================================================
  94.                   DAY-TO-DAY OPERATIONAL QUESTIONS
  95. =====================================================================
  96.  
  97.  
  98. ------------------------------
  99.  
  100. Subject:  How do I create all those directories in the newsspool?
  101.  
  102. Q:  For example, if you receive comp.sys.amiga.applications, do you
  103. have to mkdir /var/spool/news/comp/sys/amiga/applications?
  104.  
  105. A:  Nope.  innd creates the directory for you the first time you
  106. receive an article for that newsgroup.
  107.  
  108.  
  109. ------------------------------
  110.  
  111. Subject:  Safe way to edit the "active" file?
  112.  
  113. First of all, you could manipulate the active file using the ctlinnd
  114. "newgroup", "rmgroup" and "changegroup" commands.  However, sometimes
  115. you just need to do a lot of editing all at once:
  116.  
  117. The following sequence is the shortest:
  118.  
  119.     ctlinnd pause "edit active"
  120.     [do something to the active file]
  121.     ctlinnd reload active "edit active"
  122.     ctlinnd go "edit active"
  123.  
  124. Simple!  No need to "flush" since the "pause" does that.
  125.  
  126. > What if I need to delete 3000 lines from my active file?
  127.  
  128. I would definately edit the active file manually (using
  129. the above procedure).
  130.  
  131. > What if I need to delete 10 lines from my active file?
  132.  
  133. For a couple quick changes, I recommend using "ctlinnd".  This is a
  134. little slow because all channels are closed and reopened after each
  135. "rmgroup", "newgroup", and "changegroup".  However, it's easier than
  136. remembering the above sequence.
  137.  
  138. DO NOT THROTTLE THE SERVER WHEN DOING MULTIPLE rmgroup COMMANDS.  There
  139. is a bug in INN (all versions) that will shred your active file if you
  140. do multiple "rmgroup" messages while the server if throttled.  This is
  141. a common mistake.  People think the "rmgroup"'s will go faster if the
  142. server is throttled.  It will go faster, it will also shred your active
  143. file.
  144.  
  145. If you have a large number of groups to remove or create, you can use
  146. awk to write a script to do the work for you.
  147.  
  148.     % cat thelist
  149.     alt.foo.bar
  150.     alt.delete.me
  151.     comp.sys.mac
  152.     % awk <thelist '{ print "ctlinnd rmgroup " $1 }'
  153.     ctlinnd rmgroup alt.foo.bar
  154.     ctlinnd rmgroup alt.delete.me
  155.     ctlinnd rmgroup comp.sys.mac
  156.  
  157. Now, you can either send the output of that to "| sh -x",
  158. or you can redirect the output to a file, and "source" the
  159. file.
  160.  
  161. If you want to create a bunch of newsgroups, the awk
  162. command might be like this:
  163.  
  164.     % awk <thelist \
  165.     '{ print "ctlinnd newgroup " $1 " y user@host" }' | sh -x
  166.  
  167.  
  168. ------------------------------
  169.  
  170. Subject:  What's the best way to upgrade to a new version of INN?
  171.  
  172. First, you should read the README and the Install.ms (yes, read
  173. them both... again).   Things change in new versions.
  174.  
  175. Second, the README explains how to do an upgrade.  This document
  176. is redundent, but explains the procedure in more detail.
  177.  
  178. STEP 1:  Copy the values in the old config.data to your new config.data.
  179. You can do this automaticly with this trick:
  180.  
  181.     % cd config
  182.     % make subst
  183.     % cp config.dist config.data
  184.     % ./subst -f {OLDFILE} config.data
  185. where "{OLDFILE}" names your old config.data file.
  186.  
  187. STEP 2:  Edit the config.data to see if you want to change any of
  188. the new settings that didn't exist in the old version's config.data
  189. file.
  190.  
  191. STEP 3: Compile everything:
  192.  
  193.     % cd $INN
  194.     % make world
  195.  
  196. STEP 4: When you feel you are ready to install the new files shut the old daemon:
  197.  
  198.     % ctlinnd shutdown 'upgrade in progress'
  199.     [ kill innwatch by hand if you need to ]
  200.  
  201. STEP 4: Install the new files:
  202.  
  203.     % cd $INN
  204.     % make update
  205.  
  206. STEP 5: Now update all your $INN/site files to be the same as they were
  207. for your old software.  "cd $INN/site ; make diff-installed" will tell
  208. you what's different between the files in /usr/lib/news and $INN/site.
  209. If you only make changes in the $INN/site directory and use "make
  210. install" to copy them into place you'll save your self a lot of
  211. trouble.  Read $INN/site/Makefile for more interesting things that
  212. "make" can do.
  213.  
  214. STEP 6: When you feel you are ready to install the new $INN/site files:
  215.  
  216.     # cd $INN/site
  217.     # make install
  218.  
  219. STEP 7: Re-start the system:
  220.  
  221.     % sh /usr/lib/news/etc/rc.news
  222.  
  223. STEP 8: If everything was done right you should be up and running.
  224. Part 2 of the FAQ gives tips on testing your configuration.
  225.  
  226.  
  227. ------------------------------
  228.  
  229. Subject:  How do I talk to innd from C or Perl?
  230.  
  231. Rich Salz says:
  232.  
  233. If you are writing C, look at doc/inndcomm.3 and include/inndcomm.h;
  234. they include all you need to do any ctlinnd command (in fact, ctlinnd
  235. itself is little more than a call to the library).
  236.  
  237. Hacking up a Perl subroutine that spoke to innd's Unix-domain control
  238. socket should be fairly straightforward but hasn't yet been written.
  239.  
  240.  
  241. ------------------------------
  242.  
  243. Subject:  After a crash.
  244.  
  245. "What do I do after a system crash?"
  246.  
  247. INN handles crashes pretty well.  If there are any problems they
  248. get cleaned up by the nightly expire.  About once a month you
  249. might want to run "makehistory -buv" to look for "lost" articles.
  250. Check the man page for "makehistory" for more information.
  251.  
  252.  
  253. =====================================================================
  254.           INN IS RUNNING, BUT I HAVE THIS SMALL PROBLEM...
  255. =====================================================================
  256.  
  257. ------------------------------
  258.  
  259. Subject:  Suddenly my active and history files are owned by root!
  260.  
  261. rc.news runs from root.  After that, everything else should run as
  262. news.  It sounds like you've run news.daily as root by mistake.  Make
  263. sure all your cron jobs run as news and you'll be fine.
  264.  
  265. If you have an old "cron" system, you might consider replacing yours
  266. with one of the many public domain replacements.  If you can't create
  267. a different "crontab" for each user, the idiom is:
  268.  
  269. 0 * * * * * su news -c '/do/this/as/news'
  270.  
  271.  
  272. ------------------------------
  273.  
  274. Subject:  How come my host name comes out twice in the Path line?
  275.  
  276. The INN server puts its name in the Path line of every article that it
  277. receives.  Obviously, it has to do this.  The default configuration has
  278. inews put the local host in the Path header.  If nobody posts on the
  279. server and you use fully-qualified domain names on your workstations,
  280. then everything works the right way.  (If `hostname` doesn't give an
  281. FQDN on your machine, you can work-around this by setting the "domain"
  282. value in inn.conf; remember that innd never re-reads inn.conf.  You
  283. must "ctlinnd shutdown x" and then re-start the server).  Many people
  284. don't want the client machines to put their name in the Path header.
  285. To do this, set INEWS_PATH to DONT.  Finally, let me say that it is
  286. probably a mistake to have a "pathhost" line on any machine other than
  287. your server if you set INEWS_PATH to DO.  If you doubt this, please
  288. trace the article flow for yourself.  If you are curious about the
  289. effect of INEWS_PATH, read the nroff source -- not the formatted
  290. output -- of doc/inews.1
  291.  
  292.  
  293. ------------------------------
  294.  
  295. Subject:  Expire had problems last night, and while I fixed the
  296.             problem, it still won't run.
  297.  
  298. When expire starts up it "reserves" the server so that nobody else can
  299. pause or throttle it.  This prevents anyone else from coming in and
  300. modifying the history database.  If expire bails out because of a bad
  301. error (e.g., your expire.ctl has syntax errors) it leaves the server
  302. reserved so that no maintenance will be done until a good expire run has
  303. occurred.  To unblock the server, use the ctlinnd "reserve" command with
  304. an empty string argument.
  305.  
  306.  
  307. ------------------------------
  308.  
  309. Subject: expire reports "Group not matched (removed?) --
  310.         Using default expiration"
  311.  
  312. Expire says:
  313. Group not matched (removed?) alt.techno-shamanism -- Using default expiration
  314. Group not matched (removed?) misc.computers.forsale -- Using default expiration
  315. Group not matched (removed?) de.rec.sf.startrek -- Using default expiration
  316.  
  317. That just means that you've removed those newsgroups groups and expire
  318. is slowly removing articles from the spool as they expire.  Eventually
  319. the articles will all have been deleted and so will these messages.
  320.  
  321.  
  322. ------------------------------
  323.  
  324. Subject:  Why doesn't this newsfeeds entry do what I want?
  325.             "foo.com:alt,!alt.sex"
  326.  
  327. A newsfeeds entry is not a sys file (C News) entry.  Please read
  328. newsfeeds.5.  You might also find the sys2nf program in the frontends
  329. directory useful, as well as the inncheck Perl script that is found in
  330. the samples directory.  The INN Configuration FAQ has cook-book
  331. examples of the steps required to install a NNTP feed, UUCP feed, and
  332. NNTP via nntplink feed.
  333.  
  334.  
  335. ------------------------------
  336.  
  337. Subject:  Why am I forwarding cancel messages for articles in comp.foo
  338.             when I explicitly have !comp.foo in the newsfeeds entry?
  339.  
  340. Control messages can be explicitly forwarded, so a control message to
  341. comp.foo is forwarded to sites that recieve either comp.foo or control.
  342. Please see the "Control Messages" section of innd.8.  As that
  343. documentation says, you probably want to put "!control" in the
  344. subscription list for most of your newsfeeds.
  345.  
  346.  
  347. ------------------------------
  348.  
  349. Subject:  Debugging someone that is feeding you.
  350.  
  351. David Myers <dem@meaddata.com> suggests that if a neighbor complains
  352. that their feed to you doesn't work: (1) make sure they've read the man
  353. pages, and (2) have them send a copy of their newsfeeds file.
  354.  
  355. Truly sage advice!
  356.  
  357.  
  358. ------------------------------
  359.  
  360. Subject:  Feeds suddenly can't connect anymore!
  361.  
  362. Q:  How come feeds tell me they can't connect to me any more?
  363.  
  364. A:  When innd starts up it reads the hosts.nntp file and looks up the
  365. IP addresses for all the entries mentioned there.  The problem is that
  366. this data is dynamic (sometimes people change IP addresses), and innd
  367. never goes back to check.  If your system stays up for days and one of
  368. your feeds changes their IP address (or has a new CNAME), innd will
  369. reject them.  Rich plans to handle this in INN1.5, but for now you
  370. might find it useful to do a "ctlinnd reload hosts.nntp" out of cron
  371. every day or so or when you notice there's a problem.
  372.  
  373.  
  374. ------------------------------
  375.  
  376. Subject:  I'm getting groups sent to me that I don't want.
  377.  
  378. Tell the system administrator(s) of the machine(s) that feed news to
  379. you to stop sending those groups.  There is no other way to do it.  (In
  380. B or C News, the groups would end up in junk; at least with INN they
  381. are not taking up space.  You should compile with WANT_JUNK set to
  382. DONT).
  383.  
  384. If the people that feed you use B news or C news, remember that they
  385. don't use a "newsfeeds" file.  They use a file called "sys" which has a
  386. completely different format for specifying newsgroups.
  387.  
  388.  
  389. ------------------------------
  390.  
  391. Subject:  When my feeder connects, I get articles but they don't take what's waiting for them.
  392.  
  393. I hate to say this, but this really shows that you haven't RTFMed very
  394. much.
  395.  
  396. News is not automaticly bidirectional (it's like SMTP, not UUCP).  If
  397. you want to send things out you will have to make sure that you run
  398. send-nntp or nntpsend from cron.  nntpsend is easier and elsewhere in
  399. this document there are cookbook examples of what to add every time you
  400. set up a new feed.
  401.  
  402.  
  403. ------------------------------
  404.  
  405. Subject:  Directories are being created with wrong permissions.
  406.  
  407. > Question:
  408. >When I received news for /var/spool/news/foo/bar for the first
  409. >time, the directories got created:
  410. >
  411. ># ls -lgR foo
  412. >total 1
  413. >d-wx-w-rwx  2 news     news          512 Feb  9 00:03 bar/
  414. >
  415. >What did I do wrong?
  416. >
  417. >##  Mode that directories are created under.
  418. >#### =()<GROUPDIR_MODE          @<GROUPDIR_MODE>@>()=
  419. >GROUPDIR_MODE           2775
  420.  
  421.   Answer:
  422. You forgot a zero in front of this number, for the C compiler to interpret it
  423. as octal instead of decimal.
  424.  
  425.  
  426. ------------------------------
  427.  
  428. Subject:  Why am I getting alt.sex.pictures even though I have
  429.             "ME:!alt.sex.pictures" in my newsfeeds file?
  430.  
  431. The active file is the definitive list of what newsgroups you receive.
  432. INN's ME entry is different from C News and B News; please see
  433. newsfeeds.5.  If you do not want to receive alt.sex.pictures, ask the
  434. system(s) that send you news not to send it to you.  (You would have to do
  435. that no matter what news system you are running.)
  436.  
  437.  
  438. ------------------------------
  439.  
  440. Subject:  More about the "to.*" groups
  441.  
  442. (Thanks to jmalcolm@sura.net (Joseph Malcolm) for supplying
  443. these answers.)
  444.  
  445. >1) Why did my local INN act on the sendsys posted to to.neighbor?
  446.  
  447. to.* groups aren't magic to INN.  Your system received the message,
  448. it acted on it.
  449.  
  450. >2) Why did my neighbor send the cmsg to all of his neighbors?
  451.  
  452. See 3.
  453.  
  454. >3) Is is related to having the "control" group in our newsgroups patterns?
  455.  
  456. Yes.
  457.  
  458. >   The INN docs say you probably don't want to do this, but they don't say
  459. >   why.
  460.  
  461. Actually, they do. This is from innd(8):
  462.  
  463.     Sites may explicitly have the ``control'' newsgroup in their
  464.     subscription  list,  although  it is usually best to exclude
  465.     it.  If a control message is posted to a  group  whose  name
  466.     ends  with  the  four characters ``.ctl'' then the suffix is
  467.     stripped off and what is left is used  as  the  group  name.
  468.     For  example,  a cancel message posted to ``news.admin.misc.ctl''
  469.     will be sent to all sites that subscribe to  ``control''  or
  470.     ``news.admin.misc''.
  471.  
  472. There is also a pointer to this in newsfeeds(5).
  473.  
  474. >   But I still need it in my active file, right?
  475.  
  476. Yes.
  477.  
  478.  
  479. ------------------------------
  480.  
  481. Subject:  What's a decent syslog.conf configuration?
  482.  
  483. The configuration will be different for each site, but here is what
  484. Greg Earle recommends as the lines for the "news.*" related part.
  485. Remember that most syslog's require tabs, not spaces.
  486.  
  487. Greg's canonical SunOS 4.1.x INN-related syslog.conf entries (which can
  488. be merged into your current configuration):
  489.  
  490. #
  491. # INN stuff
  492. #
  493. ##  Send critical messages to everyone who is logged in and to the console.
  494. news.crit               *
  495. news.crit               /dev/console
  496.  
  497. ##  Log news messages to separate files.
  498. ##  Note that each level includes all of the above it.
  499. ## =()<news.crit        @<_PATH_MOST_LOGS>@/news.crit>()=
  500. news.crit               /var/log/news/news.crit
  501. ## =()<news.err         @<_PATH_MOST_LOGS>@/news.err>()=
  502. news.err                /var/log/news/news.err
  503. ## =()<news.notice      @<_PATH_MOST_LOGS>@/news.notice>()=
  504. news.notice             /var/log/news/news.notice
  505.  
  506.  
  507. ------------------------------
  508.  
  509. Subject:  INN batcher writing "#!rnews 0" separators
  510.  
  511. >Outgoing UUCP batches from here are going out with "#!rnews 0" at
  512. >the head of each article.
  513.  
  514. Most common cause:  your newsfeeds entry has "Wnm" not "Wnb".
  515.  
  516. Other reasons:
  517.  
  518. batchfiles have something other than a single space between article
  519. filename and size
  520.  
  521. batchfiles lack size information (all the articles sizes will be read
  522. from the batch file as zero)
  523.  
  524.  
  525. ------------------------------
  526.  
  527. Subject:  Posting while throttled doesn't work
  528.  
  529. >I want to be able to allow my users to be able to post articles when
  530. >innwatch has throttled the system when the spool disk is "full".
  531.  
  532. Cannot be done in 1.4.
  533.  
  534. At a minimum, in 1.5 nnrpd will spool the post for the user.
  535.  
  536.  
  537. ------------------------------
  538.  
  539. Subject:  "innd: overview! spooling" and the file "overview!" in /usr/spool/news/out.going
  540.  
  541. > About once a month or so, I get the following warning messages:
  542. > Jan 20 07:20:22 optima innd: overview!:31:proc:9193 cant flush count 14639 Operation would block
  543. > Jan 20 07:20:22 optima innd: overview! spooling 14639 bytes
  544. > And there's a file "overview!" in /usr/spool/news/out.going with stuff in it.
  545. > Should I be doing anything more with this than ignoring it, and maybe
  546. > occasionally deleting it (it just grows)?
  547.  
  548. This happens because innd is feeding info to overchan faster than
  549. overchan can process it.  The overflow is sent to the file
  550. "overview!".  This file can be deleted, as nnrpd will grab the missing
  551. data out of the articles "manually".  The slow-down won't be noticed.
  552. However, you can "expireover -a" to "fill in the holes".
  553.  
  554. To prevent this in the future, you need to make overchan run faster.
  555. This is easy to do.  I found that moving the overview files into
  556. /usr/spool/news/over.view made things fast enough that the problem went
  557. away.  Change "_PATH_OVERVIEWDIR" in config.data, recompile, and you're
  558. done.  (You will need to recompile any newsreaders that read via NFS or
  559. off the local disk).
  560.  
  561. Why does that speed up overchan?  overchan works by opening the proper
  562. .overview file, appending 1 line to it, then closing the file.  If you
  563. have the .overview file in the same directory as 10000 articles then
  564. opening the .overview file will take a huge amount of time.  The open()
  565. call literally searches though an average 5000 (half of 10000) file
  566. names to find ".overview".  If you move your .overview files so that
  567. each one is in it's own directory, (say,
  568. /usr/spool/news/over.view/{group}/{name}/.overview) then open() is
  569. searching through 3 files ( ".", "..", and ".overview") to find 1
  570. file.  ( O(N/2) where N=10000 vs.  N=3... and you thought those
  571. freshman year CS classes would never be useful!)
  572.  
  573. There isn't much you can do to make the "append" and "close" steps much
  574. faster, except maybe install a PrestoServe or similar write-cache, and
  575. that won't help very much.
  576.  
  577. Profiling overchan (with PureSoft's Quantify product) found that the
  578. open() (actually searching the directory to find the .overview file)
  579. was around 80% of the execution time of overchan.  That was reduced to
  580. 40% when I moved the .overview files to their own directory.  With the
  581. change, overview's profiling statistics are pretty flat. (which is
  582. good).
  583.  
  584. DO run "expireover -a" to fix the problem.
  585.  
  586. DO NOT try feeding the "overview!" file to overchan manually.
  587.     (1) overchan doesn't do any locking and you'll have two overchan's
  588.         running at once.
  589.     (2) overchan only appends to the .overview files.  If you've gotten
  590.         any articles since the "overview!" file was created (you will
  591.         have) then you'll be appending told old entries that are out of
  592.         order.  Your ".overview" files must be in sorted order for the
  593.         other utilities to work right.
  594.  
  595.  
  596. ------------------------------
  597.  
  598. Subject:  "newgroup" control messages aren't being executed
  599.  
  600. > "newgroup" control messages aren't be executed
  601.  
  602. The usual blame for this is _PATH_EGREP points to a grep that doesn't
  603. understand regular expressions.  For example, GNU grep only understands
  604. regular expressions if it is called "egrep" (i.e. not "gnuegrep" or
  605. "egnugrep").
  606.  
  607. Make sure you have a link or symlink between egnugrep and egrep.  You
  608. then need to modify config.data so that _PATH_EGREP is
  609. /your/local/path/egrep and NOT /your/local/path/egnuegrep.  Then
  610. recompile and "make install" to have the new binaries and shell
  611. scripts installed.
  612.  
  613.  
  614. =====================================================================
  615.         HOW DO I... (Big changes you can make to the system)
  616. =====================================================================
  617.  
  618. ------------------------------
  619.  
  620. Subject:  How do I set up a delayed IHAVE/SENDME over NNTP?
  621.  
  622. Christophe Wolfhugel <Christophe.Wolfhugel@grasp.insa-lyon.fr> writes:
  623.  
  624. INN now allows to generate a timestamp entry in the batchfiles or to
  625. the channels/exploders (Wt in newsfeeds) which can be used to allow (for
  626. example) delayed ihave/sendme processing.  INN's senders (like innxmit)
  627. do not use that data yet.
  628.  
  629. Christophe.Wolfhugel@grasp.insa-lyon.fr has written a small patch for
  630. nntplink 3.1.0 which supports this.  The patch is available via
  631. anonymous FTP on grasp.insa-lyon.fr in the file
  632. "pub/unix/news/nntp/nntplink/delayed-1.0.pch".
  633.  
  634. The patch has been incorporated into nntplink 3.2, available from the
  635. nntplink distribution site, shape.mps.ohio-state.edu in the file
  636. /pub/nntplink/3.2pl1.tar.gz.  nntplink 3.3 is due out soon.
  637.  
  638.  
  639. HOW TO DO IT:
  640.  
  641. The syntax that you would use in your newsfeeds file would be:
  642.  
  643.     site:*:Tf,Wnmt:
  644.  
  645. and run this command now and then:
  646.  
  647.     nntplink -i batchfile -y 300 -b site news.site.fr
  648.  
  649. The delayed IHAVE/SENDME is expected to allow bandwidth savings in
  650. situations where all sites use nntplink in following topology:
  651.  
  652.     Your site -- 64k -----------+-----------  Site 1
  653.                                 |               |
  654.                                 |              2mb
  655.                                 |               |
  656.                                 +------------ Site 2
  657.  
  658.    Site 1 and 2 are in the same metropolitan area, you feed them both.
  659.    With the standard nntplink layout, you generally send all articles
  660.    twice, which is a waste even if you're at 2 Meg/s link and even if
  661.    Site 1 and 2 do nntplinks, you're faster.
  662.  
  663.    The delayed link would be used between your site and Site 2.  A 2 or
  664.    3 minute delay allows Site 1 to feed Site 2 before you, and in case
  665.    of a Site 1 outage the backup starts nearly immediately.
  666.  
  667.    Reasonnable delays are still kept as You -> 1 -> 2 should take less
  668.    than one minute (or just 300 ms disk to disk if using nntplink -i ? :)).
  669.  
  670. Experiences seem to show that a 2 to 3 minutes delay is
  671. a reasonable choice.
  672.  
  673. Chris
  674.  
  675. ------------------------------
  676.  
  677. Subject:  Can I use gzip with INN?
  678.  
  679. (this was written with the help of Michael Brouwer <michael@tar.wft.stack.urc.tue.nl>)
  680.  
  681. There are three things that can be effected by using gzip:  Compression
  682. of old logs, compressing batches to send out, and decompressing batches
  683. that come in.
  684.  
  685. With INN 1.4 all you need to do is change two lines in config.data to
  686. something like this:
  687.  
  688. COMPRESS                /usr/local/bin/gzip
  689. DOTZ                    .gz
  690.  
  691. If you rebuild INN with these options set, all logs will be gzipped, and rnews
  692. will use gzip to decompress news.
  693.  
  694. gzip will automaticly and transparently decompress UNIX Compress, SCO
  695. UNIX Compress (I'm told it's 99% compatible with UNIX Compress), Pack,
  696. and gzip.  Therefore, you can now receive batches compressed with any
  697. of the above listed formats.  Let's say your site is now has "a
  698. universal decompresser".
  699.  
  700. It has been reported that if you hardlink gzip to be zcat, and make
  701. sure that it is the zcat that INN uses, you can get the "universal
  702. decompresser" without having to use gzip for your logs.  (Though, gzip
  703. for your logs is a big win, so why make trouble for yourself?)
  704.  
  705. `send-uucp' will still use compress for outgoing batches, so the sites
  706. you feed won't suddenly start getting data they don't understand.
  707.  
  708. Before you can send gzipped batches, you should make sure that the
  709. sites that you feed have made the above changes so that they have the
  710. "universal decompresser" too.
  711.  
  712. Edit send-uucp to use gzip instead of compress for certain hosts (see
  713. example of using compress -b12 for the host esac in send-uucp),
  714. outgoing batches will be gzipped.
  715.  
  716. If you use sendbatch, you will have to edit the file so that COMPRESS
  717. is set to "gzip" and COMPFLAGS is set to "-9vc".
  718.  
  719.  
  720. ------------------------------
  721.  
  722. Subject:  What do I do if /var/spool/news is set up over many partitions?
  723.  
  724. First of all, you can do this by either mounting a filesystem at
  725. /var/spool/news/comp (for example) or by mounting a filesystem anywhere
  726. and making /var/spool/news/comp a symbolic link to the new partition.
  727.  
  728. Articles will be written as normal, but cross-posts have to be handled
  729. specially now.  Usually INN handles crossposts by writing the article
  730. to the first newssgroup, and then creating hard links to all the other
  731. places where the article should appear.  Hard links do not take up
  732. additional disk space (except making your directories longer).  Hard
  733. links also have the advantage that the file data doesn't get deleted
  734. until the last hard link is gone (and they can be deleted in any
  735. order).  Therefore, you can expire each newsgroup at a different rate,
  736. but the file data won't delete until it is expired from the last
  737. newsgroup.
  738.  
  739. The problem is that two hard linked files must both be on the same
  740. filesystem (partition).
  741.  
  742. When INN sees that it can not make a hard link (because an article is
  743. cross-posted across two partitions) it will try to make a symbolic
  744. link.  If your system can not do symbolic links, set HAVE_SYMLINKS to
  745. DONT in your config.data file.  This will make INN write a second
  746. (or third, etc.) copy of the file instead.  (NOTE: INN 1.4 doesn't
  747. make the extra files.  This feature is planned for INN 1.5.)
  748.  
  749. Anyway, even though INN will automatically create symbolic links, you
  750. have to give expire the "-l" flag so that it will know to modify its
  751. behavior.  Suppose that a message is posted to rec.photo and
  752. alt.cameras and suppose that rec.photo expires more quickly then the
  753. alt group.  If this happens, then you will be left with a dangling
  754. symlink.  The -l flag prevents this from happening by not removing
  755. the file from rec.photos until alt.cameras expire time permits it
  756. from being deleted.
  757.  
  758. To inform expire that your spool is split across multiple partitions:
  759.  
  760. In news.daily, change:
  761.     EXPIREFLAGS="-v1"
  762. to read
  763.     EXPIREFLAGS="-v1 -l"
  764.  
  765. In expirerm, change:
  766.     RMPROC="fastrm -e -u -s ${SPOOL}"
  767. to read
  768.     RMPROC="fastrm -e -s ${SPOOL}"
  769.  
  770. Now edit innwatch.ctl so that it checks all the spool disks, not just
  771. ".".  See the lines with "No space (spool)".
  772.  
  773. Lastly, edit innstat (the line with the "df") so that all spool disks
  774. are included.  After that, you're done!
  775.  
  776. If you ever need to run "makehistory" you should pay attention to this
  777. caveat in makehistory(8):
  778.  
  779.     Makehistory does not handle symbolic links.  If the news
  780.     spool area is split across multiple partitions, the follow-
  781.     ing commands should probably be run before the database is
  782.     regenerated:
  783.         cd /usr/spool/news
  784.         find . -type l -print | xargs -t rm
  785.  
  786. However, if /var/spool/news/comp was a symlink to the partition
  787. that comp is really on, you'll have to reinstall that link.  You
  788. have avoid this by changing the above commands to:
  789.         cd /usr/spool/news
  790.         find . -type l -print | grep '[0-9][0-9]*' | xargs -t rm
  791.  
  792.  
  793. ------------------------------
  794.  
  795. Subject:  archiving expired articles
  796.  
  797. In <2hmomh$262@news.iastate.edu> rod@iastate.edu writes:
  798. >What options do I have in INN for archiving local newsgroups?
  799.  
  800. See doc/archive.8.  You could also put "never:never:never" in your
  801. expire.ctl file.
  802.  
  803. >Any help would be appreciated. Any cookbook examples would also help.
  804.  
  805. A cookbook newsfeeds entry:
  806.     # Feed all moderated source postings to an archiver
  807.     source-archive!:!*,*sources*,!*wanted*,!*.d\
  808.         :Tc,Nm,Wn:/usr/local/bin/archive -f -i /usr/spool/news.archive/INDEX
  809.  
  810. Ulf Kieber <uk1@irz.inf.tu-dresden.de> writes:
  811. People often complain that the man pages for archive and for newsfeeds
  812. do give conflicting information.  This is not true.  Newsfeeds(5) shows
  813. you how to set up a /program/ feed for archive, while archive(8) shows
  814. you how to set up a /channel/ feed.  There are some rules for using one
  815. over the other:
  816.  
  817. 1. If you intend to use the ``-i'' flag, ALWAYS use a channel feed, as
  818.    archive does not do any file locking on it's index file.  The index
  819.    file might get corruped by multiple concurrently running instances
  820.    of archive, as may happen with a program feed.
  821.  
  822. 2. If you do not intend to use the ``-i'' flag, choose a channel feed
  823.    only if that feed will be very busy (some hundred articles a day,
  824.    perhaps).  If the feed will not be really busy use a program feed.
  825.  
  826. A channel feed starts up a process that keeps running all the time and
  827. is connected to innd via a pipe, while a program feed fires up a
  828. process for every single article that goes through the feed.  That
  829. process only handles this one article and dies thereafter.
  830.  
  831.  
  832. ------------------------------
  833.  
  834. Subject:  How do I set up inpaths with INN?
  835.  
  836. inpaths should work just fine with INN as it ships.  However, you can
  837. make it run faster by using the following shell script.  Edit it to
  838. your tastes.  It replaces the long "(cd /var/spool/news ;
  839. /usr/local/bin/gfind . -type f -print | /usr/lib/news/local/inpaths sdl
  840. | /usr/ucb/mail admin,pathsurvey@decwrl.dec.com )" which people usually
  841. use.
  842.  
  843. #!/bin/sh
  844. . /home/news/innshellvars
  845. cd ${SPOOL}
  846. awk '(NF > 2){print $3}' < ${HISTORY} | tr . / | sort | \
  847. inpaths `innconfval pathhost` | \
  848. ${MAILCMD} pathsurvey@decwrl.dec.com
  849.  
  850.  
  851. =====================================================================
  852.                              BUGS IN 1.4
  853. =====================================================================
  854.  
  855. UNOFFICIAL patches for INN 1.4 are available via anonymous FTP at
  856. ftp://ftp.pop.psu.edu/pub/src/news/inn-patches/
  857.  
  858. The file ftp://ftp.pop.psu.edu/pub/src/news/inn-patches/README describes
  859. each of the UNOFFICIAL patches.
  860.  
  861. The ones that are highly recommended are:
  862.  
  863. 1.4-to-1.4sec     -- Fixes the major security hole in INN.
  864. 1.4sec-to-1.4sec2 -- Fixes the remaining known security hole in INN.
  865.  
  866. select-loop-bug.patch -- Under some circumstances innd can lose track
  867. of a file descriptor and end up sitting in a select() loop.  If your
  868. INN suddenly is using up tons of CPU time and not getting much done,
  869. install this UNOFFICIAL patch.  Some OSs are more susecptible to this
  870. bug.
  871.  
  872.  
  873. =====================================================================
  874.                              BUGS IN 1.3
  875. =====================================================================
  876.  
  877.  
  878. ------------------------------
  879.  
  880. Subject:  7-bit encoded batches are not correctly processed. Why is this?
  881.  
  882. Chris Schmidt <cs@germany.eu.net> replies:
  883.  
  884. The decode program that comes with INN up to version 1.3 is broken.
  885. Because of that the last article in a 7bit encoded batch will not
  886. correctly be decoded (the last characters are screwed up).  This is
  887. fixed in INN 1.4.
  888.  
  889.  
  890. ------------------------------
  891.  
  892. Subject:  NOV (overchan) doesn't work well.
  893.  
  894. Correct.  The NOV support in 1.3 didn't have all the bugs worked out.
  895. Don't use NOV under INN 1.3.  Better yet, upgrade to 1.4sec and get all
  896. the benefits!
  897.  
  898.  
  899. =====================================================================
  900.                              BUGS IN 1.2
  901.                  (Hey, it's 1994!  Upgrade already!)
  902. =====================================================================
  903.  
  904. ------------------------------
  905.  
  906. Subject:  Why doesn't nntpget work?
  907.  
  908. The nntpget in INN 1.2 doesn't work.  Period.  Upgrade to the latest
  909. version of INN.
  910.  
  911.  
  912. -- 
  913. Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play)
  914. "Psst!  Hey, Anthony!  Y'know what I        | Disclaimer:  I do not
  915. like about existing?"  "Uh... uh... what?"  | speak for Mentor Graphics.
  916. "Possessing a physical extension."  -TSA    |
  917.