Source:Installing guestfs-tools on Linux: Difference between revisions

From SEPsesam
(Marked this version for translation)
(10 intermediate revisions by 2 users not shown)
Line 6: Line 6:


<!--T:2-->
<!--T:2-->
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Beefalo V2'']]|link=[[Special:MyLanguage/VMware|VMware archive]]}}</div></translate><br />
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/5.0.0 ''Jaglion'']]|link=[[Special:MyLanguage/VMware|VMware archive]]}}</div></translate><br />
<translate>==Overview== <!--T:3--></translate>
<translate>==Overview== <!--T:3--></translate>
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 25%; "><center><b><translate><!--T:4-->
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 25%; "><center><b><translate><!--T:4-->
Line 12: Line 12:
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:5-->
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:5-->
[[File:SEP_next.png|45px|link=Special:MyLanguage/4_4_3:VMware_Single_File_Restore|VMware Single File Restore]]</translate>
[[File:SEP_next.png|45px|link=Special:MyLanguage/Web_Single_File_Restore_for_Virtual_Machines|Web Single File Restore for Virtual Machines]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:6-->
See also: [[Special:MyLanguage/4_4_3:VMware_Single_File_Restore|VMware Single File Restore]] – [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [http://libguestfs.org/ <tt>libguestfs</tt> tools for accessing and modifying virtual machine disk images] </translate>
See also: [[Special:MyLanguage/Web_Single_File_Restore_for_Virtual_Machines|Web Single File Restore for Virtual Machines]] – [[Special:MyLanguage/SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [http://libguestfs.org/ <tt>libguestfs</tt> tools for accessing and modifying virtual machine disk images] </translate>
|}
|}


Line 28: Line 28:
[[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide]]</translate>
[[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:12-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:12-->
Problems with VMware? Check [[Special:MyLanguage/Troubleshooting_Guide#VMware|VMware troubleshooting]].</translate>  
Problems with VMware? Check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].</translate>  
|}
|}
</div>
</div>
<translate><!--T:13-->
<translate><!--T:13-->
On Linux, SEP sesam single file restore from virtualization platform backups, e.g., ''VMware vSphere'', requires the <tt>guestfs-tools</tt> 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.
On Linux, SEP sesam single file restore (SFR) from virtualization platform backups, e.g., ''VMware vSphere'', requires the <tt>guestfs-tools</tt> 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 cannot mount the VMDK and consequently, perform a single file restore.


<!--T:14-->
<!--T:14-->
Line 40: Line 40:


<!--T:16-->
<!--T:16-->
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 [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]].   
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 [[Special:MyLanguage/SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]].   


<!--T:17-->
<!--T:17-->
Line 46: Line 46:


<ul><li><translate><!--T:18--> On SLES (SUSE Linux Enterprise Server)</translate></li>
<ul><li><translate><!--T:18--> On SLES (SUSE Linux Enterprise Server)</translate></li>
zypper install guestfs-tools
<pre> zypper install guestfs-tools</pre>
<li><translate><!--T:19--> On Debian and Ubuntu</translate></li>
<li><translate><!--T:19--> On Debian and Ubuntu</translate></li>
apt-get install libguestfs-tools
<pre> apt-get install libguestfs-tools</pre>
<li><translate><!--T:20--> On RHEL and CentOS</translate></li>
<li><translate><!--T:20--> On RHEL and CentOS</translate></li>
yum install libguestfs-tools
<pre> yum install libguestfs-tools</pre>
</ul>
</ul>


==Restrictions and extra steps required on RHEL/CentOS==
<translate>==Restrictions and extra steps required on RHEL/CentOS== <!--T:23-->
Due to restrictions on RHEL mounting Windows VMs will not work. Take a look at [https://libguestfs.org/guestfs-faq.1.html#mount:-unsupported-filesystem-type-with-ntfs-in-rhel-7.2 libguestfs FAQ] for more information.


On RHEL and its Derivates there are additional steps required to get the single file restore working:
<!--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.


1. Open /etc/libvirt/qemu.conf and change the variable user from qemu to root
<!--T:25-->
Additional steps are required on RHEL and its derivatives for single file restore to work:</translate>


2. Restart the service libvirtd, by using  
<ol><li><translate><!--T:26--> Open {{Path|/etc/libvirt/qemu.conf}} and change the variable user from ''qemu'' to ''root''.</translate></li>
systemctl restart libvirtd
<li><translate><!--T:27--> Restart the service libvirtd, by using</translate></li>
<pre> systemctl restart libvirtd</pre>
<li><translate><!--T:28--> Add a new line to {{Path|/usr/lib64/guestfs/supermin.d/packages}} containing libgpg-error.</translate></li>
<li><translate><!--T:29--> Remove old guestmount appliances</translate></li>
<pre> rm -rf /var/tmp/.guestfs-*</pre>
<li><translate><!--T:30--> Test if the guestmount appliance builds without error by running the following</translate></li>
<pre> libguestfs-test-tool </pre>
<translate><!--T:31--> This has to exit with</translate>
<pre> ===== TEST FINISHED OK =====</pre>
</ol>
<translate><!--T:32-->
If selinux is set to enforcing, guestfs-tools cannot access the virtual hard disks provided by SEP sesam, so mount will still fail.


3. Add a new line to /usr/lib64/guestfs/supermin.d/packages containing libgpg-error
==Extra steps required on SUSE== <!--T:33--></translate>


4. Remove old guestmount appliances
<ol><li><translate><!--T:34--> Install augeas ''augeas-lenses e2fsprogs'' on your SEP sesam Server or RDS Linux server.</translate></li>
rm -rf /var/tmp/.guestfs-*
5. Test if the guestmount appliance builds without errors, by executing
libguestfs-test-tool
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 by SEP sesam, so mounting still fails.
 
==Restrictions and extra steps required on SUSE==
 
1. install augeas augeas-lenses e2fsprogs on your SEP sesam Server or RDS Linux server


2. Add new lines to /usr/lib64/guestfs/supermin.d/packages containing  
<li><translate><!--T:35--> Add new lines to {{Path|/usr/lib64/guestfs/supermin.d/packages}} containing the following</translate></li>
<pre>
  libaugeas0
  libaugeas0
  augeas
  augeas
  augeas-lenses
  augeas-lenses</pre>
</ol>


== Checking guestmount capabilities on your system ==
<translate><!--T:46--> To use guestmount on SLES 15 SP4, run the following commands on the SEP sesam Server:</translate>
*<code>echo '/usr/lib64/libgcrypt.so*' > /usr/lib64/guestfs/supermin.d/zz-libgcrypt</code>
*<code>echo '/usr/lib64/libgpg-error.so*' > /usr/lib64/guestfs/supermin.d/zz-libgpg-error</code>


To check whether guestmount works on your system run
<translate>== Checking the guestmount capabilities on your system == <!--T:36-->
 
<!--T:37-->
To check whether guestmount works on your system, run</translate>
  libguestfs-test-tool
  libguestfs-test-tool
<translate><!--T:38-->
If the last line is
If the last line is
  ===== TEST FINISHED OK =====
  ===== TEST FINISHED OK =====
guestmount works correctly.
guestmount works correctly.


<!--T:39-->
You can check what things guestmount currently supports on your system, by running


You can check which things guestmount supports on your system currently, by running
<!--T:40-->
 
guestfish -a /dev/null run : supported
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.


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.
<!--T:42-->
Also you have to add lines for those package names to
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.
You also have to add lines for these package names to
  /usr/lib64/guestfs/supermin.d/packages
  /usr/lib64/guestfs/supermin.d/packages
on the system.
on the system.</translate>


<translate>
<div class="noprint">
<div class="noprint">


==Known issues== <!--T:21-->
==<translate><!--T:47-->
If you have problems with VMware single file restore, check the [[Special:MyLanguage/Troubleshooting_Guide#VMware|VMware troubleshooting]].
Known issues==
If you have problems with VMs single file restore, check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].


==See also== <!--T:22-->
<!--T:22-->
[[Special:MyLanguage/4_4_3:VMware_Single_File_Restore|VMware Single File Restore]] – [[Special:MyLanguage/4_4_3:SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [http://libguestfs.org/ <tt>libguestfs</tt> tools for accessing and modifying virtual machine disk images]</div></translate>
==See also==
[[Special:MyLanguage/Web_Single_File_Restore_for_Virtual_Machines|Web Single File Restore for Virtual Machines]] – [[Special:MyLanguage/SEP_sesam_Quick_Install_Guide#linux|SEP sesam Quick Install Guide]] – [http://libguestfs.org/ <tt>libguestfs</tt> tools for accessing and modifying virtual machine disk images]</div></translate>

Revision as of 16:07, 10 January 2023

Other languages:

Template:Copyright SEP AG en

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


Overview

On Linux, SEP sesam single file restore (SFR) 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 cannot mount the 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.

Additional steps are required on RHEL and its derivatives for single file restore to work:

  1. Open /etc/libvirt/qemu.conf and change the variable user from qemu to root.
  2. Restart the service libvirtd, by using
  3.  systemctl restart libvirtd
  4. Add a new line to /usr/lib64/guestfs/supermin.d/packages containing libgpg-error.
  5. Remove old guestmount appliances
  6.  rm -rf /var/tmp/.guestfs-*
  7. Test if the guestmount appliance builds without error by running the following
  8.  libguestfs-test-tool 

    This has to exit with

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

If selinux is set to enforcing, guestfs-tools cannot access the virtual hard disks provided by SEP sesam, so mount will still fail.

Extra steps required on SUSE

  1. Install augeas augeas-lenses e2fsprogs on your SEP sesam Server or RDS Linux server.
  2. Add new lines to /usr/lib64/guestfs/supermin.d/packages containing the following
  3.  libaugeas0
     augeas
     augeas-lenses

To use guestmount on SLES 15 SP4, run the following commands on the SEP sesam Server:

  • echo '/usr/lib64/libgcrypt.so*' > /usr/lib64/guestfs/supermin.d/zz-libgcrypt
  • echo '/usr/lib64/libgpg-error.so*' > /usr/lib64/guestfs/supermin.d/zz-libgpg-error

Checking the 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 what things guestmount currently supports on your system, 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. You also have to add lines for these package names to

/usr/lib64/guestfs/supermin.d/packages

on the system.