Registering Host Systems

Before a system can be used to host Xen or KVM instances, OpenVZ containers, Solaris Zones or Linux VServers, Cloudmin must be informed that is will be used for this purpose, and must verify that needed software and kernel support is installed. The steps to do this are similar for the various virtualization types, but they all start with the registration of the host system itself, documented on the Using Cloudmin page.

Setting up DNS

When a virtual system is created by Cloudmin, it will be assigned an IP address and a hostname. To allow this hostname to be used by other systems, it must be added to the DNS so that it can be resolved - otherwise, only the IP can be used to connect.

Fortunately, Cloudmin can make use of Webmin's BIND DNS Server module to add these DNS records automatically. For this to work, the Cloudmin master system must be running a name server, and it must have at least one DNS domain configured, as explained below :

  1. On the master system, click on the Webmin link at the top of the left menu, open the Servers category and click on BIND DNS Server.
  2. If BIND is not installed yet, Webmin will inform you and offer to automatically install it from YUM, APT or Blastwave, if your operating system supports one of those repositories. You should click on the link to install it, which if successful will return you to the BIND module.
  3. If you want to create a new DNS domain for virtual systems (recommended), click on the Create master zone link above the list of existing domains.
  4. In the Domain name / Network field, enter the new domain name. If your company's domain is yourcompany.com , we recommend a domain like xen.yourcompany.com .
  5. If the Email address field is empty, enter your email address.
  6. Click the Create button.
  7. Click the Apply Changes button below the list of domains.

Unless the Cloudmin master system is already the primary nameserver for the yourcompany.com domain, you will need to add an NS record in that domain for xen.yourcompany.com with the hostnmae of the Cloudmin master system. Using Webmin, the steps to do this are :

  1. Login to Webmin on your primary DNS server, and open the BIND DNS Server module under the Servers category.
  2. Click on your company's primary DNS domain, like yourcompany.com .
  3. Click on the Address icon.
  4. Unless the Cloudmin master system is already in your DNS, use the Add Address Record form to add it. In the Name field you could enter cloudmin, and in the Address field the IP of the Cloudmin system. Then click Create.
  5. Return to the Edit Master Zone page, and click on Name Server.
  6. In the Add Name Server Record form, enter xen.yourcompany.com for the Zone Name, and the hostname of the Cloudmin master in the Name Server field, such as cloudmin.yourcompany.com . Then click Create.
  7. Return to the main page of the BIND module, and click the Apply Changes button at the bottom of the page.

Registering a Xen Host

The steps to add a system for Xen hosting are :

  1. Make sure the system is configured for Xen as explained on the Setting up a Xen Host System page.
  2. Open the Cloudmin Settings section on the left menu, and click on Xen Host Systems.
  3. In the Add host system, select the host system from the menu and click Start Adding Host. This will bring up the new host registration page.


  4. In the Base directory for virtual systems field, enter an existing directory on the system under which Xen images will be created. This should be on a filesystem with plenty of disk space, and ideally using fast disks and/or RAID.
  5. From the Add Xen systems to DNS domain menu, select the local DNS domain to which new instances hostnames' should be added.
  6. In the textboxes next to IP address allocation range, enter the starting and ending IP addresses for a range that will be allocated to new Xen instances. These should be on the same network as the system's primary ethernet interface.
  7. Click the Register button. If Virtualmin can contact the selected system and verifies that Xen kernel support and commands are available, you will be returned to the list of Xen hosts.


Once at least one system has been registered, you will be able to create Xen instances using Cloudmin.

The steps to add a system for KVM hosting are :

  1. Make sure the system is configured for KVM as explained on the Setting Up KVM Virtualization page.
  2. Open the Cloudmin Settings section on the left menu, and click on KVM Host Systems.
  3. In the Add host system, select the host system from the menu and click Start Adding Host. This will bring up the new host registration page.


  4. In the Base directory for virtual systems field, enter an existing directory on the system under which KVM images will be created. This should be on a filesystem with plenty of disk space, and ideally using fast disks and/or RAID.
  5. From the Add KVM systems to DNS domain menu, select the local DNS domain to which new instances hostnames' should be added.
  6. In the textboxes next to IP address allocation range, enter the starting and ending IP addresses for a range that will be allocated to new Xen instances. These should be on the same network as the system's primary ethernet interface.
  7. Click the Register button. If Virtualmin can contact the selected system and verifies that Xen kernel support and commands are available, you will be returned to the list of Xen hosts.


Once at least one system has been registered, you will be able to create KVM instances using Cloudmin.

Registering a VServer Host

The steps to add a system for Linux VServers hosting are :

  1. Make sure the system is configured for VServers as explained on the Setting up a VServers Host System page.
  2. Open the Cloudmin Settings section on the left menu, and click on VServer Host Systems.
  3. In the Add host system, select the host system from the menu and click Start Adding Host. This will bring up the new host registration page.


  4. In the Base directory for virtual systems field, enter an existing directory on the system under which VServer filesystems will be created. This should be on a filesystem with plenty of disk space, and ideally using fast disks and/or RAID.
  5. From the Add VServer systems to DNS domain menu, select the local DNS domain to which new instances hostnames' should be added.
  6. In the textboxes next to IP address allocation range, enter the starting and ending IP addresses for a range that will be allocated to new VServer instances. These should be on the same network as the system's primary ethernet interface.
  7. If you will not be using Cloudmin images to create VServers, the Distribution to install on VServers field can be used to enter a distribution code like fc6 or edgy or sarge .
  8. Because VServer systems created without images are often missing important packages by default, the Packages to install on VServers section can be used to select some that you may want installed.
  9. Click the Register button. If Virtualmin can contact the selected system and verifies that VServers kernel support and commands are available, you will be returned to the list of VServers hosts.

Once at least one system has been registered, you will be able to create VServers instances using Cloudmin.

Registering a Solaris Zones Host

The steps to add a system for Zones hosting are :

  1. Open the Cloudmin Settings section on the left menu, and click on Solaris Zones Host Systems.
  2. In the Add host system, select the host system from the menu and click Start Adding Host. This will bring up the new host registration page.


  3. In the Base directory for zones field, enter an existing directory on the system under which zones filesystems will be created. This should be on a filesystem with plenty of disk space, and ideally using fast disks and/or RAID.
  4. From the Add systems in zones to DNS domain menu, select the local DNS domain to which new instances hostnames' should be added.
  5. In the textboxes next to IP address allocation range, enter the starting and ending IP addresses for a range that will be allocated to new zones. These should be on the same network as the system's primary ethernet interface.
  6. Click the Register button. If Virtualmin can contact the selected system and verifies that they run Solaris, you will be returned to the list of zones hosts.


Once at least one system has been registered, you will be able to create Solaris Zones using Cloudmin.