Skip to main content
commvault.com commvault.com
Question

How to install and configure a FREL (File Recovery Enabler for Linux)

  • March 19, 2026
  • 2 replies
  • 62 views
S
Novice
Forum|alt.badge.img

I am presented with the need to install FREL on an existing Linux VM with the operating system already in place, I want to use this FREL for Huawei Fusion Compute Hypervisor, I installed media agent, file server and VSA on this linux, So , How to install and configure a FREL ? whats the next step to make it operational

2 replies

K
Vaulter
Forum|alt.badge.img+1
  • KalaivananVaulter
  • Vaulter
  • March 19, 2026

Hi ​@Sohaib ADJ  

 

Since you have installed Media agent, Virtual Server agents in the Linux VM, please follow the below article in order to convert the Linux VM with MA and VSA role installed to a FREL. 

 

https://documentation.commvault.com/2023e/commcell-console/converting_linux_mediaagent_to_file_recovery_enabler_frel.html

 

Regards,

Kalaivanan. 

yousef
Apprentice
  • yousefApprentice
  • Apprentice
  • April 7, 2026

To install and configure a File Recovery Enabler for Linux (FREL) on an existing Linux VM for use with Huawei FusionCompute, after installing the MediaAgent, File Server, and Virtual Server Agent (VSA) packages, follow these steps:

1. Verify Prerequisites

  • Ensure the Linux VM is running a supported OS (e.g., RHEL 8, 7.5, 7, 6.x).
  • Confirm that the MediaAgent and Virtual Server Agent packages are installed.
  • Make sure rpcbind and other RPC services are running.
  • Install the Logical Volume Management (LVM) package.
  • Install XFS file system packages.

2. Prepare the FBR Cache Disk

  • Add a new disk or volume to the VM.
  • Format it with the XFS file system.
  • Create a mount point (e.g., /fbr_cache) and mount the disk there.
  • Ensure at least 40 GB free space for the FBR cache.
  • Do not use the root directory or a directory with Commvault ransomware protection enabled.

3. Stop Commvault Services

commvault stop

4. Configure FBR Registry Keys

Edit or create the file /etc/CommVaultRegistry/Galaxy/Instance001/Session/.properties and add the following lines:

nFBRDELAYEDINIT=1
nFBRSkipFsck=1
dFBRDIR=/fbr_cache
sLNFBR=/opt/commvault/Base/libCvBlkFBR.so
  • Replace /fbr_cache with your actual XFS mount point.

5. Restart Commvault Services

commvault start

6. Validate FREL Configuration

Run the validation script:

/opt/commvault/Base/cvfbr_validate.sh
  • Provide CommCell Console administrator credentials when prompted.
  • The script will confirm if the configuration is correct and mark the Linux MediaAgent as a FREL.

7. Check in CommCell Console

  • The Linux VM should now appear as a FREL (Access Node) and be available for guest file restores and live browse operations for Huawei FusionCompute.

8. Troubleshooting

  • If the FREL does not appear, check:
    • Network connectivity between the FREL and CommServe.
    • That all required packages are installed.
    • That the FBR cache mount point has enough free space.
    Terms & ConditionsAccessibility statement