prlctl register, unregister

The register command is used to register a virtual machine with Virtuozzo.

The unregister command removes a virtual machine from the Virtuozzo registry.

Syntax

prlctl register <path> --preserve-uuid <yes|no>

prlctl unregister <vm_ID|vm_name>

Options

Name	Description
`<path>`	An absolute path to the virtual machine directory.
`<vm_ID\|vm_name>`	The ID or the name of the virtual machine to remove from the Virtuozzo registry.
--preserve-uuid <yes`\|`no>	Specifies what to do with the UUID (universally unique identifier). If you specify `yes`, the UUID is preserved. If you specify `no`, the UUID is regenerated. Note: By default, IDs are regenerated.

Remarks

Use the register command when you have a virtual machine on the server that does not show up in the list of the virtual machines registered with the Virtuozzo. This can be a machine that was previously removed from the registry or a machine that was copied from another location.

The unregister command removes a virtual machine from the Virtuozzo registry, but does not delete the virtual machine files from the server. You can re-register such a machine with Virtuozzo later using the register command.

Top of page