4.1.18. prlctl start, stop, restart, reset, status

Start, stop, reset, and check the status of a virtual machine.

Syntax. 

prlctl start <VM_name>
prlctl stop <VM_name> [--kill]
prlctl restart <VM_name>
prlctl reset <VM_name>
prlctl status <VM_name>

Table 4.26. Options

NameDescription

<VM_name>

The name of the virtual machine to start, stop, restart, reset, or check the status of.

--kill

Perform a hard virtual machine shutdown. If this option is omitted, an attempt to perform a graceful shutdown will be made.

The stop command can perform a hard or a graceful virtual machine shutdown. If the --kill parameter is included, the hard shutdown will be performed. If the parameter is omitted, the outcome of the graceful shutdown attempt will depend on the following:

  • If OpenVZ tools are installed in a virtual machine, the graceful shutdown will be performed using its facilities.
  • If OpenVZ tools are not installed, the command will try to perform a graceful shutdown using ACPI. Depending on the ACPI support availability in the guest operating system, this may work or not.

The restart command first gracefully shuts down a virtual machine and then starts it again.

The reset command resets a virtual machine without shutting it down.

Note

Note: Resetting a VM may result in loss of unsaved data stored in that VM.

The start command can be used to start a stopped virtual machine or to resume a paused virtual machine).