Install/Upgrade FAQ

Installation/Upgrade FAQ

Installation/Upgrade FAQ

This FAQ is to help answer questions about installation and upgrading Dada Mail that is not covered in any of the other installation/upgrade docs. To keep those docs clean and simple, some topics are covered here, instead of in the main docs.

Prepping Dada Mail Manually

If the, uncompress_dada.cgi script fails to uncompress the Dada Mail distro, you may have to complete a few steps, yourself. This usually is because the gunzip utility just isn't available to whatever is running the uncompress_dada.cgi script. Shucks.

Uncompress the Distribution

The tar.gz distribution you just downloaded to your Desktop Computer should uncompress to one folder/directory called, dada.

Upload the, "dada" directory into your cgi-bin

There are a lot of files and this may take a few minutes.

(If you're familiar with accessing your hosting account via ssh, feel free to simply upload the distribution to your hosting account and uncompress from there.)

Change the name of the, "dada/installer-disabled" directory to, "dada/installer"

By default, the installer is disabled, so not to pose as a security issue. Rename the, dada/installer-disabled directory to, dada/installer.

Change permissions of the, "dada/mail.cgi" and "dada/installer/install.cgi" scripts to, "755"

BOTH of these scripts need to have their permissions changed to, 755

Visit the, dada/installer/install.cgi script in your web browser

The, install.cgi script should take over from there.

You can now jump back to the installation instructions at, Configuring Dada Mail with the, "install.cgi" Script

Installing Dada Mail in a directory other than in your, "cgi-bin"

It used to be common practice that CGI scripts could only be installed in a hosting account that had a, cgi-bin directory which itself had the correct server configuration to allow the execution for CGI scripts, like Dada Mail.

This is really not the case anymore and usually one can install CGI scripts wherever one want with little or no additional configuration. Our directions still tell you to install Dada Mail in your cgi-bin to be as universal as possible.

.htaccess file

If additional configuration is needed, you may simply need to create an .htaccess file inside the directory you decide to place Dada Mail in. The .htaccess file should have the following, "configuration directives":

        Options +ExecCGI
        AddHandler cgi-script cgi pl

Location Considerations

Inside a regular directory

It may be helpful to still install Dada Mail inside some other directory, instead of right inside your public html directory. This should make upgrades easier. For example, if your public html directory is located at:

 /home/youraccount/public_html

You may want to set up an additional directory called, "apps" (or, whatever you'd like it to be called):

 /home/youraccount/public_html/apps

and place the, .htaccess file, with the configuration directives listed above in that directory. Then while installing, upload both the, uncompress_dada.cgi script and Dada Mail dada-x_x_x.tar.gz distro in that same directory. The, uncompress_dada.cgi script should be allowed to execute, creating the, dada directory inside your, apps directory.

Upgrades would also be simple and you'll be able to follow the directions of the Upgrade docs - renaming the, dada directory to get it out of the way, etc.

This would give you a URL similar to:

http://example.com/apps/dada/mail.cgi

Clean and simple.

You may also want to think about creating a subdomain just for Dada Mail, allowing you to easily separate Dada Mail from the rest of your website. A suggest would be to call it:

http://ml.example.com

ml standing for, mailing list. Your URL would then be:

http://ml.example.com/dada/mail.cgi

The directory your mapping your subdomain onto would then be that, "extra" directory to install Dada Mail in, complete with .htaccess file (if needed). For example, you could map your subdomain to a directory in your home directory:

 /home/youraccount/ml.example.com

or a directory in your public html directory:

 /home/youraccount/public_html/ml

.dada_files Directory Location

The .dada_files directory really needs to be created in a secure location, so if at all possible, have it created somewhere outside of your public html directory, so as to not be accessable easily via a web browser.

By default, the Dada Mail Installer tries to find your home directory and sets this directory as the location it will automatically create the .dada_files directory.

It is possible that the Dada Mail Installer will not have permissions to create the .dada_files directory in your home directory, or that it will not be able to correctly find your home directory. In this case, you will want to set another directory location.

See if there's a directory called, private, or, files or even, etc that already exists in your home directory and give the Dada Mail Installer the full, absolute path to that directory.

If those directories do not exist, see if you cannot create your own new directory, within your home directory.

Change this new directory's permissions to, 777, give the Dada Mail Installer the full, absolute path to this new directory and see if its accepted. We suggest that you reset the permissions to the new directory you created to, 755, to be less of a security problem, once the installation is complete.

Upgrading Dada Mail From Different Installation Types

Before upgrading Dada Mail, find out how you installed and configured Dada Mail before. If you don't know or aren't sure, don't upgrade Dada Mail: you will run into major headaches.

"Basic", or, "Contemporary"? (Or Simple Scripts?)

We're going to only differentiate between two types of installations: "Basic" and, "Contemporary" (If you installed Dada Mail using the included installer, you have a Contemporary installation)

Basic Installation

A, Basic installation changes the configuration variables right in the, dada/DADA/Config.pm file - usually you want to be very much aware of the following variables:

$PROGRAM_ROOT_PASSWORD
$FILES
$MAILPROG
$PROGRAM_URL

You'll know if you have a Basic installation of Dada Mail if the $FILES variable in the, dada/DADA/Config.pm file is filled out to a directory that actually exists and that directory holds files/directories that have something to do with Dada Mail.

If you are running a Basic Installation of Dada Mail, we really suggest upgrading by taking note of where your $FILES variable is located and importing the old information after a clean installation.

More Information

http://dadamailproject.com/support/documentation-8_4_0/basic_to_contemporary_installation.pod.html

Contemporary Installation

A Contemporary Installation uses an outside configuration file to set the configuration variables in.

You'll know if you have a Contemporary Installation, if those same four variables in the, dada/DADA/Config.pm file:

$PROGRAM_ROOT_PASSWORD
$FILES
$MAILPROG
$PROGRAM_URL

Are still in their default values and your Dada Mail seems to be functioning fine. This probably means that your config variables are being read from an outside config file.

For upgrade purposes, note what the, $PROGRAM_CONFIG_FILE_DIR in the, dada/DADA/Config.pm is set to. It's OK if it's only set to, auto.

Simple Scripts Installation

If you installed Dada Mail through Simple Scripts (http://simplescripts.com) you have two good choices when it comes to upgrading.

Upgrade Through Simple Scripts

Upgrade a Simple Scripts installed Dada Mail through Simple Scripts on interface (look for an "Upgrade" link, or Simple Scripts may alert you of updates).

Turn a Simple Scripts Install into a Contemporary Installation

If you want to use the included Dada Mail installer to upgrade Dada Mail (perhaps, you purchased Pro Dada?), you can turn a Simple Scripts install into a Contemporary Installation with these directions:

http://dadamailproject.com/d/upgrade_from_simple_scripts.pod.html