Preparing for File Search and Restore (non-Windows machines)

In this article

    To view, search and restore guest files of non-Windows machines, take the following preparatory steps:

    1. To enable guest file indexing, use one of the options of the machine backup job: Index everything, Index everything except, or Index only following folders option. For more information, see the Guest OS File Indexing section of this guide and the VM Guest OS File Indexing section of the Veeam Backup & Replication User Guide.

    Keep in mind that indexing is optional. You can browse and restore machine guest files from the restore points created without guest indexing. For more information, see Browsing Machine Backups for Guest OS Files and Performing 1-Click File Restore.


    If you want Veeam Backup Enterprise Manager to display symbolic links to folders when browsing through the machine file system at 1-click file restore, enable indexing in the backup job for that machine (running Linux or another non-Windows OS).

    1. For proper file system indexing, Veeam Backup & Replication requires several utilities to be installed on the machine: mlocate, gzip, and tar. If these utilities are not found, you are prompted to deploy them to support index creation.
    2. By default, guest file restore to the original location is performed using the account specified in the machine backup job. If it does not have sufficient access to target machine, you are prompted for the credentials. Specify user account with sufficient access rights.

    For more information, see the Guest OS Credentials section of this guide and the Specify Guest Processing Settings section of the Veeam Backup & Replication User Guide.

    Preparing FLR Helper Appliance

    To perform guest file restore, configure an FLR helper appliance on the Veeam backup server that controls the backup job processing the machine. For details on FLR helper configuration, refer to the Restoring VM Guest OS Files (Multi-OS) section of the Veeam Backup & Replication User Guide. These settings are saved in Veeam Backup & Replication database on per-user basis. The settings are applied each time the user starts file-level restore.

    When guest file-level restore is started from Veeam Backup Enterprise Manager, FLR helper configuration settings are obtained from the database of the backup server. If no FLR helper configuration is found for current user account, Veeam Backup & Replication uses the default settings (set during the latest FLR appliance configuration process in Veeam backup console). Thus, before starting file-level restore from Enterprise Manager, make sure that FLR helper settings are configured on Veeam backup server.


    • When you configure an FLR helper appliance for tenants that will perform self-service restore (from Veeam Self-Service Backup Portal or vSphere Self-Service Backup Portal), be aware that multiple tenants may run the restore procedure at the same time. In this case if you have configured a static IP address for helper appliances, a tenant will not be able to deploy a helper appliance until the IP address is in use by a helper appliance of another tenant. To let tenants start multiple helper appliances, use a DHCP server in your network and configure the helper appliance to obtain an IP address automatically.
    • If you plan to deploy multiple FLR helper appliances to restore machines backed up by different Veeam backup servers, their initial configuration should be performed on the backup servers. Centralized configuration from Veeam Backup Enterprise Manager is not supported.