Installing guestfs-tools on Linux

From SEPsesam
Jump to: navigation, search
This page contains changes which are not marked for translation.

Other languages:
Deutsch • ‎English

Copyright © SEP AG 1999-2020. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Beefalo V2. For previous documentation version(s), check VMware archive.


On Linux, SEP sesam single file restore from virtualization platform backups, e.g., VMware vSphere, requires the guestfs-tools package to be installed to be able to access and mount the file system of an image on Linux. If the package is not installed on your SEP sesam Server or RDS Linux server, you will not be able to mount VMDK and consequently, perform a single file restore.

To learn more about the guestfs-tools, see libguestfs tools for accessing and modifying virtual machine disk images.

Installing guestfs-tools package

Use the command line to install the guestfs-tools package according to your specific Linux distributions, i.e., SLES, Debian, Ubuntu, RHEL, or CentOS. For details on Linux installation, see SEP sesam Quick Install Guide.

Depending on your Linux distribution, specify the relevant command:

  • On SLES (SUSE Linux Enterprise Server)
  • zypper install guestfs-tools
  • On Debian and Ubuntu
  • apt-get install libguestfs-tools
  • On RHEL and CentOS
  • yum install libguestfs-tools

Restrictions and extra steps required on RHEL/CentOS

Due to restrictions on RHEL mounting Windows VMs will not work. Take a look at libguestfs FAQ for more information.

On RHEL and its Derivates there are additional steps required to get the single file restore working:

1. Open /etc/libvirt/qemu.conf and change the variable user from qemu to root

2. Restart the service libvirtd, by using

systemctl restart libvirtd

3. Add a new line to /usr/lib64/guestfs/supermin.d/packages containing libgpg-error

4. Remove old guestmount appliances

rm -rf /var/tmp/.guestfs-*

5. Test if the guestmount appliance builds without errors, by executing


This has to exit with

===== TEST FINISHED OK =====

6. If selinux is set to enforcing, guestfs-tools will not be able to access the Virtual Harddisks provided bu SEP sesam, so mounting still fails.