Installation

INSTALLING DWmail manually

The manual setup mode has two options... guided setup mode and manual mode.

Guided Setup Mode

  1. Unzip (using your favourite zip software, such as WinZip) the files and place them in their respective directories. You do not need to keep the root directory called dwmail however.

  2. Upload the files using your favourity FTP tool to your server using the same directory structures as defined from the zip file.

    Upload in BINARY format the following files and types
    - All .jpg files
    - All .png files
    - All .gif files

  3. Upload in ASCII format the following files and types
    - All .txt files
    - All .php files
    - All .inc.php files
    - All .tpl files in the ./templates directory
    - All .css files
    - All .js files

  4. Run the file guidedsetup.php in the install directory from your web browser e.g. if you installed DWmail at http://www.domain.com/dwmail/ point your browser to http://www.domain.com/dwmail/install/

  5. The guided setup screen will ask to validate your license information. The license information was sent to your with your download details and is also available from the download area. Enter your license number, tick the 'I accept the license agreement' box and click the 'Validate DWmail' button. If your webserver cannot connect via port 80 e.g. it might be behind a proxy, then you won't be able to use guided mode.



  6. If your license was successfully validated you will now be presented with the main setup menu. For a new installation we are only interested in the first section. Here we have: Stage 1 - Check server dependencies, Stage 2 - Install the DWmail database and Stage 3 - Choose an admin username and password.



    Click on the Stage 1 link

  7. Stage 1 is to check that your server has the dependencies necessary to run DWmail. The screen below is similar to what you should see if the dependency check was passed, you can then click on the 'Install Database' button.



  8. DWmail supports three types of databases. The installer will first check which types your installation of PHP supports. You should use only one of these and set the database settings in config.inc.php to match. You can use MySQL, MySQLi (for PHP5+ and MySQL 4.1+) and PostgreSQL. Click on the relevant button for the type you wish to install.

  9. Once you have either saved or download (and re-uploaded) the new configuration you can proceed to install the database. If your database connection settings are not correct you will not be able to proceed, so you will then need to check your database connection details and edit config.inc.php with the correct ones.

    However if your database settings are correct you will see something similar to that below. Press the 'Initialise Database' button to install.



  10. If the database install was successful you will see a screen similar to below



  11. After installing the database, you will then be prompted to add default data to the database.

  12. The final stage will now be to create a user account to access the administration area with.



  13. Your installation is now complete. You should now delete the install and test directories (note if you have a support request you should leave the test directory in place for the support staff can help diagnose the problem). You will now want to configure DWmail. You can do this, using the admin account you just created and by pointing your web browser to the admin directory e.g. http://www.yourdomain.com/dwmail/admin/

Upgrading from a previous version of DWmail

IMPORTANT: Before upgrading from any version make sure you have a backup to your configuration file and any changes you may have made to the template or source code as they will be overwritten when you upload the new version.

a) To upgrade from version 1.x or 2.x to version 4.2

To upgrade your version of DWmail to 4.2 simply upload the files and make any changes you have previously done to your templates and configuration files.

Due to large scale changes many of the templates and config settings have changed.

b) To upgrade from version 3.0.x-4.1.x to version 4.2

To upgrade to version 4.2 you must upload all templates, configuration and script files. This means you will have to make any customisations to the source code or templates again as there have been many changes to the default templates and large scale changes made to the configuration files.

Before you run DWmail you must upgrade the database by running the file 'guidedsetup.php' in the install directory and following the on screen instructions

Configuration for different uses

To use DWmail for different purposes you will need to make certain changes to the configuration settings in the administration area.

To use DWmail in 'local' mode

Common Installation Issues