Xend-config.sxp

From blag.wiki.aktivix.org

Contents 1 NAME 2 SYNOPSIS 3 DESCRIPTION 4 OPTIONS 4.1 logfile 4.2 loglevel 4.3 xend-http-server 4.4 xend-unix-server 4.5 xend-relocation-server 4.6 xend-unix-path 4.7 xend-port 4.8 xend-relocation-port 4.9 xend-address 4.10 xend-relocation-address 4.11 console-limit 4.12 network-script 4.13 vif-script 4.14 dom0-min-mem 4.15 dom0-cpus 4.16 enable-dump 5 EXAMPLES 6 CAVEATS 7 SEE ALSO 8 AUTHOR

NAME

xend-config.sxp - Xen daemon configuration file

SYNOPSIS

/etc/xen/xend-config.sxp I think that you have to make this file (script) executable. As root,

chmod +x /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.

The example configuration is appropriate for an installation that utilizes a bridged network configuration. Access to xend via http is disabled.

OPTIONS

The following lists the daemon configuration parameters:

logfile

The location of the file to record runtime log messages. Defaults to /var/log/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 I<no>. wtf is this? we certainly don't need it to start the deamon or start and manage domUs. What extactly is this for?

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

OK. so it looks as if we **need** this even though it's set to no in the example file shown in /etc/xen.

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.

We will change this to no in the example file given.

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 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 occurrs. Defaults to I<no>.

EXAMPLES

An example configuration with relocation enabled for the local network:

(xend-relocation-server yes)
(xend-relocation-address 192.168.1.1)
(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

AUTHOR

The original author of these docs is Dan Smith <danms@us.ibm.com>. I've just played about with xen a bit and added a few comments. jayeola - john maclean