mirror of
https://github.com/xen-project/xen.git
synced 2026-10-28 02:01:24 +01:00
entries in vif to guide the configuration. This is much less confusing. Closes bug #440. Change the example configuration files to match. Also change them to use the XenSource OUI in the MAC addresses. Also change xm-test to match. Remove the obsolete ipaddr configuration entry, and the backend_mac vif config option. Remove the preprocess_vifs function, folding it into the configure_vifs function, and creating a simple comma_sep_kv_to_dict helper. Remove the configure_vfr method, as it is unused. Signed-off-by: Ewan Mellor <ewan@xensource.com>
177 lines
6.2 KiB
Python
177 lines
6.2 KiB
Python
# -*- mode: python; -*-
|
|
#============================================================================
|
|
# Example Python setup script for 'xm create'.
|
|
# This script sets the parameters used when a domain is created using 'xm create'.
|
|
#
|
|
# This is a relatively advanced script that uses a parameter, vmid, to control
|
|
# the settings. So this script can be used to start a set of domains by
|
|
# setting the vmid parameter on the 'xm create' command line. For example:
|
|
#
|
|
# xm create vmid=1
|
|
# xm create vmid=2
|
|
# xm create vmid=3
|
|
#
|
|
# The vmid is purely a script variable, and has no effect on the the domain
|
|
# id assigned to the new domain.
|
|
#============================================================================
|
|
|
|
# Define script variables here.
|
|
# xm_vars is defined automatically, use xm_vars.var() to define a variable.
|
|
|
|
# This function checks that 'vmid' has been given a valid value.
|
|
# It is called automatically by 'xm create'.
|
|
def vmid_check(var, val):
|
|
val = int(val)
|
|
if val <= 0:
|
|
raise ValueError
|
|
return val
|
|
|
|
# Define the 'vmid' variable so that 'xm create' knows about it.
|
|
xm_vars.var('vmid',
|
|
use="Virtual machine id. Integer greater than 0.",
|
|
check=vmid_check)
|
|
|
|
# Check the defined variables have valid values..
|
|
xm_vars.check()
|
|
|
|
#----------------------------------------------------------------------------
|
|
# Kernel image file.
|
|
kernel = "/boot/vmlinuz-2.6.10-xenU"
|
|
|
|
# Optional ramdisk.
|
|
#ramdisk = "/boot/initrd.gz"
|
|
|
|
# The domain build function. Default is 'linux'.
|
|
#builder='linux'
|
|
|
|
# Initial memory allocation (in megabytes) for the new domain.
|
|
memory = 64
|
|
|
|
# A name for the new domain. All domains have to have different names,
|
|
# so we use the vmid to create a name.
|
|
name = "VM%d" % vmid
|
|
|
|
# List of which CPUS this domain is allowed to use, default Xen picks
|
|
#cpus = "" # leave to Xen to pick
|
|
#cpus = "0" # all vcpus run on CPU0
|
|
#cpus = "0-3,5,^1" # run on cpus 0,2,3,5
|
|
#cpus = "%s" % vmid # set based on vmid (mod number of CPUs)
|
|
|
|
# Number of Virtual CPUS to use, default is 1
|
|
#vcpus = 1
|
|
vcpus = 4 # make your domain a 4-way
|
|
|
|
#----------------------------------------------------------------------------
|
|
# Define network interfaces.
|
|
|
|
# By default, no network interfaces are configured. You may have one created
|
|
# with sensible defaults using an empty vif clause:
|
|
#
|
|
# vif = [ '' ]
|
|
#
|
|
# or optionally override backend, bridge, ip, mac, script, type, or vifname:
|
|
#
|
|
# vif = [ 'mac=00:16:3e:00:00:11, bridge=xenbr0' ]
|
|
#
|
|
# or more than one interface may be configured:
|
|
#
|
|
# vif = [ '', 'bridge=xenbr1' ]
|
|
|
|
vif = [ '' ]
|
|
|
|
#----------------------------------------------------------------------------
|
|
# Define the disk devices you want the domain to have access to, and
|
|
# what you want them accessible as.
|
|
# Each disk entry is of the form phy:UNAME,DEV,MODE
|
|
# where UNAME is the device, DEV is the device name the domain will see,
|
|
# and MODE is r for read-only, w for read-write.
|
|
|
|
# This makes the disk device depend on the vmid - assuming
|
|
# that devices sda7, sda8 etc. exist. The device is exported
|
|
# to all domains as sda1.
|
|
# All domains get sda6 read-only (to use for /usr, see below).
|
|
disk = [ 'phy:sda%d,sda1,w' % (7+vmid),
|
|
'phy:sda6,sda6,r' ]
|
|
|
|
#----------------------------------------------------------------------------
|
|
# Define to which TPM instance the user domain should communicate.
|
|
# The vtpm entry is of the form 'instance=INSTANCE,backend=DOM'
|
|
# where INSTANCE indicates the instance number of the TPM the VM
|
|
# should be talking to and DOM provides the domain where the backend
|
|
# is located.
|
|
# Note that no two virtual machines should try to connect to the same
|
|
# TPM instance. The handling of all TPM instances does require
|
|
# some management effort in so far that VM configration files (and thus
|
|
# a VM) should be associated with a TPM instance throughout the lifetime
|
|
# of the VM / VM configuration file. The instance number must be
|
|
# greater or equal to 1.
|
|
#vtpm = ['instance=%d,backend=0' % (vmid) ]
|
|
|
|
#----------------------------------------------------------------------------
|
|
# Set the kernel command line for the new domain.
|
|
# You only need to define the IP parameters and hostname if the domain's
|
|
# IP config doesn't, e.g. in ifcfg-eth0 or via DHCP.
|
|
# You can use 'extra' to set the runlevel and custom environment
|
|
# variables used by custom rc scripts (e.g. VMID=, usr= ).
|
|
|
|
# Set if you want dhcp to allocate the IP address.
|
|
#dhcp="dhcp"
|
|
# Set netmask.
|
|
#netmask=
|
|
# Set default gateway.
|
|
#gateway=
|
|
# Set the hostname.
|
|
#hostname= "vm%d" % vmid
|
|
|
|
# Set root device.
|
|
root = "/dev/sda1 ro"
|
|
|
|
# Root device for nfs.
|
|
#root = "/dev/nfs"
|
|
# The nfs server.
|
|
#nfs_server = '169.254.1.0'
|
|
# Root directory on the nfs server.
|
|
#nfs_root = '/full/path/to/root/directory'
|
|
|
|
# Sets runlevel 4 and the device for /usr.
|
|
extra = "4 VMID=%d usr=/dev/sda6" % vmid
|
|
|
|
#----------------------------------------------------------------------------
|
|
# Configure the behaviour when a domain exits. There are three 'reasons'
|
|
# for a domain to stop: poweroff, reboot, and crash. For each of these you
|
|
# may specify:
|
|
#
|
|
# "destroy", meaning that the domain is cleaned up as normal;
|
|
# "restart", meaning that a new domain is started in place of the old
|
|
# one;
|
|
# "preserve", meaning that no clean-up is done until the domain is
|
|
# manually destroyed (using xm destroy, for example); or
|
|
# "rename-restart", meaning that the old domain is not cleaned up, but is
|
|
# renamed and a new domain started in its place.
|
|
#
|
|
# The default is
|
|
#
|
|
# on_poweroff = 'destroy'
|
|
# on_reboot = 'restart'
|
|
# on_crash = 'restart'
|
|
#
|
|
# For backwards compatibility we also support the deprecated option restart
|
|
#
|
|
# restart = 'onreboot' means on_poweroff = 'destroy'
|
|
# on_reboot = 'restart'
|
|
# on_crash = 'destroy'
|
|
#
|
|
# restart = 'always' means on_poweroff = 'restart'
|
|
# on_reboot = 'restart'
|
|
# on_crash = 'restart'
|
|
#
|
|
# restart = 'never' means on_poweroff = 'destroy'
|
|
# on_reboot = 'destroy'
|
|
# on_crash = 'destroy'
|
|
|
|
#on_poweroff = 'destroy'
|
|
#on_reboot = 'restart'
|
|
#on_crash = 'restart'
|
|
|
|
#============================================================================
|