Deploying a File Recovery Enabler for Linux with Nutanix Acropolis Hypervisor (AHV) Cluster

A File Recovery Enabler for Linux (FREL) enables instance data to be browsed from a backup for the source instance, with support for ext2, ext3, ext4, XFS, JFS, HFS, HFS Plus, and Btrfs file systems. Use the QCOW2 template supplied by Commvault to create an instance that contains the File Recovery Enabler.

Note

  • The File Recovery Enabler for Linux package is deployed as a MediaAgent in restore-only mode, and does not consume a license. The client does not appear in the Client Computers list unless the Show Unlicensed with software (Restore only Clients) option is selected in User Preferences.

  • Live browse and file recovery operations are not supported for XFS realtime subvolumes.

Before You Begin

  • Before creating an instance for Linux file restores, install the latest available service pack for Commvault on the CS host and Virtual Server Agent (VSA).

  • Use the latest available version of the File Recovery Enabler template. For example, you can deploy FREL from an SP24 template and connect it to an SP26 CommServe. You can then upgrade the template to SP26 if needed.

  • The File Recovery Enabler must be deployed on the same Nutanix AHV cluster cloud. Optionally, you can reconfigure the File Recovery Enabler to act as a VSA proxy, in which case the File Recovery Enabler consumes a Virtual Server license.

Procedure

  1. On the Cloud Services website, go to the Commvault Store and download the Nutanix FREL Image with 11.20 n package for the installed service pack (for example, SP20) to a location that is accessible from the Nutanix AHV cluster.

    Note

    The cloud image will only be released for Long-Term Support (LTS) releases. However, releases 25 and 26 are not LTS releases and will not include the cloud image. If you have Commvault software releases 25 or 26, you can deploy using the FR 24 image and then upgrade the software to release 25 or 26 accordingly.

  2. Go to https:// < cluster-IP-or-FQDN > :9440/console/#page/settings/acropolis_image, and then upload the image to the Nutanix AHV cluster.

    A new task is launched.

  3. Check whether the new task is complete at https:// < cluster-IP-or-FQDN > :9440/console/#page/tasks.

  4. Go to VMs page, click Create VM, and then use the following configuration:

    • 1 CPU

    • 1 core/CPU

    • 4GB RAM

    • 1 NIC

  5. Add a disk and select option Clone from Image Service.

  6. Select Custom Script.

  7. In the Type Or Paste Script, paste the following:

    CS_IP_OR_FQDN=commserve_host

    CS_SHORT_NAME=commserve_client_name

    CS_USERNAME=user_name

    CS_PASSWORD=password

    FREL_CLIENTNAME=client_name

    ROOT_PASSWORD=password

    Note

    The user name must have both Global > Administrative Management and Commcell > Install Client permissions.

  8. Click Save.

    A new VM is launched and registered to the CommServe.

    If the attached NIC does not use DHCP, then FREL is expected to fail when registering to the Commserve. You can configure the network manually to successfully complete the FREL deployment process.

    Register to the CommServe After the IP Assignment

    1. Check that FREL can communicate with the CommServe.

    2. Edit /var/lib/cloud/instance/user-data.txt and enter the script parameter values again, (Step 7).

    3. Save the file.

    4. Run /etc/initfrel_sc

  9. Configure a default File Recovery Enabler for Linux to use for UNIX-based file restores as described in Specifying the Default File Recovery Enabler for Linux for a Virtual Server Instance.

  10. You can login to FREL with root account using password given in the script. Once logged in, you can enable root access by modifying /etc/ssh/sshd_config to allow root login (PermitRootLogin yes) and or to allow password authentication (PasswordAuthentication yes), and then restarting ssh services. To use password authentication for root, perform the following steps:

    $ sudo su

    # passwd (enter new password for root)

Note

If you still experience connection issues after deployment, you can also add fully qualified host names and IP addresses for the File Recovery Enabler and the CommServe system to the /etc/hosts files for both machines to ensure that both systems can resolve host names locally.

Page contents

×

Loading...