[pve-devel] [PATCH docs 2/2] vzdump: add section about single file restore

[Dylan Whyte]

Hi,

Have even less notes for this one. Just some little things sounded off 
to me.

Reviewed-by: Dylan Whyte <d.whyte at proxmox.com>

On 4/22/21 10:25 AM, Stefan Reiter wrote:
> Signed-off-by: Stefan Reiter <s.reiter at proxmox.com>
> ---
>   vzdump.adoc | 24 ++++++++++++++++++++++++
>   1 file changed, 24 insertions(+)
>
> diff --git a/vzdump.adoc b/vzdump.adoc
> index 0577a97..c6063ad 100644
> --- a/vzdump.adoc
> +++ b/vzdump.adoc
> @@ -365,6 +365,30 @@ amount of data is required for initial operation, e.g. web servers - once the OS
>   and necessary services are started, the VM is already operational, while the
>   background task keeps copying seldomly used data.
>   
> +Single File Restore
> +~~~~~~~~~~~~~~~~~~~
> +
> +The 'File Restore' button in the 'Backups' tab of the storage GUI can be used to
> +open a file browser directly on the data contained in a backup. This feature
> +is only available for backups on a Proxmox Backup Server.
> +
> +For containers, the first layer of the file tree shows all included 'pxar'
> +archives, which can be opened and browsed freely. For VMs, the first layer shows
> +contained drive images, which can be opened to reveal a list of supported
> +storage technologies found on the drive. In the most basic case, this will be an
> +entry called 'part', representing a partition table, containing entries for each
s/containing/which contains/
> +partition found on the drive. Note that for VMs, not all data might be
> +accessible (unsupported guest file systems, storage technologies, etc...).
> +
> +Files and directories can be downloaded using the 'Download' button, the latter
> +being compressed into a zip archive on the fly.
> +
> +To enable secure access to VM images, which might contain untrusted data, a
> +temporary VM (not visible as a guest) is started. This does not mean that data
> +downloaded from such an archive is inherently safe, but avoids exposing the
s/avoids/it avoids/
> +hypervisor system to danger. The VM will stop itself after a timeout, the entire
s/, the entire/. This entire/
> +process happens transparently from a users point of view.
s/users/user's/
> +
>   [[vzdump_configuration]]
>   Configuration
>   -------------