FreeVSD 'mod_bind' HOWTO
========================

This HOWTO explains how to incorporate 'mod_bind' on virtual
servers. You should read this document before installing and using
'mod_bind'. To understand about other areas of freeVSD, refer to the
following documentation contained in the documentation set:

user-guide.txt		details of the installation and administration of 
			freeVSD and virtual servers

security.txt		notes about freeVSD security issues
		
protocol.txt		detailed information on the freeVSD protocol

faq.txt			frequently asked questions on freeVSD

HOWTOquotas.txt		a short HOWTO on enabling quotas in freeVSD

NEWS			list of developments in the current version as well
			as past versions of freeVSD

README			essential information about freeVSD
INSTALL			generic installation notes

1. Defining 'mod_bind'
---------------------

'mod_bind' is a module in freeVSD system that allows the management of
name servers in virtual servers. With 'mod bind', the 'admin' user of
a virtual server can add and delete domain names, as well as handle
zone file settings through a virtual server  administration tool.

2. Installation Prerequisites
-----------------------------

'mod_bind' is used in a production environment such as an ISP. Before
installing 'mod_bind' on your virtual server, you need to have met the
following conditions:

 - a fully configured DNS server running freeVSD

 - the '/etc/named.conf' configuration file on your DNS server

 - a Red Hat hosting server with freeVSD

NOTE: For details on configuring DNS, the following HOWTO document
provides background information:

http://www.linuxdoc.org/HOWTO/DNS-HOWTO-2.html

3. Installing 'mod_bind' on a virtual server
--------------------------------------------

1.  Make sure that you are in the freeVSD hosting server.

2.  Enter the name of the DNS server running freeVSD under the 
    'PrimaryNS' entry in the <Global> section of the vsd configuration
    file.
	
NOTE:  An example host name entry is 'serverone'.

3.  Enter the host name and IP address in the '/etc/hosts' file.

4.  Create your virtual servers by entering the following commands on the 
    hosting server: 

        $ vsdadm vs_create <host name> <virtual server name> 
	  <IP address>  <FQDN> <numid> <quota>

	$ vsdadm vsd-vsbatch.pl

5.  Include the following line at the end of the /etc/named.conf file 
    on the DNS server. 

        include "/var/named/named.conf";

    This points the name server to the named.conf file created by 
    'mod_bind'.
			     		
6.  If the name server database is running, restart your name server. 

7.  To add the virtual server information to the name server, enter the
    following command on the host server:

       $ vsdadm bind_addvs <Name Server FQDN> <virtual server name>
         <virtual server IP address> <maximum number of domains>

8.  Start the virtual server so that a client can connect to it and
    add name server entries.


	$ vsboot --start

    Once these steps are complete, you are ready to perform
    further name server operations on your virtual server.