.. _Virtuozzo Utilities:

Virtuozzo Utilities
-------------------

This section provides information on utilities that can be used to manage Virtuozzo parameters.

.. _prlsrvctl:

prlsrvctl
~~~~~~~~~

The ``prlsrvctl`` command-line utility is used to perform management tasks on the hardware node and Virtuozzo. The tasks include getting the Virtuozzo information, modifying its preferences, installing a license, obtaining statistics and problem reports, and some others.

::

    prlsrvctl [<command> [<options>]
              [-l, --login [<user>[:<passwd>]@]<server>[:<port>]]]

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``<command>``                       | The command to execute.                                                                                   |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<options>``                       | Command options. See individual commands for available options.                                           |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``-l, --login``                     | Connect to the remote hardware node and execute a command there. If this parameter is omitted, the        |
|                                     | command will be executed on the local server.                                                             |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<user>``                          | The name of the user used to log in to the remote server.                                                 |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<passwd>``                        | The user password. If the password is omitted, you will be prompted to enter it.                          |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<server>:<port>``                 | The remote server IP address or hostname and port number, If port number is omitted, the default port     |
|                                     | will be used.                                                                                             |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

.. note:: To display help, enter ``prlsrvctl`` on the command-line without any options.

.. _prlsrvctl backup:

prlsrvctl backup
^^^^^^^^^^^^^^^^

The command is used to back up all virtual environments on the node.

::

    prlsrvctl backup [-f,--full] [-i,--incremental]
                     [-s,--storage <user>[:<password>]@<server>[:<port>]]
                     [--description <desc>] [-u,--uncompressed]

+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| Name                                                        | Description                                                                      |
+=============================================================+==================================================================================+
| ``-f,--full``                                               | Creates a full backup of each virtual environment on the node. A full backup     |
|                                                             | contains all the virtual environment data.                                       |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-i,--incremental``                                        | Creates an incremental backup of each virtual environment on the node. An        |
|                                                             | incremental backup contains only the files that were changed since the previous  |
|                                                             | full or incremental backup. This is the default backup type.                     |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-s,--storage <user>[:<password>]@<server>[:<port>]``      | The host to store backup images at.                                              |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--description <desc>``                                    | Adds a description to each virtual environment backup.                           |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-u,--uncompressed``                                       | Does not compress backup images.                                                 |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+

.. _prlsrvctl info:

prlsrvctl info
^^^^^^^^^^^^^^

Displays the hardware node and Virtuozzo configuration information.

::

    prlsrvctl info

The information returned by the ``info`` command includes the following:

-  Server ID and hostname.

-  Virtuozzo version number.

-  Default directory for storing virtual machine files.

-  Virtuozzo memory limits.

-  Virtuozzo minimum allowable security level.

-  Default directory for storing virtual machine backups.

-  Virtuozzo license information.

-  Server hardware configuration information.

-  Other miscellaneous info.

.. _prlsrvctl net:

prlsrvctl net
^^^^^^^^^^^^^

The ``prlsrvctl net`` command is used to create and configure virtual networks.

**Subcommands**

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``net add``                         | Creates a new virtual network                                                                             |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``net set``                         | Configures the parameters of an existing virtual network.                                                 |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``net del``                         | Removes an existing virtual network.                                                                      |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``net list``                        | List the available virtual networks.                                                                      |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

**net add**

Creates a new virtual network.

::

    prlsrvctl net add <vnetwork_ID> [-i, --ifname <if>] [-m, --mac <mac_address>]
                      [-t, --type <bridged|host-only>] [-d, --description <desc>]
                      [--ip <IP_address>[/<mask>]] [--dhcp-server <on|off>]
                      [--dhcp-ip <IP_address>] [--ip-scope-start <IP_address>]
                      [--ip-scope-end <IP_address>] [--ip6 <IP_address>[/</emphasis><mask>_]]
                      [--dhcp6-server <on|off>] [--dhcp-ip6 <IP_address>]
                      [--ip6-scope-start <IP_address>] [--ip6-scope-end <IP_address>]

