Usage: create [options] [vars] Create a domain. Domain creation parameters can be set by command-line switches, from a python configuration script or an SXP config file. See documentation for --defconfig, --config. Configuration variables can be set using VAR=VAL on the command line. For example vmid=3 sets vmid to 3. -h, --help Print this help. --help_config Print help for the configuration script. -q, --quiet Quiet. --path PATH Search path for configuration scripts. The value of PATH is a colon-separated directory list. Default .:/etc/xen -f, --defconfig FILE Use the given Python configuration script. The configuration script is loaded after arguments have been processed. Each command-line option sets a configuration variable named after its long option name, and these variables are placed in the environment of the script before it is loaded. Variables for options that may be repeated have list values. Other variables can be set using VAR=VAL on the command line. After the script is loaded, option values that were not set on the command line are replaced by the values set in the script. Default xmdefconfig -F, --config FILE Domain configuration to use (SXP). SXP is the underlying configuration format used by Xen. SXP configurations can be hand-written or generated from Python configuration scripts, using the -n (dryrun) option to print the configuration. Default None -L, --load FILE Domain saved state to load. Default None -n, --dryrun Dry run - print the configuration but don't create the domain. Loads the configuration script, creates the SXP configuration and prints it. -p, --paused Leave the domain paused after it is created. -c, --console_autoconnect Connect to the console after the domain is created. vncviewer=no|yes Spawn a vncviewer listening for a vnc server in the domain. The address of the vncviewer is passed to the domain on the kernel command line using 'VNC_SERVER=:'. The port used by vnc is 5500 + DISPLAY. A display value with a free port is chosen if possible. Only valid when vnc=1. Default None name=NAME Domain name. Must be unique. Default None bootloader=FILE Path to bootloader. Default None bootentry=NAME Entry to boot via boot loader Default None kernel=FILE Path to kernel image. Default None ramdisk=FILE Path to ramdisk. Default None builder=FUNCTION Function to use to build the domain. Default linux memory=MEMORY Domain memory in MB. Default 128 ssidref=SSIDREF Security Identifier. Default None maxmem=MEMORY Maximum domain memory in MB. Default None cpu=CPU CPU to run the VCPU0 on. Default None cpus=CPUS CPUS to run the domain on. Default None acpi=ACPI Disable or enable ACPI of VMX domain. Default None apic=APIC Disable or enable APIC of VMX domain. Default None vcpus=VCPUS # of Virtual CPUS in domain. Default 1 cpu_weight=WEIGHT Set the new domain's cpu weight. WEIGHT is a float that controls the domain's share of the cpu. Default None restart=onreboot|always|never Deprecated. Use on_poweroff, on_reboot, and on_crash instead. Whether the domain should be restarted on exit. - onreboot: restart on exit with shutdown code reboot - always: always restart on exit, ignore exit code - never: never restart on exit, ignore exit code Default None on_poweroff=destroy|restart|preserve|rename-restart Behaviour when a domain exits with reason 'poweroff'. - destroy: the domain is cleaned up as normal; - restart: a new domain is started in place of the old one; - preserve: no clean-up is done until the domain is manually destroyed (using xm destroy, for example); - rename-restart: the old domain is not cleaned up, but is renamed and a new domain started in its place. Default None on_reboot=destroy|restart|preserve|rename-restart Behaviour when a domain exits with reason 'reboot'. - destroy: the domain is cleaned up as normal; - restart: a new domain is started in place of the old one; - preserve: no clean-up is done until the domain is manually destroyed (using xm destroy, for example); - rename-restart: the old domain is not cleaned up, but is renamed and a new domain started in its place. Default None on_crash=destroy|restart|preserve|rename-restart Behaviour when a domain exits with reason 'crash'. - destroy: the domain is cleaned up as normal; - restart: a new domain is started in place of the old one; - preserve: no clean-up is done until the domain is manually destroyed (using xm destroy, for example); - rename-restart: the old domain is not cleaned up, but is renamed and a new domain started in its place. Default None blkif=no|yes Make the domain a block device backend. Default None netif=no|yes Make the domain a network interface backend. Default None tpmif=no|yes Make the domain a TPM interface backend. Default None disk=phy:DEV,VDEV,MODE[,DOM] Add a disk device to a domain. The physical device is DEV, which is exported to the domain as VDEV. The disk is read-only if MODE is 'r', read-write if MODE is 'w'. If DOM is specified it defines the backend driver domain to use for the disk. The option may be repeated to add more than one disk. Default None pci=BUS,DEV,FUNC Add a PCI device to a domain, using given params (in hex). For example '-pci c0,02,1a'. The option may be repeated to add more than one pci device. Default None ioports=FROM[-TO] Add a legacy I/O range to a domain, using given params (in hex). For example '-ioports 02f8-02ff'. The option may be repeated to add more than one i/o range. Default None usb=PATH Add a physical USB port to a domain, as specified by the path to that port. This option may be repeated to add more than one port. Default None vif=type=TYPE,mac=MAC,bridge=BRIDGE,ip=IPADDR,script=SCRIPT,backend=DOM,vifname=NAME Add a network interface with the given MAC address and bridge. The vif is configured by calling the given configuration script. If type is not specified, default is netfront not ioemu device. If mac is not specified a random MAC address is used. If not specified then the network backend chooses it's own MAC address. If bridge is not specified the first bridge found is used. If script is not specified the default script is used. If backend is not specified the default backend driver domain is used. If vifname is not specified the backend virtual interface will have name vifD.N where D is the domain id and N is the interface id. This option may be repeated to add more than one vif. Specifying vifs will increase the number of interfaces as needed. Default None vtpm=instance=INSTANCE,backend=DOM Add a TPM interface. On the backend side use the given instance as virtual TPM instance. The given number is merely the preferred instance number. The hotplug script will determine which instance number will actually be assigned to the domain. The associtation between virtual machine and the TPM instance number can be found in /etc/xen/vtpm.db. Use the backend in the given domain. Default None nics=NUM DEPRECATED. Use empty vif entries instead. Set the number of network interfaces. Use the vif option to define interface parameters, otherwise defaults are used. Specifying vifs will increase the number of interfaces as needed. Default -1 root=DEVICE Set the root= parameter on the kernel command line. Use a device, e.g. /dev/sda1, or /dev/nfs for NFS root. Default None extra=ARGS Set extra arguments to append to the kernel command line. Default None ip=IPADDR Set the kernel IP interface address. Default None gateway=IPADDR Set the kernel IP gateway. Default None netmask=MASK Set the kernel IP netmask. Default None hostname=NAME Set the kernel IP hostname. Default None interface=INTF Set the kernel IP interface name. Default eth0 dhcp=off|dhcp Set the kernel dhcp option. Default off nfs_server=IPADDR Set the address of the NFS server for NFS root. Default None nfs_root=PATH Set the path of the root NFS directory. Default None device_model=FILE Path to device model program. Default None fda=FILE Path to fda Default None fdb=FILE Path to fdb Default None serial=FILE Path to serial or pty or vc Default None localtime=no|yes Is RTC set to localtime? Default None stdvga=no|yes Use std vga or cirrhus logic graphics Default None isa=no|yes Simulate an ISA only system? Default None cdrom=FILE Path to cdrom Default None boot=a|b|c|d Default boot device Default c nographic=no|yes Should device models use graphics? Default None ne2000=no|yes Should device models use ne2000? Default None audio=no|yes Should device models enable audio? Default None vnc= Should the device model use VNC? sdl= Should the device model use SDL? display=DISPLAY X11 display to use Default None xauthority=XAUTHORITY X11 Authority to use Default None uuid= xenstore UUID (universally unique identifier) to use. One will be randomly generated if this option is not set, just like MAC addresses for virtual network interfaces. This must be a unique value across the entire cluster.