4.1.14. prlctl register, unregister

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

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

Syntax. 

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

Table 4.14. Options

NameDescription

<path>

An absolute path to the virtual machine directory.

<VM_name>

The name of the virtual machine to remove from the OpenVZ 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 (default behavior).

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 OpenVZ. 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 OpenVZ registry, but does not delete the virtual machine files from the server. You can re-register such a machine with OpenVZ later using the register command.