2/7/2000

This file briefly describes how to set up a Web email archive
on www.nersc.gov using hypermail.

It may be helpful to note that I (Jed) have written a script that
I put into /usr/local/bin/makehyper that carries out all these
steps but the last two which need special priviledges.  You
can run it as:

%makehyper listname
(where "listname" is of course the name of your newly archived list)

Note that after running makehyper or after carrying out these
steps manually your are free to tune the configuration as per
the documentation at:

<a href="http://www.hypermail.org/">http://www.hypermail.org/</a>

Here are the steps if you choose to do them manually:

1. Go to the directory /www/hypermail and copy the configuration
file template there, template.config, to a file with the name of
your list to be archived, e.g.:

  cp template.config mylist.config

2.  Edit the following fields in your new config file:

  a.  hm_label - Substitute the title you would like to see
                 on your Web email archive:
                 e.g. "Mylist email archive"

  b.  hm_directory - Substitute the name or your email list
                     for the last link in this path name:
                     e.g. /www/nersc/hypermail/mylist

  c.  hm_mailto - Substitute the email address for your list
                  for the value of this parameter
                  e.g. "mylist@nersc.gov>.

  d.  Make any other changes you like.  You can read about
      what options are available at:
      <a href="http://www.hypermail.org/">http://www.hypermail.org/</a>

3.  After the above are done you can create a directory at:
    /www/nersc/hypermail/<your list name>:
    e.g. /www/nersc/hypermail/mylist

4.  Change the group of /www/nersc/hypermail/mylist to group upload.
    This allows the alias code that runs as user daemon to write into it.


Finally here are the steps that need priviledges to accomplish:

5.  Have somebody with root on www.nersc.gov add a line like:

mylist: "|/usr/local/bin/hypermail -iu -c /www/hypermail/mylist.config"

at the end of the /etc/aliases file.

6.  Finally have support (or whoever) add the email address
    mylist@www.nersc.gov   to your email list.  After that
    all messages sent to the list should also appear in the
    hyperlinked archive at http://www.nersc.gov/hypermail/mylist

Naturally you are free to put softlinks to
/www/nersc/hypermail/mylist

anywhere you like and can link your html pages to the
list directly or to your softlinks.