.. _Virtuozzo Automator Command-Line Utilities: Virtuozzo Automator Command-Line Utilities ------------------------------------------ This chapter is an additional reference on the Hardware Node command-line utilities. The chapter documents the utilities that are available after the VA Agent is installed on the Hardware Node. For every utility, all available command-line options are described. .. _vzagroup: vzagroup ~~~~~~~~ The ``vzagroup`` utility is used to logically organize the physical servers and containers. There are two independent ways to design the structure organization. They are called **Infrastructure** and **Logical View** and presented as top-level elements in the Virtuozzo Automator left menu. You can use either one of them or, better, both at once, as their functions are different. For more information on building up a logical structure and combining containers into groups, refer to the :ref:`Organizing Logical Structure` section. The utility is also used as a part of an upgrading procedure for importing data between server. The utility can be run either on a Master server or a Slave server with a different number of available commands. **Running on VA Slave Server** The utility has the following syntax: :: # vzagroup The restoration options are the following: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Command | Description | +===============================================+=================================================================================================+ | ``addToGroup [USER[:PASSWORD]@]ADDRESS`` | Adds the Slave server to the VA group. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``list`` | Lists the physical servers within the VA infrastructure. The command shows the statuses | | | ``(online/offline)`` and roles ``(Master/Slave)`` of the listed servers. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``removeFromGroup [USER[:PASSWORD]@]ADDRESS`` | Removes the Slave server, you are logged into, from the VA group. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ **Running on VA Master Server** The utility has the following syntax: :: # vzagroup Commands: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Command | Description | +===============================================+=================================================================================================+ | ``addContainer /`` option) or | | ``organizational>[/subfolder name]`` | **Logical View** (```` option) context. To indicate the container, specify its | | ``[USER[:PASSWORD]@]ADDRESS `` | ID and the hosting physical server IP address. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``addFolder /[/subfolder name]`` | ```` or ```` option respectively. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``addSlave [USER[:PASSWORD]@]ADDRESS`` | Registers a new Slave physical server in the VA infrastructure. Specify the physical server's | | | IP address. In case the server is registered in another infrastructure, you can force the | | | server re-registration with the ``[--force]`` option. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``delContainer /[/subfolder name]`` | folder/subfolder name where the container belongs, the physical server IP address that host | | ``[USER[:PASSWORD]@]ADDRESS `` | the container and the container ID. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``delFolder /[/subfolder name]`` | | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``list`` | Lists the physical servers within the VA infrastructure. The command shows the statuses | | | ``(online/offline)`` and roles (``Master/Slave``) of the listed servers. | +-----------------------------------------------+------------------------+------------------------------------------------------------------------+ | ``listInfrastructure /[/subfolder name]`` | **Logical View** context. To list the elements of a particular folder/sub-folder, specify its | | | name additionally. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``reconfigure [/option-path-in-xml-`` | Changes the configuration settings for a group of containers, such as, managing permissions, | | ``config option-value]`` | scheduling backups, applying system updates, etc. | | | | | | For example. the log level can be changes with the following command: | | | ``vzagroup reconfigure /data/system/configuration/log_level 5``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``removeSlave [USER[:PASSWORD]@]ADDRESS`` | Unregisters a Slave physical server from the VA infrastructure. Use the ``[--force]`` option | | | to unregister the server even if it's offline. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``[--force]`` | Use the option with the ``addSlave`` and ``removeSlave`` commands. With the ``addSlave`` | | | command, the option forces the Slave registration even if it registered in another | | | Infrastructure. With the ``removeSlave`` command, the option unregisters the slave server | | | even if it is offline. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Upgrade commands: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Command | Description | +===============================================+=================================================================================================+ | ``--switchSlave [USER[:PASSWORD]@]ADDRESS`` | Registers the Slave server from the PIM 4.0 infrastructure in the Virtuozzo Automator | | | Infrastructure. The Slave server's version remains 4.0. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--importSettings`` | Transfers data from the PIM 4.0 infrastructure to the Virtuozzo Automator infrastructure. | | ``[USER[:PASSWORD]@]ADDRESS [options]`` | | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ The options which can be used with the ``--importSettings`` command of ``vzagroup:`` +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``--import-security`` | Imports security settings from 4.0 server (roles, role assignments, users, groups). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-infrastructure`` | Imports infrastructure folders, logical view from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-alerts`` | Imports alerts and events from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-operations`` | Imports task log from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-tasks`` | Imports scheduled tasks from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-messaging`` | Imports physical server messaging settings from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-backup-settings`` | Imports default backup settings from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-ipranges`` | Imports IP ranges from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-samples`` | Imports container templates from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--import-networks`` | Imports virtual networks from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--clear`` | Deletes data from a 6.1 master server before importing information from 4.0 server. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--switch-master`` | Assigns a 4.0 Master server a Slave server role while registering by 6.1 Master server. | | | | | | .. note:: You can also register the server from Virtuozzo Automator. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ .. _vzabackup: vzabackup ~~~~~~~~~ .. note:: This feature is only supported for Virtuozzo 6 servers. The ``vzabackup`` utility is used to back up legacy containers or certain container files/folders and can be run on any Virtuozzo 6 host (including the Source and Backup Nodes) with the ``vzabackup`` package installed. It has the following syntax: :: vzabackup [BACKUP\_OPTIONS] NODE1 ... [CT\_OPTIONS] vzabackup [STORAGE\_OPTIONS] .. note:: For the ``vzabackup`` functionality to work, forward and reverse DNS lookups must be correctly configured for both the Source and Backup Nodes. General backup options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``-F``, ``-I, --Tfull`` | Forces performing a full backup. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-i, --Tinc`` | Makes an incremental backup or, if no full backups are available, a full backup. If this and | | | ``--Tdiff`` options are omitted, the full backup is created. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--Tdiff`` | Makes a differential backup or, if no full backups are available, a full backup. If this and | | | ``-i`` options are omitted, the full backup is created. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-D DESCRIPTION`` | The description of the backup archive. The backup description should always be quoted | | | (e.g. "backup for Container 101"). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-o, --rm-old`` | Creates a new backup and then removes the oldest backup of the specified container. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-d, --rm-tag BACKUP_ID`` | Creates a backup and then removes the backup with the specified ID. You can learn what ID is | | | assigned to this or that container backup by running the ``vzarestore`` utility with the | | | ``-l`` or ``-f`` option. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-Cn, -C0`` | Creates the container backup without any compression. This will speed up the backing up time; | | | however, it may significantly increase the size of the resulting backup archive. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-Cg, -C1`` | Compresses the resulting backups with the normal level of compression. This is the default | | | level of compression used to back up all server/containers. | | | | | | The optimal data compression level depends on the type of files to be stored in the backup | | | archive. For example, it is advisable to use the 'normal' and 'none' compression types if most | | | of the files to be backed up are already compressed (e.g. the files with the ``.zip`` and | | | ``.rar`` extensions) or can be compressed with a low degree of efficiency (e.g. all executable | | | files with the ``.exe`` extension or image files with the ``.jpg``, ``.jpeg``, and ``.gif`` | | | extensions). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-C2`` | Compresses the resulting backups with the high level of compression. The size of the resulting | | | backup file is smaller than that of the backup file compressed with the ``-C0`` and ``C1`` | | | options; however, it takes longer to create the backup file. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-Cb, -C3`` | Compresses the resulting backups with the maximum level of compression. In this case the backup | | | file size is the smallest; however, it may take much time to create such backups. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-J`` | If several servers (Hardware Nodes) are specified, this option tells ``vzabackup`` to back up | | | the specified Hardware Nodes (and their containers) simultaneously. If the option is omitted, | | | the Hardware Nodes are backed up sequentially one after another. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--force`` | Forces the process of backing up the server (Hardware Nodes)/containers. You are recommended | | | to use this option when simultaneously backing up more than one Node/container. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--storage NODE`` | The IP address or hostname and the credentials of the Backup Node where the created backup will | | | be stored. Should be specified in the following format: ``[USER[:PASSWD]]@IP_ADDRESS`` where: | | | | | | - ``IP_ADDRESS`` is the IP address or hostname of the Backup Node, and | | | | | | - ``USER`` and ``PASSWD`` denote the credentials of the ``root`` user used to log in to the | | | Backup Node. | | | | | | When using this option, keep in mind the following: | | | | | | - If you do not indicate the user and/or password to log in to the Backup Node, you will be | | | asked to do so during the ``vzabackup`` execution. | | | | | | - If you are backing up containers residing on the local Node and this local Node is also | | | used as the Backup Node, you do not need to specify the Node credentials, provided that you | | | are logged in to this Node as ``root``. | | | | | | - If the ``--storage`` option is omitted, ``vzabackup`` puts the created container backups | | | to the backup directory on the Source Node. By default, this directory is ``/vz/backups``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``NODE1...`` | The IP address and the root credentials of the Source Node, i.e. of the Node hosting the | | | containers to be backed up. Should be specified in the following form: | | | ``[USER[:PASSWD]]@IP_ADDRESS`` where: | | | | | | - ``IP_ADDRESS`` is the IP address or hostname of the Source Node and | | | | | | - ``USER`` and ``PASSWD`` denote the credentials of the ``root`` user used to log in to the | | | Source Node. | | | | | | When using this option, keep in mind the following: | | | | | | - If you do not indicate the user and/or password to log in to the Source Node, you will be | | | asked to do so during the ``vzabackup`` execution. | | | | | | - If you are backing up containers residing on the Source Node, you do not need to specify | | | the Node credentials, provided that you are logged in to this Source Node as ``root``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-q, --no-progress`` | Disables logging to the screen during the ``vzabackup`` operation. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Per-Container parameters: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``--chain-length NUMBER`` | An incremental backup parameter. After this number of incremental backups, a full backup will | | | be performed. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--chain-days NUMBER`` | An incremental backup parameter. After this number of days, a full backup will be performed. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Container backup options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``-e CT1...`` | The containers to back up on the Source Node. If this and the ``-x`` options are omitted, all | | | containers on the given Node will be backed up. containers can be specified using both their | | | IDs (e.g., ``101`` or ``102``) and their names (e.g. ``server1`` or ``server2``). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-x CT1...`` | The containers that need not to be backed up, i.e. the containers you wish to exclude from the | | | backup process. If this and the ``-e`` options are omitted, all containers on the given Node | | | will be backed up. Containers can be specified using both their IDs (e.g., ``101`` or ``102``) | | | and their names (e.g., ``server1`` or ``server2``). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--include-files FILE_LIST`` | The path to the files and directories inside the container to be included in the backup. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--exclude-files FILE_LIST`` | The path to the files and directories inside the container to be excluded from the backup. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Backup storage options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``--view-folder`` | Displays the path tothe backup storage directory on the local Node. The default directory is | | | ``/vz/backups``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--set-folder PATH`` | Sets a new directory on the local Node where the created backups are to be stored (if the | | | local Node is used as the Backup Node). Uses ``--backup-folder-*`` parameters. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--set-folder-creds USER[:PASSWD]`` | Sets backup storage login credentials. Required for Samba storage. Uses ``--backup-folder-*`` | | | parameters. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--backup-folder-path PATH`` | Path to a custom backup storage location. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--backup-folder-login LOGIN`` | Username for a custom backup storage on a Samba share. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--backup-folder-passwd PASSWD`` | Password for a custom backup storage on a Samba share. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ .. _vzarestore: vzarestore ~~~~~~~~~~ The ``vzarestore`` utility is used to restore legacy containers or certain files/folders from container backup archives, list backups existing on the Backup Node, remove backups, etc. The utility has the following syntax: :: vzarestore [CTID[:NEW_CTID] | -e [] [OPTIONS] [BACKUP_NODE] vzarestore -r,--remove vzarestore -l,--list [LIST_OPTIONS] [BACKUP_NODE] vzarestore --browse BACKUP_ID [BROWSE_OPTIONS] [BACKUP_NODE] vzarestore --print-ct-config BACKUP_ID [BACKUP_NODE] vzarestore --help Restoration options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``-e CTID[:NEW_CTID]...`` | Comma-separated list of containers to restore. Containers can be specified using both their IDs | | | (e.g., ``101``) and their names (e.g., ``computer1``). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-x CT1...`` | Comma-separated list of containers to skip. Containers can be specified using both their IDs | | | (e.g., ``101``) and their names (e.g., ``computer1``). | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-b BACKUP_ID`` | The ID assigned to the container backup. This ID can be used to restore this container or | | | its certain files from the backup with the specified ID. If not specified, the last container | | | backup is used. | | | | | | This option is incompatible with the ``-e`` option. | | | | | | .. note:: ``-b`` is used for restoring files only and can't be used to change the restored | | | container ID. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--force`` | Do not stop on errors during the ``vzarestore`` execution. You are recommended to use this | | | option when restoring more than one container at once. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--skip-ct-config`` | Do not restore the container configuration file. This option can be used only when restoring | | | a single container. | | | | | | .. note:: The container configuration file is not changed when restoring separate container | | | files. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--files PATH`` | The full path to the file/directory inside the container to be restored. This option is | | | incompatible with the ``-e`` option. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--skip-locked`` | Do not stop on errors even if some of the files to be restored are in the 'locked' state. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-B`` | Handles the values after the ``-e`` option as container backup IDs. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--storage NODE`` | The IP address and the credentials of the Backup Node where the container backups are stored. | | | Can be specified in the following form: ``USER[:PASSWD]@IP_ADDRESS``. If this option is | | | omitted, the local Node is treated as the Backup Node. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Miscellaneous options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``-r, --remove BACKUP_ID`` | Removes the container backup with the specified backup ID. You can specify several backup IDs | | | and separate them by spaces. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-l, --list`` | Do not restore any containers. Displays the information on the existing backups located either | | | on the Backup Node or on the local Node if the former is not specified. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--browse BACKUP_ID`` | Displays the contents of the container backup with the specified backup ID. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--print-ct-config BACKUP_ID`` | Displays the configuration file contents of the container with the specified backup ID. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Listing options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``-f, --full`` | Displays the full information on the specified container backup. Used only with ``--list``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--latest`` | Displays the latest containers backups. Used only with ``--list``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-e CT1...`` | Displays the information on the backups for the specified containers only. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``-B`` | Handles the values after the ``-e`` option as container backup IDs. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ Browsing options: +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | Option | Description | +===============================================+=================================================================================================+ | ``-d, --dir PATH`` | Path to a directory inside a container backup archive contents of which you want to see. Used | | | with ``--browse``. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+ | ``--backup-folder-path PATH`` | Path to a custom backup storage location. | +-----------------------------------------------+-------------------------------------------------------------------------------------------------+