+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| Name                                                        | Description                                                                      |
+=============================================================+==================================================================================+
| ``<vnetwork_ID>``                                           | A user-defined name that will identify the new virtual network.                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-i, --ifname <if>``                                       | The name of a physical network adapter on the hardware node to which this        |
|                                                             | virtual network should be bound.                                                 |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-m, --mac <mac_address>``                                 | The MAC address of a virtual network adapter on the hardware node to which this  |
|                                                             | virtual network should be bound.                                                 |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-t, --type <bridged|host-only>``                          | The type of the virtual network to create. Possible values are:                  |
|                                                             |                                                                                  |
|                                                             | -  ``bridged``. A virtual machine and container connected to this type of        |
|                                                             |    virtual network appears as an independent computer on the network.            |
|                                                             |                                                                                  |
|                                                             | -  ``host_only`` (default). A virtual machine and container connected to this    |
|                                                             |    type of virtual network can access only the hardware node and the virtual     |
|                                                             |    machines and containers connected to the same virtual network.                |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-d, --description <desc>``                                | A user-defined description of the virtual network. Descriptions with white       |
|                                                             | spaces must be enclosed in quotation marks.                                      |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--ip <IP_address>[/<mask>]``                              | Set an IPv4/IPv6 address and subnet mask for the Virtuozzo virtual adapter.      |
| ``--ip6 <IP_address>[/<mask>]``                             |                                                                                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--dhcp-server <on|off>``                                  | Enable or disable the Virtuozzo virtual DHCPv4/DHCPv6 server.                    |
| ``--dhcp6-server <on|off>``                                 |                                                                                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--dhcp-ip <IP_address>``                                  | Set an IPv4/IPv6 address for the Virtuozzo virtual DHCPv4/DHCPv6 server.         |
| ``--dhcp-ip6 <IP_address>``                                 |                                                                                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--ip-scope-start <IP_address>``                           | Set the starting and ending IPv4/IPv6 addresses for the DHCPv4/DHCPv6 pool. The  |
| ``--ip-scope-end <IP_address>``                             | virtual machines and containers connected to the network you are creating will   |
| ``--ip6-scope-start <IP_address>``                          | automatically receive their IPv4/IPv6 addresses from the respective              |
| ``--ip6-scope- end <IP_address>``                           | DHCPv4/DHCPv6 pool.                                                              |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+

**net set**

Configures the settings of an existing virtual network.

::

    prlsrvctl net set <vnetwork_ID> [-i, --ifname <if>] [-m, --mac <mac_address>]
                      [-t, --type <bridged|host-only>] [-d, --description <desc>]
                      [--ip <IP_address>[/<mask>]] [--dhcp-server <on|off>]
                      [--dhcp-ip <IP_address>] [--ip-scope-start <IP_address>]
                      [--ip-scope-end <IP_address>] [--ip6 <IP_address>[/</emphasis><mask>_]]
                      [--dhcp6-server <on|off>] [--dhcp-ip6 <IP_address>]
                      [--ip6-scope-start <IP_address>] [--ip6-scope-end <IP_address>]

