Installation
INSTALLING DWmail manually
The manual setup mode has two options... guided setup mode and manual mode.
Guided Setup Mode
- 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.
- 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
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
- 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/
- 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.
- 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
- 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.
- 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.
- 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.
- If the database install was successful you will see a screen similar to below
- After installing the database, you will then be prompted to add default data to the database.
- The final stage will now be to create a user account to access the administration area with.
- 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
- If you wish to use DWmail solely for checking email accounts on your OWN
server rather than allowing the public the access email accounts from anywhere
on the Internet we have supplied a default configuration file to set DWmail
to 'local' mode (as opposed to 'remote' mode)
- Set 'DWmail Mode' to 'local mode'
- Set the 'Default Server' to your desired IMAP or POP3 server
- If your server requires your full email address as a username set 'User full email address as username'
to enabled
- We recommend using SMTP, if possible, for local mode, so set 'Use SMTP' to
enabled
- Set your 'SMTP Server' (if you enable SMTP) to your SMTP server name
Common Installation Issues