Step by step guide to ...
Setting up DMail + CWMail + NetAuth
1. For suffix based virtual domains.
2. Using NWAuth as your external authentication module.
Pick one domain to be your 'main' domain on the email server. In all examples below this will be main.domain.com
Install and then check each of the products for just this one domain, as per the detailed instructions below. Be sure to do it in the order in which they appear, i.e. starting with DMail.
(I'll complete this step later as you seem to have already done it)
see the manual for the installation instructions.
Things to note:
i)We recommend that you set authent_domain to true in dmail.conf and then restart the servers before adding any users.
Things to check/test once you think that it is working:
i)Add a test user. Remember to add the user as email@example.com rather than just 'bob' if you have authent_domain set to true.
Windows users use DMAdmin.
UNIX users enter the following 3 lines,
set firstname.lastname@example.org pass
ii)Check that the user was added correctly by one of the following methods.
1. DMAdmin - do a search for the letter b
2. Run NWAuth as above for UNIX and use the check
command. Here is an example for NT users,
check email@example.com pass
3.Look in the user database file, nwauth.add (or
nwauth.txt) to see that the user is there.
iii)Send in a message to that user with a normal email client by setting the SMTP server that it uses to the ip address of DSMTP . Then try looking for the drop file in the drop_path directory and opening it with a text editor.
iv)Use a normal email client to try to read the message by pointing it at DPOP.
b) CWMail ...
c) NetAuth ...
Gotcha - if authent_domain true and external authentication fails first host_domain
setting and/or dpop_host setting is actual machine
name rather than resolvable main domain of the email server.
Add a virtual domain to DMail and check that you can email a
user on that domain.
1. add a vdomain line to dmail.conf. Here is an example for the
suffix based virtual domain, netwinsite.com
vdomain nw @netwinsite.com netwinsite.com c:\dmail\in\netwin
nw is the prefix for the netwinsite virtual domain - this is put on
the start of drop files for this domain.
@netwinsite.com is the suffix for this domain, so user bob
MUST log in with the username firstname.lastname@example.org in order for
DPOP to work out that he belongs to the netwinsite virtual domain.
c:\dmail\in\netwin is the drop_path for the NetWin virtual domain,
i.e. where you will find all drop files for users on the NetWin virtual
domain. (on UNIX it would probably look like, /var/spool/mail/netwin)
2. In order to make the vdomain line take affect, you MUST stop and
restart both DSMTP and DPOP, so
Windows users use the 'stop all' and 'start all' buttons on
UNIX users enter the following,
3. Add a user to your user database on this virtual domain.
UNIX users enter,
set email@example.com pass
4. send a message to this user using a normal email client by
pointing it at the ip address of DSMTP. Address the message to,
5. try to read this message using a normal email client by
pointing it at the IP address of DPOP. Remember that you MUST
make the username, firstname.lastname@example.org
Add the virtual domain to CWMail and then test CWMail.
1. Edit cwmail.ini in your web servers CGI (or scripts) directory
and add the following to the BOTTOM.
NOTE: this assumes that the user on this virtual domain uses
the a URL starting http://www.netwinsite.com to access
2. now test connecting to http://www.netwinsite.com/x/cwmail.y
where x is the relative path on your web server and y is the
CGI's ending (.exe on windows platforms and .cgi on UNIX
3. log in as the test user, with just the username 'test' (cwmail
should see the suffix setting and add @netwinsite.com onto the
end before sending it on to dpop).
4. Send a message from the test user to the test user.
Add the virtual domain to NetAuth and test that you can add
another test user to the virtual domain.
1. Edit netauth.ini in your web servers CGI (or scripts) directory
and add the following to the BOTTOM.
NOTE: this assumes that the user on this virtual domain uses a
URL starting http://www.netwinsite.com to access NetAuth.
2. Point your browser at the NetAuth page with the URL starting
3. Add a user to this virtual domain, by entering their name as
test2 (and supplying a password).
NOTE: you will still have to provide your administrator password
in the same form as the other domain, i.e. with the domain on the
end, e.g. email@example.com
4. See if you can log on to DPOP as this user using a normal
. . .