ia64/xen-unstable

view tools/examples/xmexample3 @ 10098:48c0f5489d44

Remove Emacs variables settings from tail of our Linux files.
Signed-off-by: Keir Fraser <keir@xensource.com>
author kaf24@firebug.cl.cam.ac.uk
date Thu May 18 11:39:03 2006 +0100 (2006-05-18)
parents 6a285d7d7b39
children d2505c4ca32b
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" # run on cpus 0,2,3,5
66 cpus = "%s" % vmid # set based on vmid (mod number of CPUs)
68 #----------------------------------------------------------------------------
69 # Define network interfaces.
71 # Optionally define mac and/or bridge for the network interfaces.
72 # Random MACs are assigned if not given.
74 vif = [ 'ip=192.168.%d.1/24' % (vmid)]
76 #----------------------------------------------------------------------------
77 # Define the disk devices you want the domain to have access to, and
78 # what you want them accessible as.
79 # Each disk entry is of the form phy:UNAME,DEV,MODE
80 # where UNAME is the device, DEV is the device name the domain will see,
81 # and MODE is r for read-only, w for read-write.
83 # This makes the disk device depend on the vmid - assuming
84 # tHat devices sda7, sda8 etc. exist. The device is exported
85 # to all domains as sda1.
86 # All domains get sda6 read-only (to use for /usr, see below).
87 disk = [ 'phy:hda%d,hda1,w' % (vmid)]
89 #----------------------------------------------------------------------------
90 # Define to which TPM instance the user domain should communicate.
91 # The vtpm entry is of the form 'instance=INSTANCE,backend=DOM'
92 # where INSTANCE indicates the instance number of the TPM the VM
93 # should be talking to and DOM provides the domain where the backend
94 # is located.
95 # Note that no two virtual machines should try to connect to the same
96 # TPM instance. The handling of all TPM instances does require
97 # some management effort in so far that VM configration files (and thus
98 # a VM) should be associated with a TPM instance throughout the lifetime
99 # of the VM / VM configuration file. The instance number must be
100 # greater or equal to 1.
101 #vtpm = ['instance=%d,backend=0' % (vmid) ]
103 #----------------------------------------------------------------------------
104 # Set the kernel command line for the new domain.
105 # You only need to define the IP parameters and hostname if the domain's
106 # IP config doesn't, e.g. in ifcfg-eth0 or via DHCP.
107 # You can use 'extra' to set the runlevel and custom environment
108 # variables used by custom rc scripts (e.g. VMID=, usr= ).
110 # Set if you want dhcp to allocate the IP address.
111 dhcp="off"
112 ip="192.168.%d.2" % (vmid)
113 # Set netmask.
114 netmask="255.255.255.0"
115 # Set default gateway.
116 gateway="192.168.%d.1" % (vmid)
117 # Set the hostname.
118 hostname= "domain-%d.xeno" % vmid
120 # Set root device.
121 root = "/dev/hda1 ro"
123 # Root device for nfs.
124 #root = "/dev/nfs"
125 # The nfs server.
126 #nfs_server = "10.212.4.103"
127 # Root directory on the nfs server.
128 #nfs_root = "/path/to/root/filesystem"
130 # Sets runlevel 4 and the device for /usr.
131 extra = "4 VMID=%d" % vmid
133 #----------------------------------------------------------------------------
134 # Configure the behaviour when a domain exits. There are three 'reasons'
135 # for a domain to stop: poweroff, reboot, and crash. For each of these you
136 # may specify:
137 #
138 # "destroy", meaning that the domain is cleaned up as normal;
139 # "restart", meaning that a new domain is started in place of the old
140 # one;
141 # "preserve", meaning that no clean-up is done until the domain is
142 # manually destroyed (using xm destroy, for example); or
143 # "rename-restart", meaning that the old domain is not cleaned up, but is
144 # renamed and a new domain started in its place.
145 #
146 # The default is
147 #
148 # on_poweroff = 'destroy'
149 # on_reboot = 'restart'
150 # on_crash = 'restart'
151 #
152 # For backwards compatibility we also support the deprecated option restart
153 #
154 # restart = 'onreboot' means on_poweroff = 'destroy'
155 # on_reboot = 'restart'
156 # on_crash = 'destroy'
157 #
158 # restart = 'always' means on_poweroff = 'restart'
159 # on_reboot = 'restart'
160 # on_crash = 'restart'
161 #
162 # restart = 'never' means on_poweroff = 'destroy'
163 # on_reboot = 'destroy'
164 # on_crash = 'destroy'
166 #on_poweroff = 'destroy'
167 #on_reboot = 'restart'
168 #on_crash = 'restart'
170 #============================================================================