NAME¶
xend-config.sxp - Xen daemon configuration file
SYNOPSIS¶
/etc/xen/xend-config.sxp
DESCRIPTION¶
The
xend(1) program requires xend-config.sxp to specify operating
parameters which determine the behavior of the daemon at runtime.
The parameters are specified in S-expression format. See the example
configuration file in
/etc/xen/xend-config.sxp for details.
OPTIONS¶
The following lists the daemon configuration parameters:
- logfile
- The location of the file to record runtime log messages. Defaults to
/var/log/xen/xend.log.
- loglevel
- Filters out messages below the specified level. Possible values are DEBUG,
INFO, WARNING, ERROR, CRITICAL. Defaults to DEBUG.
- xend-http-server
- A boolean value that tells xend whether or not to start the http stream
socket management server. Defaults to no.
- xend-unix-server
- A boolean value that tells xend whether or not to start the unix domain
socket management server. This is required for the CLI tools to operate.
Defaults to yes.
- xend-relocation-server
- A boolean value that tells xend whether or not to start the relocation
server. This is required for cross-machine migrations. Defaults to
no.
- xend-unix-path
- The location of the unix domain socket the xend-unix-server will use to
communicate with the management tools. Defaults to
/var/lib/xend/xend-socket.
- xend-port
- The port that will be used by the http management server. Defaults to
8000.
- xend-relocation-port
- The port that will be used by the relocation server. Defaults to
8002.
- xend-address
- The address to which the http management server will bind. Defaults to
'' which means "all interfaces".
- xend-relocation-address
- The address to which the relocation server will bind. Defaults to
'' which means "all interfaces".
- console-limit
- The kilobyte buffer limit that will be enforced by the console server.
This limit is set per-domain, and is needed to prevent a single domain
from overwhelming the console server with massive amounts of data.
Defaults to 1024.
- network-script
- The name of the script in /etc/xen/scripts that will be run to
setup the networking environment. This can be any name, but in general is
either network-bridge or network-route.
- vif-script
- The name of the script in /etc/xen/scripts that will be run to
setup a virtual interface when it is created or destroyed. This needs to
(in general) work in unison with the network-script.
- dom0-min-mem
- This specifies the minimum number of megabytes that will be reserved for
Domain0. If this value is positive, Domain0 will be automatically
ballooned down to this limit to make space for new domains. If this is set
to 0, Domain0 will not be automatically ballooned.
- dom0-cpus
- This specifies the number of CPUs that Domain0 will be allowed to use. If
the value is 0, all available CPUs will be used by Domain0.
- enable-dump
- A boolean value that tells xend whether or not core dumps of guest domains
should be saved when a crash occurs. Defaults to no.
- external-migration-tool
- The name of an application or script that can handle external device
migration, such as for example virtual TPM migration. An example script is
/etc/xen/scripts/external-device-migrate.
- device-create-timeout
- Integer value that tells xend how long it should wait for a new device to
be created. Defaults to 100.
- device-destroy-timeout
- Integer value that tells xend how long it should wait for a device to be
destroyed. Defaults to 100.
EXAMPLES¶
An example configuration with relocation enabled for the local network:
(xend-relocation-server yes)
(xend-relocation-address 192.0.2.192)
(network-script network-bridge)
(vif-script vif-bridge)
(dom0-min-mem 0)
(dom0-cpus 0)
CAVEATS¶
Note that relocation is currently unsecured and is very dangerous if left
enabled. No authentication is performed, and very little sanity checking takes
place. Enable at your own risk.
SEE ALSO¶
xend(1)
AUTHOR¶
Dan Smith <danms@us.ibm.com>