Converting a Linux MediaAgent to a File Recovery Enabler for Linux

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 virtual machine backup data for Live Browse and Live Recovery operations, without requiring that granular recovery metadata be collected during backups.

Before You Begin

  • This solution is supported for a Linux MediaAgent on a virtual or physical machine running any of the following operating systems:
    • Oracle Linux 6 Update 4 (OEL6U4) Red Hat Compatible Kernel
    • Red Hat Enterprise Linux (RHEL) 6.4, 6.5, 6.6, 6.7, or 7.2
    • CentOS 6.4, 6.5, 6.6, 6.7, or 7.2
  • 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).
  • The Logical Volume Management (LVM) package must be installed on the File Recovery Enabler MediaAgent to enable browsing files and folders on UNIX VMs.


  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.