L.......T.......T.......T.......T.......T.......T.......T.......T.......T....J Dear SCO Customer: This package contains Version B 2.11 of the USENET News software for SCO XENIX. This package is intended for use with SCO XENIX Releases 2.2 and 2.3. Both 80286 and 80386 binary executables are included. The disks in this package contain compiled versions of all the News programs and utilities, as well as formatted versions of all USENET News documentation. The C source code for the News software can be obtained from the UUNET archives. Contact UUNET (electronic mail address uunet!postmaster) for more information. Other USENET archive sites also may have the News software available. NOTE: The USENET News is user-supported software, which means that each user is solely responsible for its proper operation. USENET News is normally distributed as C source code, and is then compiled and installed by the system administrator. SCO has created this set of compiled programs as a courtesy to customers who do not have access to the SCO XENIX Development System. However, since the USENET News is not an SCO product, SCO does not warrant or support this software in any way. If you encounter problems installing or using this software, you should contact your system administrator, your news feed site, or the program authors (listed in the documentation). You can also seek assistance from the general USENET community. INSTALLATION The installation procedure will create or modify the following files: /usr/lib/news: directory created to contain the News utilities and data files. /usr/lib/news/organization: creates this one-line file, containing the name to use for the "Organization" field of outgoing news. /usr/man/cat.NEWS: directory created to contain the documentation for the News software. /usr/spool/news: spooling directory created to contain all news articles. /etc/passwd: a user "news" is added to own all news configuration files and news articles in the news spool directory. /etc/group: a group "news" is added for news configuration files and news articles. page 1 INSTALLATION PROCEDURE To install the USENET News software, follow this procedure: H...L............T.......T.......T.......T.......T.......T.......T.......T....J 1. Put your system in system maintenance mode. If your system is already in multiuser mode, use the "shutdown su" command to bring it into system maintenance mode. 2. Use the custom(C) utility to install the package. 3. From the initial menu, select option 4, "Add a supported product." 4. Follow the instructions that appear on your screen. 5. Adjust your UUCP configuration to communicate with your news feed site. For complete instructions on setting up a UUCP configuration, see the chapter "Building a Communications System" in the SCO XENIX System Administrator's Guide. Test your connection by exchanging mail in both directions between yoursystem and your feed site. ....L...........T.......T.......T.......T.......T.......T.......T.......T....R To begin receiving news, you must add the command "rnews" to the list of commands that your feed site may execute. This is done in 2.2 by adding "rnews" to /usr/lib/uucp/L.cmds, and in 2.3 by adding "rnews" to the COMMANDS list in /usr/lib/uucp/Permissions. Also, you must set up a regular schedule of UUCP connections by either having your system call your feed site, or your feed site call your system. This is normally handled by setting up a cron job that invokes uucico(C) to call your feed site once per day. H...L...........T.......T.......T.......T.......T.......T.......T.......T....J 6. Configure the News software for your site. The configuration is discussed in the document "USENET Version B Installation," contained in the file /usr/lib/news/doc/install. Most of the configuration discussed in this document pertains to changes to the software source code, and has already been done for you. The changes you will need to make are to the following files in the directory /usr/lib/news: ....L...........T.......T.......T.......T.......T.......T.......T.......T....J active: This file should contain the list of all newsgroups that currently exist. You should get the most-current version from your news feed site. For a description of this file, see section 3.1 of the installation document. mailpaths: This file should contain the UUCP paths to the nearest USENET backbone and Internet sites. See section 3.17 of the installation document for more information. sys:This file describes the interconnection between your system and the system that feeds yours. For a description of how to set up this file, see section 5 of the installation document. page 2 H...L...........T.......T.......T.......T.......T.......T.......T.......T....J 7. Set up a cron job to run the news utility expire(NEWS) to periodically remove old articles from your system. If news articles are not removed regularly, old articles will soon use up all of your disk space. This utility must be used rather than simply rm(C) because the news software maintains special history files that must be updated when articles are deleted. Expire(NEWS) is usually run by cron soon after the UUCP connection to your feed site. By default, expire(NEWS) will delete all articles that are more than 14 days old. There are options to expire(NEWS) that control the age of articles to be deleted. See the expire(NEWS) manual entry in /usr/man/cat.NEWS. L.......T.......T.......T.......T.......T.......T.......T.......T.......T....J USING THE NEWS SOFTWARE Onceyour system is configured, you may use the rn, readnews, or vnews programs to read articles in any of the newsgroups. You can also use the Pnews or postnews programs to submit articles of your own. Manual entries for each of these programs are in the directory /usr/man/cat.NEWS. DOCUMENTATION Before posting any articles to USENET, you should read the documents "How to Read the Network News," located in the file /usr/lib/news/doc/howto, and "How to use USENET Effectively," in the file /usr/lib/news/doc/manner. "USENET News Version B Installation," in the file /usr/lib/news/doc/install contains a detailed description of the various utilities and configuration files of the USENET News system. Manual entries for all News programs and utilities can be found in the directory /usr/man/cat.NEWS. If you need futher assistance, please feel free to call our toll-free Support Hotline at 1-800/347-4381 Monday through Friday between the hours of 6:00 a.m. and 5:00 p.m, Pacific Time. We appreciate your business. SoftCare Support Services EH:mhj/7-89 xnx.143-03C.rev.a page 3