Subscribe to receive updates on Dada Mail:

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.


Upgrading Dada Mail from a Simple Scripts Installation



Upgrading Dada Mail from a Simple Scripts Installation

SimpleScripts is a one-click installer service that Cpanel-enabled sites, like BlueHost offer, that allow you to install programs, like Dada Mail, relatively simply - a lot more simpler than our own installation instructions. It may also be available as a stand-alone service. Take a look:

http://www.simplescripts.com/

Simple Scripts may also support upgrading your old Dada Mail to a new Dada Mail which is quite convenient.

A problem comes up when you want to upgrade from regular Dada Mail - the version Simple Scripts provides to Pro Dada, something that only we provide.

Below are a stab at directions on doing just that - as easily as we can make them. You will have to have some basic knowledge on how FTP works and there's some light text editing.

Beware! The Point of No Return

Do be advised, that the changes we make may render your Simple Scripts installation unusable if you muck it up, so, as always, we suggest making backups of any and all files that we're going to move or edit.

These instructions are up to date as of March, 2009. It's very possible that they may change in the future, as Simple Scripts seems to be in a period of much improvement and growth. We'd really like to hear from you, if these instructions fall out of date.

Step #1 Install Dada Mail through Simple Scripts

We'll start with installing Dada Mail, just so we're all on the same page.

I'll be using a Blue Host hosting account that Simple Scripts and Blue Host have lent to me for testing purposes. Your own account may differ quite a bit.

Log Onto Your Cpanel, Get into Simple Scripts

Log Onto your Cpanel and find the, "Simple Scripts" button.


Finding the Simple Scripts button in Cpanel

Once your browser has redirected and refreshed, find, "Dada Mail" in the Simple Scripts, "Script List" and click on the Dada Mail icon.

Finding Dada Mail in Simple Scripts


Finding the Dada Mail logo in Simple Scripts

Once the screen has refreshed again, find the, "Install Now" button and give that a click as well:

Install Away!


Find and click the, "Install Now" button

Once thats refreshed, choose a location for where Dada Mail should be installed. For simplicity's sake, we're going to install it in a directory called, "dada".

Also, make sure to check all the options:

Finally, note the server path. In our case, it's, /home/dadabhco/public_html/dada

This will be important, once we manually upgrade this Simple Scripts installation.


Options, when installing via Simple Scripts

As far as installation via Simple Scripts, we're all done!

What's really nice about this system, is that the Simple Scripts installer has created our SQL database and configured Dada Mail correctly to use it.

Step #2 Upgrading from the Simple Scripts Installation

In Simple Scripts: Remove from List

Now, we can upgrade Dada Mail.

Get back to the main screen of Simple Scripts. On the top of the screen, you should see, under the heading, My Installs, Your Dada Mail.

Click the, Uninstall Link.


Find and Click the Uninstall Link.

Once the screen refreshed, DO NOT click the, Yes, I'm Sure Button, but instead, click on the, Remove from List link. This will keep your Dada Mail installation around, but Simple Scripts won't administrate it, anymore.

We're now all set with Simple Scripts and it's time to go it alone.

From this point, you'll need an FTP program and a Text Editor, as well as a new copy of Dada Mail (or, Pro Dada)

Move the, ".dada_files" directory

In your FTP program, find the, "dada" directory that Simple Scripts has created:


Finding the, "dada" directory in your hosting accoutn via your FTP program.

In the, dada directory is a directory called, .dada_files.

Very important: DO NOT delete this directory.

Rather, we're going to move the directory to our hosting account's home directory, like so:


Moving the, ".dada_files" directory


All Moved.

Edit the, ".dada_config" File

Simple Scripts uses Dada Mail's .dada_config file, which makes upgrades a whole lot easier. We're still going to have to edit it a little bit, so let's do that:

In the, .dada_files directory we just moved into our home directory, go into the, .configs directory and open up the, .dada_config file found there. We'll have to make three simple changes:

$DIR

Since we moved where the, .dada_files directory is, we also have to change this variable. In my example, it was living at:

/home/dadabhco/public_html/dada/.dada_files

Our home directory is,

/home/dadabhco

So, we'd edit this line as so:

 my $DIR         = '/home/dadabhco/.dada_files';

cut lines

For some strange reason, Simple Scripts puts the SQL information in the outside config file, but doesn't enable them. This is easy to do, though. Find the following lines in the .dada_config file:

 # start cut for SQL Backend
 =cut

and,

 =cut
 # end cut for SQL Backend

and remove them. Save/upload the file back to where you found it. All set with edits!

Move the, "dada" directory

Now comes the actual upgrade. All we have to do is move the current, dada directory to somewhere else, like, dada-bak:


Renaming the, "dada" directory to, "dada-bak:.

Upload a new, "dada" directory

Download Dada Mail from,

http://dadamailproject.com/download

uncompress the distro on your desktop and upload the, "dada" directory in the same directory the old, "dada" directory that Simple Scripts put up, lived. Change the permissions of the, mail.cgi file to, 755:


Changing the permission of the mail.cgi file to, "755"

And, you are all set!

If Dada Mail can't find your new .dada_files location, open up the, Config.pm file, found in the, dada/DADA directory and edit the, $PROGRAM_CONFIG_FILE_DIR variable to point it to the right place. In our example, it would be changed from:

 $PROGRAM_CONFIG_FILE_DIR = 'auto';

to,

 $PROGRAM_CONFIG_FILE_DIR = '/home/dadabhco/.dada_files';