Changes to the VRTSpddes.rpm package in 10.5.0.1 for BYO storage server

Problem

For security reasons, the /usr/openv/pdde/pdopensource/supermin_appliance directory has been removed from VRTSpddes.rpm package from 10.5.0.1 BYO storage server. As a result, VMs with the BTRFS file system or using Windows Logical Disk Manager (LDM) will experience the following:

• Instant Access cannot be used to browse, download, or restore files from the VMware backup image.
• Malware scan does not work for the VMs.

Error Message

The virt-access logs under the /var/log/vpfs directory will show:

• "Unknown filesystem type: btrfs" if the VM has a BTRFS file system.
• The "ldmtool: command not found" error if the VM has Windows LDM and the disk did not show up in the Web UI or in the malware scan path. 

Cause

From 10.5.0.1, the /usr/openv/pdde/pdopensource/supermin_appliance directory has been removed from VRTSpddes.rpm for BYO storage servers.

• Since the BTRFS kernel module and btrfs-prog utility is removed from RHEL 8.x, it is not possible to browse, download, file restore, or perform malware scans for virtual machines with the BTRFS file system.
• For upgrades, if the /usr/openv/pdde/pdopensource/supermin_appliance directory does not exist, please follow the same solution. 

Solution

A. To support browsing, download, file restore, and malware scan for Windows VMs:

1. Download and install the libguestfs-winsupport package:

yum install libguestfs-winsupport

If the Window VM has LDM, also install the libldm package:

yum install libldm

2. After the libldm package is installed, run the following commands: 

• echo -e "/usr/bin/ldmtool\n/usr/lib64/libldm-1.0.so.0\n/usr/lib64/libldm-1.0.so.0.0.0" > /usr/lib64/guestfs/supermin.d/hostfiles-for-ldm
• echo -e "readline\nglib2\njson-glib\nlibuuid\ndevice-mapper\nzlib" > /usr/lib64/guestfs/supermin.d/packages-for-ldm

B. To support browsing, download, file restore and malware scan for a VM which has a BTRFS file system

1. Download these three kernel-ml packages from the following page: https://elrepo.org/wiki/doku.php?id=kernel-ml

• kernel-ml-<version>.rpm
• kernel-ml-core-<version>.rpm
• kernel-ml-modules-<version>.rpm 

Note: Do not install the packages yet.

2. Download the btrfs.box.static package from the following GitHub repository:

https://github.com/kdave/btrfs-progs/releases

Note: Select the same version as kernel-ml. 

3. Run the following command to automatically build the supermin appliance with BTRFS support and copy it to the /usr/openv/pdde/pdopensource/supermin_appliance directory:

/usr/openv/pdde/vpfs/bin/build_fixed_supermin_appliance_with_btrfs_support.sh --kernel-ml=/root/kernel-ml-<version>.x86_64.rpm --kernel-ml-core=/root/kernel-ml-core-<version>.elrepo.x86_64.rpm --kernel-ml-modules=/root/kernel-ml-modules-.x86_64.rpm --btrfs-prog=/root/btrfs.box.static 

C. Please remove the /usr/openv/pdde/pdopensource/supermin_appliance directory under the following circumstances:

• when using another version of the supermin appliance
• when adding a new feature for libguestfs
• when upgrading the storage server to a new version