Listserv to Mailman migration package 

1) Preface

This package contains several utilities that helps you to convert Listserv's configuration
and user database to Mailman.

The software is not bug free but takes off most of the load have at migration.
Gets the configuration of the lists and users and configures mailman to use them similarly
as much as possible (and we could figure out).

2) Copyright

   Copyright (C) 2005 Levente Torok <lev at niif.hu> and Gabor Vitez <vitezg at niif.hu>.

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; version 2 dated June, 1991.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program;  if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
				 
3) Operation

3.0) System requirements:

3.0.1) Have bash, sed, awk and perl installed from your distribution.
Ensure that either exim or sendmail is working somewhere and you can run 
one script on that machine.

3.0.2) install the package "Mail-RFC822-Address-0.4.tar.gz" from the 
to_install directory such as

tar xvzf Mail-RFC822-Address-0.4.tar.gz
cd Mail-RFC822-Address-0.4
perl Makefile.PL

3.1) You have to get the MAIN directory from the Listserv first.
Copy it here and set the correct location in "config.sh"

3.2) Run "1parse_lists.sh" script
This will generate 2 directories for you.
these are "list_members" and "list_opts" by default.

3.3) Run "2gen_mm_lists.sh"
This will create you the lists hopefully with the options you wanted.

3.4) Run "3send_emails.sh" 
This will send one mail per user to get the his/him options from Listserv.
You must be a server administrator on Listserv to do this.
You should set your email address in config.sh
It will take a lot of time until all mails from Listserv arrives.
Have a look at the 3send_emails.sh script. Select if exim or sendmail/postfix whatever is used
Finally please copy the mail directory of the received mails to here to the 
directory "mails" or whatever you set it in "config.sh"

3.5) Run "4gen_mm_users.sh"
This will create list of digest and digest users and do a bulk subscription to lists.

For the reason that sendmail is more sensitive to mail addresses than RFC822
we have made a check over the email addesses too.

May be it is a good idea to run it as
"4gen_mm_users.sh | tee error.out"
so you can collect by grepping to errors such as
"grep ^Error error.out"
to get to know what email addresses are dropped from lists.

3.5) If you have leave_files set on in config.sh, then you have a lot directory not
needed anymore. You may clean them by "clean_all.sh"
Or if you want to see which email addesses we are considering to be wrong in the 
list_members directory then run "get_nonvalid_emails.sh"

3.6) Thats it.

4) I hope you can save a lot of money by not purchasing regularly licenses from L-Soft.

If you success, let us know.
