Path: uunet!news.mentorg.com!sdl!not-for-mail From: tal@Warren.MENTORG.COM (Tom Limoncelli) Newsgroups: news.software.nntp,news.software.b,news.answers Subject: INN FAQ Part 2/3: Tutorial on installing Supersedes: Followup-To: news.software.nntp Date: 5 Nov 1993 05:00:12 -0000 Organization: Mentor Graphics - IC Group, Warren, NJ, USA Lines: 177 Sender: tal@Warren.MENTORG.COM Approved: news-answers-request@MIT.Edu Distribution: world Expires: 11/20/93 Message-ID: References: Reply-To: Tom_Limoncelli@Warren.MENTORG.COM (Tom Limoncelli) NNTP-Posting-Host: sdl.warren.mentorg.com X-Summary-1: Part 1: Common questions about INN itself, and some advice when compiling it and installing it. X-Summary-2: Part 2: This assumes that you've successfully compiled the software. This is a tutorial that takes you through configuration and setting up feeds. It ends with common questions about INN configuration. X-Summary-3: Part 3: Norman's quick guide to getting started (assumes SunOS and other things), and misc. other things.) Xref: uunet news.software.nntp:6371 news.software.b:15096 news.answers:14376 Posted-By: auto-faq 2.4 Archive-name: inn-faq/part2 Last Changed: $Id: FAQ-inn.2,v 1.12 1993/09/21 16:01:30 tal Exp $ This is a separate guide to installing INN. It is written for INN 1.4, but should work on any version. It is written and maintained by Norman J. Pieniazek (norman@giardia.pdb.cdc.gov). Please send updates and corrections to him. INSTALLATION AND MAINTENANCE OF INN 1.4 I. INSTALLATION 1. Get: inn1.4.tar.Z from ftp.uu.net (192.48.96.9). This file is in the directory: /networking/news/nntp/inn 2. Get: patch.tar.Z from ftp.uu.net. This file is in the directory /pub. Compile and install patch in the directory: /usr/local/bin. 3. If you don't have any gnu software, ftp to aeneas.mit.edu (18.71.0.38), go to directory /pub/gnu and get the following files. fgrep current version: fgrep-1.1 gawk current version: gawk-2.15.2 gcc current version: gcc-2.4.2 grep current version: grep-1.6 make current version: make-3.65 sed current version: sed-1.14 Compile and install these programs starting with make and gcc. Some people have reported problems with gnu sed 2.02. If people want to help me maintain a list of which GNU replacements are required on certain OS's, please send me the data. I'll keep the list up to date. 4. Get perl-4.0.36.tar.gz from ftp.uu.net - directory: /archive/systems/gnu. Compile and install in /usr/bin. 5. As root, create directories: /usr/local/inn (this is your $INN directory) /usr/local/news /news/bin /news/lib 6. Move inn1.4.tar.Z to $INN. Change directory to $INN Type: "zcat inn1.4.tar.Z | tar xvf -". This will install inn files for compilation. 7. Change directory to $INN/config and follow the instructions in R. Salz's INN nstallation manual. At least, change the compiler from cc to gcc. (If you have Solaris 2.1 - see changes made to the config files in Daniel Rich's letter). 8. Change directory to $INN. Type: "make world install". 9. If you get no fatal errors from make, check the /usr/local/news directory for history* files. Remove or rename them. Go back to the $INN directory and type: "BUILD" to run the final installation script. 10. Read Part 3 of this FAQ. Follow the instructions to set up at least your newsfeeds, hosts.nntp, and nnrp.access files. Get the active file from your newsfeed and edit it to your taste. Remember to include the control and junk newsgroups. 11. Type: "/usr/bin/perl /usr/local/news/bin/inncheck" and correct any errors reported by inncheck. 12. Type: "sh /usr/local/etc/rc.news". Look in syslog for any errors. Type: "ps -aux" and check, if innd owner is news. 13. In /etc/aliases create an entry: "usenet: ". Reboot, change directory to /var/yp, type: "make". From the same directory, type: "/usr/etc/yp/ypinit -m". Restart innd (see #12). 14. Type: "/bin/crontab -e news" and insert the following line: 40 23 * * * /usr/local/news/bin/news.daily delayrm if you are using overchan (in newsfeeds): 40 23 * * * /usr/local/news/bin/news.daily delayrm expireover 15. Run tests from your machine to the server (your machine at telnet port 119). See Tom Limoncelli's manual (Part 3 of the FAQ) for details. 16. After completing the test, be sure to delete the entry for your machine from the hosts.nntp file. If you will not do it, your machine will be treated as a "feeder" and not as a "reader". 17. Watch the news.daily reports in your mail for any additional errors. 18. Adding new groups - see Part II, Section 2.b, or: a. Type: "ctlinnd pause 'edit active'" b. Edit the active file. Format is: groupname himark lomark flag. Set himark to 0000000000 and lomark to 0000000001. c. Run inncheck (see #11) to check the new active file for errors. d. Type: "ctlinnd reload active 'new active'". e. Type: "ctlinnd go 'edit active'". 19. Set posting. a. Edit the /usr/local/news/newsfeeds file and add: /:::-T1800 -t300 c. Type: "/bin/crontab -e news" and insert a line: 0,10,20,30,40,50 * * * * /usr/local/news/bin/nntpsend d. Run inncheck (see #11). e. Post to misc.test and include reply in the Subject line, automatic responses will be mailed to usenet (see 13) within a few minutes. 20. To start innd automatically at bootup, include at the end of your rc.local the following lines: # # Start INN news service - Internet News Daemon (innd) # if [ -f /usr/local/etc/rc.news ]; then /usr/local/etc/rc.news; echo "Starting INN news service" fi II. MAINTENANCE 1. Newgroups are sometimes added automatically through a control message. A mail message to usenet will alert to such an automatic change to the active file. If you do not want to subscribe to a news group, change directory to /usr/local/news and type: ctlinnd rmgroup xx.xxx.xx 2. Sometimes, a mail message will arrive for usenet with a checkgroups file. Remove header, save the body of the message in: /usr/local/news/bin/control/news_control/news_control_todaysdate cd to that directory and type: "../docheckgroups todaysdate_pre" Read the output file (todaysdate_pre) and carry out all the instructions that you think pertain to your situation. You will have to change directory to /usr/local/news and: a. remove some discontinued groups: type: "ctlinnd rmgroup xx.xxx.xxxx" b. add a group: type: "ctlinnd newgroup xx.xxx.xxxx flag ''" c. mark a group correctly: type: "ctlinnd changegroup xx.xxx.xxxx flag" Run inncheck and repeat the docheckgroups command: "../docheckgroups todaysdate_after" Check for any problems. Also, edit the /usr/local/news/newsgroups file to reflect any changes you introduced. 3. IMPORTANT!!! Never run fsck on the drive where the /spool/news files are located. Innd has a lot of active disk I/O going on and fsck will show a lot of errors. Use ctlinnd to throttle, pause, or shotdown innd - see the manual page for ctlinnd. -- Tom Limoncelli -- tal@warren.mentorg.com (work) -- tal@plts.org (play) "Psst! Hey, Anthony! Y'know what I | Disclaimer: I do not like about existing?" "Uh... uh... what?" | speak for Mentor Graphics. "Possessing a physical extension." -TSA |