Enabling virtual domains

To enable virtual domains on your system you must go through three steps:

1. Add an IP alias to TCP.

   This step does not have a GUI interface, and needs a shell prompt as root.

   1. Add an IP alias to your machine as follows:
      
      ifconfig interface alias address netmask mask broadcast address

      The interface name is obtained by running ifconfig -a. See the ifconfig(1Mtcp) manual page for details.

      For example:
      
      ifconfig net0 alias 132.147.193.68 netmask 255.255.255.0 broadcast 132.147.193.255

   2. To remove an IP alias type:
      
      ifconfig net0 -alias address

      For example:
      
      ifconfig net0 -alias 132.147.193.68

   Note that ifconfig aliases do not persist after a reboot, so you must add a script in /etc/rc2.d named S70ipalias that contains the ifconfig line you generated.

2. Enable the virtual domain (multihome) channel using the Mail Manager, as follows:

   1. Start the Mail Manager (as described in ``Starting up the Mail Manager'').

   2. Use the Settings menu and either click on the desired channel, or else highlight the channel, and click on the Enable/disable button.

   3. Save changes and exit.

3. Add physical users to the virtual domain using the Virtual Domain User Manager.

   Full details of how to start the manager are given in ``Starting up the Virtual Domain User Manager''. In order for the manager to work, the IP alias you configured must first be assigned a domain name in DNS.

   Each virtual user is really an alias to a normal system user. This means that system users can be exported into multiple virtual domains under multiple aliases. Virtual user names must be unique within each virtual domain, as system users must be unique within the physical domain. No other restrictions are applied.

   Full details of how to export users into virtual domains are given in ``Exporting a user into a virtual domain''.