1## Path: System/Virtualization
2## Description: xen domain start/stop on boot
3## Type: string
4## Default:
5#
6# The xendomains script can send SysRq requests to domains on shutdown.
7# If you don't want to MIGRATE, SAVE, or SHUTDOWN, this may be a possibility
8# to do a quick and dirty shutdown ("s e i u o") or at least sync the disks
9# of the domains ("s").
10#
11XENDOMAINS_SYSRQ=""
12
13## Type: integer
14## Default: 100000
15#
16# If XENDOMAINS_SYSRQ is set, this variable determines how long to wait
17# (in microseconds) after each SysRq, so the domain has a chance to react.
18# If you want to a quick'n'dirty shutdown via SysRq, you may want to set
19# it to a relatively high value (1200000).
20#
21XENDOMAINS_USLEEP=100000
22
23## Type: integer
24## Default: 5000000
25#
26# When creating a guest domain, it is sensible to allow a little time for it
27# to get started before creating another domain or proceeding through the
28# boot process.  Without this, the booting guests will thrash the disk as they
29# start up.  This timeout (in microseconds) specifies the delay after guest
30# domain creation.
31#
32XENDOMAINS_CREATE_USLEEP=5000000
33
34## Type: string
35## Default: ""
36#
37# Set this to a non-empty string if you want to migrate virtual machines
38# on shutdown. The string will be passed to the xm migrate DOMID command
39# as is: It should contain the target IP address of the physical machine
40# to migrate to and optionally parameters like --live. Leave empty if
41# you don't want to try virtual machine relocation on shutdown.
42# If migration succeeds, neither SAVE nor SHUTDOWN will be executed for
43# that domain.
44#
45XENDOMAINS_MIGRATE=""
46
47## Type: string
48## Default: @XEN_LIB_DIR@/save
49#
50# Directory to save running domains to when the system (dom0) is
51# shut down. Will also be used to restore domains from if # XENDOMAINS_RESTORE
52# is set (see below). Leave empty to disable domain saving on shutdown
53# (e.g. because you rather shut domains down).
54# If domain saving does succeed, SHUTDOWN will not be executed.
55#
56XENDOMAINS_SAVE=@XEN_LIB_DIR@/save
57
58## Type: string
59## Default: "--wait"
60#
61# If neither MIGRATE nor SAVE were enabled or if they failed, you can
62# try to shut down a domain by sending it a shutdown request. To do this,
63# set this to "--wait". Omit the "--wait" flag to avoid waiting
64# for the domain to be really down. Leave empty to skip domain shutdown.
65#
66XENDOMAINS_SHUTDOWN="--wait"
67
68## Type: string
69## Default: "--all --wait"
70#
71# After we have gone over all virtual machines (resp. all automatically
72# started ones, see XENDOMAINS_AUTO_ONLY below) in a loop and sent SysRq,
73# migrated, saved and/or shutdown according to the settings above, we
74# might want to shutdown the virtual machines that are still running
75# for some reason or another. To do this, set this variable to
76# "--all --wait", it will be passed to xm shutdown.
77# Leave it empty not to do anything special here.
78# (Note: This will hit all virtual machines, even if XENDOMAINS_AUTO_ONLY
79# is set.)
80#
81XENDOMAINS_SHUTDOWN_ALL="--all --wait"
82
83## Type: boolean
84## Default: true
85#
86# This variable determines whether saved domains from XENDOMAINS_SAVE
87# will be restored on system startup.
88#
89XENDOMAINS_RESTORE=true
90
91## Type: string
92## Default: /etc/xen/auto
93#
94# This variable sets the directory where domains configurations
95# are stored that should be started on system startup automatically.
96# Leave empty if you don't want to start domains automatically
97# (or just don't place any xen domain config files in that dir).
98# Note that the script tries to be clever if both RESTORE and AUTO are
99# set: It will first restore saved domains and then only start domains
100# in AUTO which are not running yet.
101# Note that the name matching is somewhat fuzzy.
102#
103XENDOMAINS_AUTO=/etc/xen/auto
104
105## Type: boolean
106## Default: true
107#
108# If this variable is set to "true", only the domains started via config
109# files in XENDOMAINS_AUTO will be treated according to XENDOMAINS_SYSRQ,
110# XENDOMAINS_MIGRATE, XENDOMAINS_SAVE, XENDMAINS_SHUTDOWN; otherwise
111# all running domains will be.
112# Note that the name matching is somewhat fuzzy.
113#
114XENDOMAINS_AUTO_ONLY=true
115
116## Type: integer
117## Default: 300
118#
119# On xendomains stop, a number of xm commands (xm migrate, save, shutdown,
120# shutdown --all) may be executed. In the worst case, these commands may
121# stall forever, which will prevent a successful shutdown of the machine.
122# If this variable is non-zero, the script will set up a watchdog timer
123# for every of these xm commands and time it out after the number of seconds
124# specified by this variable.
125# Note that SHUTDOWN_ALL will not be called if no virtual machines or only
126# zombies are still running, so you don't need to enable this timeout just
127# for the zombie case.
128# The setting should be large enough to make sure that migrate/save/shutdown
129# can succeed. If you do live migrations, keep in mind that live migration
130# of a 1GB machine over Gigabit ethernet may actually take something like
131# 100s (assuming that live migration uses 10% of the network # bandwidth).
132# Depending on the virtual machine, a shutdown may also require a significant
133# amount of time. So better setup this variable to a huge number and hope the
134# watchdog never fires.
135#
136XENDOMAINS_STOP_MAXWAIT=300
137
138