=head1 Upgrading Mojo Mail from 2.5.1 to 2.6 

This document will try to summarize how to upgrade your Mojo Mail installation. If you're using a version lower than 2.4, these instructions should still work for you. 

=head2 The Good News...

Your old lists should still work! Yes, you may thank me now. 

=head2 Backup EVERYTHING

Something may go wrong, you back up everything on your computer religiously anyways right?

=over 

=item * Download The Files

The simplist way to back up Mojo Mail is to download via FTP whatever directory you store your list files in to your local computer This is the directory  known in 2.5.1 and below as the directory you set B<$lists> to in the CONFIG.pm file. This is also the worst way, since Some of the list settings files can get currupted. You've been warned.

=item * Move The Files

In Unixland, there's a magical utility called B<cp>, which lets you copy stuff. You're amazed, I know. You can copy directories by using cp with the '-R' flag, observe: 

	cp -R mojo_lists backup_mojo_lists_if_i_makey_a_booboo

=item * Compress The Files

You can also just compress the files for safe keeping and save some space: 

	tar -zcvf mojo_lists mojo_backup.tar.gz

=back

=head2 Do not install Mojo Mail over the previous installation

This takes some prior thought, but it's best to keep the old version around until you see that everything is running just chipper. Yes, two different versions of Mojo Mail can work on the same lists without anything blowing up really good. This means that you should rename the old mojo directory, the one that's in your cgi-bin. This also means that you have to change the $mojo_url variable in the CONFIG.pm file to point to where mojo.cgi is now.

	mv -R mojo mojo2_5_1 

works well. That way, when you do install the new version and everything checks out, you can just remove the old version. 

=head2 When Good Lists Go Bad

If you're reading this, you're also swearing at something as well, eh? heh... 

To salvage your list subscribers (you did make that backup, using one of the three ways mentioned above, correct?) just open up every file in your backup that ends in '.list' such as, B<listname.list> 'listname' would be the name of the list they were on. This file holds probably the most important part of your list, the subscribers; so all, is not lost. 

B<Note> Mojo Mail was never intended to be moved across servers. You may have complications if you find yourself in that situation. It's possible that the new server will be using a different DB package and downloading/uploading the list setting files in Mojo Mail will corrupt these files.






