V11 SP8

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.

Note: For Commvault Service Pack 7 and later, MediaAgents that are able to act as File Recovery Enablers are automatically configured.

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 live browse and file recovery for the following file systems:

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


  • Live browse and file recovery operations are not supported for XFS realtime subvolumes.
  • With Service Pack 8 or later, live browse and recovery is supported for subvolumes of Btrfs file systems.

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 Commvault 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/commvault/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 Commvault 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.