+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| Name                                                        | Description                                                                      |
+=============================================================+==================================================================================+
| ``<vnetwork_ID>``                                           | The name of the virtual network to modify.                                       |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-i, --ifname <if>``                                       | The name of a physical network adapter on the hardware node to which this        |
|                                                             | virtual network should be bound.                                                 |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-m, --mac <mac_address>``                                 | The MAC address of a virtual network adapter on the hardware node to which this  |
|                                                             | virtual network should be bound.                                                 |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-t, --type <bridged|host-only>``                          | The type of the virtual network to modify. Possible values are:                  |
|                                                             |                                                                                  |
|                                                             | -  ``bridged``. A virtual machine and container connected to this type of        |
|                                                             |    virtual network appears as an independent computer on the network.            |
|                                                             |                                                                                  |
|                                                             | -  ``host_only`` (default). A virtual machine and container connected to this    |
|                                                             |    type of virtual network can access only the hardware node and the virtual     |
|                                                             |    machines and containers connected to the same virtual network.                |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``-d, --description <desc>``                                | A user-defined description of the virtual network. Descriptions with white       |
|                                                             | spaces must be enclosed in quotation marks.                                      |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--ip <IP_address>[/<mask>]``                              | Set an IPv4/IPv6 address and subnet mask for the Virtuozzo virtual adapter.      |
| ``--ip6 <IP_address>[/<mask>]``                             |                                                                                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--dhcp-server <on|off>``                                  | Enable or disable the Virtuozzo virtual DHCPv4/DHCPv6 server.                    |
| ``--dhcp6-server <on|off>``                                 |                                                                                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--dhcp-ip <IP_address>``                                  | Set an IPv4/IPv6 address for the Virtuozzo virtual DHCPv4/DHCPv6 server.         |
| ``--dhcp-ip6 <IP_address>``                                 |                                                                                  |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| ``--ip-scope-start <IP_address>``                           | Set the starting and ending IPv4/IPv6 addresses for the DHCPv4/DHCPv6 pool. The  |
| ``--ip-scope-end <IP_address>``                             | virtual machines and containers connected to the network you are creating will   |
| ``--ip6-scope-start <IP_address>``                          | automatically receive their IPv4/IPv6 addresses from the respective              |
| ``--ip6-scope- end <IP_address>``                           | DHCPv4/DHCPv6 pool.                                                              |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+

**net del**

Deletes an existing virtual network.

::

    prlsrvctl net del <vnetwork_ID>

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``<vnetwork_ID>``                   | The name of the virtual network to delete.                                                                |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

**net list**

Lists the existing virtual networks.

::

    prlsrvctl net list

.. _prlsrvctl problem-report:

prlsrvctl problem-report
^^^^^^^^^^^^^^^^^^^^^^^^

Generates and displays problem reports.

::

    prlsrvctl problem-report

The command collects technical data about Virtuozzo and the hardware node and displays the report on screen (the output can also be piped to a file). The report can then be directed to the Virtuozzo technical support team for analysis.

.. _prlsrvctl set:

prlsrvctl set
^^^^^^^^^^^^^

Configures Virtuozzo preferences.

::

    prlsrvctl set [--mem-limit <auto>|<size>]
                  [-s, --min-security-level <low|normal|high>]
                  [--mng-settings <allow|deny>]
                  [--device <device> --assignment <host|vm>_]
                  [--backup-storage [<user>[:<passwd>]@]<server>[:<port>]]
                  [--backup-tmpdir <tmp_dir>] [--backup-path <path>]
                  [--idle-connection-timeout <timeout>]
                  [--verbose-log <on|off>] [--cluster-mode <on|off>]
                  [--cpu-features-mask <{+|-}feature1,feature2=value[,...]>]
                  [--vm-cpulimit-type <full|guest>]
                  [--vcmmd-policy <density|performance>]
                  [--vnc-ssl-certificate <path> --vnc-ssl-key <path>]

