Source:Installing guestfs-tools on Linux: Difference between revisions
(Prepared for translation again.) |
(Marked this version for translation) |
||
Line 53: | Line 53: | ||
</ul> | </ul> | ||
<translate>==Restrictions and extra steps required on RHEL/CentOS== | <translate>==Restrictions and extra steps required on RHEL/CentOS== <!--T:23--> | ||
<!--T:24--> | |||
Due to restrictions on RHEL mounting Windows VMs will not work. Check the [https://libguestfs.org/guestfs-faq.1.html#mount:-unsupported-filesystem-type-with-ntfs-in-rhel-7.2 libguestfs FAQ] for more information. | Due to restrictions on RHEL mounting Windows VMs will not work. Check the [https://libguestfs.org/guestfs-faq.1.html#mount:-unsupported-filesystem-type-with-ntfs-in-rhel-7.2 libguestfs FAQ] for more information. | ||
<!--T:25--> | |||
On RHEL and its Derivates there are additional steps required to get the single file restore working:</translate> | On RHEL and its Derivates there are additional steps required to get the single file restore working:</translate> | ||
<ol><li><translate>Open {{Path|/etc/libvirt/qemu.conf}} and change the variable user from ''qemu'' to ''root''.</translate></li> | <ol><li><translate><!--T:26--> Open {{Path|/etc/libvirt/qemu.conf}} and change the variable user from ''qemu'' to ''root''.</translate></li> | ||
<li><translate>Restart the service libvirtd, by using</translate></li> | <li><translate><!--T:27--> Restart the service libvirtd, by using</translate></li> | ||
systemctl restart libvirtd | systemctl restart libvirtd | ||
<li><translate>Add a new line to {{Path|/usr/lib64/guestfs/supermin.d/packages}} containing libgpg-error.</translate></li> | <li><translate><!--T:28--> Add a new line to {{Path|/usr/lib64/guestfs/supermin.d/packages}} containing libgpg-error.</translate></li> | ||
<li><translate>Remove old guestmount appliances</translate></li> | <li><translate><!--T:29--> Remove old guestmount appliances</translate></li> | ||
rm -rf /var/tmp/.guestfs-* | rm -rf /var/tmp/.guestfs-* | ||
<li><translate>Test if the guestmount appliance builds without errors, by executing</translate></li> | <li><translate><!--T:30--> Test if the guestmount appliance builds without errors, by executing</translate></li> | ||
libguestfs-test-tool | libguestfs-test-tool | ||
<translate>This has to exit with</translate> | <translate><!--T:31--> This has to exit with</translate> | ||
===== TEST FINISHED OK ===== | ===== TEST FINISHED OK ===== | ||
</ol> | </ol> | ||
<translate>If selinux is set to enforcing, guestfs-tools will not be able to access the virtual hard disks provided by SEP sesam, so mounting still fails. | <translate><!--T:32--> | ||
If selinux is set to enforcing, guestfs-tools will not be able to access the virtual hard disks provided by SEP sesam, so mounting still fails. | |||
==Restrictions and extra steps required on SUSE==</translate> | ==Restrictions and extra steps required on SUSE== <!--T:33--></translate> | ||
<ol><li><translate>Install augeas ''augeas-lenses e2fsprogs'' on your SEP sesam Server or RDS Linux server.</translate></li> | <ol><li><translate><!--T:34--> Install augeas ''augeas-lenses e2fsprogs'' on your SEP sesam Server or RDS Linux server.</translate></li> | ||
<li><translate>Add new lines to {{Path|/usr/lib64/guestfs/supermin.d/packages}} containing</translate></li> | <li><translate><!--T:35--> Add new lines to {{Path|/usr/lib64/guestfs/supermin.d/packages}} containing</translate></li> | ||
libaugeas0 | libaugeas0 | ||
augeas | augeas | ||
augeas-lenses | augeas-lenses | ||
</ol> | </ol> | ||
<translate>== Checking guestmount capabilities on your system == | <translate>== Checking guestmount capabilities on your system == <!--T:36--> | ||
<!--T:37--> | |||
To check whether guestmount works on your system run</translate> | To check whether guestmount works on your system run</translate> | ||
libguestfs-test-tool | libguestfs-test-tool | ||
<translate>If the last line is | <translate><!--T:38--> | ||
If the last line is | |||
===== TEST FINISHED OK ===== | ===== TEST FINISHED OK ===== | ||
guestmount works correctly. | guestmount works correctly. | ||
<!--T:39--> | |||
You can check which things guestmount supports on your system currently, by running | You can check which things guestmount supports on your system currently, by running | ||
guestfish -a /dev/null run : supported | <!--T:40--> | ||
guestfish -a /dev/null run : supported | |||
<!--T:41--> | |||
on your SEP sesam Server or the SEP sesam RDS, where the savesets you want to mount are located. | on your SEP sesam Server or the SEP sesam RDS, where the savesets you want to mount are located. | ||
<!--T:42--> | |||
This will show you whether vms with filesystems like btrfs or ntfs can be mounted. You may add this functionality by installing the required packages on your system. | This will show you whether vms with filesystems like btrfs or ntfs can be mounted. You may add this functionality by installing the required packages on your system. | ||
Also you have to add lines for those package names to | Also you have to add lines for those package names to | ||
Line 100: | Line 109: | ||
on the system. | on the system. | ||
<!--T:43--> | |||
<div class="noprint"> | <div class="noprint"> | ||
Revision as of 08:20, 20 November 2020
Overview
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. Check the libguestfs FAQ for more information.
On RHEL and its Derivates there are additional steps required to get the single file restore working:
- Open
/etc/libvirt/qemu.conf
and change the variable user from qemu to root. - Restart the service libvirtd, by using systemctl restart libvirtd
- Add a new line to
/usr/lib64/guestfs/supermin.d/packages
containing libgpg-error. - Remove old guestmount appliances rm -rf /var/tmp/.guestfs-*
- Test if the guestmount appliance builds without errors, by executing libguestfs-test-tool This has to exit with ===== TEST FINISHED OK =====
If selinux is set to enforcing, guestfs-tools will not be able to access the virtual hard disks provided by SEP sesam, so mounting still fails.
Restrictions and extra steps required on SUSE
- Install augeas augeas-lenses e2fsprogs on your SEP sesam Server or RDS Linux server.
- Add new lines to
/usr/lib64/guestfs/supermin.d/packages
containing
libaugeas0
augeas
augeas-lenses
Checking guestmount capabilities on your system
To check whether guestmount works on your system run
libguestfs-test-tool
If the last line is
===== TEST FINISHED OK =====
guestmount works correctly.
You can check which things guestmount supports on your system currently, by running
guestfish -a /dev/null run : supported
on your SEP sesam Server or the SEP sesam RDS, where the savesets you want to mount are located.
This will show you whether vms with filesystems like btrfs or ntfs can be mounted. You may add this functionality by installing the required packages on your system. Also you have to add lines for those package names to
/usr/lib64/guestfs/supermin.d/packages
on the system.