Next: NA-NET Database Setup Up: Email Netlib Server Previous: Email Netlib Server

Acquiring and Installing the Netlib Software

CAUTION: The most common problems with the email interface to Netlib are corrupted mail addresses, network errors, and so on. You ought to be reasonably expert with email before installing the Netlib email server.

To obtain the Netlib email server software, send the following message to

send netlib from misc

Netlib will return a shar file with instructions at the beginning as to how it should be unbundled. This guide assumes that the software is unbundled in a directory named /netlib/admin. After unbundling, carry out the following steps:

  1. Edit the call to chdir in bin/reply.c to point to the place where the source code is stored on your system. /netlib is assumed for illustration here.

  2. Edit /netlib/admin/LIBS to reflect what you are distributing. Items strictly for local users go in LIBS.lcl and index.lcl; edit function groupid() in reply.c to define ``local users''. If everything is public, groupid() can simply return 0. As it currently stands, ``local'' addresses are those whose machines are in /netlib/admin/groups/local; if any machine name in groups/enemies is found, processing is aborted.

    Suppose you have a library eispack that you want to install. Make the directory /netlib/eispack; copy in files such as rg.f; create a file index there; add some lines to /netlib/admin/LIBS like

            eispack => eispack
            eispac => eispack

    (That second line is to allow for misspellings; use your imagination and watch the logfiles for common mistakes.) Be sure that the line

            master => master

    is in LIBS, so that people can get the main index.

  3. Edit the various disclaimers in /netlib/admin/mess. You may also wish to add disclaimer files in the source directories.

To activate mail processing:

*  if you run \command{sendmail}, put
          netlib: "|/netlib/admin/bin/reply"
          netlibd: "|/netlib/admin/bin/netlibd"
   into /usr/lib/aliases and execute newaliases;
*  if you run \command{upas}, put
          Pipe to \file{/netlib/admin/bin/reply}
   in \file{/usr/spool/mail/netlib} and make that file owned by
   "netlibd" and similarly put
          Pipe to \file{/netlib/admin/bin/netlibd}
   in \file{/usr/spool/mail/netlibd} and make that file owned by 
*  else if your system has no equivalent mechanism, try the
   daemon in /netlib/admin/bin/Old-mail-sys.

The script admin/bin/netlibd contains (on line 3) cd /netlib, which you may need to change. Because Berkeley's alias facility provides no way to set the userid, you probably should put your name and address in the message so people know who is actually sending the mail.

To try the system out, echo send index mail netlib and expect return mail in a couple minutes. A line should be added to /netlib/admin/log and admin/stderr should remain empty.

Once the basics are working, you can polish things a bit.

Next: NA-NET Database Setup Up: Email Netlib Server Previous: Email Netlib Server
Thu Aug 25 09:07:23 EDT 1994