+------------------------------------------------------------------------+------------------------------------------------------------------------+
| Name                                                                   | Description                                                            |
+========================================================================+========================================================================+
| ``--mem-limit {auto|<size>}``                                          | Sets the upper limit of the memory size that can be reserved for use   |
|                                                                        | by virtual machines. The following options are available:              |
|                                                                        |                                                                        |
|                                                                        | -  ``auto`` - if this option is used, the memory size will be          |
|                                                                        |    calculated automatically.                                           |
|                                                                        |                                                                        |
|                                                                        | -  ``size`` - user-defined memory size, in megabytes.                  |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``-s, --min-security-level <low|normal|high>``                         | The lowest allowable security level that can be used to connect to the |
|                                                                        | hardware node. The following options are available:                    |
|                                                                        |                                                                        |
|                                                                        | -  ``low`` - plain TCP/IP (no encryption).                             |
|                                                                        |                                                                        |
|                                                                        | -  ``normal`` - most important data is sent and received using SSL     |
|                                                                        |    over TCP/IP (user credentials during login, guest OS clipboard,     |
|                                                                        |    etc.) Other data is sent and received using plain TCP/IP with no    |
|                                                                        |    encryption.                                                         |
|                                                                        |                                                                        |
|                                                                        | -  ``high`` - all of the data is sent and received using SSL.          |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--mng-settings <allow|deny>``                                        | Allows to grant or deny permission to new users to modify Virtuozzo    |
|                                                                        | preferences. By default, only administrators of the host OS can modify |
|                                                                        | Virtuozzo preferences. When a new user profile is created (this        |
|                                                                        | happens when a user logs in to the hardware node for the first time),  |
|                                                                        | he/she will be granted or denied this privilege based on the default   |
|                                                                        | setting. This parameter allows you to set that default setting. Please |
|                                                                        | note that this parameter only affects new users (the users that will   |
|                                                                        | be created in the future). The profiles of the existing users will not |
|                                                                        | be modified.                                                           |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--device <device> --assignment <host|vm>``                           | Allows to set the assignment mode for the specified VTd device. The    |
|                                                                        | following options are available:                                       |
|                                                                        |                                                                        |
|                                                                        | -  ``host`` - assign the device to the hardware node.                  |
|                                                                        |                                                                        |
|                                                                        | -  ``vm`` - assign the device to virtual machines.                     |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--backup-storage [<user>[:<passwd>]@]<server>[:<port>]``             | The default backup server where to store virtual machine backups.      |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--backup-path <path>``                                               | The name and path of the default directory on the backup server where  |
|                                                                        | to store virtual machine backups.                                      |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--verbose-log <on|off>``                                             | Turns the verbose output for the command on or off.                    |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--cluster-mode <on|off>``                                            | Turns the cluster mode on or off.                                      |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--idle-connection-timeout <timeout>``                                | Sets a timeout interval in seconds after which, if no data has been    |
|                                                                        | received from the storage server or backup client, the process of      |
|                                                                        | backup/restore is terminated.                                          |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--backup-tmpdir <tmp_dir>``                                          | Specifies a temporary directory where special snapshots created during |
|                                                                        | virtual machine backup will be stored. This may be necessary so as not |
|                                                                        | to run out of storage space on physical servers where most of the      |
|                                                                        | storage space is allocated to virtual machines and very little is left |
|                                                                        | for the server itself.                                                 |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--cpu-features-mask <{+|-}feature1,feature2=value[,…]>``             | Changes CPU features mask on the host. To mask/unmask features, use    |
|                                                                        | the ``+feature``/``-feature`` syntax respectively. Omitting the sign   |
|                                                                        | is equvalent to unmasking. Features that require specific value can be |
|                                                                        | set using the ``feature=value`` syntax. To view a full list of host    |
|                                                                        | CPU features which are supported, unmaskable and already masked, run   |
|                                                                        | the ``prlsrvctl info --full`` command.                                 |
|                                                                        |                                                                        |
|                                                                        | .. note::                                                              |
|                                                                        |                                                                        |
|                                                                        |    1. All virtual machines and containers on the host must be stopped. |
|                                                                        |                                                                        |
|                                                                        |    2. You can change CPU features mask only for physical servers.      |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--vm-cpulimit-type <full|guest>``                                    | Specifies the type of virtual machine threads to be affected by the    |
|                                                                        | CPU limit:                                                             |
|                                                                        |                                                                        |
|                                                                        | -  ``full`` (default) - both hardware emulation and guest OS threads   |
|                                                                        |    are limited.                                                        |
|                                                                        |                                                                        |
|                                                                        | -  ``guest`` - only guest OS threads are limited.                      |
|                                                                        |                                                                        |
|                                                                        | With the ``guest`` option, the guest OS is guaranteed to have all the  |
|                                                                        | resources implied by the VM configuration. At the same time, the VM’s  |
|                                                                        | hardware emulation threads spend additional resources of the host. For |
|                                                                        | example, for a VM with two 2.8 GHz vCPUs, switching to guest means     |
|                                                                        | that VM’s guest applications will have all the resources of two 2.8    |
|                                                                        | GHz vCPUs at their disposal.                                           |
|                                                                        |                                                                        |
|                                                                        | .. note::                                                              |
|                                                                        |                                                                        |
|                                                                        |     1. Some types of guest applications, like voice-over-IP software,  |
|                                                                        |        significantly increase expenses on hardware emulation threads.  |
|                                                                        |                                                                        |
|                                                                        |     2. After changing this parameter, restart running virtual machines |
|                                                                        |        for the changes to take effect.                                 |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--vcmmd-policy <density|performance>``                               | Switches the automatic memory management policy on the host:           |
|                                                                        |                                                                        |
|                                                                        | -  ``performance`` (default), used for nodes without memory            |
|                                                                        |    overcommit.                                                         |
|                                                                        |                                                                        |
|                                                                        | -  ``density``, recommended for nodes with memory overcommit.          |
|                                                                        |                                                                        |
|                                                                        | .. note:: Before setting a policy, make sure there are no running      |
|                                                                        |    virtual machines or containers on the host.                         |
+------------------------------------------------------------------------+------------------------------------------------------------------------+
| ``--vnc-ssl-certificate <path> --vnc-ssl-key <path>``                  | Names and paths of SSL certificate file and key used to encrypt VNC    |
|                                                                        | connections on the node. To disable VNC encryption, specify empty      |
|                                                                        | arguments (e.g., '').                                                  |
+------------------------------------------------------------------------+------------------------------------------------------------------------+

