ia64/xen-unstable

view tools/examples/xmexample3 @ 19835:edfdeb150f27

Fix buildsystem to detect udev > version 124

udev removed the udevinfo symlink from versions higher than 123 and
xen's build-system could not detect if udev is in place and has the
required version.

Signed-off-by: Marc-A. Dahlhaus <mad@wol.de>
author Keir Fraser <keir.fraser@citrix.com>
date Thu Jun 25 13:02:37 2009 +0100 (2009-06-25)
parents 0942baa2a088
children
line source
1 # -*- mode: python; -*-
2 #============================================================================
3 # Example Python setup script for 'xm create'.
4 # This script sets the parameters used when a domain is created using 'xm create'.
5 #
6 # This is a relatively advanced script that uses a parameter, vmid, to control
7 # the settings. So this script can be used to start a set of domains by
8 # setting the vmid parameter on the 'xm create' command line. For example:
9 #
10 # xm create vmid=1
11 # xm create vmid=2
12 # xm create vmid=3
13 #
14 # The vmid is purely a script variable, and has no effect on the the domain
15 # id assigned to the new domain.
16 #============================================================================
18 # Define script variables here.
19 # xm_vars is defined automatically, use xm_vars.var() to define a variable.
21 # This function checks that 'vmid' has been given a valid value.
22 # It is called automatically by 'xm create'.
23 def vmid_check(var, val):
24 val = int(val)
25 if val <= 0:
26 raise ValueError
27 return val
29 # Define the 'vmid' variable so that 'xm create' knows about it.
30 xm_vars.var('vmid',
31 use="Virtual machine id. Integer greater than 0.",
32 check=vmid_check)
34 # Check the defined variables have valid values..
35 xm_vars.check()
37 #----------------------------------------------------------------------------
38 # Kernel image file.
39 kernel = "/path/to/domU/kernel"
41 # Optional ramdisk.
42 #ramdisk = "/boot/initrd.gz"
44 # The domain build function. Default is 'linux'.
45 #builder='linux'
47 # Initial memory allocation (in megabytes) for the new domain.
48 #
49 # WARNING: Creating a domain with insufficient memory may cause out of
50 # memory errors. The domain needs enough memory to boot kernel
51 # and modules. Allocating less than 32MBs is not recommended.
52 memory = 64
54 # A name for the new domain. All domains have to have different names,
55 # so we use the vmid to create a name.
56 name = "VM%d" % vmid
58 # 128-bit UUID for the domain. The default behavior is to generate a new UUID
59 # on each call to 'xm create'.
60 #uuid = "06ed00fe-1162-4fc4-b5d8-11993ee4a8b9"
62 # List of which CPUS this domain is allowed to use, default Xen picks
63 #cpus = "" # leave to Xen to pick
64 #cpus = "0" # all vcpus run on CPU0
65 #cpus = "0-3,5,^1" # all vcpus run on cpus 0,2,3,5
66 #cpus = ["2", "3"] # VCPU0 runs on CPU2, VCPU1 runs on CPU3
67 cpus = "%s" % vmid # set based on vmid (mod number of CPUs)
69 #----------------------------------------------------------------------------
70 # Define network interfaces.
72 # Optionally define mac and/or bridge for the network interfaces.
73 # Random MACs are assigned if not given.
75 vif = [ 'ip=192.168.%d.1/24' % (vmid)]
77 #----------------------------------------------------------------------------
78 # Define the disk devices you want the domain to have access to, and
79 # what you want them accessible as.
80 # Each disk entry is of the form phy:UNAME,DEV,MODE
81 # where UNAME is the device, DEV is the device name the domain will see,
82 # and MODE is r for read-only, w for read-write.
84 # This makes the disk device depend on the vmid - assuming
85 # tHat devices sda7, sda8 etc. exist. The device is exported
86 # to all domains as sda1.
87 # All domains get sda6 read-only (to use for /usr, see below).
88 disk = [ 'phy:hda%d,hda1,w' % (vmid)]
90 #----------------------------------------------------------------------------
91 # Define frame buffer device.
92 #
93 # By default, no frame buffer device is configured.
94 #
95 # To create one using the SDL backend and sensible defaults:
96 #
97 # vfb = [ 'sdl=1' ]
98 #
99 # This uses environment variables XAUTHORITY and DISPLAY. You
100 # can override that:
101 #
102 # vfb = [ 'sdl=1,xauthority=/home/bozo/.Xauthority,display=:1' ]
103 #
104 # To create one using the VNC backend and sensible defaults:
105 #
106 # vfb = [ 'vnc=1' ]
107 #
108 # The backend listens on 127.0.0.1 port 5900+N by default, where N is
109 # the domain ID. You can override both address and N:
110 #
111 # vfb = [ 'vnc=1,vnclisten=127.0.0.1,vncdisplay=%d' % vmid ]
112 #
113 # Or you can bind the first unused port above 5900:
114 #
115 # vfb = [ 'vnc=1,vnclisten=0.0.0.0,vncunused=1' ]
116 #
117 # You can override the password:
118 #
119 # vfb = [ 'vnc=1,vncpasswd=MYPASSWD' ]
120 #
121 # Empty password disables authentication. Defaults to the vncpasswd
122 # configured in xend-config.sxp.
124 #----------------------------------------------------------------------------
125 # Define to which TPM instance the user domain should communicate.
126 # The vtpm entry is of the form 'instance=INSTANCE,backend=DOM'
127 # where INSTANCE indicates the instance number of the TPM the VM
128 # should be talking to and DOM provides the domain where the backend
129 # is located.
130 # Note that no two virtual machines should try to connect to the same
131 # TPM instance. The handling of all TPM instances does require
132 # some management effort in so far that VM configration files (and thus
133 # a VM) should be associated with a TPM instance throughout the lifetime
134 # of the VM / VM configuration file. The instance number must be
135 # greater or equal to 1.
136 #vtpm = ['instance=%d,backend=0' % (vmid) ]
138 #----------------------------------------------------------------------------
139 # Set the kernel command line for the new domain.
140 # You only need to define the IP parameters and hostname if the domain's
141 # IP config doesn't, e.g. in ifcfg-eth0 or via DHCP.
142 # You can use 'extra' to set the runlevel and custom environment
143 # variables used by custom rc scripts (e.g. VMID=, usr= ).
145 # Set if you want dhcp to allocate the IP address.
146 dhcp="off"
147 ip="192.168.%d.2" % (vmid)
148 # Set netmask.
149 netmask="255.255.255.0"
150 # Set default gateway.
151 gateway="192.168.%d.1" % (vmid)
152 # Set the hostname.
153 hostname= "domain-%d.xeno" % vmid
155 # Set root device.
156 root = "/dev/hda1 ro"
158 # Root device for nfs.
159 #root = "/dev/nfs"
160 # The nfs server.
161 #nfs_server = "10.212.4.103"
162 # Root directory on the nfs server.
163 #nfs_root = "/path/to/root/filesystem"
165 # Sets runlevel 4 and the device for /usr.
166 extra = "4 VMID=%d" % vmid
168 #----------------------------------------------------------------------------
169 # Configure the behaviour when a domain exits. There are three 'reasons'
170 # for a domain to stop: poweroff, reboot, and crash. For each of these you
171 # may specify:
172 #
173 # "destroy", meaning that the domain is cleaned up as normal;
174 # "restart", meaning that a new domain is started in place of the old
175 # one;
176 # "preserve", meaning that no clean-up is done until the domain is
177 # manually destroyed (using xm destroy, for example); or
178 # "rename-restart", meaning that the old domain is not cleaned up, but is
179 # renamed and a new domain started in its place.
180 #
181 # In the event a domain stops due to a crash, you have the additional options:
182 #
183 # "coredump-destroy", meaning dump the crashed domain's core and then destroy;
184 # "coredump-restart', meaning dump the crashed domain's core and the restart.
185 #
186 # The default is
187 #
188 # on_poweroff = 'destroy'
189 # on_reboot = 'restart'
190 # on_crash = 'restart'
191 #
192 # For backwards compatibility we also support the deprecated option restart
193 #
194 # restart = 'onreboot' means on_poweroff = 'destroy'
195 # on_reboot = 'restart'
196 # on_crash = 'destroy'
197 #
198 # restart = 'always' means on_poweroff = 'restart'
199 # on_reboot = 'restart'
200 # on_crash = 'restart'
201 #
202 # restart = 'never' means on_poweroff = 'destroy'
203 # on_reboot = 'destroy'
204 # on_crash = 'destroy'
206 #on_poweroff = 'destroy'
207 #on_reboot = 'restart'
208 #on_crash = 'restart'
210 #-----------------------------------------------------------------------------
211 # Configure PVSCSI devices:
212 #
213 #vscsi=[ 'PDEV, VDEV' ]
214 #
215 # PDEV gives physical SCSI device to be attached to specified guest
216 # domain by one of the following identifier format.
217 # - XX:XX:XX:XX (4-tuples with decimal notation which shows
218 # "host:channel:target:lun")
219 # - /dev/sdxx or sdx
220 # - /dev/stxx or stx
221 # - /dev/sgxx or sgx
222 # - result of 'scsi_id -gu -s'.
223 # ex. # scsi_id -gu -s /block/sdb
224 # 36000b5d0006a0000006a0257004c0000
225 #
226 # VDEV gives virtual SCSI device by 4-tuples (XX:XX:XX:XX) as
227 # which the specified guest domain recognize.
228 #
230 #vscsi = [ '/dev/sdx, 0:0:0:0' ]
232 #============================================================================