Install Dada Mail w/Dada Mail Installer
- Installing and Configuring Dada Mail
- Overview
- Download the Dada Mail distribution
- Download, then Upload the helper script
- Configuring Dada Mail using the Dada Mail Installer
- Do You Need to Manually Edit The, "dada/DADA/Config.pm" File?
- Making Additional Edits
- Running Dada Mail for the First Time
- Making Additional Global Configuration Changes using the Dada Mail Installer
- Command Line Interface
Installing and Configuring Dada Mail
Overview
Most of the configuration of Dada Mail is done by just filling out the form in the included Dada Mail Installer. But, before we can do that, we have to get Dada Mail on your hosting account. That involves downloading the Dada Mail distirbution, uploading it back to your hosting account (along with a helper script called uncompress_dada.cgi
), running helper script, then visiting the Installer. Let's go!
Download the Dada Mail distribution
Or, if you're a Pro Dada Subscriber,
When installing Pro Dada, use, pro_dada-9_6_1 as the name of the distribution, in these directions.
Upload the Dada Mail distribution
Once you have downloaded the Dada Mail distribution ( dada-9_6_1.tar.gz
), upload it to your hosting account.
For historical reasons, CGI scripts were usually installed in your account's cgi-bin
directory, but you may be able to install Dada Mail wherever you would like. One suggestion is to set up a subdomain (for example: lists.yourdmain.com
), then intall Dada Mail in there. That way, the URL is kept short, and there will be less potential interference between Dada Mail and any other apps you may have running (like, Wordprsss)
Download, then Upload the helper script
The helper script is called, uncompress_dada.cgi
.
Download it here, it's a small CGI Perl script - so you will want to save the source you see as a PlainText File - keep the name, uncompress_dada.cgi
.
and upload the uncompress_dada.cgi
script (PlainTest/ASCII mode - NOT binary!) to the same directory in your hosting account that you just uploaded, dada-9_6_1.tar.gz.
Change the file permissions of the helper script to, "755"
Visit the helper script in your web browser
Visiting the uncompress_dada.cgi
script should attempt to uncompress the dada-9_6_1.tar.gz distro, change the necessary permissions of various files and prep the actual installer for you to use.
Once it's finished running, you should be presented with a link to use the actual installer.
Click the link at the bottom of the screen labeled, Continue Installing and Configuring Dada Mail! to continue.
See, Prepping Dada Mail Manually if this doesn't happen and you get a message in your browser window, sort of like this:
Can't find dada-9_6_1.tar to uncompress! You may have to uncompress and prep Dada Mail manually.
Configuring Dada Mail using the Dada Mail Installer
The first screen of the installer will ask you if you'd like to Install, or Upgrade Dada Mail.
Choose, Install and click the button labeled, Continue.
A Warning Up Top?
It's possible that before you even start using the Dada Mail installer, that you'll receive a warning stating that Dada Mail won't be able to edit the, dada/DADA/Config.pm
file. This would be because there's a difference in file permissions/privileges between the user that the installer is running under and the user that owns the dada/DADA/Config.pm
file.
This means you'll need to edit one line in the dada/DADA/Config.pm
file to get Dada Mail running correctly.
".dada_files" Directory Location
The, .dada_files
directory is the directory that Dada Mail saves its global configuration file (called, .dada_config
); as well as its logs, templates and temporary files. Your mailing lists themselves will be saved in the SQL database.
For most installations, we suggest having the installer create the, .dada_files
directory in your home directory. All you'll need to do is fill out where your home directory is located.
The installer will do its best to pre-fill out its own guess for a good location for you.
Check, AUTO
If the installer has successfully selected your home directory, or you like the directory it has selected.
Check, MANUAL
(then, fill in the location you'd like) if the installer doesn't pick a good location or, you'd rather the directory be somewhere else.
See, .dada_files Directory Location for help on picking an alternative location for your .dada_files directory.
Dada Mail URL
The Dada Mail URL is simply the URL that you will access Dada Mail's, mail.cgi
file from. This form field should be filled out automatically, but if something doesn't look right, just look at the URL of the installer - for example, if the URL of the installer is:
http://example.com/cgi-bin/dada/installer/install.cgi
Your Dada Mail URL will be:
http://example.com/cgi-bin/dada/mail.cgi
If you do not like the URL of your Dada Mail installation, you will want to move your entire Dada Mail installaton, then run the Installer again at this new location. Setting this form field to where you would like your Dada Mail installer won't work the way you may hope.
Support Files Directory
Dada Mail needs a collection of static files (image files, css files, javascript files, etc) to work correctly. During configuraation, the Installer will copy over these resources to a new directory on your hosting account called, dada_mail_support_files. You will need to tell the Installer where this new directory should reside.
Unlike the .dada_files
directory, you will want to be able to access the dada_mail_support_files directory through your web browser, so make sure that you pick a publically accessable directory (a directory you can visit in your web browser).
By default, a pretty good guess is made for the location to set both the Server Absolute Path to your base Public HTML directory, as well as the Corresponding URL to access that same directory through your web browser.
If the default location looks fine, keep it as-is. If you'd like to customize/fix where this directory should live, you may do so.
Make sure That this URL and the Program URL either both domain name, or are located on the same subdomain. The following examples will work great:
- Same Domain
-
Program URL: http://example.com/cgi-bin/dada/mail.cgi
Dada Mail Support Files Dir: http://example.com/dada_mail_support_files
- Same Subdomain
-
Program URL: http://www.example.com/cgi-bin/dada/mail.cgi
Dada Mail Support Files Dir: http://www.example.com/dada_mail_support_files
- Same Subdomain
-
Program URL: http://list.example.com/cgi-bin/dada/mail.cgi
Dada Mail Support Files Dir: http://list.example.com/dada_mail_support_files
The following examples will not work well:
- Different Subdomain!
-
Program URL: http://www.example.com/cgi-bin/dada/mail.cgi
Dada Mail Support Files Dir: http://example.com/dada_mail_support_files
- Different Subdomain!
-
Program URL: http://example.com/cgi-bin/dada/mail.cgi
Dada Mail Support Files Dir: http://list.example.com/dada_mail_support_files
Dada Mail Root Password
The, Dada Mail Root Password is the main administrative password to your Dada Mail installation - choose a good, strong password. This password will be stored in a one-way encrypted form, so there will be no way to retrieve it, later on (although there are options available to reset the password later, without having to know the current password).
Dada Mail Backend
Dada Mail will need to save its mailing lists and other information in an SQL database.
Choices: MySQL, PostgreSQL or SQLite
Both MySQL and PostgreSQL will have the same features available and work under the hood, basically the same way. We recommend either equally. Most people seem to prefer MySQL - that's fine by us.
SQLite is also an option, but we recommend using it only for local testing purposes.
When you select one of the SQL backends, you'll also be asked to fill in the SQL connection information, including the database server, the port number, the name of the database itself and the username and password.
Set up this database and note its Server, Database, Username and Password. You will not need to create any tables beforehand. The SQL user will need full priviliges to your database.
For security reasons, we don't suggest giving this same user any permissions to any other database.
Database Server
The majority of the time, you'll set this to,
localhost
, unless you have specific instructions to set it to something a little different.Database
Fill this out to whatever you've called your database.
Port
By default, this is set to,
auto
. If you do not know what port your database uses, Dada Mail will take its best guess. By default, if you use MySQL, the port will be,3306
, for PostgreSQL, the port will be:5432
. Unless your database is set up different from the default configuration, these two numbers should work for the majority of people out there.Username
Fill this with the username that's associated with your database
Password
Fill this with the password associated with the username.
Test Your SQL Connection
A button labeled, Test SQL Connection is present - and when pressed, it will run a quick connection test, to see if Dada Mail can connect to your SQL server. This can help you make sure your SQL credentials for Dada Mail are working correctly.
Advanced Configuration (Optional)
As far as needed configuration settings - we're done! Dada Mail's Installer does support additional global configuration options. You can drop back into the installer later in a couple of different ways, if you would rather get up and running now.
Completing the Installation and Configuration.
Once you've filled out the form correctly, click the button labeled, Configure Dada Mail! The Installer will configure your Dada Mail. Once finished, the screen will refresh with the list of steps it has taken.
Setup the Scheduled Job (cronjobs)
For many things in Dada Mail, including making sure your mass mailings are going out correctly, you will need to set up the scheduled job.
The unique command needed to run the required jobs will be shown. More information on the scheduled job:
https://dadamailproject.com/d/features-scheduled_cronjobs.pod.html
Move the, "dada/installer" directory
Dada Mail will not start working, until you move the, dada/installer
directory out of the way. This is a security precaution, so someone else doesn't come along and attempt to reconfigure your Dada Mail!
The provided button, Move the, 'dada/installer' Directory, Disable the, 'install.cgi' script should do the trick, but if it fails (it'll let you know), you'll have to remove it manually. If you had to do the above step manually, you'll most likely have to do this step manually, too.
Do You Need to Manually Edit The, "dada/DADA/Config.pm" File?
There's a possibility, especially if you were issued the warning before filling out the configuration form, that you'll have to edit a line in the, dada/DADA/Config.pm
file. If this is the case, the installer will show you which file to look for and what to change it to.
Be careful when editing this file, as any error will stop Dada Mail from working. When saving the file and putting it back up to your hosting account, make sure to upload the file in ASCII/Plain Text mode, NOT binary!
Making Additional Edits
The installer should give you the full path to the, .dada_config
file it creates. This is the file that is written that holds your configuration that the installer just created. There's a ton of additional configuration options you can set - the installer just gets you up and running correctly.
Making additional configurations is a lot more advanced than running the Installer, so be careful when editing this file - make a backup first (for example).
Instructions on how to configure more of Dada Mail's more advanced global features can be found here:
https://dadamailproject.com/d/global_variables.pod.html
Running Dada Mail for the First Time
Once you've gotten the, dada/DADA/Config.pm
file edited (if needed) and moved the, installer
directory out of the way, it's time to begin using Dada Mail. Press the button labeled, Start Working With Dada Mail!
to begin!
Good Luck!
Making Additional Global Configuration Changes using the Dada Mail Installer
Along with Installing Dada Mail, the Dada Mail Installer can also help reconfigure the global configuration of Dada Mail, at any time in the future, after your installation.
Dada Mail comes with a plugin called, Global Configuration to make this easy. It itself can be installed using the Dada Mail installer. Once installed, it can be accessed in the List Control Panel, under, "Plugins". Make sure you have logged into a mailing list, with the Dada Mail Root Pass, as it's not available, if you log in with the List Password.
You can also re-enable the Dada Mail Installer Manually.
To do this, you will need to:
Rename the, "dada/installer-a.bunch.of.letters.and.numbers" directory back to, "dada/installer"
Change the file permission of the, "dada/installer/install.cgi" script back to, "755"
Visit the "install.cgi" script in your browser
When asked if you want to Install or, Upgrade your Dada Mail, choose, Upgrade and make sure the text box labeled, Current .dada_files Location is filled in with the correct absolute path to the parent directory that holds your .dada_files
directory. Click the button labeled, Continue..., to bring you back to the Configuration screen. Make your changes on this screen (make sure to select, Create a new .dada_config file on the top of the form).
Once you've completed your configuration changes, click the Configure Dada Mail! button as before, and follow the same directions you did during the installation, for the next screen.
Command Line Interface
An alternative command line interface is available:
https://dadamailproject.com/d/install_dada_mail_cl.pod.html