The prlctl set
command is used to modify the virtual machine configuration parameters.
Syntax.
prlctl set <VM_name> [--cpus <number>] [--memsize <number>] [--videosize <number>] [--memguarantee <percentage>] [--mem-hotplug <on|off>] [--distribution _<name>] [--description <desc>] [--autostart <on|off|auto>] [--autostart-delay <number>] [--autostop <stop|suspend>] [--applyconfig <conf>] [--name <new_name>] [--start-as-user <administrator|owner|<user>:_<passwd>_] [--vnc-mode <auto|manual|off> {--vnc-passwd <passwd> | --vnc-nopasswd}] [--vnc-port <port>] [--vnc-address <address>] [--cpu-hotplug <on|off>] [--cpuunits <units>] [--cpulimit {<percent>|<megahertz>}] [--ioprio <priority>] [--iolimit <limit>] [--iopslimit <limit>] [--cpumask {<N>[,N,N1-N2] | all}] [--offline-management <on|off>] [--offline-service <service_name>] [--userpasswd <user>:<passwd> [--crypted]] [--rate <rate>] [--ratebound <on|off>_] [--apply-iponly <yes|no>] [--efi-boot <on|off>] [--tools-autoupdate <on|off>]
Table 4.16. Options
Name | Description |
---|---|
| Target virtual machine name. |
| Number of virtual CPUs in the virtual machine. If the server has several CPU cores, this option also defines the number of CPUs shown to users from inside a virtual machine. |
| The amount of memory (RAM) available to the virtual machine, in megabytes. You can use the following suffixes to specify measurement units:
|
| The amount of video memory available to the virtual machine graphics card. You can use the following suffixes to specify measurement units:
|
| Sets a percentage of virtual machine’s RAM that said VM is guaranteed to have. By default, set to 40%. |
| Enables or disables memory (RAM) hotplug support in the virtual machine. This feature is disabled in the virtual machine by default. The guest operating system must support memory hotplug for this functionality to work. |
| Optimize the virtual machine for use with the operating system |
| Sets virtual machine description. Descriptions with white spaces must be enclosed in quotation marks. |
| Defines the virtual machine start-up options:
If you set this option to |
| Sets the time delay used during the virtual machine automatic startup. |
| Sets the automatic shutdown mode for the specified virtual machine:
|
| Applies the resource parameter values from the specified VM sample file in
|
| Changes the virtual machine name. You can only change the names of stopped virtual machines. |
| Specifies the account to use to autostart the virtual machine:
|
| Enables or disables access to the virtual machine via the VNC protocol. |
| Sets the VNC port number. |
| Sets the VNC password or specifies that no password is needed for VNC connections. Either of these options is mandatory for any VNC connection. |
| Sets the IP address to use for logging in to the virtual machine via VNC. It must be one of the IP addresses assigned to the hardware node. By default, you can use any of the IP addresses of the hardware node to log in to the virtual machine. |
| Enables or disables CPU hotplug support in the virtual machine. This feature is disabled by default. The guest operating system must support CPU hotplug for this functionality to work. |
| Sets the CPU weight for the virtual machine. This is a positive integer number that defines how much CPU time the virtual machine can get as compared to the other virtual machines and containers running on the server. The larger the number, the more CPU time the virtual machine can receive. Possible values range from 8 to 500000. If this parameter is not set, the default value of 1000 is used. |
| CPU limit, in percent or megahertz (MHz) the virtual machine is not allowed to exceed. By default, the limit is set in percent. To set the limit in MHz, specify "m" after the value. NoteNote: If the server has 2 processors, the total CPU time equals 200%. |
| Disk I/O priority level from 0 to 7. The default is 4. |
| Disk I/O bandwidth limit. The default is 0 (no limit). By default the limit is set in megabytes per second. You can use the following letters following the number to specify units of measure:
The default I/O bandwidth limit for all newly created virtual machines is set to 0, which means that no limits are applied to them. |
| Maximum number of disk input and output operations per second a virtual machine is allowed to perform. By default, any newly created container does not have the IOPS limit set and can perform so many disk I/O operations per second as necessary. |
| An affinity mask indicating what CPU(s) the virtual machine processes should be run on. You can specify a list of CPUs identified by their index numbers separated by commas (0, 1, 2, 3, etc.) or a range (4-6). To make all CPUs available for the virtual machine processes specify |
| Turns the offline management on or off. |
| The name of the service to use for offline management. |
| Sets the password for the specified user in the virtual machine. If the user account does not exist, it will be created. OpenVZ tools must be installed in the virtual machine for the command to work. |
| Used with |
| Sets the guaranteed outgoing traffic rate in Kbps for the virtual machine. |
| Turns the network traffic rate limitation set by the |
| If set to |
| If set to |
| Enables or disables automatic update of OpenVZ tools inside Windows virtual machines. If set to |