xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx PLASMA ORGANIZATION DOC.MN.1 ARCH_MIG MEMO (DESCRIPTION, USAGE) Peter 'Rattacresh' Backes <[log in to unmask]>, Jul 03 2000, Rev 0 (c) 2000 PLASMA ORGANIZATION Keywords: LISTSERV, archive, notebook, converting, UNIX mailbox, mailing list, mailing list manager, MLM Archive_migrate is a program which helps you converting your UNIX mailbox format files into the notebook format, which are nowadays used mainly in the context of LISTSERV archives. If you were using a different MLM in the past which used the UNIX mailbox format as it's archive format (notably Listproc) or if you just took over mailing list hosting for a list you were a member of in the past and can't contact the old owner to send you the old archives so you have to use what your own mailbox folder contains, then this is the program you're looking for. Before you run the actual conversion script, order the original log files as follows: . Current directory + lstone-l Directory for the first list | | 9701 UNIX mailbox format archive for Jan 1997 | | 9702 Feb 1997 | | ... Other archive formats, using the name convention + lsttwo-l Directory for the second list | | ... + ... More list directories containing archives The conversion script actually only cares about the first character of the archive files; it must be a digit. After conversion, you will find the files in LISTSERV name convention, <listname>.log<period>. You can exploit this to use a different period scheme, like weekly or yearly notebooks, as LISTSERV provides them. For further information about this, consult section 8.10.3 of the Site Manager's Operations Manual for LISTSERV 1.8d (reference number 9903-MD-01). To separate your archives in monthly/weekly/yearly chunks just use your favourite mailer that provides a feature to bulk move mails between UNIX mailbox folders. I used mutt which did it's job without any problems. When you've prepared the directory structure as described, change to the directory that contains the list subdirectories and execute the script from there (either copy the conversion program into this directory or add the directory that contains it to your PATH). Don't forget to give it +x mode first. Then run the script. It will show something similar to the following, depending on your list names: ************************************************************** * * Listproc -> Listserv Archive Migration Utility * ************************************************************** Found a total of 1 list archive directories. Continuing .. >>>> Processing directory ogde-l, press "y" to continue.. You can press 'y' to process this archive directory, something else to skip it or send a ^C to terminate the script entirely. By the way, you can press ^C at any time to emergency exit the script if it shows brain disease. After pressing 'y', you will be asked the following: Please enter the title of the group: arch_mig expects the RFC822 mailbox for your list to be entered. It is recommended to give it a description of the list and the (old) list email address in angle brackets. Be sure to use "double quotes" around your list description if it contains one of the following characters: ()<>@,;:".[]\ Also be sure to escape double quotes inside double quotes with a backspace: German OG Mailing List <[log in to unmask]> After hitting enter, arch_mig will process each archive and save it in notebook format under a new directory. It will print a short status message for each file: Creating Directory /var/tmp/ogde-l ... Processing archive 0001... DONE Processing archive 0003... DONE Processing archive 9802... DONE Processing archive 9803... DONE Processing archive 9804... DONE Processing archive 9806... DONE Processing archive 9807... DONE Processing archive 9808... DONE Processing archive 9809... DONE Processing archive 9810... DONE Processing archive 9811... DONE Processing archive 9812... DONE Processing archive 9901... DONE Processing archive 9902... DONE Processing archive 9903... DONE Processing archive 9904... DONE Processing archive 9905... DONE Processing archive 9906... DONE Processing archive 9907... DONE Processing archive 9908... DONE Processing archive 9909... DONE Processing archive 9911... DONE Processing archive 9912... DONE When every file it found in the list directory was converted properly, it possibly asks you for the the next one if there is one. Just proceed as described above. After the last one being finished, it will give you a summary of the work it's done. As we only converted archives for one list in our case we would be shown this: Processed 1 list(s) and 23 archives. A total of 0 lists were skipped. Then you'll find yourself on the shell prompt again. All notebooks can now be found under the directory /var/tmp/<listname>, for our example list that's /var/tmp/ogde-l. You can change to /var/tmp, fix file permissions if neccessary and either just move all directories to where your LISTSERV list folders are stored or -- if they already exist for your list -- move the contents of the directories to their appropriate positions. Send a INDEX command for your list to LISTSERV and check whether everything is OK. You can reboot LISTSERV or wait until midnight if you want the archives to be available via web interface. THE SOFTWARE IS PROVIDED ``AS IS'' WITHOUT EXPRESS OR IMPLIED WARRANTY INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL PLASMA OR ANY OTHER CONTRIBUTOR BE LIABLE FOR DIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF PLASMA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.