.. _prlsrvctl shutdown:

prlsrvctl shutdown
^^^^^^^^^^^^^^^^^^

Shuts down the Virtuozzo component responsible for managing virtual machines and containers. No operations on virtual machines and containers are possible.

::

    prlsrvctl shutdown [-f, --force]

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``-f, --force``                     | Specifies whether the shutdown operation should be forced. If one or more virtual machines and containers |
|                                     | are running, clients are connected, or some tasks are currently in progress, then forcing the shutdown    |
|                                     | will stop all processes automatically and will shut down the Virtuozzo component.                         |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

.. _prlsrvctl usb:

prlsrvctl usb
^^^^^^^^^^^^^

The ``prlsrvctl usb`` command is used to permanently assign a USB device to a specific virtual machine. A permanently assigned USB device will be connected to the virtual machine automatically on server restart. This functionality works only with virtual machines (not containers).

**Subcommands**

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``usb list``                        | Lists USB devices connected to the server together with the information about their virtual machine       |
|                                     | assignments for the current user.                                                                         |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``usb set``                         | Permanently assigns a USB device to the specified virtual machine.                                        |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``usb del``                         | Removes a previously created USB device assignment.                                                       |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

**usb list**

Lists the USB devices connected to the physical server.

::

    prlsrvctl usb list

Returns a list of USB devices in tabular format with the following columns:

-  **Name** - the USB device name.

-  **ID** - a string that uniquely identifies the USB devices on the physical server. The ID never changes even if the device is disconnected from the server and then reconnected again. Please note that if a device ID is listed in quotes, they are a part of the ID and must be included in other calls that use it as an input parameter.

-  **VM UUID** - a universally unique ID of the virtual machine to which this USB device is permanently assigned. If a USB device is not assigned to any virtual machine, this column will be empty.

