| Info |
|---|
|
 Image Added
Copyright 2013 by Citrix Systems, Inc. This work is licensed under the Creative Commons Attribution 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/. |
Introduction
This page is intended to document the OpenXT toolstack. Please feel free to contribute heavily.
...
The default rpc rules are stored in /etc/rpc-proxy.rules file. Extra rules can be attached to VM config trees and will take effect when the VM is started and be torn down when the VM is stopped. The format of the rules is relatively straightforward, for example:
TODO does that look ok?
| Code Block |
|---|
|
# nothing can be done by default
deny all
# allow stubdoms to talk to surfman,xenmgr,dbus
allow stubdom true destination com.citrix.xenclient.surfman
allow stubdom true destination com.citrix.xenclient.xenmgr
allow stubdom true destination org.freedesktop.DBus interface org.freedesktop.DBus
# allow guests to call 'gather' on diagnostics interface (required by xc-diag)
allow destination com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr.diag member gather
# allow anybody to do some vm queries required for switcher bar
allow destination com.citrix.xenclient.xenmgr interface org.freedesktop.DBus.Properties member Get
allow destination com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr member list_vms
allow destination com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr.vm member get_db_key
allow destination com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr.vm member read_icon
allow destination com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr.vm member switch
allow destination com.citrix.xenclient.input interface com.citrix.xenclient.input member get_focus_domid
allow destination com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr member find_vm_by_domid
# allow guest to do some requests allow destinationdestination
com.citrix.xenclient.xenmgr interface com.citrix.xenclient.xenmgr.guestreq member request_attention
# allow conditional domstore (private db space) access
allow destination com.citrix.xenclient.db interface com.citrix.xenclient.db member read if-boolean domstore-read-access true
allow destination com.citrix.xenclient.db interface com.citrix.xenclient.db member read_binary if-boolean domstore-read-access trueallowtrue
allow destination com.citrix.xenclient.db interface com.citrix.xenclient.db member list if-boolean domstore-read-access true
allow destination com.citrix.xenclient.db interface com.citrix.xenclient.db member exists if-boolean domstore-read-access true
#
allow destination com.citrix.xenclient.db interface com.citrix.xenclient.db member write if-boolean domstore-write-access true
allow destination com.citrix.xenclient.db interface com.citrix.xenclient.db member rm if-boolean domstore-write-access true |
...
In case of xenmgr the boilerplate is generated from its BB recipe, in the configure step:
TODO why the ` marks?
| Code Block |
|---|
|
# generate rpc stubs
mkdir -p Rpc/Autogen
# Server objects
xc-rpcgen --haskell -s -o Rpc/Autogen --module-prefix=Rpc.Autogen ${STAGING_DATADIR}/idl/xenmgr.xml
xc-rpcgen --haskell -s -o Rpc/Autogen --module-prefix=Rpc.Autogen ${STAGING_DATADIR}/idl/xenmgr_vm.xml |
...
It's sometimes handy to turn off the automatic overwrite of service VM templates each xenmgr start, so that the service VM can be reconfigured via manual xec-vm invocations. This can be achieved via
$ db-write /xenmgr/overwrite-<vmtype>-settings false
for example for NDVM: db-write /xenmgr/overwrite-ndvm-settings false
...
This configures how the toolstack handles requests to put a VM to S3. Note that this doesn't affect requests made from within guest, but just requests originating from the UI / closing the laptopt laptop lid etc. It can be one of the following:
...
- XenMgr/Connect/* - wrappers to access other daemons in the system
- XenMgr/Expose/* - entry points for all xenmgr's dbus server rpcs
- XenMgr/CdLock.hs - relatively new code for handling the AFRL request cd drive lock model
- XenMgr/Config.hs - global xenmgr config storage/query
- XenMgr/Diagnostics.hs - gathering status reports from vms + other diagnostics
- XenMgr/Diskmgr.hs - vhd creation
- XenMgr/Errors.hs - definition of numbered errors reported to the UI
- XenMgr/Host.hs - lots of host level query functions (eth0 mac adreesesadresses, bios versions, xc versions, update state etc)
- XenMgr/HostOps.hs - host shutdown/sleesleep/hibernate/reboot entry points
- XenMgr/PowerManagement.hs - actual implementation of host shutdown/sleep/hibernate/reboot etc plus code to handle lid state changes
- XenMgr/Notify.hs - wrappers for easier generation of various dbus signals
- XenMgr/Rpc.hs - definition of Rpc monad used in xenmgr for dbus access
- XenMgr/XM.hs - definition of XM monad based on reader monad containing context forall vms. Useful for doing some cross vm interactions which require locking / synchronization
...
Apptool is an OVF (open virtualization format) import tool. More info at httpathttps://wikien.cam.xci-test.com/index.php/Ovf <<< TODO that is a bad link - maybe make the page public?wikipedia.org/wiki/Open_Virtualization_Format and https://github.com/OpenXT/manager/tree/master/apptool.
XenVM cont.
There is some more documentation buried in the toolstack repository. I added it - for convenience purposes - here.
...
you can put the following parameters in your config file:
(common options)
| key name | type | description |
|---|
| hvm | s | command line given to the kernel |
| startup | s | specify what to do with the domain at startup possibles value: started, paused, shutdown or restore |
| debug | b | logs all operations to /tmp/xenvm-debug-%uuid |
| uuid | s | specify the domain uuid (default to autogeneration) |
| on_crash | s | specify the action to be taken after notifying a |
| on_halt | s | crash/halt/reboot. possible values: |
| on_reboot | s | preserve, reboot, destroy |
| kernel | s | specify where to find the kernel to boot (can be empty for hvm. default to hvmloader) |
| memory | i | specify the memory given to the guest in megabytes |
| vcpus | i | number of vcpus available to the guest |
| disk | s | add a virtual disk. |
| |
|
| format: physpath:phystype:virtpath:mode:devty[:k=v...] |
| |
|
| - physpath: path to the disk image, raw device, .. |
| | | | | | |
|
| - extra k=v arguments (cipher, key-size, key-file) |
| nic | s | add a virtual nic. |
| |
|
| format: key=value,key=value,... (can be empty) |
| |
|
| supported key: bridge, mac, id |
| | |
|
| "nic = bridge=xen-br0,mac=ab:ef:fe:dc:ba:ab" |
|
|
| "nic = mac=ab:ef:fe:dc:ba:ab" |
| |
|
| "nic = " |
| pci | s | add a pci device. |
|
|
| format: devid,bind,domain |
Image Removed| :bus device.function |
| serial | s | redirect serial to device or network tcp:ip:port |
| |
|
| ex: "pty" or "tcp:1.2.3.4:1234" |
| display | s | details the type of display available for the guest |
| |
|
| format: :key[=value],key[=value],... |
| | | | | |
|
| - vnc (keys allowed: use-port-unused, keymap, port) |
| | | (the following are just useful for pv)
| key name | type | description |
|---|
| cmdline | s | command line given to the kernel |
| initrd | s | specify the initrd use, leave empty for none |
(the following are just useful for hvm)
| key name | type | description |
|---|
| pae | b | specify that the guest is using PAE |
| acpi | b | specify that the guest is using ACPI |
| apic | b | specify that the guest is using APIC |
| nx | b | specify that the guest is using NX |
| smbios-pt | b | specify that the guest is using smbios pass-through |
| smbios-oem-type-pt | i | tables number to passthrough |
| acpi-pt | b | specify that the guest is using ACPI pass-through |
| diskinfo-pt | b | specify the guest is using SCSI diskinfo pass-through |
| boot | s | specify the qemu boot string |
| extra-hvm | k=v | specify extra arguments passthrough to qemu as -k v |
| power-management | i | specify the power management passthrough mode |
|
|
| - 1 : pass-through mode (limited scope) |
| |
|
| - 2 : non pass-through mode (in doubt use this) |
| oem-features | i | specify whether or not to pass through oem features. |
| |
|
| Note: At the moment any integer value can be passed |
| |
|
| but this is likely to change in future especially if |
| |
|
| we decide to pass through a subset of oem features |
| |
|
| and let user configure that subset. |
| timer-mode | i | specify the timer mode used. |
| timeoffset | s | specify the time offset (i.e. timezone) used. |
| pci-msitranslate | i | specify whether to use MSI-INTx translation for guest. |
| pci-power-management | i | specify whether or not to enable Dx power management |
| |
|
| for passthrough devices. |
| inject-sci | i | specify whether or not to inject SCIs like lid close, |
| |
|
| power button press to guest. (Default: no injection) |
Sending command to the monitor
...
| Code Block |
|---|
|
uuid = 00000000-0000-0000-0000-000000000001000000000001
hvm = falsefalse
kernel = /boot/vmlinuz-2.6.18-xenUxenU
cmdline = root=/dev/sda1 roro
memory = 6464
disk = /dev/vg/test:phy:sda:w:diskdisk
vif = |
HVM config for installing a windows 2k3 from iso on a LVM disk called 'testhvm':
| Code Block |
|---|
|
uuid = 00000000-0000-0000-0000-000000000002000000000002
hvm = truetrue
memory = 256256
disk = /dev/vg/testhvm:phy:hda:w:diskdisk
disk = /var/opt/xen/iso_import/w2k3eesp2.iso:file:hdd:r:cdromcdrom
boot = dcdc
pae = true
trueacpiacpi = truetrue
apic = true |
...