Considerations and Limitations

Before you restore VM guest OS files, check the following considerations and limitations.

Infrastructure Components

  • Check the supported file systems. For details, see the File-Level Restore section of Supported Platforms and Applications.
  • [For source and target VM] Veeam Backup & Replication uses the ICMP ping command to define whether a VM is available over network. If the VM must be available over the network, check that ICMP protocol is enabled on the VM.

  • Veeam Backup & Replication must have access to the guest OS of the target VM to deploy a coordination process. The coordination process performs a number of administrative actions on the target VM guest OS, for example, collects information about mount points.
  • The mount server, helper host and helper appliance, must have access over the network to a VM whose files you restore and to Hyper-V host where the VM resides.
  • You can restore from Novell Storage Services (NSS) file system only if you use FUSE. When using FUSE, the helper host must differ from the backed-up VM.

Helper Host

If you mount disks to a helper host, consider the following:

  • Check the supported OSes listed in System Requirements.
  • The backup server and the mount server, associated with the repository where the backup is stored, must be able to resolve the FQDN of the helper host.
  • You can restore from ZFS using the helper host option if the zfsutils-linux package is installed on the specified helper host. The package zfs-fuse package is not supported.
  • The helper host OS kernel must support the file system that you plan to mount on this host. Otherwise, the mount will be refused and in rare cases it may cause kernel panic.
  • Make sure that the /tmp directory is mounted with the exec option. Otherwise, you will get an error with the permission denial.
  • For the helper host option, mounting of LVM snapshots is not supported. Thus, LVM snapshots are skipped from processing.
  • [For backups created by Veeam Agent for Linux] The original machine cannot be used as the helper host for the 32-bit versions of the Linux-based OSes. However, for VM backups, you can still use the original VM as the helper host for the 32-bit versions of the Linux-based OSes.
  • Restore from a Btrfs disk using the original host as the helper host is not possible. The issue occurs due to restriction of mounting two Btrfs disks with identical IDs to the same machine. To avoid this issue, use the helper appliance option or a different Linux-based server that supports Btrfs. However, note that Btrfs disks can be restored for backups created by Veeam Agent for Linux. During the backup process, Veeam Agent for Linux changes disk IDs in the backup file.
  • Restore from a ZFS pool using the original host as the helper host is not possible. The issue occurs due to restriction of mounting two ZFS pools with identical UUIDs to the same machine. To avoid this issue, use the helper appliance option or a different Linux-based server that supports ZFS pools.
  • Hardened repositories cannot be selected as helper hosts.

Source for Data Recovery

  • You can restore VM guest OS files from a backup that has at least one successfully created restore point.
  • You can restore files whose names are written in all locales in the UTF-8 encoding. If the encoding is other than UTF-8, you can restore only files whose names are written in the English locale.
  • The multi-OS guest OS file restore wizard does not support restore of deduplicated volumes (for example, Microsoft Windows volumes with data deduplication enabled).
  • You cannot restore files from a backup created in the reverse incremental mode if the backup job is being performed. If the backup is created in the incremental backup mode and the backup job is being performed, you can restore files from any available restore point.
  • [For backups of BSD, macOS and Solaris VMs] You cannot restore files directly to the original location. Use the Copy to option instead.
  • [For backups of Linux workloads] You can restore files from basic disks, Linux LVM (Logical Volume Manager) and ZFS pools. Encrypted, RAID1 and mirrored LVM volumes are not supported.
  • [For backups of Linux workloads] RAID mounts and restores are not supported.
  • [If you restore from backups with guest file system indexing disabled] To properly show the file system tree in the Veeam Backup browser, check that the /etc/fstab file lists disk UUIDs or labels. Disks listed using device names are shown outside the file system tree as separate disks.

    Target for Data Recovery

    • If you plan to restore VM guest OS files to their original location or to another Microsoft Hyper-V VM, Hyper-V Integration Services must be installed on the target VM.
    • The following applies if guest processing components are not installed on the target VM:
    • Make sure that the /tmp directory on the target VM is mounted with the exec option. Otherwise, you will get an error with the permission denial.
    • If you restore files using the account for which only the Elevate account privileges automatically check box is selected, the /home/<username> directory also must be mounted with the exec option.
    • Veeam Backup & Replication uses the SSH protocol to communicate with the target Linux VM and requires the SCP utility on the target VM. Make sure that the SSH daemon is properly configured and SCP utility is available on the target VM.
    • [For restore to a new location] Veeam Backup & Replication can restore ACL for recovered VM guest OS files. To let Veeam Backup & Replication detect the target Linux system architecture and kernel version, the following utilities must be present in the minimal configuration of the system: arch and uname.
    • For backups created by Veeam Agents, you can use the Restore to (restore to a new location) command only if the target computer is available over the network. This applies to backups created by Veeam Agent for Linux, Veeam Agent for IBM AIX or Veeam Agent for Oracle Solaris.

    Linux Firewalls in Helper Host and Target for Data Recovery

    If you want to use the helper host option or if you want to restore files to a new location on another Linux VM, consider the following.

    Veeam Backup & Replication automatically opens ports used for the restore process on the helper host and on the target Linux VM. Generally, Veeam Backup & Replication automatically opens ports for most popular firewalls (iptables, ufw, firewall-cmd). However, if for some reason the ports are not opened, you can open the ports manually. You can also specify these ports at the SSH Connection step of the New Linux Server wizard. Note that ports are opened dynamically: if 10 concurrent jobs are running, Veeam Backup & Replication opens ports 2500-2509.

    If you use the firewalld tool, you can configure firewall rules to open ports only in necessary zones. By default, Veeam Backup & Replication opens ports in all active firewalld zones. If your firewall is configured for different zones, and you want to minimize security holes, you can configure Veeam Backup & Replication to open the ports only for certain zones. To do this, perform the following:

    1. On the helper host or target Linux host, create the /etc/VeeamNetConfig file and define the following parameter:

    FirewalldZones=zone_name_1, zone_name_2

    where zone_name_1, zone_name_2 is a list of zone names where the ports must be open. Veeam Backup & Replication will skip the zones that are not in this list.

    1. [Only for helper host] If you select a Linux host that is already added to the Veeam Backup & Replication infrastructure, you should also add required zones to the /opt/veeam/transport/VeeamTransportConfig file.

    FirewalldZones=zone_name_1, zone_name_2

    Note

    Veeam Backup & Replication opens the port 2500 in all zones even if you have specified the required zones in configuration files.

Page updated 9/11/2024

Page content applies to build 12.2.0.334