MHonArc configuration checklist:

Key: * = required, - = optional
NOTE: All UNIX commands are case sensitive - type them exactly as shown!

1.	Creating your archive directory:

*[ ]  login to your shell account

*[ ]  check for any existing public_html directory

$ ls -al | grep public_html 
drwxr-xr-x   3 bulley  bulley  512 May  2 17:12 public_html

-[ ]  create public_html if needed:

$ mkdir public_html
$ chmod a+rx public_html

*[ ]  create an archive directory under public_html: (use your majordomo listname as your archive name!)

$ cd public_html
$ mkdir [archivename_here]
$ chmod a+rx [archivename_here] 

2.	Installing custom rcfiles and a shell script:

*[ ]  make sure you're in your home directory:

$ cd ~
  
*[ ]  determine the full path for your home directory:

$ pwd
/home/bulley
  
*[ ]  copy the stock majordomo startup files:

*[ ]  edit and then rename the following files using your prefered editor (pico, emacs, vi, etc)

Search and replace the following in the .mhonarc.listname file:

/home/ w/ your home directory (e.g. /home10/)
hostname w/ your_hostname 
username w/ your_username
listname w/ your_archive or listname

Save this file as .mhonarc.[your_list_name_here]
  
Do the same as above for .mhonarc.daterc.listname and save the file as .mhonarc.daterc.[your_list_name_here] 
  
Search and replace the following in the listname.sh file above:
	
listname w/ your_archive or listname

Save this file as [your_list_name_here].sh 

Make sure that the [your_list_name_here].sh file is executable:
  
$ chmod u+x [your_list_name_here].sh

3.	Creating your initial MHonArc files:

Generic configuration:

*[ ]  type the following, replacing 'listname' with your archive directory
  
$ mhonarc -editidx -umask 022 -outdir $HOME/public_html/listname/

Custom configuration:

*[ ]  type the following, replacing 'listname' with your archive/list

$ mhonarc -editidx -umask 022 -outdir $HOME/public_html/listname/         -rcfile $HOME/.mhonarc.listname

4.	Adding messages from an existing mail folder:

-[ ]  type the following, replacing 'listname' with your archive/list

$ mhonarc -add -umask 022 -outdir $HOME/public_html/listname/ 
-rcfile  $HOME/.mhonarc.listname $HOME/mail/listname

5.	Automating MhonArc

Using Procmail and a bourne shell (sh script to process in-coming messages i.e. messages are added to the archive as they are received.

*[ ]  make sure you're in your home directory:

$ cd ~

*[ ]  check for exisiting .forward and .procmailrc files:

$ ls -al .forward

If found you'll see something like this:

-rw-r--r-- 1 bulley bulley 112 May 3 01:20 .forward

$ ls -al .procmailrc
  
If found you'll see somthing like this:

 		-rw-r--r-- 1 bulley bulley 350 May 4 11:15 .procmailrc

*[ ]  edit or create a .procmailrc file by typing:

$ vi .procmailrc

If you own the list you plan to archive include the following at the top of the file:
  
:0
* ^Subject: *BOUNCE
$DEFAULT

To process a copy of incoming messages from a majordomo list include the following (replace listname as needed):
  
:0:c # process a copy a mail messages
* ^sender: *owner-listname # coming from this sender
| listname.sh # using this script

If you would rather just process the message and not receive a copy in your mailbox use the following:
  
:0 # process a copy a mail messages
* ^sender: *owner-listname # coming from this sender
| listname.sh # using this script 

If you had an existing .forward file you will need to add the following (replace username and hostname as needed):

:0 # no flags, no copies, no lock
* # all remaining messages 
! username@hostname # sent to this forwarding address 

*[ ]  save the file as .procmailrc

-[ ]  if you had an existing .forward file type:

$ mv .forward forward.old

Piping messages from Pine (added by owner - one at a time)

6.	Configuring Pine to use the pipe command:

From the Main Menu in Pine:

Type: s (SETUP - Configure or update Pine) you'll see a prompt at the bottom of your screen:

Choose a setup task from the menu below :

? Help 	P [Printer] 	C Config 	S Signature 
^C Cancel 	N Newpassword 	U Update

Type: c 

Using your down arrow, scroll down the list of options until you find:

[ ]  enable-unix-pipe-cmd 

Put an x between the brackets

[x] enable-unix-pipe-cmd 

Type: e

You'll see the following prompt:

Commit changes ("Yes" replaces settings, "No" abandons changes)?
? Help Y [Yes] 
^C Cancel N No 

Type: y

7.	Piping a single message:

You can now go the your mail folders and highlight the message you want to include in the archive:

Highlight the message and type: |<br> 

You'll see a prompt like this:

Pipe message # to :

^G Help 	^W Raw Text 	^R With Delimiter
^C Cancel 	Ret Accept 	^Y Free Output

Type in the name of your list shell script: listname.sh and press return. The message selected will be added to the listname  archive.