1xend(1M)                System Administration Commands                xend(1M)
2
3
4

NAME

6       xend - xVM control daemon
7

SYNOPSIS

9       /usr/lib/xend
10
11

DESCRIPTION

13       The  xend  daemon provides control of the Solaris xVM domains on a sys‐
14       tem. Its administrative interface is xm(1M).
15
16   Service Management Facility Support
17       The xend service is managed by the service management facility, smf(5),
18       under the service identifier:
19
20         svc:/system/xvm/xend:default
21
22
23
24
25       Administrative actions on this service, such as enabling, disabling, or
26       requesting restart, can be performed using  svcadm(1M).  The  service's
27       status can be queried using the svcs(1) command.
28
29   xend Properties
30       The  xend service instance has the properties listed below. These prop‐
31       erties are administered by means of svccfg(1M) and svcadm(1M).
32
33       config/default-nic
34
35           Specifies the default network interface used for guest domain  net‐
36           working.  By  default, the empty string is specified, in which case
37           the first interface listed in the output of dladm(1M) show-link  is
38           used.  If you need to use a different interface, for example, bge0,
39           you should change this property appropriately.
40
41
42       config/dom0-cpus
43
44           The number of physical CPUs to be used for the virtual CPUs of  the
45           control  domain  (dom0). The default of 0 implies that each virtual
46           CPU will be placed on its own physical  CPU  where  possible.  Note
47           that  physical  CPUs  can  still  be  shared between dom0 and other
48           domains unless they are configured not to do so.
49
50
51       config/dom0-min-mem
52
53           The minimum amount of  memory  guaranteed  to  the  control  domain
54           (dom0). The default is 196 (MB).
55
56
57       config/enable-dump
58
59           Controls  whether  a domain core dump should be created if a domain
60           crashes. Dumps are generated in /var/xen/dump and can be  processed
61           with mdb(1). The default is true.
62
63
64       config/vncpasswd
65
66           Sets  the  password required by any client connecting to a VNC ses‐
67           sion for a guest domain. Defaults to "" (no password). VNC password
68           authentication  is  not  secure and should not be used for securing
69           guest domain consoles.
70
71
72       config/vnc-listen
73
74           Address to listen on  for  VNC  connections.  By  default  this  is
75           127.0.0.1,  which  has  a  special meaning: only users or processes
76           with the PRIV_VIRT_MANAGE privilege are  allowed  to  connect,  and
77           they must be logged on locally. If you set this to any other value,
78           then anyone will be able to connect to VNC sessions, regardless  of
79           authorization.
80
81
82       config/xend-relocation-address
83
84           Address  that  xend listens on for relocation requests. If blank or
85           not present, all interfaces are used. The default is 127.0.0.1.
86
87
88       config/xend-relocation-hosts-allow
89
90           A space-separated list of regular expressions. If the host name  of
91           a  system  matches  any one of the given regular expressions, it is
92           allowed to connect and interact with the relocation server, if  the
93           server has been enabled by the xend-relocation-server property. The
94           default is ^localhost$.
95
96
97       config/xend-relocation-server
98
99           Controls whether the xend relocation server  (for  live  migration)
100           should listen for relocation requests on TCP port 8002. The default
101           is true.
102
103
104       config/xend-unix-server
105
106           Controls whether the legacy HTTP server interface  should  be  pro‐
107           vided on the local machine. The default is true.
108
109

EXAMPLES

111       Example 1 Modifying an Existing Property
112
113
114       Use the following sequence of commands to modify an existing xend prop‐
115       erty.
116
117
118         # svccfg -s svc:/system/xvm/xend:default listprop
119         # svccfg -s svc:/system/xvm/xend:default setprop config/dom0-cpus = 1
120         # svcadm refresh svc:/system/xvm/xend:default
121
122
123
124       Example 2 Enabling Live Migration
125
126
127       By default, xend listens only on the loopback address for requests from
128       the  localhost.  If you want to allow other machines to live migrate to
129       the local machine, you need to configure xend appropriately. For  exam‐
130       ple:
131
132
133         # svccfg -s svc:system/xvm/xend
134         svc:/system/xvm/xend> setprop config/xend-relocation-address = ""
135         svc:/system/xvm/xend> setprop config/xend-relocation-hosts-allow = \
136         "^flax$ ^localhost$"
137         svc:/system/xvm/xend> end
138         # svcadm refresh svc:system/xvm/xend:default && \
139         svcadm restart svc:system/xvm/xend:default
140
141
142

FILES

144       /var/log/xen/xend.log
145       /var/log/xen/xend-debug.log
146
147           Log files for xend.
148
149
150       /var/xen/dump/
151
152           Domain crash dump files.
153
154

ATTRIBUTES

156       See attributes(5) for descriptions of the following attributes:
157
158
159
160
161       ┌─────────────────────────────┬─────────────────────────────┐
162       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
163       ├─────────────────────────────┼─────────────────────────────┤
164       │Availability                 │SUNWxvmu                     │
165       ├─────────────────────────────┼─────────────────────────────┤
166       │Interface Stability          │Volatile                     │
167       └─────────────────────────────┴─────────────────────────────┘
168

SEE ALSO

170       mdb(1),    svcs(1),    dladm(1M),   svcadm(1M),   svccfg(1M),   xm(1M),
171       attributes(5), privileges(5), smf(5), xVM(5)
172
173
174
175SunOS 5.11                        14 Jan 2009                         xend(1M)
Impressum