DMAILWEB Installation and Upgrade instructions

# DMailWeb

# - A great way to provide all your users with full web access to their email - anywhere, anytime.

### | Overview | Features | FREE Evaluation | Prices & Support | Example | Installation Guide-Manual | FAQ

### DMailWeb - in brief

Many users need, and almost all users want, access to their email regardless of where they happen to be. DMailWeb allows you to offer this important service easily to ALL your users by providing a simple easy to use web interface, allowing them access to their email from anywhere, at anytime.

DMailWeb is a web to mail gateway, it gives your users/customers direct access to their new mail folder using any web browser from anywhere in the world. DMailWeb allows users to read, reply to and delete their mail, send new mail messages (with attachments) and forward messages intact to others from anywhere. A critical feature of DMailWeb is that the messages may be left available on the server. This means, for example, your users can answer their email at home or when away on a business but still download and file off messages when they return to work in their normal manner with their own client software.

#### DMailWeb Features and Benefits

#### DMailWeb provides the same features you would expect to see in any good mail client. Being Web based it provides a number of advantages that make it popular with users:

1. Provides all users full access to their email from anywhere anytime
2. Smooth integration with current email system, users can use both systems at once.
3. Easy installation
4. Images are viewable in mail messages. Non image attachments can be easily downloaded.
5. MIME support for both incoming and outgoing email
6. Files can be attached to outgoing mail messages
7. A pick list of recent addresses is provided to simplify sending email
8. Templates are used for all pages so you can totally customize the look and feel, this includes the ability to add your own advertising etc...

How it Works

DMailWeb works by interacting with your POP server, this means you can configure it to use your current mail system in a matter of minutes. It also means that messages read via this gateway are still available to be downloaded into your user's normal email system.

### Prices and Support

### To allow you to evaluate DMailWeb you may use it for one month without charge. At the end of this evaluation period you must register your copy of the software and purchase a license, or stop using it.

DMAILWEB will work with any mail server software and is available at the following price. (Please check our prices page for full list of products and bundles and current prices.)

License | Users | Price
DMailWeb Unlimited User License with 12 months standard email support and upgrades. | No Limit | US$485
Bundles |  |
DMail (including DSMTP, DList and DPOP) and DMailWeb Unlimited User Licenses with 12 months standard email support and upgrades. | No Limit | US$695
DNEWS, DMail (including DSMTP, DList and DPOP) and DMailWeb Unlimited User Licenses with 12 months standard email support and upgrades. | 0-5 Users | US$225
DNEWS, DMail (including DSMTP, DList and DPOP) and DMailWeb Unlimited User Licenses with 12 months standard email support and upgrades. | 5-20 Users | US$485
DNEWS, DMail (including DSMTP, DList and DPOP) and DMailWeb Unlimited User Licenses with 12 months standard email support and upgrades. | No Limit | US$1095

### How do I register?

To register DMailWeb, first install it on your machine, then use the DMailWeb url with ?cmd=register added e.g. let's assume you access it normally with a web address like this:

    	http://your.domain.name/cgi-bin/dmailweb.exe

Then to register your copy type in this URL in your web browser.

    	http://your.domain.name/cgi-bin/dmailweb.exe?cmd=register

Then answer the questions and your registration info will be emailed to NetWin. We will email you a registration key back in 1-2 days.

| If you would like to show that your site uses DMailWeb please use this GIF file on your web site. If you have any questions please send email to netwin@netwinsite.com.

### Complimentary Support and Upgrades

Netwin provides 12 months standard email support and 12 months upgrades for no charge.

To extend support or take advantage of new upgrades beyond the complimentary period the following support or upgrade insurance options are available.

Support and Upgrade Options | Price
12 Months Upgrade Insurance (no support) | US$160
12 Months Standard Email Support and Upgrades | US$320

## DMailWeb Installation

DMailWeb is easy to install and it takes only a few minutes to have it up and running on your site. You must install DMailWeb on your WEB server, in a directory that you have already setup on your server as containing CGI programs. You should read your server documentation if you don't currently know how to setup a cgi program, typically you would copy the files to a directory like:

    SERVER_ROOT\cgi-bin\

And you also need to copy all the template files to a directory on your system, it can be anywhere as long as you define the templates variable in dmailweb.ini to point to the same directory, e.g.