**usb set**

Permanently assigns a USB device to the specified virtual machine. A permanently assigned USB device will be connected to the virtual machine automatically on server restart. The USB device assignment is performed for the current user only. Other users may create their own USB device assignments. This functionality works only with virtual machines (not containers).

::

    prlsrvctl usb set <usb_dev_ID> <VM_name>

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``<usb_dev_ID>``                    | The USB device ID. To obtain the list of USB devices connected to the server use the ``usb list``         |
|                                     | command.                                                                                                  |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<VM_name>``                       | The name of the virtual machine to which to assign the USB device.                                        |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

**usb del**

Deletes a USB device assignment previously created with the ``usb set`` command. The USB device assignment is performed on the user level, so if you remove an assignment, it will only be removed for the current user. Other users may have their own USB devices assignments, which will not be affected.

::

    prlsrvctl usb del <usb_dev_ID>

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``<usb_dev_ID>``                    | The USB device ID. To see the current USB device assignments for the current user use the ``usb list``    |
|                                     | command.                                                                                                  |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

.. _prlsrvctl user list:

prlsrvctl user list
^^^^^^^^^^^^^^^^^^^

Displays the list of Virtuozzo users. Only those users are displayed who has created at least one virtual machine and container.

::

    prlsrvctl user list [-o, --output <name|mng_settings|def_vm_home>]

+-------------------------------------------------------------+----------------------------------------------------------------------------------+
| Name                                                        | Description                                                                      |
+=============================================================+==================================================================================+
| ``-o, --output <name|mng_settings|def_vm_home>``            | Fields to include in the output. The following fields are available:             |
|                                                             |                                                                                  |
|                                                             | -  ``name`` - User name.                                                         |
|                                                             |                                                                                  |
|                                                             | -  ``mng_settings`` - Indicates whether the user is allowed to modify Virtuozzo  |
|                                                             |    preferences.                                                                  |
|                                                             |                                                                                  |
|                                                             | -  ``def_vm_home`` - The user default virtual machine folder.                    |
|                                                             |                                                                                  |
|                                                             | The fields must be specified in lowercase.                                       |
+-------------------------------------------------------------+----------------------------------------------------------------------------------+

.. _prlsrvctl user set:

prlsrvctl user set
^^^^^^^^^^^^^^^^^^

Configures the profile of the user currently logged in to the Virtuozzo server.

::

    prlsrvctl user set [--def-vm-home <path>]

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``--def-vm-home <path>``            | The default virtual machine and container directory name and path.                                        |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

.. _prlsrvctl cttemplate:

prlsrvctl cttemplate
^^^^^^^^^^^^^^^^^^^^

The ``prlsrvctl cttemplate`` command is used to manage OS and application EZ templates for containers on the Virtuozzo server.

**list**

Lists all the OS and application templates installed on the server.

::

    prlsrvctl cttemplate list

**copy**

Copies the specified OS or application template from the local server to the destination server. To copy an application EZ template, additionally specify the ``os_template_name`` parameter.

::

    prlsrvctl cttemplate copy <dst_node> <name> [<os_template_name>] [-f, --force]

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``<name>``                          | OS or application template name.                                                                          |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<os_template_name>``              | OS template name. Required for copying application templates.                                             |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<dst_node>``                      | Destination server specified in the format [<user>[:<password>]@]<server>[:<port>].                       |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``-f, --force``                     | Specifies whether all validation checks should be skipped.                                                |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

**remove**

Removes the specified OS or application template from the server. 

::

    prlsrvctl cttemplate remove <name> [<os_template_name>]

+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| Name                                | Description                                                                                               |
+=====================================+===========================================================================================================+
| ``<name>``                          | OS or application template name.                                                                          |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+
| ``<os_template_name>``              | OS template name. Required for deleting application templates.                                            |
+-------------------------------------+-----------------------------------------------------------------------------------------------------------+

