Upgrade Dada Mail
- Upgrading Dada Mail
Upgrading Dada Mail
This doc. will guide you through an upgrade of Dada Mail, originally installed and configured with the included Dada Mail Installer.
For information on how to upgrade Dada Mail from an install that wasn't done using the included Dada Mail Installer, see, Upgrading Dada Mail From Different Installation Types
Step #1 Rename the, "dada" Directory
Dada Mail, "The App" is the collection of files and directories that are in the directory called,
dada directory has a structure like this:
cgi-bin (directory) - dada (directory, _lower_ case) - mail.cgi - DADA (directory, UPPER case) - App (directory) - Config.pm - etc, etc, etc
This is Dada Mail, The App
Simply rename this directory on your hosting account from:
to something like:
Moving the directory:
Keeps a backup that is known to work
Makes sure we don't overwrite the old version of the program with the new version
Makes sure we don't mix up the old version of Dada Mail with the new version of Dada Mail
Step #2 Install the new Dada Mail
Upgrading will now be similar to installing Dada Mail (https://dadamailproject.com/d/install_dada_mail.pod.html)
Except that on the first screen of the Installer, instead of choosing, "Install"...
The first screen of the installer will ask you if you'd like to Install, or Upgrade Dada Mail. Choose, Upgrade.
A new form field will appear labeled, Current .dada_files Location.
If it can automatically be found, the textbox will already be filled with the absolute path to the parent directory of where the
.dada_files directory lives. If this path looks correct, click, Continue....
If this isn't the correct location or no location was pre-filled in, fill in the correct location manually. The installer shouldn't allow you to continue, unless this directory is successfully found.
Two new options are presented to you in the installer, if you are upgrading.
Create a new .dada_config file
(This is what we suggest in most cases)
Select this option if you are upgrading between major versions of Dada Mail. For example, version 7.0.0 to version 8.0.0 or, from version 8.0.0 to version 8.2.0.
Why Create a new .dada_config file?
Changes are periodically made to Dada Mail's default configuration and it's a good idea to have the installer create a new
.dada_config file to take advantage of any new enhancements and also to keep your
.dada_config file current and compatible with your new copy of Dada Mail. If you are unsure, use the option to create a new .dada_config file>
The Installer will read your old
.dada_config file and pre-fill in the configuration that can be set on this screen. Give it a quick look-over and make sure the information looks correct and make any changes that you would like. This is a good oppourtunity to add/remove installed plugins, or do more advanced configurations, like set up Amazon SES sending.
If you have manually editing the
.dada_config file, note that the installer does not support moving over any manual edits when you upgrade. You will need to manually copy over these configurations after the upgrade is completed. The Installer will make a backup of your previous
.dada_config file, to make this easy to do.
Use the current .dada_config file
Select this option if you are upgrading between minor versions of Dada Mail. For example, version 8.0.0 to 8.0.1.
It's a very very good idea to look at the changelog and note any incompatibilities between versions. It's possible that incompatibilities could break your installation, when you upgrade.