Live browse fails with "Device mismatch detected" error

Symptom

Live browse of files and folders on the guest VMs might fail as a result of UUID conflicts with physical volumes (PVs) on the FREL.

The fbr.log file contains the following error:

Device mismatch detected

Cause

If the virtual machine where a File Recovery Enabler for Linux is installed is based on the same VM template or image as the guest virtual machines or instances that the FREL is browsing, then live browse of files and folders on the guest VMs might fail as a result of UUID conflicts with physical volumes (PVs) on the FREL.

Resolution

To resolve this issue, change the UUIDs of the PVs on the FREL:

1. List all the physical volumes:

   pvs -o --noheadings
   

2. Change the UUID for each PV listed in step 1.

   pvchange -f --uuid pv_name --config "global {activation=0}"
   

3. List all the volume groups:

   vgs -o vg_name,vg_uuid,pv_name --noheadings
   

4. Run the following commands to change the UUIDs and rename each of the volume groups listed in step 3 and activate the changed configuration:

   vgchange --uuid vg_name --config "global {activation=0}"
   

   vgrename old_vg_name new_vg_name
   

   vgchange -ay new_vg_name
   

5. If there are logical volumes (LVs) on the volume groups that were renamed in the preceding step, the device paths for the LVs typically contain the VG name (for example, /dev/vg_name-lv_name). If /etc/fstab contains those device paths, update the paths to use the new volume group name. For example, the following command could be used for each volume group, specifying the old and new VG names:

   sed -i -e 's/old_vg_name/new_vg_name/g' /etc/fstab
   

   As a result of this command, a device path such as /dev/old_vg_name-lv_name would be renamed as /dev/new_vg_name-lv_name.

6. Rename bootloader entries in /boot/grub2/grub.cfg and /etc/default/grub. For example, the following commands could be used for each volume group, specifying the old and new VG names:

   sed -i -e 's/old_vg_name/new_vg_name/g' /boot/grub2/grub.cfg
   

   sed -i -e 's/old_vg_name/new_vg_name/g' /etc/default/grub
   

7. Reboot the FREL machine and verify that all Commvault services are running.