Next: The sys file Up: C-News Previous: Delivering News

# Installation

To install C-News, untar the files into their proper places if you haven't done so yet, and edit the configuration files listed below. They are all located in /usr/lib/news. Their formats will be described in the following sections.

          1. There may be a difference between the groups  that  exist
             at  your  site,  and  those  that your site is willing to
             receive. For example, the subscription list  may  specify
             comp.all,  which  means  all  newsgroups  below  the comp
             hierarchy, but at your site, only a number of comp groups
             are  listed  in  active.  articles posted to those groups
             will be moved to junk.
          2. Note that this should be the crontab of  news,  in  order
             not to mangle file permissions.

### Figure 22. News flow through relaynews.

sys
  You probably have to modify the ME line that describes your system, although using all/all is always a safe bet. You also have to add a line for each site you feed news to. If you are a leaf site, you only need a line that sends all locally generated articles to your feed. Assume your feed is moria, then your sys file should look like this:

                           ME:all/all::
                           moria/moria.orcnet.org:all/all,!local:f:

organization
  Your organization's name. For example, ``Virtual Brewery, Inc.''. On your home machine, enter ``private site'', or any- thing else you like. Most people will not call your site properly configured if you haven't customized this file.
mailname
  Your site's mail name, e.g. vbrew.com.
whoami
  Your site's name for news purposes. Quite often, the UUCP site name is used, for example vbrew.
explist
  You should probably edit this file to reflect your preferred expiry times for some special newsgroups. Disk space may play an important role in it. To create an initial hierarchy of newsgroups, obtain an active and a newsgroups file from the site that feeds you, and install them in /usr/lib/news, making sure they are owned by news and have a mode of 644. Remove all to.* groups from the active file, and add to.mysite and to.feedsite, as well as junk and control. The to.* groups are normally used for exchanging ihave/sendme messages, but you should create them regardless of whether you plan to use ihave/sendme or not. Next, replace all article numbers in the second and third field of active using the following command:

                 # cp active active.old
                 # sed 's/ [0-9]* [0-9]* / 0000000000 00001 /' active.old > active
                 # rm active.old

  The second command is an invocation of sed(1), one of my favorite commands. This invocation replaces two strings of digits with a string of zeroes and the string 000001, respectively.

  Finally, create the news spool directory and the subdirectories used for incoming and outgoing news:

                 # cd /var/spool
                 # mkdir news news/in.coming news/out.going
                 # chown -R news.news news
                 # chmod -R 755 news

  If you're using a later release of C-News, you may also have to create the out.master directory in the news spool directory.

  If you're using newsreaders from a different distribution than the C-News you have running, you may find that some expect the news spool on /usr/spool/news rather than in /var/spool/news. If your newsreader doesn't seem to find any articles, create a symbolic from /usr/spool/news to /var/spool/news.

  Now, you are ready to receive news. Note that you don't have to create any directories other than those shown above, because each time C-News receives an article from a group for which there's no spool directory yet, it will create it.

  In particular, this happens to all groups an article has been cross-posted to. So, after a while, you will find your news spool cluttered with directories for newsgroups you have never subscribed to, like alt.lang.teco. You may prevent this by either removing all unwanted groups from active, or by regularly running a shell script which removes all empty directories below /var/spool/news (except out.going and in.coming, of course).

  C-News needs a user to send error messages and status reports to. By default, this is usenet. If you use the default, you have to set up an alias for it which forwards all of its mail to one or more responsible persons. (Chapters- and- explain how to do so for smail and sendmail). You may also override this behavior by setting the environment variable NEWSMASTER to the appropriate name. You have to do so in news' crontab file, as well as every time you invoke an administrative tool manually, so installing an alias is probably easier.

  While you're hacking /etc/passwd, make sure that every user has her real name in the pw_gecos field of the password file (this is the fourth field). It is a question of Usenet netiquette that the sender's real name appears in the From: field of the article. Of course, you will want to do so anyway when you use mail.

  Next: The sys file Up: C-News Previous: Delivering News