Version 9 (modified by aydan, 10 years ago)

--

Before you can use the Xen Zfs handler, it must be customized for your installation. In particular, the handler must know which disk and kernel images to use when instantiating a virtual machine. The current version supports multiple disk images but requires that all of them share the same kernel image.

The kernel and disk images are controlled by a property file inside the xen zfs handler. You will need to check out the handler from the repository and make the following changes.

svn co https://geni-orca.renci.org/svn/orca/handlers/standard[trunk or the tag/branch you need] handler

cd handler/resources/handlers/standard/xen/zfs

touch user.properties

The last line creates an empty file called user.properties. This file overrides properties contained in build.properties (in the same directory). In particular, the properties that you need to override are:

  • unit.os.kernel - path to the kernel image to use. The path is relative to the software sub-directory within the installation directory of the Xen driver on each Xen VMM. You can also add an absolute path, but it should refer to a valid location on each Xen VMM. See this page for instructions how to deploy your kernel image to each Xen VMM.
  • image.guid - guid of the default vm image. See this page for information about preparing an image to be used with the system
  • vm.ssh.key - ssh private key to be used by the Xen driver to detect that a VM has completed booting. The location of the file is relative to the keys sub-directory within the installation directory of the Xen driver on each Xen VMM. See this page for instructions how to add your probe key to the xen driver's installation package.

For our setup at RENCI/Duke, this file should look something like this:

###################################
# Kernel-related properties
###################################

# Name of the kernel file
unit.os.kernel=vmlinuz-2.6.18-nfsroot

###################################
# Default Values
###################################

# Default image guid
image.guid=b24aa725-f142-4c19-8e22-998bbf483f6a

# ssh key to use to determine when the vm has finished booting
vm.ssh.key=orca_rsa

To complete the customization, you need to package the handler and install it to your local maven repository:

mvn install