On NT

    	mkdir \unzip		# Create a temporary directory
    	cd \unzip		# cd to it
    	dmailweb10.exe		# Unzip the self extracting archive
    	copy *.* \dmailweb	# Copy the templates to destination
    	copy dmailweb.exe \SERVER_ROOT\cgi-bin
    	copy dmailweb.ini \SERVER_ROOT\cgi-bin

On UNIX

    	uncompress dmailweb10.tar.Z
    	tar -xvf dmailweb10.tar
    	cd dmailweb
    	cp * /usr/web/dmailweb
    	copy dmailweb /SERVER_ROOT/cgi-bin
    	copy dmailweb.ini /SERVER_ROOT/cgi-bin

Now edit dmailweb.ini and define the following four things:

    notepad \SERVER_ROOT\cgi-bin\dmailweb.ini

Symbol | Example | Explanation
pophost | pop.your.domain | The name or IP number of your POP server
templates | c:/dmailweb | The directory where you have copied the *.tpl files
smtphost | mail.your.domain | Your local smtp host, by name or number
domain | acme.com | Your domain, this will be used to construct email addresses

### Changing the look of DMailWeb

DMailWeb is designed to allow you to customize the look as little or as much as you like. If you wish, you can tailor the template files to give DMailWeb the same look and feel as your own web pages. It is assumed you know how to edit raw HTML files, in addition there are some variables that you can use. The list of variables depends on which page DMailWeb is showing. For example the `%%h_subject%%` variable only works when displaying an item, or directory listing.

Here is a list of the template files, and a brief description of each.

File Name | Description
login.tpl | The first page shown when dmailweb is run, this handles the user login
list.tpl | A list of new mail messages
item.tpl | A single mail item
send.tpl | Sending a new mail messages
sent.tpl | Confirmation message when a message has been sent
forward.tpl | Forwarding one or more messages
error.tpl | Used to display any error messages

### Template Variables

Here is a list of some of the variables that you can use in these templates

Variable | Description | Typicall in
%%begin_list%% | Starts list of new mail messages | list.tpl
%%end_list%% | Ends list of new items | list.tpl
%%ifdef%%var%% | Conditional inclusion if variable is defined |
%%b_follow%% | Goes to form for posting followup messages | item.tpl
%%b_item%% | Show a specific mail message | list.tpl
%%b_next%% | Next mail message | item.tpl
%%b_prev%% | Previous mail message | item.tpl
%%h_subject%% | The subject for a given mail message | list.tpl,item.tpl
%%h_date%% | The date for a given item | items.tpl
%%h_from%% | The email address of the person who sent the message | list.tpl
%%h_lines%% | The number of lines in this message | list.tpl
%%include%%file%% | Reads the named file in, (it cannot contain variables) |

### %%include%%advert.htm%%

Useful for displaying adverts, you would setup a cron job (or program that runs every 10 minutes) to change the advert file, thus displaying a new advert each time someone reads their mail.

### DMAILWEB.INI settings

Symbol | Example | Default | Explanation
pophost | pop.your.domain | this host | The name or number of your POP mail server
smtphost | mail.your.domain | this host | The name or number of your SMTP server
templates | c:/dmailweb | NONE | The directory where you have copied the *.tpl files
debug | True | false | Enables verbose debug output.
smtphost | mail.your.domain | this host | The name or ip number of your SMTP mail gateway
log_file | c:/dmailweb | ini dir | Directory to store the log file
content_type | text/x-html | text/html | HTML Mime content type, some servers allow 'special' features for documents with a modified type.
key | 2222-333-44-222 | 1 month | Registration key
domain | acme.com | this host | Used to create the email from address for each user
port | 2110 | 110 | TCPIP port of pop server
cgi_path | /cgi-bin/dmailweb.cgi | env var | Occasionally needed to tell dmailweb where it is
send_wrap | 90 | 75 | Where to wrap long lines when sending a message
read_wrap | 60 | 85 | Where to wrap logn lines in displayed messages

### Frequently Asked Quesetions

#### Why do I get the error "user token not available"

This error occurs on IE3 due to a fault in the templates originally provided with DMailWeb. Go thru all your template files and move the <form...> line BELOW the <body...> line, this will fix it.

#### Why does it say 'user limit reached'

This was a fault in the early versions of DMailWeb, upgrade to the latest one on our site and it will fix this error.

#### How do I register?

See the section on prices above and it gives details on registering.

Products | Downloads | Prices | Support | Company
--- | --- | --- | --- | ---