"title":"List of IP/Network address rejected, if 'Restrict all access' is off.",
"description":"Unique identifier of the additional frontend instance, like \"SOFTINST-11031\", if empty won't be requested.",
"description":"When Firewall is enabled, this contain the list of IP address which should not access to all VM of this cluster.",
"type":"string"
"type":"array",
"optional":true
},
},
"frontend-additional-software-type":{
"authorized-keys":{
"title":"Additional Frontend Software Type",
"title":"Public keys for virtual machines.",
"description":"Type of the frontend instance, like \"RootSoftwareInstance\".",
"description":"Set the list of public keys to add in your virtual machine. The public key file will be available in the VM via url http://10.0.2.100/authorized_keys if you keep the NAT interface enabled",
"type":"string",
"type":"array"
"default":"RootSoftwareInstance"
},
},
"frontend-additional-software-url":{
"bootstrap-script-url":{
"title":"Additional Frontend Software URL",
"title":"Virtual Machines bootstrap script URL.",
"description":"Software Release URL of the frontend instance, like \"http://example.com/path/to/software.cfg\".",
"description":"If dedicaced disk image is used, this script will be downloaded and run at first boot of the virtual machine. Set md5sum to URL like: http://example.com/file#MD5SUM. Get file in vm at http://10.0.2.100/vm-bootstrap.",
"title":"Text content to share with virtual machines.",
"description":"Text content which will be written in a file data of cluster http server. All VM will be able to download that file via the static URL of cluster HTTP server: https://10.0.2.101/FOLDER_HASH/data.",
"type":"string"
}
}
},
},
"type":"object"
"type":"object"
},
},
"slave-frontend":{
{
"title":"Web frontend",
"description":"Front end used to provide web access for internal services at the kvm.",
"properties":{
"properties":{
"instance-guid":{
"kvm-partition-dict":{
"title":"Main Frontend Instance ID",
"title":"kvm instances definition",
"description":"Unique identifier of the frontend instance, like \"SOFTINST-11031\".",
"description":"kvm instances definition",
"type":"string",
"default":""
},
"frontend-software-type":{
"title":"Frontend Software Type",
"description":"Type of the frontend instance, like \"frontend\".",
"type":"string",
"default":"custom-personal"
},
"frontend-software-url":{
"title":"Frontend Software URL",
"description":"Software Release URL of the frontend instance, like \"http://example.com/path/to/software.cfg\".",
"title":"ID of the computer where to deploy this VM.",
"description":"Name of the domain to be used (example: mydomain.com). Subdomains of this domain will be used for the slave instances (example: instance12345.mydomain.com).",
"description":"Unique identifier of the computer, like \"COMP-1234\". By default, let Master choose a computer.",
"type":"string",
"type":"string",
"default":""
"default":""
},
},
"url":{
"state":{
"title":"URL of backend to use.",
"title":"State of this Virtual Machine",
"description":"URL of backend to use. This URL will be used to request frontend if parameter 'kvm-partition-name' is not set.",
"description":"Define if SlapOS should start or stop this VM.",
"description":"Use keyboard layout language (for example fr for French). Can be usefull with VNC display",
"type":"string",
"enum":[
"ar",
"da",
"de",
"de-ch",
"en-gb",
"en-us",
"es",
"et",
"fi",
"fo",
"fr",
"fr-be",
"fr-ca",
"fr-ch",
"hr",
"hu",
"is",
"it",
"ja",
"lt",
"lv",
"mk",
"nl",
"nl-be",
"no",
"pl",
"pt",
"pt-br",
"ru",
"sl",
"sv",
"th",
"tr"
],
"default":"fr"
},
"ram-size":{
"title":"RAM size",
"description":"RAM size, in MB.",
"type":"integer",
"default":1024,
"minimum":1024,
"multipleOf":512
},
"ram-max-size":{
"title":"Maximum RAM size, in MB",
"description":"Define the maximum size of the memory. The size is in MB and should be a multiple of 512. Defaults to ram-size + 512",
"type":"integer",
"minimum":1024,
"multipleOf":512
},
"disk-size":{
"title":"Disk size",
"description":"Disk size, in GB.",
"type":"integer",
"default":10,
"minimum":1
},
"disk-type":{
"title":"Disk type",
"description":"Type of QEMU disk drive.",
"type":"string",
"default":"virtio",
"enum":[
"ide",
"scsi",
"sd",
"mtd",
"floppy",
"pflash",
"virtio"
]
},
"disk-format":{
"title":"Disk format",
"description":"Format of QEMU disk drive, to create.",
"type":"string",
"default":"qcow2",
"enum":[
"qcow2",
"raw",
"vdi",
"vmdk",
"cloop",
"qed"
]
},
"cpu-count":{
"title":"CPU amount",
"description":"Number of CPU cores.",
"type":"integer",
"minimum":1
},
"cpu-max-count":{
"title":"Maximum CPU amount",
"description":"Specifies the maximum number of CPUs. Defaults to cpu-count + 1",
"type":"integer",
"minimum":1
},
"use-tap":{
"title":"Use QEMU TAP network interface",
"description":"Use QEMU TAP network interface, requires taps creation on SlapOS Node.",
"type":"boolean",
"default":true
},
"use-nat":{
"title":"Enable QEMU TAP network interface",
"description":"Use QEMU TAP network interface, might require a bridge on SlapOS Node.",
"type":"boolean",
"default":true
},
"nat-rules":{
"title":"List of rules for NAT of QEMU user mode network stack.",
"description":"List of rules for NAT of QEMU user mode network stack, as line-separated list of ports (with optional protocol). For each port specified, it will redirect port x of the VM (example: \"80 udp:53\") to the port x + 10000 of the public IPv6 of the host (example: \"10080 udp:10053\").",
"type":"array",
"default":"22 80 443"
},
"nat-restrict-mode":{
"title":"Isolate the NAT Interface (No Internet access)",
"description":"If this option is enabled, the NAT interface will be isolated, i.e. it will not be able to contact the host and no guest IP packets will be routed over the host to the outside. This option does not affect any explicitly set nat rules.",
"type":"boolean",
"default":false
},
},
"enable-cache":{
"enable-device-hotplug":{
"title":"Use cache for this slave frontend.",
"title":"Enable device hotplug mode",
"description":"Specify if slave frontend should use a squid to connect to backend.",
"description":"If yes, this will allow to Create devices like CPU and Memory in hotplug mode without restart the VM. Operatin System should be configured to Online new created devices.",
"type":"boolean",
"type":"boolean",
"default":false
"default":false
},
},
"type":{
"ram-hotplug-slot-size":{
"title":"Specify if slave frontend will redirect to a zope backend.",
"title":"Size of Hotpluggable RAM slot, in MB",
"description":"If specified, Apache RewriteRule will use Zope's Virtual Host Daemon. Possible values: 'zope', 'default'.",
"description":"Define the RAM size to plug on one hotpluggable slot in MB, understand the size of one RAM bar. The RAM hotplugged on each slot will always have the same RAM size.",
"type":"integer",
"default":512,
"minimum":512,
"multipleOf":512
},
"auto-ballooning":{
"title":"Enable qemu auto ballooning.",
"description":"Enable virtio balloon device to allows KVM guests to reduce/re-increase their memory size.",
"type":"boolean",
"default":true
},
"disk-cache":{
"title":"Cache option to use with Disk.",
"description":"Disk cache controls how the host cache is used to access block data.",
"type":"string",
"type":"string",
"default":"default"
"default":"writeback",
"enum":[
"none",
"writeback",
"unsafe",
"directsync",
"writethrough"
]
},
"disable-ansible-promise":{
"default":false,
"description":"If the VM of cluster doesn't run Ansible and report status to this SlapOS instances, then this allow to disable ansible promise so your instance will not fail to check ansible promise.",
"title":"Desactivate Ansible promise check",
"type":"boolean"
},
},
"zope-path":{
"disk-aio":{
"title":"Path to the VirtualHostRoot of the zope.",
"title":"Disk aio to use.",
"description":"Only used if type is 'zope'. Will append the specified path to the VirtualHostRoot of the zope's VirtualHostMonster.",
"description":"Selects between pthread based disk I/O and native Linux AIO.",
"type":"string",
"type":"string",
"default":""
"default":"threads",
"enum":[
"threads",
"native"
]
},
"numa":{
"title":"Simulate a multi node NUMA system.",
"description":"Simulate a multi node NUMA system. If mem and cpus are omitted, resources are split equally. Each numa option are separated by space: node,nodeid=4,cpus=40-49,mem=64g node,nodeid=1,cpus=10-19,mem=128g. Set this option if you know what you're doing.",
"type":"string"
},
"machine-options":{
"title":"Machine options.",
"description":"Select the emulated machine by name. Ex: pc-i440fx-2.4,accel=kvm",
"type":"string"
},
},
"https-only":{
"cpu-model":{
"title":"Access website with https url only.",
"title":"CPU model.",
"description":"Specify if website should be accessed using https only. If so, the frontend will redirect the user to https if accessed from http.",
"description":"Select the emulated CPU model. Ex: SandyBridge,+erms,+smep,+smx,+vmx",
"type":"string",
"default":"host"
},
"enable-http-server":{
"title":"Enable local http server",
"description":"Set if local http server which serve files to the vm should be deployed. If set to true, get file into the vm with URL: http://10.0.2.100/FILE.",
"type":"boolean",
"type":"boolean",
"default":false
"default":false
},
},
"kvm-partition-name":{
"enable-vhost":{
"title":"Reference name in kvm instance definition to get url from.",
"title":"Use vhost-net to improve network performance of tap interface",
"description":"Compose url from kvm definition. Only work if 'use-nat' is true and 'service-port' is set. This will allow to get URL from defined nat-rules. Play the same as url, but help if you don't know kvm ipv6 yet.",
"description":"The vhost-net provides much improved network performance for your VM. Only work if the vhost-net kernel module is loaded and available on host machine, please keep this option off if you're not shure.",
"type":"boolean",
"default":false
},
"httpd-port":{
"title":"Local http server port",
"description":"Port of the local http server used to share files.",
"type":"integer",
"default":8081,
"minimum":1,
"maximum":65535
},
"authorized-key":{
"title":"Public keys to get from all virtual machines.",
"description":"Set the public keys to add in your virtual machine. The public key file will be available in the VM via url http://10.0.2.100/authorized_keys if you keep the NAT interface enabled",
"type":"string"
},
"bootstrap-script-url":{
"title":"VM bootstrap script URL.",
"description":"If dedicaced disk image is used, this script will be downloaded and run at first boot of the virtual machine. Set md5sum to URL like: http://example.com/file#MD5SUM. Get file in vm at http://10.0.2.100/vm-bootstrap.",
"type":"string",
"type":"string",
"default":""
"format":"uri"
},
},
"service-port":{
"data-to-vm":{
"title":"Port of service into the VM (require: kvm-name).",
"title":"Text content to send to this virtual machine.",
"description":"This will allow to get URL from defined nat-rules. The port should exist in nat-rules of KVM you have referenced by 'kvm-partition-name'",
"description":"Text content which will be written in a file 'data' of http server of this virtual machine instance. The file will be available via URL: http://10.0.2.100/data in the VM.",
"type":"integer"
"type":"string"
},
},
"url-scheme":{
"boot-image-url-list":{
"title":"Scheme of HTTP service into the VM (require: kvm-name).",
"title":"Boot image list",
"description":"Say If HTTP service to run/or running into the Virtual Machine will use http or https. Possible values: http, https.",
"description":"The list shall be list of direct URLs to images, followed by hash (#), then by image MD5SUM. Each image shall appear on newline, like: \"https://example.com/image.iso#06226c7fac5bacfa385872a19bb99684<newline>https://example.com/another-image.iso#31b40d58b18e038498ddb46caea1361c\". They will be provided in KVM image list according to the order on the list. After updating the list, the instance has to be restarted to refresh it. Amount of images is limited to 4, and one image can be maximum 10G. Image will be downloaded and checked against its MD5SUM 4 times, then it will be considered as impossible to download with given MD5SUM. Each image has to be downloaded in time shorter than 4 hours, so in case of very slow images to access, it can take up to 16 hours to download all of them. Note: The instance has to be restarted in order to update the list of available images in the VM. Note: Maximum 3 ISOs are supported.",
"type":"string",
"type":"string",
"enum":[
"textarea":true
"http",
"https"
],
"default":"http"
}
},
"type":"object"
}
},
"type":"object"
}
},
"type":"object"
},
"fw-restricted-access":{
"title":"Restrict all access to VM with firewall.",
"description":"When Firewall is enabled, this parameter define if only vm of this cluster and authorized sources ip should have access to cluster.",
"type":"string",
"enum":[
"on",
"off"
],
"default":"off"
},
"fw-authorized-sources":{
"title":"List of IP/Network address authorized to cluster.",
"description":"When Firewall is enabled, this contain the list of IP address to authorize for access to all VM of this cluster.",
"type":"array",
"optional":true
},
"fw-reject-sources":{
"title":"List of IP/Network address rejected, if 'Restrict all access' is off.",
"description":"When Firewall is enabled, this contain the list of IP address which should not access to all VM of this cluster.",
"type":"array",
"optional":true
},
"authorized-keys":{
"title":"Public keys for virtual machines.",
"description":"Set the list of public keys to add in your virtual machine. The public key file will be available in the VM via url http://10.0.2.100/authorized_keys if you keep the NAT interface enabled",
"type":"array"
},
"bootstrap-script-url":{
"title":"Virtual Machines bootstrap script URL.",
"description":"If dedicaced disk image is used, this script will be downloaded and run at first boot of the virtual machine. Set md5sum to URL like: http://example.com/file#MD5SUM. Get file in vm at http://10.0.2.100/vm-bootstrap.",
"type":"string",
"format":"uri"
},
"cluster-data":{
"title":"Text content to share with virtual machines.",
"description":"Text content which will be written in a file data of cluster http server. All VM will be able to download that file via the static URL of cluster HTTP server: https://10.0.2.101/FOLDER_HASH/data.",
"type":"string"
},
"monitor-interface-url":{
"title":"Monitor Web Interface URL",
"description":"Give Url of HTML web interface that will be used to render this monitor instance.",
"type":"string",
"format":"uri",
"default":"https://monitor.app.officejs.com"
},
"monitor-cors-domains":{
"title":"Monitor CORS domains",
"description":"List of cors domains separated with space. Needed for ajax query on this monitor instance from a different domain.",
"type":"string",
"default":"monitor.app.officejs.com"
},
"kvm-partition-dict":{
"title":"kvm instances definition",
"description":"kvm instances definition",
"patternProperties":{
".*":{
"properties":{
"computer-guid":{
"title":"ID of the computer where to deploy this VM.",
"description":"Unique identifier of the computer, like \"COMP-1234\". By default, let Master choose a computer.",
"type":"string",
"default":""
},
"state":{
"title":"State of this Virtual Machine",
"description":"Define if SlapOS should start or stop this VM.",
"type":"string",
"default":"started",
"enum":[
"started",
"stopped"
]
},
"enable-device-hotplug":{
"title":"Enable device hotplug mode",
"description":"If yes, this will allow to Create devices like CPU and Memory in hotplug mode without restart the VM. Operatin System should be configured to Online new created devices.",
"type":"boolean",
"default":false
},
"ram-size":{
"title":"RAM size",
"description":"RAM size, in MB.",
"type":"integer",
"default":1024,
"minimum":1024,
"multipleOf":512
},
"ram-max-size":{
"title":"Maximum RAM size, in MB",
"description":"Define the maximum size of the memory. The size is in MB and should be a multiple of 512. Defaults to ram-size + 512",
"type":"integer",
"minimum":1024,
"multipleOf":512
},
"ram-hotplug-slot-size":{
"title":"Size of Hotpluggable RAM slot, in MB",
"description":"Define the RAM size to plug on one hotpluggable slot in MB, understand the size of one RAM bar. The RAM hotplugged on each slot will always have the same RAM size.",
"type":"integer",
"default":512,
"minimum":512,
"multipleOf":512
},
"auto-ballooning":{
"title":"Enable qemu auto ballooning.",
"description":"Enable virtio balloon device to allows KVM guests to reduce/re-increase their memory size.",
"type":"boolean",
"default":true
},
"disk-size":{
"title":"Disk size",
"description":"Disk size, in GB.",
"type":"integer",
"default":10,
"minimum":1
},
"disk-format":{
"title":"Disk format.",
"description":"Format of QEMU disk drive, to create.",
"type":"string",
"default":"qcow2",
"enum":[
"qcow2",
"raw",
"vdi",
"vmdk",
"cloop",
"qed"
]
},
"disk-type":{
"title":"Disk type",
"description":"Type of QEMU disk drive.",
"type":"string",
"default":"virtio",
"enum":[
"ide",
"scsi",
"sd",
"mtd",
"floppy",
"pflash",
"virtio"
]
},
"disk-cache":{
"title":"Cache option to use with Disk.",
"description":"Disk cache controls how the host cache is used to access block data.",
"type":"string",
"default":"writeback",
"enum":[
"none",
"writeback",
"unsafe",
"directsync",
"writethrough"
]
},
"disk-aio":{
"title":"Disk aio to use.",
"description":"Selects between pthread based disk I/O and native Linux AIO.",
"type":"string",
"default":"threads",
"enum":[
"threads",
"native"
]
},
"cpu-count":{
"title":"CPU count",
"description":"Number of CPU cores.",
"type":"integer",
"minimum":1
},
"cpu-max-count":{
"title":"Maximum CPU amount",
"description":"Specifies the maximum number of CPUs. Defaults to cpu-count + 1",
"type":"integer",
"minimum":1
},
"numa":{
"title":"Simulate a multi node NUMA system.",
"description":"Simulate a multi node NUMA system. If mem and cpus are omitted, resources are split equally. Each numa option are separated by space: node,nodeid=4,cpus=40-49,mem=64g node,nodeid=1,cpus=10-19,mem=128g. Set this option if you know what you're doing.",
"type":"string"
},
"machine-options":{
"title":"Machine options.",
"description":"Select the emulated machine by name. Ex: pc-i440fx-2.4,accel=kvm",
"type":"string"
},
"cpu-model":{
"title":"CPU model.",
"description":"Select the emulated CPU model. Ex: SandyBridge,+erms,+smep,+smx,+vmx",
"type":"string",
"default":"host"
},
"keyboard-layout-language":{
"title":"Use keyboard layout language",
"description":"Use keyboard layout language (for example fr for French). Can be usefull with VNC display",
"type":"string",
"enum":[
"ar",
"da",
"de",
"de-ch",
"en-gb",
"en-us",
"es",
"et",
"fi",
"fo",
"fr",
"fr-be",
"fr-ca",
"fr-ch",
"hr",
"hu",
"is",
"it",
"ja",
"lt",
"lv",
"mk",
"nl",
"nl-be",
"no",
"pl",
"pt",
"pt-br",
"ru",
"sl",
"sv",
"th",
"tr"
],
"default":"fr"
},
"nbd-host":{
"title":"NBD hostname or IP",
"description":"hostname (or IP) of the NBD server containing the boot image.",
"type":"string",
"format":"internet-address"
},
"nbd-port":{
"title":"NBD port",
"description":"Port of the NBD server containing the boot image.",
"type":"integer",
"default":1024,
"minimum":1,
"maximum":65535
},
"virtual-hard-drive-url":{
"title":"Existing disk image URL",
"description":"If specified, will download an existing disk image (qcow2, raw, ...), and will use it as main virtual hard drive. Can be used to download and use an already installed and customized virtual hard drive.",
"format":"uri",
"type":"string"
},
"virtual-hard-drive-md5sum":{
"title":"Checksum of virtual hard drive",
"description":"MD5 checksum of virtual hard drive, used if virtual-hard-drive-url is specified.",
"type":"string"
},
"virtual-hard-drive-gzipped":{
"title":"Virtual hard drive to download is gzipped",
"description":"Define if virtual hard drive to download is gzipped using gzip. This help to reduce size of file to download.",
"type":"boolean",
"default":false
},
"hard-drive-url-check-certificate":{
"title":"Check certificate when downloading virtual hard drive from https.",
"description":"Define if certificate should be checked when downloading virtual hard drive from https url.",
"type":"boolean",
"default":true
},
"external-disk-number":{
"title":"Number of additional disk to create for virtual machine",
"description":"Specify the number of additional disk to create for virtual machine in data folder of SlapOS Node. Requires instance_storage_home to be configured on SlapOS Node.",
"type":"integer",
"minimum":0,
"default":0
},
"external-disk-size":{
"title":"Size of additional disk to create for virtual machine, in Gigabytes",
"description":"Specify the size of additional disk to create for virtual machine in data folder of SlapOS Node. Requires instance_storage_home to be configured on SlapOS Node.",
"type":"integer",
"minimum":5,
"default":20
},
"external-disk-format":{
"title":"Type of external disk drive to create by QEMU.",
"description":"Type of QEMU disk drive, to create.",
"type":"string",
"default":"qcow2",
"enum":[
"qcow2",
"raw",
"vdi",
"vmdk",
"cloop",
"qed"
]
},
"wipe-disk-ondestroy":{
"title":"Wipe disks when destroy the VM",
"description":"Say if disks should be wiped by writing new data over every single bit before delete them. This option is used to securely delete VM disks",
"type":"boolean",
"default":false
},
"wipe-disk-iterations":{
"title":"Wipe disk iterations",
"description":"Number of disk overwrite iterations with random data. Default is 1. WARNING: Increase this value will slow down partition destruction and increase IO.",
"type":"integer",
"default":1,
"minimum":1
},
"use-tap":{
"title":"Enable QEMU TAP network interface",
"description":"Use QEMU TAP network interface, might require a bridge on SlapOS Node.",
"title":"List of rules for NAT of QEMU user mode network stack.",
"description":"List of rules for NAT of QEMU user mode network stack, as comma-separated list of ports. For each port specified, it will redirect port x of the VM (example: 80) to the port x + 10000 of the public IPv6 (example: 10080). Defaults to \"22 80 443\".",
"type":"array",
"default":[]
},
"nat-restrict-mode":{
"title":"Isolate the NAT Interface (No Internet access)",
"description":"If this option is enabled, the NAT interface will be isolated, i.e. it will not be able to contact the host and no guest IP packets will be routed over the host to the outside. This option does not affect any explicitly set nat rules.",
"type":"boolean",
"default":false
},
"enable-vhost":{
"title":"Use vhost-net to improve network performance of tap interface",
"description":"The vhost-net provides much improved network performance for your VM. Only work if the vhost-net kernel module is loaded and available on host machine, please keep this option off if you're not shure.",
"type":"boolean",
"default":false
},
"bootstrap-script-url":{
"title":"VM bootstrap script URL.",
"description":"If dedicaced disk image is used, this script will be downloaded and run at first boot of the virtual machine. Set md5sum to URL like: http://example.com/file#MD5SUM. Get file in vm at http://10.0.2.100/vm-bootstrap.",
"type":"string",
"format":"uri"
},
"data-to-vm":{
"title":"Text content to send to this virtual machine.",
"description":"Text content which will be written in a file 'data' of http server of this virtual machine instance. The file will be available via URL: http://10.0.2.100/data in the VM.",
"type":"string"
},
"disable-ansible-promise":{
"title":"Desactivate Ansible promise check",
"description":"If the VM of cluster doesn't run Ansible and report status to this SlapOS instances, then this allow to disable ansible promise so your instance will not fail to check ansible promise.",
"type":"boolean",
"default":false
},
"boot-image-url-list":{
"title":"Boot image list",
"description":"The list shall be list of direct URLs to images, followed by hash (#), then by image MD5SUM. Each image shall appear on newline, like: \"https://example.com/image.iso#06226c7fac5bacfa385872a19bb99684<newline>https://example.com/another-image.iso#31b40d58b18e038498ddb46caea1361c\". They will be provided in KVM image list according to the order on the list. After updating the list, the instance has to be restarted to refresh it. Amount of images is limited to 4, and one image can be maximum 10G. Image will be downloaded and checked against its MD5SUM 4 times, then it will be considered as impossible to download with given MD5SUM. Each image has to be downloaded in time shorter than 4 hours, so in case of very slow images to access, it can take up to 16 hours to download all of them. Note: The instance has to be restarted in order to update the list of available images in the VM. Note: Maximum 3 ISOs are supported.",
"description":"If specified, will download an existing disk image (qcow2, raw, ...), and will use it as main virtual hard drive. Can be used to download and use an already installed and customized virtual hard drive.",
"description":"MD5 checksum of virtual hard drive, used if virtual-hard-drive-url is specified.",
],
"type":"string"
"title":"FreeBSD 12.1 RELEASE bootonly x86_64"
},
"virtual-hard-drive-gzipped":{
"title":"Define if virtual hard drive to download is gzipped",
"description":"Define if virtual hard drive to download is gzipped using gzip. This help to reduce size of file to download.",
"type":"boolean",
"default":false
},
"hard-drive-url-check-certificate":{
"title":"Check certificate when downloading virtual hard drive from https.",
"description":"Define if certificate should be checked when downloading virtual hard drive from https url.",
"type":"boolean",
"default":true
},
"wipe-disk-ondestroy":{
"title":"Wipe disks when destroy the VM",
"description":"Say if disks should be wiped by writing new data over every single bit before delete them. This option is used to securely delete VM disks",
"type":"boolean",
"default":false
},
"wipe-disk-iterations":{
"title":"Wipe disk iterations",
"description":"Number of disk overwrite iterations with random data. Default is 1. WARNING: Increase this value will slow down partition destruction and increase IO.",
"description":"If yes, this will allow to Create devices like CPU and Memory in hotplug mode without restart the VM. Operatin System should be configured to Online new created devices.",
"type":"boolean",
"default":false
},
},
"ram-size":{
{
"title":"RAM size",
"$ref":"instance-kvm-frontend-schema.json#"
"description":"RAM size, in MB.",
"type":"integer",
"default":1024,
"minimum":1024,
"multipleOf":512
},
"ram-max-size":{
"title":"Maximum RAM size, in MB",
"description":"Define the maximum size of the memory. The size is in MB and should be a multiple of 512. Defaults to ram-size + 512",
"type":"integer",
"minimum":1024,
"multipleOf":512
},
"ram-hotplug-slot-size":{
"title":"Size of Hotpluggable RAM slot, in MB",
"description":"Define the RAM size to plug on one hotpluggable slot in MB, understand the size of one RAM bar. The RAM hotplugged on each slot will always have the same RAM size.",
"type":"integer",
"default":512,
"minimum":512,
"multipleOf":512
},
"auto-ballooning":{
"title":"Enable qemu auto ballooning.",
"description":"Enable virtio balloon device to allows KVM guests to reduce/re-increase their memory size.",
"type":"boolean",
"default":true
},
"disk-size":{
"title":"Disk size",
"description":"Disk size, in GB.",
"type":"integer",
"default":10,
"minimum":1
},
"disk-type":{
"title":"Disk type",
"description":"Type of QEMU disk drive.",
"type":"string",
"default":"virtio",
"enum":[
"ide",
"scsi",
"sd",
"mtd",
"floppy",
"pflash",
"virtio"
]
},
"disk-format":{
"title":"Type of disk drive to create by QEMU.",
"description":"Type of QEMU disk drive, to create.",
"type":"string",
"default":"qcow2",
"enum":[
"qcow2",
"raw",
"vdi",
"vmdk",
"cloop",
"qed"
]
},
"disk-cache":{
"title":"Cache option to use with Disk.",
"description":"Disk cache controls how the host cache is used to access block data.",
"type":"string",
"default":"writeback",
"enum":[
"none",
"writeback",
"unsafe",
"directsync",
"writethrough"
]
},
"disk-aio":{
"title":"Disk aio to use.",
"description":"Selects between pthread based disk I/O and native Linux AIO.",
"type":"string",
"default":"threads",
"enum":[
"threads",
"native"
]
},
"cpu-count":{
"title":"CPU count",
"description":"Number of CPU cores.",
"type":"integer",
"minimum":1
},
"cpu-max-count":{
"title":"Maximum CPU amount",
"description":"Specifies the maximum number of CPUs. Defaults to cpu-count + 1",
"type":"integer",
"minimum":1
},
"numa":{
"title":"Simulate a multi node NUMA system.",
"description":"Simulate a multi node NUMA system. If mem and cpus are omitted, resources are split equally. Each numa option are separated by space: node,nodeid=4,cpus=40-49,mem=64g node,nodeid=1,cpus=10-19,mem=128g. Set this option if you know what you're doing.",
"type":"string"
},
"machine-options":{
"title":"Machine options.",
"description":"Select the emulated machine by name. Ex: pc-i440fx-2.4,accel=kvm",
"type":"string"
},
"cpu-model":{
"title":"CPU model.",
"description":"Select the emulated CPU model. Ex: SandyBridge,+erms,+smep,+smx,+vmx",
"type":"string",
"default":"host"
},
"keyboard-layout-language":{
"title":"Use keyboard layout language",
"description":"Use keyboard layout language (for example fr for French). Can be usefull with VNC display",
"type":"string",
"enum":[
"ar",
"da",
"de",
"de-ch",
"en-gb",
"en-us",
"es",
"et",
"fi",
"fo",
"fr",
"fr-be",
"fr-ca",
"fr-ch",
"hr",
"hu",
"is",
"it",
"ja",
"lt",
"lv",
"mk",
"nl",
"nl-be",
"no",
"pl",
"pt",
"pt-br",
"ru",
"sl",
"sv",
"th",
"tr"
],
"default":"fr"
},
"nbd-host":{
"title":"NBD hostname",
"description":"hostname (or IP) of the NBD server containing the boot image.",
"type":"string",
"format":"internet-address"
},
"nbd-port":{
"title":"NBD port",
"description":"Port of the NBD server containing the boot image.",
"type":"integer",
"default":1024,
"minimum":1,
"maximum":65535
},
"nbd2-host":{
"title":"Second NBD hostname",
"description":"hostname (or IP) of the second NBD server (containing drivers for example).",
"type":"string",
"format":"internet-address"
},
"nbd2-port":{
"title":"Second NBD port",
"description":"Port of the second NBD server containing the boot image.",
"type":"integer",
"minimum":1,
"maximum":65535
},
"virtual-hard-drive-url":{
"title":"Existing disk image URL",
"description":"If specified, will download an existing disk image (qcow2, raw, ...), and will use it as main virtual hard drive. Can be used to download and use an already installed and customized virtual hard drive.",
"format":"uri",
"type":"string"
},
"virtual-hard-drive-md5sum":{
"title":"Checksum of virtual hard drive",
"description":"MD5 checksum of virtual hard drive, used if virtual-hard-drive-url is specified.",
"type":"string"
},
"virtual-hard-drive-gzipped":{
"title":"Define if virtual hard drive to download is gzipped",
"description":"Define if virtual hard drive to download is gzipped using gzip. This help to reduce size of file to download.",
"type":"boolean",
"default":false
},
"hard-drive-url-check-certificate":{
"title":"Check certificate when downloading virtual hard drive from https.",
"description":"Define if certificate should be checked when downloading virtual hard drive from https url.",
"type":"boolean",
"default":true
},
"external-disk-number":{
"title":"Number of additional disk to create for virtual machine",
"description":"Specify the number of additional disk to create for virtual machine in data folder of SlapOS Node. Requires instance_storage_home to be configured on SlapOS Node.",
"type":"integer",
"minimum":0,
"default":0
},
"external-disk-size":{
"title":"Size of additional disk to create for virtual machine, in Gigabytes",
"description":"Specify the size of additional disk to create for virtual machine in data folder of SlapOS Node. Requires instance_storage_home to be configured on SlapOS Node.",
"type":"integer",
"minimum":10,
"default":20
},
"external-disk-format":{
"title":"Type of external disk drive to create by QEMU.",
"description":"Type of QEMU disk drive, to create.",
"type":"string",
"default":"qcow2",
"enum":[
"qcow2",
"raw",
"vdi",
"vmdk",
"cloop",
"qed"
]
},
"wipe-disk-ondestroy":{
"title":"Wipe disks when destroy the VM",
"description":"Say if disks should be wiped by writing new data over every single bit before delete them. This option is used to securely delete VM disks",
"type":"boolean",
"default":false
},
"wipe-disk-iterations":{
"title":"Wipe disk iterations",
"description":"Number of disk overwrite iterations with random data. Default is 1. WARNING: Increase this value will slow down partition destruction and increase IO.",
"type":"integer",
"default":1,
"minimum":1
},
"use-tap":{
"title":"Use QEMU TAP network interface",
"description":"Use QEMU TAP network interface, requires taps creation on SlapOS Node.",
"title":"List of rules for NAT of QEMU user mode network stack.",
"description":"List of rules for NAT of QEMU user mode network stack, as space-separated list of ports (with optional protocol). For each port specified, it will redirect port x of the VM (example: \"80 udp:53\") to the port x + 10000 of the public IPv6 of the host (example: \"10080 udp:10053\").",
"type":"string",
"default":"22 80 443"
},
"nat-restrict-mode":{
"title":"Isolate the NAT Interface (No Internet access)",
"description":"If this option is enabled, the NAT interface will be isolated, i.e. it will not be able to contact the host and no guest IP packets will be routed over the host to the outside. This option does not affect any explicitly set nat rules.",
"type":"boolean",
"default":false
},
"enable-vhost":{
"title":"Use vhost-net to improve network performance of tap interface",
"description":"The vhost-net provides much improved network performance for your VM. Only work if the vhost-net kernel module is loaded and available on host machine, please keep this option off if you're not shure.",
"type":"boolean",
"default":false
},
"monitor-interface-url":{
"title":"Monitor Web Interface URL",
"description":"Give Url of HTML web interface that will be used to render this monitor instance.",
"type":"string",
"format":"uri",
"default":"https://monitor.app.officejs.com"
},
"monitor-cors-domains":{
"title":"Monitor CORS domains",
"description":"List of cors domains separated with space. Needed for ajax query on this monitor instance from a different domain.",
"type":"string",
"default":"monitor.app.officejs.com"
},
"enable-http-server":{
"title":"Enable local http server",
"description":"Set if local http server which serve files to the vm should be deployed. If set to true, get file into the vm with URL: http://10.0.2.100/FILE.",
"type":"boolean",
"default":false
},
"httpd-port":{
"title":"Local http server port",
"description":"Port of the local http server used to share files.",
"type":"integer",
"default":8081,
"minimum":1,
"maximum":65535
},
"authorized-key":{
"title":"Public keys to get from all virtual machines.",
"description":"Set the public keys to add in your virtual machine. The public key file will be available in the VM via url http://10.0.2.100/authorized_keys if you keep the NAT interface enabled",
"type":"string"
},
"bootstrap-script-url":{
"title":"VM bootstrap script URL.",
"description":"If dedicaced disk image is used, this script will be downloaded and run at first boot of the virtual machine. Set md5sum to URL like: http://example.com/file#MD5SUM. Get file in vm at http://10.0.2.100/vm-bootstrap.",
"type":"string",
"format":"uri"
},
"data-to-vm":{
"title":"Text content to send to this virtual machine.",
"description":"Text content which will be written in a file 'data' of http server of this virtual machine instance. The file will be available via URL: http://10.0.2.100/data in the VM.",
"type":"string"
},
"frontend-instance-guid":{
"title":"Frontend Instance ID",
"description":"Unique identifier of the frontend instance, like \"SOFTINST-11031\".",
"type":"string"
},
"frontend-software-type":{
"title":"Frontend Software Type",
"description":"Type of the frontend instance, like \"frontend\".",
"type":"string",
"default":"RootSoftwareInstance"
},
"frontend-software-url":{
"title":"Frontend Software URL",
"description":"Software Release URL of the frontend instance, like \"http://example.com/path/to/software.cfg\".",
"description":"The list shall be list of direct URLs to images, followed by hash (#), then by image MD5SUM. Each image shall appear on newline, like: \"https://example.com/image.iso#06226c7fac5bacfa385872a19bb99684<newline>https://example.com/another-image.iso#31b40d58b18e038498ddb46caea1361c\". They will be provided in KVM image list according to the order on the list. After updating the list, the instance has to be restarted to refresh it. Amount of images is limited to 4, and one image can be maximum 10G. Image will be downloaded and checked against its MD5SUM 4 times, then it will be considered as impossible to download with given MD5SUM. Each image has to be downloaded in time shorter than 4 hours, so in case of very slow images to access, it can take up to 16 hours to download all of them. Note: The instance has to be restarted in order to update the list of available images in the VM. Note: Maximum 3 ISOs are supported.",
