From a9ac325984fc7afc6aae763ea66ea19ebe7785f8 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Tue, 13 Mar 2018 20:35:43 +0100 Subject: [PATCH 1/9] Set correct xen network default sript and bridge --- tasks/configure_xen.yml | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 tasks/configure_xen.yml diff --git a/tasks/configure_xen.yml b/tasks/configure_xen.yml new file mode 100644 index 0000000..8417e0f --- /dev/null +++ b/tasks/configure_xen.yml @@ -0,0 +1,16 @@ +--- +- name: Set network default script + lineinfile: + line: "vif.default.script=\"{{ xen_vman_default_network_script }}\"" + regexp: '^vif.default.script=".*"$' + insertafter: '^# default vif script to use.*' + path: /etc/xen/xl.conf + +- name: Set network default bridge + lineinfile: + line: "vif.default.bridge=\"{{ xen_vman_default_network_bridge }}\"" + regexp: '^vif.default.bridge=".*"$' + insertafter: '^# default bridge device to use.*' + path: /etc/xen/xl.conf + when: xen_vman_default_network_bridge is defined + From 12992d6871e4baf94e5dfa4f7edf7e136975b662 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Tue, 13 Mar 2018 20:36:24 +0100 Subject: [PATCH 2/9] Add default setting for xen network script --- defaults/main.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/defaults/main.yml b/defaults/main.yml index 1e2405a..218fc66 100644 --- a/defaults/main.yml +++ b/defaults/main.yml @@ -35,3 +35,4 @@ xen_vman_default_spicevdagent: True xen_vman_default_share_clipboard: True xen_vman_default_max_usb_redirections: 4 xen_vman_default_additonal_xen_options: {} +xen_vman_default_network_script: vif-bridge From c251e50e14316c7420932cb716201b79cfc00844 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Tue, 13 Mar 2018 20:36:59 +0100 Subject: [PATCH 3/9] Add task to configure xen xl.conf settings --- tasks/main.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/tasks/main.yml b/tasks/main.yml index 91c7e7b..9af3167 100644 --- a/tasks/main.yml +++ b/tasks/main.yml @@ -1,5 +1,6 @@ --- - include_tasks: install_packages.yml +- include_tasks: configure_xen.yml - name: Collect all necessary facts and set them if needed include_tasks: set_facts.yml From 904c4c2adf51049a958bf461fb3054109cfb32a6 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Tue, 13 Mar 2018 20:39:44 +0100 Subject: [PATCH 4/9] Update README for xl.conf options --- README.md | 84 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 43 insertions(+), 41 deletions(-) diff --git a/README.md b/README.md index c111a9e..5f0cc87 100644 --- a/README.md +++ b/README.md @@ -28,47 +28,49 @@ Mount or umount the root filesystem from the given VM. For example `systemd star ## Role Variables -| Name | Type | Default | Description | -|------------------------------------------|-----------------------|---------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------| -| `xen_vman_xl_path` | string | _auto determined_ | Fully qualified path of the xl command | -| `xen_vman_iscsiadm_path` | string | _auto determined_ | Fully qualified path of the iscsiadm command | -| `xen_vman_vms` | list of dicts | `[]` | A list of all VM specifications, see [below](#vm-variables) | -| `xen_vman_vm_config_path` | string | `/etc/xen/vms` | Path to store the generated Xen VM configurations | -| `xen_vman_start_timeout` | integer | `15` | systemd timeout in seconds to start a VM | -| `xen_vman_stop_timeout` | integer | `300` | systemd timeout in seconds to stop a VM, after timeout is reached, systemd kills the VM | -| `xen_vman_iscsi_login_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI login request to complete | -| `xen_vman_iscsi_logout_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI logout request to complete | -| `xen_vman_mount_timeout` | integer | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | -| `xen_vman_umount_timeout` | integer | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | -| `xen_vman_public_keys` | list of strings | `[]` | List of public keys to add to the newly generated user in the VM | -| `xen_vman_nfsroot_base` | string | ` ` | Path to prepend to all NFS paths | -| `xen_vman_iscsi_server` | string | _required for iSCSI_ | iSCSI server to connect to | -| `xen_vman_iscsi_base_wwn` | string | _required for iSCSI_ | Base of the WWN name | -| `xen_vman_debootstrap_packages` | list of strings | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | -| `xen_vman_default_memory` | integer | `1024` | Memory to assign to a Xen domU in MiB [¹](#xen_doc) | -| `xen_vman_default_vcpus` | integer | `2` | Number of virtual CPU cores to assign to a VM [¹](#xen_doc) | -| `xen_vman_default_cpu_str` | string | `all,^1` | List of which CPUs the guest is allowed to use [¹](#xen_doc) | -| `xen_vman_default_storage_type` | string | `nfs` | Default filesystem backend to use. Valid choices are `nfs` and `iscsi` | -| `xen_vman_default_disks` | list of strings | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | -| `xen_vman_default_manual_root_disk` | boolean | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | -| `xen_vman_default_filesystem` | string | `ext4` | Filesystem to use for VMs with iSCSI root disk | -| `xen_vman_default_gateway` | string | ` ` | Default gateway of the new VM | -| `xen_vman_default_nameserver` | list of strings | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | -| `xen_vman_default_boot_after_creation` | boolean | `True` | Start the VM after installation | -| `xen_vman_default_auto_boot` | boolean | `True` | Start VM when hypervisor boots | -| `xen_vman_default_builder` | string | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | -| `xen_vman_default_kernel` | string | _auto determined_ | Path to the kernel to use for generic VMs | -| `xen_vman_default_initrd` | string | _auto determined_ | Path to the initrd to use for generic VMs | -| `xen_vman_default_cmdline` | string | ` ` | Command line to pass to the kernel for generic VMs | -| `xen_vman_default_spice` | boolean | False | Allow access to the display via the SPICE protocol [¹](#xen_doc) | -| `xen_vman_default_spicehost` | string (IP-Address) | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [¹](#xen_doc) | -| `xen_vman_default_spiceport` | integer | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [¹](#xen_doc) | -| `xen_vman_default_mouse` | boolean | True | Whether SPICE agent is used for client mouse mode [¹](#xen_doc) | -| `xen_vman_default_share_clipboard` | boolean | True | Enables SPICE clipboard sharing [¹](#xen_doc) | -| `xen_vman_default_spicevdagent` | boolean | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [¹](#xen_doc) | -| `xen_vman_default_max_usb_redirections` | integer (0-4) | `4` | Enable SPICE USB redirections [¹](#xen_doc) | -| `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | `[]` | Add additional Xen options | -| `xen_vman_default_auto_install` | boolean | `True` | Install specified OS automatically, when no xen configuration is found | +| Name | Type | : Required : | Default | Description | +|------------------------------------------|-----------------------|:-----------------------------:|---------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------| +| `xen_vman_xl_path` | string | N | _auto determined_ | Fully qualified path of the xl command | +| `xen_vman_iscsiadm_path` | string | N | _auto determined_ | Fully qualified path of the iscsiadm command | +| `xen_vman_vms` | list of dicts | N | `[]` | A list of all VM specifications, see [below](#vm-variables) | +| `xen_vman_vm_config_path` | string | N | `/etc/xen/vms` | Path to store the generated Xen VM configurations | +| `xen_vman_start_timeout` | integer | N | `15` | systemd timeout in seconds to start a VM | +| `xen_vman_stop_timeout` | integer | N | `300` | systemd timeout in seconds to stop a VM, after timeout is reached, systemd kills the VM | +| `xen_vman_iscsi_login_timeout` | integer | N | `40` | Maximum time in seconds to wait for an iSCSI login request to complete | +| `xen_vman_iscsi_logout_timeout` | integer | N | `40` | Maximum time in seconds to wait for an iSCSI logout request to complete | +| `xen_vman_mount_timeout` | integer | N | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | +| `xen_vman_umount_timeout` | integer | N | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | +| `xen_vman_public_keys` | list of strings | N | `[]` | List of public keys to add to the newly generated user in the VM | +| `xen_vman_nfsroot_base` | string | N | ` ` | Path to prepend to all NFS paths | +| `xen_vman_iscsi_server` | string | N | _required for iSCSI_ | iSCSI server to connect to | +| `xen_vman_iscsi_base_wwn` | string | N | _required for iSCSI_ | Base of the WWN name | +| `xen_vman_debootstrap_packages` | list of strings | N | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | +| `xen_vman_default_memory` | integer | N | `1024` | Memory to assign to a Xen domU in MiB [¹](#xen_doc) | +| `xen_vman_default_vcpus` | integer | N | `2` | Number of virtual CPU cores to assign to a VM [¹](#xen_doc) | +| `xen_vman_default_cpu_str` | string | N | `all,^1` | List of which CPUs the guest is allowed to use [¹](#xen_doc) | +| `xen_vman_default_storage_type` | string | N | `nfs` | Default filesystem backend to use. Valid choices are `nfs` and `iscsi` | +| `xen_vman_default_disks` | list of strings | N | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | +| `xen_vman_default_manual_root_disk` | boolean | N | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | +| `xen_vman_default_filesystem` | string | N | `ext4` | Filesystem to use for VMs with iSCSI root disk | +| `xen_vman_default_gateway` | string | N | ` ` | Default gateway of the new VM | +| `xen_vman_default_nameserver` | list of strings | N | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | +| `xen_vman_default_boot_after_creation` | boolean | N | `True` | Start the VM after installation | +| `xen_vman_default_auto_boot` | boolean | N | `True` | Start VM when hypervisor boots | +| `xen_vman_default_builder` | string | N | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | +| `xen_vman_default_kernel` | string | N | _auto determined_ | Path to the kernel to use for generic VMs | +| `xen_vman_default_initrd` | string | N | _auto determined_ | Path to the initrd to use for generic VMs | +| `xen_vman_default_cmdline` | string | N | ` ` | Command line to pass to the kernel for generic VMs | +| `xen_vman_default_spice` | boolean | N | False | Allow access to the display via the SPICE protocol [¹](#xen_doc) | +| `xen_vman_default_spicehost` | string (IP-Address) | N | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [¹](#xen_doc) | +| `xen_vman_default_spiceport` | integer | N | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [¹](#xen_doc) | +| `xen_vman_default_mouse` | boolean | N | True | Whether SPICE agent is used for client mouse mode [¹](#xen_doc) | +| `xen_vman_default_share_clipboard` | boolean | N | True | Enables SPICE clipboard sharing [¹](#xen_doc) | +| `xen_vman_default_spicevdagent` | boolean | N | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [¹](#xen_doc) | +| `xen_vman_default_max_usb_redirections` | integer (0-4) | N | `4` | Enable SPICE USB redirections [¹](#xen_doc) | +| `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | N | `[]` | Add additional Xen options | +| `xen_vman_default_auto_install` | boolean | N | `True` | Install specified OS automatically, when no xen configuration is found | +| `xen_vman_default_network_script` | string | N | `vif-bridge` | Default xen-script used to setup vm network interfaces, for valid values see `ls /etc/xen/scripts/vif*` on the hypervisor | +| `xen_vman_default_network_bridge` | string | N(Y for some network scripts) | | Default network bridge to use for vm network interfaces | ¹ For further reference see [man xl.cfg](http://xenbits.xen.org/docs/4.8-testing/man/xl.cfg.5.html) From 00162819ccb5ebcb6ed501f1348b1e0225e797a9 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Wed, 14 Mar 2018 15:10:15 +0100 Subject: [PATCH 5/9] Simplified README --- README.md | 93 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 47 insertions(+), 46 deletions(-) diff --git a/README.md b/README.md index 5f0cc87..0fa84c0 100644 --- a/README.md +++ b/README.md @@ -28,52 +28,53 @@ Mount or umount the root filesystem from the given VM. For example `systemd star ## Role Variables -| Name | Type | : Required : | Default | Description | -|------------------------------------------|-----------------------|:-----------------------------:|---------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------| -| `xen_vman_xl_path` | string | N | _auto determined_ | Fully qualified path of the xl command | -| `xen_vman_iscsiadm_path` | string | N | _auto determined_ | Fully qualified path of the iscsiadm command | -| `xen_vman_vms` | list of dicts | N | `[]` | A list of all VM specifications, see [below](#vm-variables) | -| `xen_vman_vm_config_path` | string | N | `/etc/xen/vms` | Path to store the generated Xen VM configurations | -| `xen_vman_start_timeout` | integer | N | `15` | systemd timeout in seconds to start a VM | -| `xen_vman_stop_timeout` | integer | N | `300` | systemd timeout in seconds to stop a VM, after timeout is reached, systemd kills the VM | -| `xen_vman_iscsi_login_timeout` | integer | N | `40` | Maximum time in seconds to wait for an iSCSI login request to complete | -| `xen_vman_iscsi_logout_timeout` | integer | N | `40` | Maximum time in seconds to wait for an iSCSI logout request to complete | -| `xen_vman_mount_timeout` | integer | N | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | -| `xen_vman_umount_timeout` | integer | N | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | -| `xen_vman_public_keys` | list of strings | N | `[]` | List of public keys to add to the newly generated user in the VM | -| `xen_vman_nfsroot_base` | string | N | ` ` | Path to prepend to all NFS paths | -| `xen_vman_iscsi_server` | string | N | _required for iSCSI_ | iSCSI server to connect to | -| `xen_vman_iscsi_base_wwn` | string | N | _required for iSCSI_ | Base of the WWN name | -| `xen_vman_debootstrap_packages` | list of strings | N | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | -| `xen_vman_default_memory` | integer | N | `1024` | Memory to assign to a Xen domU in MiB [¹](#xen_doc) | -| `xen_vman_default_vcpus` | integer | N | `2` | Number of virtual CPU cores to assign to a VM [¹](#xen_doc) | -| `xen_vman_default_cpu_str` | string | N | `all,^1` | List of which CPUs the guest is allowed to use [¹](#xen_doc) | -| `xen_vman_default_storage_type` | string | N | `nfs` | Default filesystem backend to use. Valid choices are `nfs` and `iscsi` | -| `xen_vman_default_disks` | list of strings | N | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | -| `xen_vman_default_manual_root_disk` | boolean | N | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | -| `xen_vman_default_filesystem` | string | N | `ext4` | Filesystem to use for VMs with iSCSI root disk | -| `xen_vman_default_gateway` | string | N | ` ` | Default gateway of the new VM | -| `xen_vman_default_nameserver` | list of strings | N | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | -| `xen_vman_default_boot_after_creation` | boolean | N | `True` | Start the VM after installation | -| `xen_vman_default_auto_boot` | boolean | N | `True` | Start VM when hypervisor boots | -| `xen_vman_default_builder` | string | N | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | -| `xen_vman_default_kernel` | string | N | _auto determined_ | Path to the kernel to use for generic VMs | -| `xen_vman_default_initrd` | string | N | _auto determined_ | Path to the initrd to use for generic VMs | -| `xen_vman_default_cmdline` | string | N | ` ` | Command line to pass to the kernel for generic VMs | -| `xen_vman_default_spice` | boolean | N | False | Allow access to the display via the SPICE protocol [¹](#xen_doc) | -| `xen_vman_default_spicehost` | string (IP-Address) | N | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [¹](#xen_doc) | -| `xen_vman_default_spiceport` | integer | N | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [¹](#xen_doc) | -| `xen_vman_default_mouse` | boolean | N | True | Whether SPICE agent is used for client mouse mode [¹](#xen_doc) | -| `xen_vman_default_share_clipboard` | boolean | N | True | Enables SPICE clipboard sharing [¹](#xen_doc) | -| `xen_vman_default_spicevdagent` | boolean | N | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [¹](#xen_doc) | -| `xen_vman_default_max_usb_redirections` | integer (0-4) | N | `4` | Enable SPICE USB redirections [¹](#xen_doc) | -| `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | N | `[]` | Add additional Xen options | -| `xen_vman_default_auto_install` | boolean | N | `True` | Install specified OS automatically, when no xen configuration is found | -| `xen_vman_default_network_script` | string | N | `vif-bridge` | Default xen-script used to setup vm network interfaces, for valid values see `ls /etc/xen/scripts/vif*` on the hypervisor | -| `xen_vman_default_network_bridge` | string | N(Y for some network scripts) | | Default network bridge to use for vm network interfaces | - - -¹ For further reference see [man xl.cfg](http://xenbits.xen.org/docs/4.8-testing/man/xl.cfg.5.html) +| Name | Type | Default/Required [¹](#__required) | Description | +|------------------------------------------|-----------------------|:-------------------------------------------------------------------:|---------------------------------------------------------------------------------------------------------------------------------------| +| `xen_vman_xl_path` | string | **auto determined** | Fully qualified path of the xl command | +| `xen_vman_iscsiadm_path` | string | **auto determined** | Fully qualified path of the iscsiadm command | +| `xen_vman_vms` | list of dicts | `[]` | A list of all VM specifications, see [below](#vm-variables) | +| `xen_vman_vm_config_path` | string | `/etc/xen/vms` | Path to store the generated Xen VM configurations | +| `xen_vman_start_timeout` | integer | `15` | systemd timeout in seconds to start a VM | +| `xen_vman_stop_timeout` | integer | `300` | systemd timeout in seconds to stop a VM, after timeout is reached, systemd kills the VM | +| `xen_vman_iscsi_login_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI login request to complete | +| `xen_vman_iscsi_logout_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI logout request to complete | +| `xen_vman_mount_timeout` | integer | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | +| `xen_vman_umount_timeout` | integer | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | +| `xen_vman_public_keys` | list of strings | `[]` | List of public keys to add to the newly generated user in the VM | +| `xen_vman_nfsroot_base` | string | ` ` | Path to prepend to all NFS paths | +| `xen_vman_iscsi_server` | string | _required for iSCSI_ | iSCSI server to connect to | +| `xen_vman_iscsi_base_wwn` | string | _required for iSCSI_ | Base of the WWN name | +| `xen_vman_debootstrap_packages` | list of strings | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | +| `xen_vman_default_memory` | integer | `1024` | Memory to assign to a Xen domU in MiB [²](#xen_doc) | +| `xen_vman_default_vcpus` | integer | `2` | Number of virtual CPU cores to assign to a VM [²](#xen_doc) | +| `xen_vman_default_cpu_str` | string | `all,^1` | List of which CPUs the guest is allowed to use [²](#xen_doc) | +| `xen_vman_default_storage_type` | string | `nfs` | Default filesystem backend to use. Valid choices are `nfs` and `iscsi` | +| `xen_vman_default_disks` | list of strings | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | +| `xen_vman_default_manual_root_disk` | boolean | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | +| `xen_vman_default_filesystem` | string | `ext4` | Filesystem to use for VMs with iSCSI root disk | +| `xen_vman_default_gateway` | string | ` ` | Default gateway of the new VM | +| `xen_vman_default_nameserver` | list of strings | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | +| `xen_vman_default_boot_after_creation` | boolean | `True` | Start the VM after installation | +| `xen_vman_default_auto_boot` | boolean | `True` | Start VM when hypervisor boots | +| `xen_vman_default_builder` | string | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | +| `xen_vman_default_kernel` | string | **auto determined** | Path to the kernel to use for generic VMs | +| `xen_vman_default_initrd` | string | **auto determined** | Path to the initrd to use for generic VMs | +| `xen_vman_default_cmdline` | string | ` ` | Command line to pass to the kernel for generic VMs | +| `xen_vman_default_spice` | boolean | False | Allow access to the display via the SPICE protocol [²](#xen_doc) | +| `xen_vman_default_spicehost` | string (IP-Address) | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [²](#xen_doc) | +| `xen_vman_default_spiceport` | integer | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [²](#xen_doc) | +| `xen_vman_default_mouse` | boolean | True | Whether SPICE agent is used for client mouse mode [²](#xen_doc) | +| `xen_vman_default_share_clipboard` | boolean | True | Enables SPICE clipboard sharing [²](#xen_doc) | +| `xen_vman_default_spicevdagent` | boolean | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [²](#xen_doc) | +| `xen_vman_default_max_usb_redirections` | integer (0-4) | `4` | Enable SPICE USB redirections [²](#xen_doc) | +| `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | `[]` | Add additional Xen options | +| `xen_vman_default_auto_install` | boolean | `True` | Install specified OS automatically, when no xen configuration is found | +| `xen_vman_default_network_script` | string | `vif-bridge` | Default xen-script used to setup vm network interfaces, for valid values see `ls /etc/xen/scripts/vif*` on the hypervisor | +| `xen_vman_default_network_bridge` | string | _required for some `xen_vman_default_network_bridge` settings_ | Default network bridge to use for vm network interfaces | + + +¹ Variable is not required unless no default is given or other specified +² For further reference see [man xl.cfg](http://xenbits.xen.org/docs/4.8-testing/man/xl.cfg.5.html) ### VM variables From 4e02c7d5e3712278d9e9518857203029eb6b4fe9 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Wed, 14 Mar 2018 15:19:10 +0100 Subject: [PATCH 6/9] Fix documentation for requirements --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0fa84c0..edf56e8 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ Mount or umount the root filesystem from the given VM. For example `systemd star | `xen_vman_mount_timeout` | integer | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | | `xen_vman_umount_timeout` | integer | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | | `xen_vman_public_keys` | list of strings | `[]` | List of public keys to add to the newly generated user in the VM | -| `xen_vman_nfsroot_base` | string | ` ` | Path to prepend to all NFS paths | +| `xen_vman_nfsroot_base` | string | _required for NFS_ | Path to prepend to all NFS paths | | `xen_vman_iscsi_server` | string | _required for iSCSI_ | iSCSI server to connect to | | `xen_vman_iscsi_base_wwn` | string | _required for iSCSI_ | Base of the WWN name | | `xen_vman_debootstrap_packages` | list of strings | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | @@ -52,14 +52,14 @@ Mount or umount the root filesystem from the given VM. For example `systemd star | `xen_vman_default_disks` | list of strings | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | | `xen_vman_default_manual_root_disk` | boolean | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | | `xen_vman_default_filesystem` | string | `ext4` | Filesystem to use for VMs with iSCSI root disk | -| `xen_vman_default_gateway` | string | ` ` | Default gateway of the new VM | +| `xen_vman_default_gateway` | string | _required for a default route on newly installed vms_ | Default gateway of the new VM | | `xen_vman_default_nameserver` | list of strings | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | | `xen_vman_default_boot_after_creation` | boolean | `True` | Start the VM after installation | | `xen_vman_default_auto_boot` | boolean | `True` | Start VM when hypervisor boots | | `xen_vman_default_builder` | string | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | | `xen_vman_default_kernel` | string | **auto determined** | Path to the kernel to use for generic VMs | | `xen_vman_default_initrd` | string | **auto determined** | Path to the initrd to use for generic VMs | -| `xen_vman_default_cmdline` | string | ` ` | Command line to pass to the kernel for generic VMs | +| `xen_vman_default_cmdline` | string | `""` | Command line to pass to the kernel for generic VMs | | `xen_vman_default_spice` | boolean | False | Allow access to the display via the SPICE protocol [²](#xen_doc) | | `xen_vman_default_spicehost` | string (IP-Address) | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [²](#xen_doc) | | `xen_vman_default_spiceport` | integer | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [²](#xen_doc) | From 6e97974a491d9da313e6bd8dc70ee065ad51054b Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Wed, 14 Mar 2018 15:41:20 +0100 Subject: [PATCH 7/9] Reordered and simplified README even more --- README.md | 170 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 89 insertions(+), 81 deletions(-) diff --git a/README.md b/README.md index edf56e8..f226b6e 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,14 @@ For each configured VM a Xen VM configuration is generated. You can start and st Currently, iSCSI and NFS are completely supported as filesystem backends. For all other backends you manually need to install the system afterwards. + +## Requirements + +- A Xen host machine running a Debian host system (you can use [xen-setup](https://github.com/stuvusIT/xen-setup) to perform this task) +- Filesystem utilities for filesystems used by the guests +- `python-netaddr` on the executing machine + + ## systemd services ### vm@<organisation>-<host>.service @@ -20,99 +28,96 @@ Does a login or a logout for the iSCSI root disk for the given VM, this is only Mount or umount the root filesystem from the given VM. For example `systemd start vm_mount@stuvus-web02` mounts the root filesystem of _web01 @stuvus_ into `/mnt/vms/stuvus-web01`. The mount point is automated created and removed. -## Requirements - -- A Xen host machine running a Debian host system -- Filesystem utilities for filesystems used by the guests are required -- `python-netaddr` on the executing machine ## Role Variables -| Name | Type | Default/Required [¹](#__required) | Description | -|------------------------------------------|-----------------------|:-------------------------------------------------------------------:|---------------------------------------------------------------------------------------------------------------------------------------| -| `xen_vman_xl_path` | string | **auto determined** | Fully qualified path of the xl command | -| `xen_vman_iscsiadm_path` | string | **auto determined** | Fully qualified path of the iscsiadm command | -| `xen_vman_vms` | list of dicts | `[]` | A list of all VM specifications, see [below](#vm-variables) | -| `xen_vman_vm_config_path` | string | `/etc/xen/vms` | Path to store the generated Xen VM configurations | -| `xen_vman_start_timeout` | integer | `15` | systemd timeout in seconds to start a VM | -| `xen_vman_stop_timeout` | integer | `300` | systemd timeout in seconds to stop a VM, after timeout is reached, systemd kills the VM | -| `xen_vman_iscsi_login_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI login request to complete | -| `xen_vman_iscsi_logout_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI logout request to complete | -| `xen_vman_mount_timeout` | integer | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | -| `xen_vman_umount_timeout` | integer | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | -| `xen_vman_public_keys` | list of strings | `[]` | List of public keys to add to the newly generated user in the VM | -| `xen_vman_nfsroot_base` | string | _required for NFS_ | Path to prepend to all NFS paths | -| `xen_vman_iscsi_server` | string | _required for iSCSI_ | iSCSI server to connect to | -| `xen_vman_iscsi_base_wwn` | string | _required for iSCSI_ | Base of the WWN name | -| `xen_vman_debootstrap_packages` | list of strings | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | -| `xen_vman_default_memory` | integer | `1024` | Memory to assign to a Xen domU in MiB [²](#xen_doc) | -| `xen_vman_default_vcpus` | integer | `2` | Number of virtual CPU cores to assign to a VM [²](#xen_doc) | -| `xen_vman_default_cpu_str` | string | `all,^1` | List of which CPUs the guest is allowed to use [²](#xen_doc) | -| `xen_vman_default_storage_type` | string | `nfs` | Default filesystem backend to use. Valid choices are `nfs` and `iscsi` | -| `xen_vman_default_disks` | list of strings | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | -| `xen_vman_default_manual_root_disk` | boolean | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | -| `xen_vman_default_filesystem` | string | `ext4` | Filesystem to use for VMs with iSCSI root disk | -| `xen_vman_default_gateway` | string | _required for a default route on newly installed vms_ | Default gateway of the new VM | -| `xen_vman_default_nameserver` | list of strings | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | -| `xen_vman_default_boot_after_creation` | boolean | `True` | Start the VM after installation | -| `xen_vman_default_auto_boot` | boolean | `True` | Start VM when hypervisor boots | -| `xen_vman_default_builder` | string | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | -| `xen_vman_default_kernel` | string | **auto determined** | Path to the kernel to use for generic VMs | -| `xen_vman_default_initrd` | string | **auto determined** | Path to the initrd to use for generic VMs | -| `xen_vman_default_cmdline` | string | `""` | Command line to pass to the kernel for generic VMs | -| `xen_vman_default_spice` | boolean | False | Allow access to the display via the SPICE protocol [²](#xen_doc) | -| `xen_vman_default_spicehost` | string (IP-Address) | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [²](#xen_doc) | -| `xen_vman_default_spiceport` | integer | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [²](#xen_doc) | -| `xen_vman_default_mouse` | boolean | True | Whether SPICE agent is used for client mouse mode [²](#xen_doc) | -| `xen_vman_default_share_clipboard` | boolean | True | Enables SPICE clipboard sharing [²](#xen_doc) | -| `xen_vman_default_spicevdagent` | boolean | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [²](#xen_doc) | -| `xen_vman_default_max_usb_redirections` | integer (0-4) | `4` | Enable SPICE USB redirections [²](#xen_doc) | -| `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | `[]` | Add additional Xen options | -| `xen_vman_default_auto_install` | boolean | `True` | Install specified OS automatically, when no xen configuration is found | -| `xen_vman_default_network_script` | string | `vif-bridge` | Default xen-script used to setup vm network interfaces, for valid values see `ls /etc/xen/scripts/vif*` on the hypervisor | -| `xen_vman_default_network_bridge` | string | _required for some `xen_vman_default_network_bridge` settings_ | Default network bridge to use for vm network interfaces | +| Name | Type | Default/Required [¹](#__required) | Description | +|------------------------------------------|--------------------------------|:-------------------------------------------------------------------:|---------------------------------------------------------------------------------------------------------------------------------------| +| `xen_vman_xl_path` | string | **auto determined** | Fully qualified path of the xl command | +| `xen_vman_iscsiadm_path` | string | **auto determined** | Fully qualified path of the iscsiadm command | +| `xen_vman_vms` | [list of dicts](#vm-variables) | `[]` | A list of all VM specifications, see [below](#vm-variables) | +| `xen_vman_vm_config_path` | string | `/etc/xen/vms` | Path to store the generated Xen VM configurations | +| `xen_vman_start_timeout` | integer | `15` | systemd timeout in seconds to start a VM | +| `xen_vman_stop_timeout` | integer | `300` | systemd timeout in seconds to stop a VM, after timeout is reached, systemd kills the VM | +| `xen_vman_iscsi_login_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI login request to complete | +| `xen_vman_iscsi_logout_timeout` | integer | `40` | Maximum time in seconds to wait for an iSCSI logout request to complete | +| `xen_vman_mount_timeout` | integer | `20` | Maximum time in seconds to wait for mount before systemd unit enters failed state | +| `xen_vman_umount_timeout` | integer | `20` | Maximum time in seconds to wait for umount before systemd unit enters failed state | +| `xen_vman_public_keys` | list of strings | `[]` | List of public keys to add to the newly generated user in the VM | +| `xen_vman_nfsroot_base` | string | _required for NFS_ | Path to prepend to all NFS paths | +| `xen_vman_iscsi_server` | string | _required for iSCSI_ | iSCSI server to connect to | +| `xen_vman_iscsi_base_wwn` | string | _required for iSCSI_ | Base of the WWN name | +| `xen_vman_debootstrap_packages` | list of strings | `[systemd,systemd-sysv,udev,resolvconf,openssh-server,sudo,python]` | Packages to install into a newly installed VM using debootstrap | +| `xen_vman_default_memory` | integer | `1024` | Memory to assign to a Xen domU in MiB [²](#xen_doc) | +| `xen_vman_default_vcpus` | integer | `2` | Number of virtual CPU cores to assign to a VM [²](#xen_doc) | +| `xen_vman_default_cpu_str` | string | `all,^1` | List of which CPUs the guest is allowed to use [²](#xen_doc) | +| `xen_vman_default_storage_type` | string | `nfs` | Default filesystem backend to use. Valid choices are `nfs` and `iscsi` | +| `xen_vman_default_disks` | list of strings | `[]` | Xen disk specification (see also [xl-disk-configuration.txt](http://xenbits.xen.org/docs/4.8-testing/misc/xl-disk-configuration.txt)) | +| `xen_vman_default_manual_root_disk` | boolean | `False` | Use only disk specified by `xen_vman_default_disks` or `vm.disks` | +| `xen_vman_default_filesystem` | string | `ext4` | Filesystem to use for VMs with iSCSI root disk | +| `xen_vman_default_gateway` | string | _required for a default route on newly installed vms_ | Default gateway of the new VM | +| `xen_vman_default_nameserver` | list of strings | `[8.8.8.8, 8.8.4.4]` | Nameservers to initially set for the new VMs | +| `xen_vman_default_boot_after_creation` | boolean | `True` | Start the VM after installation | +| `xen_vman_default_auto_boot` | boolean | `True` | Start VM when hypervisor boots | +| `xen_vman_default_builder` | string | `generic` | Select the domU guest type, valid values are `generic` (para virtualization) and `hvm` (all hardware is emulated) | +| `xen_vman_default_kernel` | string | **auto determined** | Path to the kernel to use for generic VMs | +| `xen_vman_default_initrd` | string | **auto determined** | Path to the initrd to use for generic VMs | +| `xen_vman_default_cmdline` | string | `""` | Command line to pass to the kernel for generic VMs | +| `xen_vman_default_spice` | boolean | False | Allow access to the display via the SPICE protocol [²](#xen_doc) | +| `xen_vman_default_spicehost` | string (IP-Address) | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [²](#xen_doc) | +| `xen_vman_default_spiceport` | integer | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [²](#xen_doc) | +| `xen_vman_default_mouse` | boolean | True | Whether SPICE agent is used for client mouse mode [²](#xen_doc) | +| `xen_vman_default_share_clipboard` | boolean | True | Enables SPICE clipboard sharing [²](#xen_doc) | +| `xen_vman_default_spicevdagent` | boolean | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [²](#xen_doc) | +| `xen_vman_default_max_usb_redirections` | integer (0-4) | `4` | Enable SPICE USB redirections [²](#xen_doc) | +| `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | `[]` | Add additional Xen options | +| `xen_vman_default_auto_install` | boolean | `True` | Install specified OS automatically, when no xen configuration is found | +| `xen_vman_default_network_script` | string | `vif-bridge` | Default xen-script used to setup vm network interfaces, for valid values see `ls /etc/xen/scripts/vif*` on the hypervisor | +| `xen_vman_default_network_bridge` | string | _required for some `xen_vman_default_network_bridge` settings_ | Default network bridge to use for vm network interfaces | ¹ Variable is not required unless no default is given or other specified ² For further reference see [man xl.cfg](http://xenbits.xen.org/docs/4.8-testing/man/xl.cfg.5.html) + ### VM variables These variables can be specified for each VM. VMs are defined as elements of the `xen_vman_vms` list. -| Name | Type | Required | Description | -|--------------------------|-----------------------|:--------:|-----------------------------------------------------------------------------------------| -| `org` | string | Y | Organization which owns this VM | -| `name` | string | Y | Name of this VM | -| `memory` | integer | N | Amount of memory to assign to this VM. The number is treated as amount of megabytes | -| `vcpus` | integer | N | Amount of virtual CPU cores | -| `cpu_str` | string | N | List of which CPU cores the VM is allowed to use. See above for more information | -| `interfaces` | list of dicts | Y | Virtual network interfaces. See [below](#vm-interfaces) | -| `connection_ip` | string | N | IP of this VM. Will be configured as static IP. First interface IP is used when omitted | -| `storage_type` | string | N | Storage backend of the root filesystem. See above for valid options | -| `disks` | list of strings | N | Additional Xen disk specifications. See above for more information | -| `manual_root_disk` | boolean | N | Use only disk specified by `xen_vman_default_disks` or `vm.disk` | -| `filesystem` | string | N | When using iSCSI, this filesystem is used for the root | -| `os.type` | string | Y | Type of the operating system | -| `os.version` | string | Y | Version of the chosen operating system | -| `boot_after_creation` | boolean | N | Whether to boot the VM after creation | -| `auto_boot` | boolean | N | Whether to boot the VM on hypervisor boot | -| `builder` | string | N | Select the builder for this VM (`generic` or `hvm`) | -| `kernel` | string | N | (For generic VMs only) Path to the kernel to boot | -| `initrd` | string | N | (For generic VMs only) Path to the initrd to pass to the kernel | -| `cmdline` | string | N | (For generic VMs only) Command line to pass to the kernel | -| `spice` | boolean | N | (For generic VMs only) Enable SPICE | -| `spicehost` | string | N | (For HVM VMs only) Address for the SPICE server to listen on | -| `spiceport` | integer | N | (For HVM VMs only) Port for the SPICE server to listen on | -| `spicepasswd` | string | N | (For HVM VMs only) Password required when connecting to the SPICE server | -| `share_clipboard` | boolean | N | (For HVM VMs only) Share clipboard via SPICE | -| `spicevdagent` | boolean | N | (For HVM VMs only) Enable the SPICE vdagent | -| `max_usb_redirections` | integer | N | (For HVM VMs only) Maximum amount of USB redirections | -| `additional_xen_options` | xl.cfg key value dict | N | Add additional Xen options | -| `auto_install` | boolean | N | Install specified OS automatically, when no xen configuration is found | - -# VM interfaces +| Name | Type | Required | Description | +|--------------------------|---------------------------------|:--------:|-----------------------------------------------------------------------------------------| +| `org` | string | Y | Organization which owns this VM | +| `name` | string | Y | Name of this VM | +| `memory` | integer | N | Amount of memory to assign to this VM. The number is treated as amount of megabytes | +| `vcpus` | integer | N | Amount of virtual CPU cores | +| `cpu_str` | string | N | List of which CPU cores the VM is allowed to use. See above for more information | +| `interfaces` | [list of dicts](#vm-interfaces) | Y | Virtual network interfaces. See [below](#vm-interfaces) | +| `connection_ip` | string | N | IP of this VM. Will be configured as static IP. First interface IP is used when omitted | +| `storage_type` | string | N | Storage backend of the root filesystem. See above for valid options | +| `disks` | list of strings | N | Additional Xen disk specifications. See above for more information | +| `manual_root_disk` | boolean | N | Use only disk specified by `xen_vman_default_disks` or `vm.disk` | +| `filesystem` | string | N | When using iSCSI, this filesystem is used for the root | +| `os.type` | string | Y | Type of the operating system | +| `os.version` | string | Y | Version of the chosen operating system | +| `boot_after_creation` | boolean | N | Whether to boot the VM after creation | +| `auto_boot` | boolean | N | Whether to boot the VM on hypervisor boot | +| `builder` | string | N | Select the builder for this VM (`generic` or `hvm`) | +| `kernel` | string | N | (For generic VMs only) Path to the kernel to boot | +| `initrd` | string | N | (For generic VMs only) Path to the initrd to pass to the kernel | +| `cmdline` | string | N | (For generic VMs only) Command line to pass to the kernel | +| `spice` | boolean | N | (For generic VMs only) Enable SPICE | +| `spicehost` | string | N | (For HVM VMs only) Address for the SPICE server to listen on | +| `spiceport` | integer | N | (For HVM VMs only) Port for the SPICE server to listen on | +| `spicepasswd` | string | N | (For HVM VMs only) Password required when connecting to the SPICE server | +| `share_clipboard` | boolean | N | (For HVM VMs only) Share clipboard via SPICE | +| `spicevdagent` | boolean | N | (For HVM VMs only) Enable the SPICE vdagent | +| `max_usb_redirections` | integer | N | (For HVM VMs only) Maximum amount of USB redirections | +| `additional_xen_options` | xl.cfg key value dict | N | Add additional Xen options[²](#xen_doc) | +| `auto_install` | boolean | N | Install specified OS automatically, when no xen configuration is found | + + +### VM interfaces Each network interface may have the following options. All of them are optional. @@ -124,6 +129,7 @@ All of them are optional. | `bridge` | `string` | Bridge to attach the interface to | | `xen_str` | `string` | Additional Xen parameters for this interface | + ## Example Playbook ```yml @@ -141,11 +147,13 @@ All of them are optional. version: 18.04 ``` + ## License This work is licensed under a [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/). + ## Author Information - [Markus Mroch (Mr. Pi)](https://github.com/Mr-Pi) _markus.mroch@stuvus.uni-stuttgart.de_ -- [Janne Heß](https://github.com/dasJ) +- [Janne Heß](https://github.com/dasJ) _janne.hess@stuvus.uni-stuttgart.de_ From 4c059a3c1b04d98e27d5a9160d306ab55f5b8139 Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Wed, 14 Mar 2018 23:16:26 +0100 Subject: [PATCH 8/9] Typo --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index f226b6e..f9d123f 100644 --- a/README.md +++ b/README.md @@ -63,12 +63,12 @@ Mount or umount the root filesystem from the given VM. For example `systemd star | `xen_vman_default_kernel` | string | **auto determined** | Path to the kernel to use for generic VMs | | `xen_vman_default_initrd` | string | **auto determined** | Path to the initrd to use for generic VMs | | `xen_vman_default_cmdline` | string | `""` | Command line to pass to the kernel for generic VMs | -| `xen_vman_default_spice` | boolean | False | Allow access to the display via the SPICE protocol [²](#xen_doc) | +| `xen_vman_default_spice` | boolean | `False` | Allow access to the display via the SPICE protocol [²](#xen_doc) | | `xen_vman_default_spicehost` | string (IP-Address) | `0.0.0.0` | Specify the interface address to listen on if given, defaults to any interface [²](#xen_doc) | | `xen_vman_default_spiceport` | integer | `3100` | Specify the port to listen on by the SPICE server if SPICE is enabled [²](#xen_doc) | -| `xen_vman_default_mouse` | boolean | True | Whether SPICE agent is used for client mouse mode [²](#xen_doc) | -| `xen_vman_default_share_clipboard` | boolean | True | Enables SPICE clipboard sharing [²](#xen_doc) | -| `xen_vman_default_spicevdagent` | boolean | True | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [²](#xen_doc) | +| `xen_vman_default_mouse` | boolean | `True` | Whether SPICE agent is used for client mouse mode [²](#xen_doc) | +| `xen_vman_default_share_clipboard` | boolean | `True` | Enables SPICE clipboard sharing [²](#xen_doc) | +| `xen_vman_default_spicevdagent` | boolean | `True` | Enables SPICE vdagent, this is automatically enabled when clipboard sharing is enabled [²](#xen_doc) | | `xen_vman_default_max_usb_redirections` | integer (0-4) | `4` | Enable SPICE USB redirections [²](#xen_doc) | | `xen_vman_default_additonal_xen_options` | xl.cfg key value dict | `[]` | Add additional Xen options | | `xen_vman_default_auto_install` | boolean | `True` | Install specified OS automatically, when no xen configuration is found | From 0c988e691b89dd9b1902cb2bec8f2463c5ed9d4c Mon Sep 17 00:00:00 2001 From: "Mr. Pi" Date: Wed, 14 Mar 2018 23:21:11 +0100 Subject: [PATCH 9/9] Janne :'( --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index f9d123f..9262035 100644 --- a/README.md +++ b/README.md @@ -156,4 +156,3 @@ This work is licensed under a [Creative Commons Attribution-ShareAlike 4.0 Inter ## Author Information - [Markus Mroch (Mr. Pi)](https://github.com/Mr-Pi) _markus.mroch@stuvus.uni-stuttgart.de_ -- [Janne Heß](https://github.com/dasJ) _janne.hess@stuvus.uni-stuttgart.de_