Step by step guide to ...

Setting up DMail + CWMail + NetAuth

1. For suffix based virtual domains.
2. Using NWAuth as your external authentication module.

Step 1 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) a) DMail 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 bob@main.domain.com rather than just 'bob' if you have authent_domain set to true. Windows users use DMAdmin. UNIX users enter the following 3 lines, /usr/local/dmail set bob@main.domain.com pass quit 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, c:\dmail\nwauth check bob@main.domain.com pass quit 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. Step 2: 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 where, 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 bob@netwinsite.com 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 DMAdmin UNIX users enter the following, tellsmtp shutdown tellpop shutdown /usr/local/dmail/dm_start.sh /usr/local/dmail/dpop_start.sh 3. Add a user to your user database on this virtual domain. UNIX users enter, /usr/local/dmail/nwauth set test@netwinsite.com pass quit 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, test@netwinsite.com 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, test@netwinsite.com Step 3 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. vhost www.netwinsite.com suffix @netwinsite.com vend NOTE: this assumes that the user on this virtual domain uses the a URL starting http://www.netwinsite.com to access CWMail. 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 platforms) 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. Step 4 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. vhost www.netwinsite.com domain netwinsite.com domain_seperator @ suffix netwinsite.com suffix_seperator @ vend 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 http://www.netwinsite.com... 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. admin@main.domain.com 4. See if you can log on to DPOP as this user using a normal email client.



Page Section

. . .