4. How Do I set it up?

4.1. Create the New Account

Create a regular Linux account for the virtual customer with home directory and mail.

4.2. NCSA 1.5 or Apache Config Files

Virtual Host implementations are still changing. A few patches exist to support Virtual Host Check the server's release notes for more details. NCSA 1.5 or Apache now include the Virtual patches, and I have been told that Spinner supports virtual hosts.

One virtual patch supports the following srm.conf syntax, however the second NCSA 1.5 method of defining a Virtual host allows for greater flexibility

SubDocumentRoot www.domain1.com /usr/local/etc/httpd/docs/domain1
SubDocumentRoot www.domain2.com /usr/local/etc/httpd/docs/domain2

NCSA and Apache support the following httpd.conf syntax:

ServerAdmin webmaster@domain1.com
DocumentRoot /usr/local/etc/httpda/docs/domain1
ServerName www.domain1.com
ErrorLog logs/errors.domain1.com
TransferLog logs/access_log.domain1.com

4.3. Configuring the interface

Once the IPalias patches have been installed add the following to your /etc/rc.d/rc.local on your local web server.

/sbin/ifconfig eth0 alias www.domain1.com
/sbin/ifconfig eth0 alias www.domain2.com
/sbin/ifconfig eth0 alias www.domainN.com

4.4. Registering with Internic

If you are setting up a new domain or change a current domain, you must register the domain with Internic. The template can be found at ftp://rs.internic.net/templates/domain-template.txt

4.5. Configuring Named

Named will need to be configured so that your virtual domain will be visible to the outside world. I don't claim to be an expert on DNS. Suggestions always welcome.

4.5.1. Example /etc/named.boot

directory /etc/named.data
primary           realdomain.com                  db.realdomain.com
primary           xxx.xxx.xxx.IN-ADDR.ARPA        db.xxx.xxx.xxx
primary           0.0.127.IN-ADDR.ARPA            db.local

primary           domain1.com                     db.domain1.com
primary           domain2.com                     db.domain2.com
cache             .                               named.root

Note

Replace x with your IP.

4.5.2. Example /etc/named.data/db.domain1.com

$ORIGIN com.
  domain1    IN      SOA     domain1.com. hostmaster.domain1.com. (
             10134 43200 3600 604800 86400 )
             IN      NS      ns1.realdomain.com.
             IN      MX      10 mail.realdomain.com.
             IN      MX      0 domain1.com.
domain1.com. IN      A       xxx.xxx.xxx.xxx    ;www.domain1.com IP

  $ORIGIN domain1.com.
  ftp        IN      CNAME   domain1.com.
  www        IN      CNAME   domain1.com.
  mail       IN      CNAME   domain1.com.

4.5.3. Example /etc/named.data/db.xxx.xxx.xxx

You should already have a db.xxx.xxx.xxx for your current site update it to contain the new virtual domains for reverse lookups

xx              IN      PTR     www.domain1.com.
xx              IN      PTR     www.domain2.com.

4.5.4. Restart named

Once you've finished editing config files, you will need to restart the named daemon.

4.6. Virtual Mail

Your virtual customers will more than likely want the ability to have mail that is sent to their domain forwarded to another domain. A few sendmail.cf changes will do the trick. After several months of trying different sendmail changes, this is the 1st method that I found that works and requires only one sendmail.cf change for each new virtual site.

4.6.1. Sendmail Configuration

  1. Retrieve the current version of sendmail that contains makemap btree support.

  2. Create a file called /etc/domainalias with the following mappings:

    *@domain1.com           localnet@realdomain.com
    *@domain2.com           townplaz@realdomain.com
    *@domainN.com           soracomp@realdomain.net
    
    webmaster@domain1.com   somuser@anotherhost.com
    jamison@domain2.com     anotheruser@somehost.com

  3. Create the maped DB file

    makemap btree /etc/domainalias.db  < /etc/domainalias

  4. /etc/sendmail.cf changes:

    1. Add a Cw record for each new virtual host

      Cwdomain1.com
      Cwdomain2.com

    2. Add the domainalias mapping only once.

      Kdomainalias btree /etc/domainalias.db

    3. Add/Change Ruleset 98

      ###################################################################
      ###  Ruleset 98 -- local part of ruleset zero (can be null)     ###
      ###################################################################
      
      S98
      
      R$+ < $+ . >          $1 < $2 >                         remove trailing dots
      R$+ < $+ >            $: < > $(domainalias $1$2 $)      match user@address
      R< > $+ @ $*          $: < $1 > $(domainalias * @ $2 $) match *@address
      R< $+ > * $*          $: < > $1 $2                      replace * with userid
      R < $+ > $+           $: < > $2                         bugfix
      R< > $*               $: $>3 $1                         and rewrite using S3

  5. Sendmail Testing

    Test the sendmail configuration to verify the new sendmail.cf changes

    sendmail -v -bv info@domain1.com

    The final destination should be displayed.

4.7. Virtual FTP

Currently, I have not been able to get Virtual FTP to work. A few patches exist, and I'm sure a working patch exist. We just create a working directory /home/ftp/business/domain1, but a true Virtual FTP would be nice.

If anyone would like to contribute a solution, I would be more than happy to add it here.

Arnt Gulbrandsen has rewritten ftpd and has included support for independent FTP services The Troll Tech FTP Daemon