Converting a Linux MediaAgent to a File Recovery Enabler

A Linux MediaAgent can be installed as a guest agent on a virtual or physical machine to provide backup services for Linux virtual machines. To enable extended file system support, a Linux MediaAgent running on a supported Linux guest operating system can be transformed into a File Recovery Enabler for Linux. This enables the Linux MediaAgent to mount and recover virtual machine backup data for Live Browse and Live Recovery operations, without requiring that granular recovery metadata be collected during backups.

A File Recovery Enabler for Linux can be used with any of the hypervisors supported by the Virtual Server Agent.

For hypervisors that support Linux proxies, the Virtual Server Agent role can also be enabled on the MediaAgent.

Operating System Support

This solution is supported for a Linux MediaAgent on a virtual or physical machine running any of the following operating systems:

  • CentOS 6.4, 6.5, 6.6, 6.7, 7.2
  • Oracle Linux 6 Update 4 (OEL6U4) Red Hat Compatible Kernel
  • Red Hat Enterprise Linux (RHEL) 6.4, 6.5, 6.6, 6.7, 7.2

File System Support

The File Recovery Enabler supports the following file systems:

  • ext2
  • ext3
  • ext4
  • XFS
  • JFS
  • HFS
  • HFS Plus
  • Btrfs

Note:  File Recovery Enabler does not support Live Browse and file recovery operations for subvolumes of logical volumes in XFS or Btrfs.

Before You Begin

  • Use an isolated virtual machine or physical machine for this deployment, not an existing Linux MediaAgent that is used for backup operations.
  • To deploy this solution on a new Linux machine, install the Linux MediaAgent and file system agent in restore only mode as described in Installing Restore Only Agents.
  • Ensure that RPC services are running (for example, rpcbind).
  • Do not deploy a File Recovery Enabler on a virtual machine that was created from the same VM template as VMs being backed up, or that was cloned from the same VM.
  • The Logical Volume Management (LVM) package must be installed on the File Recovery Enabler MediaAgent to enable browsing files and folders on UNIX VMs.
  • For OpenStack, the following packages must be installed on MediaAgents that are converted to act as File Recovery Enablers:
    • QEMU disk image utility (qemu-img)
    • libguestfs
    • libguestfs-tools
    • Logical Volume Management (lvm)
    Note: These packages are included with the template that is used to deploy a new File Recovery Enabler for OpenStack.


  1. Download and install XFS file system packages on the machine where the Linux MediaAgent is installed.
  2. Add two disks or volumes with the XFS file system and create two mount points for cache data:
    • For FBR cache: 40 GB minimum
    • For 3DFS cache:  20 GB minimum
  3. Stop SnapProtect services.
  4. Create a 3Dfs directory in the /etc/CommVaultRegistry/Galaxy/Instance001/ directory.
  5. Create a .properties file in the /etc/CommVaultRegistry/Galaxy/Instance001/3Dfs/ directory
  6. Add the following required registry keys to configure FBR and 3DFS mount paths:
    • For /etc/CommVaultRegistry/Galaxy/Instance001/Session/.properties:
      nFBRSkipFsck 1
      dFBRDIR Path for the FBR cache mount point
      sLNFBR /opt/snapprotect/Base/libCvBlkFBR.so (if not already present)
  7. Create the s3dfsRootDir additional setting on the Linux MediaAgent and specify the path for the 3DFS cache mount point.
  8. Start SnapProtect services.
  9. Run the following script to validate the configuration and settings:


  10. When prompted, provide administrator management user login credentials for the CommCell Console.


After validating the configurations, the script marks the Linux MediaAgent as a File Recovery Enabler for Linux, and the MediaAgent can be used for Live Browse and Live Recovery operations.