THE VIRTUAL SERVER HANDBOOK

Creating E mail Address

Mappings or Virtmaps

Address mappings, or "Virtmaps," are similar to aliases but are tailored to

virtual domain names.  Virtual servers that have one or more domain names

associated with them in addition to their primary domain name use virtmaps

to organize their aliases.

Aliases do not incorporate information about the hostname portion of an E 

mail address, just the username portion. As a result, clashes occur when two

virtual domains have E mail addresses with identical username portions,

such as "webmaster". Virtual E mail address mappings are designed to

avoid these clashes ensuring that mail sent to "webmaster@domain1.com"

and mail sent to "webmaster@domain2.com" do not collide, even though

both domain names ("domain1.com" and "domain2.com") are associated

with the same virtual server.

To create a simple address mapping

1.

From your virtual server 

~/etc/virtmaps

 file, enter

address recipient

(where "address" is replaced with the full address you would like to

route to and "recipient" is replaced with the recipient address)

2.

From the command prompt, enter 

vnewvirtmaps

. This action

recreates the 

~/etc/virtmaps.db

 file so the changes take effect.

Sample 

virtmaps

 file

In the following sample virtmaps file, the address mappings are grouped

together by domain name. The first address mapping in the abc.com group

is redirecting mail to a non local user. The second address mapping is

directing mail to a local user.

#abc.com mappings

bob@abc.com

bob@aol.com

webmaster@abc.com

carol

#xyz.com mappings

bob@xyz.com

bob

webmaster@xyz.com

john

Note:  Unlike the ~/etc/aliases file, there is no colon character between

the address and the recipient in the ~/etc/virtmaps file.

Using Wildcard Mappings

A wildcard address mapping serves as a "catch all" that matches any

address at a hostname that is not already explicitly listed

COPYRIGHT 

 1999  DIGITAL TOOLS  LLC.

73