xend-config.sxp(5)

1xend-config.sxp(5)                    Xen                   xend-config.sxp(5)
2
3
4

NAME

6       xend-config.sxp - Xen daemon configuration file
7

SYNOPSIS

9       /etc/xen/xend-config.sxp
10

DESCRIPTION

12       The xend(1) program requires xend-config.sxp to specify operating
13       parameters which determine the behavior of the daemon at runtime.
14
15       The parameters are specified in S-expression format.  See the example
16       configuration file in /etc/xen/xend-config.sxp for details.
17

OPTIONS

19       The following lists the daemon configuration parameters:
20
21       logfile
22           The location of the file to record runtime log messages.  Defaults
23           to /var/log/xen/xend.log.
24
25       loglevel
26           Filters out messages below the specified level.  Possible values
27           are DEBUG, INFO, WARNING, ERROR, CRITICAL.  Defaults to DEBUG.
28
29       xend-http-server
30           A boolean value that tells xend whether or not to start the http
31           stream socket management server.  Defaults to no.
32
33       xend-unix-server
34           A boolean value that tells xend whether or not to start the unix
35           domain socket management server.  This is required for the CLI
36           tools to operate.  Defaults to yes.
37
38       xend-relocation-server
39           A boolean value that tells xend whether or not to start the
40           relocation server.  This is required for cross-machine migrations.
41           Defaults to no.
42
43       xend-unix-path
44           The location of the unix domain socket the xend-unix-server will
45           use to communicate with the management tools.  Defaults to
46           /var/lib/xend/xend-socket.
47
48       xend-port
49           The port that will be used by the http management server.  Defaults
50           to 8000.
51
52       xend-relocation-port
53           The port that will be used by the relocation server.  Defaults to
54           8002.
55
56       xend-address
57           The address to which the http management server will bind.
58           Defaults to '' which means "all interfaces".
59
60       xend-relocation-address
61           The address to which the relocation server will bind.  Defaults to
62           '' which means "all interfaces".
63
64       console-limit
65           The kilobyte buffer limit that will be enforced by the console
66           server.  This limit is set per-domain, and is needed to prevent a
67           single domain from overwhelming the console server with massive
68           amounts of data.  Defaults to 1024.
69
70       network-script
71           The name of the script in /etc/xen/scripts that will be run to
72           setup the networking environment.  This can be any name, but in
73           general is either network-bridge or network-route.
74
75       vif-script
76           The name of the script in /etc/xen/scripts that will be run to
77           setup a virtual interface when it is created or destroyed.  This
78           needs to (in general) work in unison with the network-script.
79
80       dom0-min-mem
81           This specifies the minimum number of megabytes that will be
82           reserved for Domain0.  If this value is positive, Domain0 will be
83           automatically ballooned down to this limit to make space for new
84           domains.  If this is set to 0, Domain0 will not be automatically
85           ballooned.
86
87       dom0-cpus
88           This specifies the number of CPUs that Domain0 will be allowed to
89           use.  If the value is 0, all available CPUs will be used by
90           Domain0.
91
92       enable-dump
93           A boolean value that tells xend whether or not core dumps of guest
94           domains should be saved when a crash occurs.  Defaults to no.
95
96       external-migration-tool
97           The name of an application or script that can handle external
98           device migration, such as for example virtual TPM migration. An
99           example script is /etc/xen/scripts/external-device-migrate.
100
101       device-create-timeout
102           Integer value that tells xend how long it should wait for a new
103           device to be created. Defaults to 100.
104
105       device-destroy-timeout
106           Integer value that tells xend how long it should wait for a device
107           to be destroyed. Defaults to 100.
108

EXAMPLES

110       An example configuration with relocation enabled for the local network:
111
112        (xend-relocation-server yes)
113        (xend-relocation-address 192.0.2.192)
114        (network-script network-bridge)
115        (vif-script vif-bridge)
116        (dom0-min-mem 0)
117        (dom0-cpus 0)
118

CAVEATS

120       Note that relocation is currently unsecured and is very dangerous if
121       left enabled.  No authentication is performed, and very little sanity
122       checking takes place.  Enable at your own risk.
123

AUTHOR

128       Dan Smith <danms@us.ibm.com>
129
130
131
132xen-unstable                      2011-10-20                xend-config.sxp(5)