Using the MHonArc Installer for Majordomo Lists with Darkwing
The installer can be used to create a web-accessable majordomo mailing list archive
by using MHonArc. If you're interested in building an archive for a listserv or an
existing mail archive, please see:
http://lists.uoregon.edu/~majordom/mdwks/index.html (username: lists password: letmein) or contact the listmaster@lists.uoregon.edu.
We strongly advise that you print out this file and use it for
reference as you move through the steps. This documentation
will not always be visible in your browser's window.
Before you start:
- Ensure that you have:
- a uoregon.edu user account which will house the web archive (normally your own account)
- the password to this uoregon.edu account
- access to a computer with a web browser.
- the email address of the UO majordomo mailing list that you wish to archive (i.e. testlist@lists.uoregon.edu)
- subscribed the target uoregon..edu account to that mailing list (in other
words, you receive e-mail from that list at username@uoregon.edu)
- Again, you must subscribe username@uoregon.edu
to the mailing list for the archive to work.
- The list must be a majordomo list
(listname@lists.uoregon.edu), not a departmental listserv, since
this installation only works for majordomo lists. If you need to create a new list,
you can do so by filling out the form at
http://lists.uoregon.edu/newap.html
and then waiting a day or two for your request to be processed.
You must wait to get confirmation that your list exists before you can
proceed with this installation.
If you are unsure if you have an email account and its password, you can
contact University Computing at 346-1758 or e-mail at consult@uoregon.edu.
If you have not already created a mailing list, go to Managing
a Mailing List or email listmaster@lists.uoregon.edu.
The Installation:
- Open a connection to the target shell.uoregon.edu account using ssh
and login using the username and password for the account where the archive will
be created (normally your own account, but it could also be a group or departmental
account)
- Start your Web browser, and go to:
http://www.uoregon.edu/cgi-bin/majordomo/mhonarc/makedat.cgi
- Back at the shell.uoregon.edu prompt, type
% ~listmast/archive-it listname
where listname is the name of your list.
- Verify that all this worked by sending mail to the list and waiting
2 minutes. Then go to your web browser, and type:
http://lists.uoregon.edu/~username/listname
replacing username with the archive username, and listname with
the name of your mailing list.
The Fine Print
Procmail
If you don't know what procmail is (and you shouldn't), don't worry about
this, it shouldn't affect you in any way. If you do know what procmail
is, be aware that this program does alter the .procmailrc file in order to
activate automatic updating. If you've already got a .procmailrc file, you
might just want to make sure it still works after installing the list,
since this program will add a few lines to it.
Problems?
If at anytime you should commit an error, or something else of an unknown
origin occurs, please consult the MhonArc
troubleshooting page. There you will find answers to some possible mishaps
you could encounter while setting up a mailing list to be archived by MhonArc.
Acknowledgements
This installer is based on scripts originally developed for TEP (Teaching Effectiveness Program) and we thank them for their willingness
to make the scripts available to UO users. Developers included Santos R. Cash & Michael Sweet.