Loading...

Deploying a File Recovery Enabler for Linux with OpenStack

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 SnapProtect to create an instance that contains the File Recovery Enabler.

The File Recovery Enabler is deployed as a MediaAgent in restore-only mode, and does not consume a license.

Before You Begin

  • Before creating an instance for Linux file restores, install the latest available service pack for SnapProtect on the CommServe host and Virtual Server Agent.
  • Use the latest available version of the File Recovery Enabler template. The template version must match the installed service pack version.
  • The File Recovery Enabler must be deployed on the same OpenStack cloud and within the same region or domain where the proxy instance is running. 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.

Limitations

  • The File Recovery Enabler does not support file recovery operations for subvolumes of logical volumes in XFS or Btrfs.

Creating a File Recovery Enabler Instance

  1. Go to Cloud Services, log in, access the Download Center, and select Tools > Virtual Server. Download the V11 OpenStack Ready FREL Image package for the installed service pack (for example, SP5) to a location that is accessible from OpenStack.
  2. From the OpenStack Horizon dashboard, create an image based on the V11 OpenStack Ready FREL Image template.

    Use the following options when creating the image:

    • Image File: Select the FREL_OpenStack_SP5.qcow2 template.
    • Format: Select QCOW2 - QEMU Emulator.
    • Minimum Disk (GB): Provide at least 40 GB.
    • Minimum RAM (MB): Provide at least 2048 MB RAM.

    The Launch Instance wizard appears. You can use default options except as noted in the following steps.

  3. On the Details page, specify an Availability Zone in the same region as the instances for which the File Recovery Enabler will be used.
  4. On the Flavor page, choose an instance type that provides at least 50 GB disk space and 2048 MB RAM.
  5. On the Networks page, assign a private network if the CommServe system resides outside of OpenStack.

    If you assign a private network, you must also associate a floating IP address with the private network and modify the client that is created in the CommCell Console.

  6. On the Configuration page, paste the following script into the script box and provide values for commserve_host, commserve_client_name, user_name, password, and client_name:

    CS_IP_OR_FQDN=commserve_host
    CS_SHORT_NAME=commserve_client_name
    CS_USERNAME=user_name
    CS_PASSWORD=password
    FREL_CLIENTNAME=client_name

    Notes:

    • The values in the script are case sensitive.
    • The value for commserve_client_name must be identical to the Client Name value in the virtualization client properties in the CommCell Console, including exactly the same capitalization.
    • The client_name you specify is used to register the File Recovery Enabler and create a client in the CommCell Console.
  7. After launching the instance, if you assigned a private network, associate a floating IP address with the private network.
  8. 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.

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.

Command Line Deployment

You can also use the following command line to create a glance image on the controller node for OpenStack, as shown in the following example:

# glance image-create --name FREL_Cloud --container-format bare --disk-format qcow2 --min-disk 40 --min-ram 2048 --file ./FREL_OpenStack_SP5.qcow2

Modifying the IP Address for the File Recovery Enabler Client

If you assigned a private network, the IP address for the private network is used as the host name for the client that is created in the CommCell Console. After associating a floating IP address, modify the client properties:

  1. From the CommCell Browser, expand the Client Computers tree.
  2. Right-click the client for the File Recovery Enabler, and then select Properties.

    The Client Computer Properties dialog box appears.

  3. On the General tab, click Edit.

    The Edit Client Name Dialog box appears.

  4. Change the Host Name value to the floating IP address for the File Recovery Enabler instance.
  5. Click OK to save the host name.
  6. Click OK to save the client properties.

Updating the File Recovery Enabler

As needed, the template for the File Recovery Enabler is updated to include operating system updates and enhancements. To ensure that the File Recovery Enabler contains all critical fixes and features, upgrade the CommServe host and Virtual Server Agent to the latest service pack, and download the latest template for the File Recovery Enabler to deploy the File Recovery Enabler.

If you have deployed an older version of the File Recovery Enabler, decommission the older version and deploy a new one as described in Creating a File Recovery Enabler Instance.