Subscribe to receive updates on Dada Mail:

The Dada Mail New Features Fundraiser is on! Contribute and cast your vote today!

The following content is adapted from the Dada Mail Manual. The Dada Mail Manual is available through the purchase of Pro Dada.

Support Dada Mail by purchasing Pro Dada!

Professional installation is available.


How to Upgrade Dada Mail



Upgrading Dada Mail

Introduction

There is no automated upgrade script that is distributed with Dada Mail. Usually, upgrades are very easy to do, so long as you have performed an Advanced Installation of Dada Mail. The reasoning is, all the custom configuration of Dada Mail will be located in the outside config file called, .dada_config.

All you need to do is to moved the old copy of Dada Mail out of the way, place the new copy of Dada Mail where the old copy was, tell it where the outside configuration file is and maybe change the permissions of a few files. So, let's get to it:


Step #1 Take note of what the, $PROGRAM_CONFIG_FILE_DIR variable is set to.

In your current Dada Mail installation, open up the, Config.pm file that's located in the, dada/DADA directory, which is in your cgi-bin Find the variable called, $PROGRAM_CONFIG_FILE_DIR and copy the value saved.


Finding the, "$PROGRAM_CONFIG_FILE_DIR" variable and noting its value.

If the value is, auto, as above, it means Dada Mail is automatically finding the correct directory.

Step #1 Move your old Dada Mail out of the way

There's many ways you can move Dada Mail - I'm going to use my FTP client, Transmit to rename the, dada directory that's in the cgi-bin, to, dada-old. When we're talking about moving Dada Mail, we're talking about moving the directory, dada that you've placed in the cgi-bin. This is the core Dada Mail program.


Renaming the, "dada" directory to, "dada-old"

Step #2 Place a new Dada Mail into the cgi-bin

Once the old Dada Mail is out of the way, put a fresh copy of the Dada Mail program into your cgi-bin. This is basically Step #1 of the Advanced Installation of Dada Mail - change the permissions of the mail.cgi file to, 755 and visit the program in your web browser. If you get the screen complaining about being installed and not configured, we're on the right track.


The old Dada Mail in the renamed, "dada-old" directory and the new Dada Mail in the, "dada" directory.

Step #3 Configure the new Dada Mail like the Old Dada Mail

Open up the Config.pm that's now in the dada/DADA directory, which is in your cgi-bin and change the variable named, $PROGRAM_CONFIG_FILE_DIR to the same value that was set in your old copy of Dada Mail. Save the file to your server and visit the mail.cgi script in your web browser. Your Dada Mail should be back and upgraded.

Cleaning Up

If everything looks good, you may remove the old copy of Dada Mail. If you want to test the new copy of Dada Mail and want to easily rollback to the old version - just in case, just change the permissions of the old copy of the, mail.cgi script to, 644, so that Dada Mail is still on your hosting account, but can't be executed.


Changing the old Dada Mail copy's, "mail.cgi" script permissions to, "644"


See Also

The following technical documentation, located on the Dada Mail support site can help with difficult upgrades:

Upgrade FAQ

The Upgrade FAQ also walks through an upgrade process, but doesn't necessarily expect your to be using the outside config file (.dada_config)

Changelog

The Changelog will let you know most every change between versions of Dada Mail. It's a good thing to look at before an upgrade, if you're following a bug, or if you want to know if a new version of Dada Mail will be compatible with your current version.

Dada Mail is Free Software and is released under the Gnu Public License.
Dada Mail is written in Perl because we love Perl.