4.1.3. prlctl create

Creates a new virtual machine. A virtual machine can be created from scratch or from a virtual machine template. When created from scratch, the target operating system type or version must be specified. To create a virtual machine from a template, the template name must be passed to the command.

Syntax. 

prlctl create <VM_name> [<options>]

Table 4.3. Options

NameDescription

<VM_name>

User-defined new virtual machine name. If the name consists of two or more words separated by spaces, it must be enclosed in quotes.

-d, --distribution {<name>|list}

The operating system distribution the virtual machine will be optimized for. For the full list of supported distributions, refer to the prlctl man pages.

--ostemplate <template_name>

The name of the virtual machine template from which to create the new virtual machine. Use the prlctl list --template command to obtain the list of the available templates.

--dst <vm_path>

User-defined new VM home path. If this parameter is omitted, the VM will be placed in the default virtual machine directory.

--uuid <uuid>

A custom UUID to assign to the virtual machine.

Note

Note: You can use either --distribution or --ostemplate, not both options at once.

When creating a virtual machine from scratch, you may specify the operating system family or version. If an operating system version is specified using the --distribution parameter, the virtual machine will be configured for that operating system. If an operating system family is specified using the --ostype parameter, the virtual machine will be configured for the default version of this OS family. The default versions are determined internally by OpenVZ. The best way to find out the default versions used in your OpenVZ installation is by creating a sample virtual machine.