Managing Optimized Backups for File System Subclients

Starting from Feature Release 11.21, optimized backups (formerly known as extent-based backups) are used by default for files that are 1 GB or larger.

Note

The support for enabling optimized backups on older subclients is available only for Windows and UNIX nodes that protect local volumes or UNC shares. Support for Changelist API based file servers such as NetApp, Isilon, Nutanix, and Qumulo is added in the 11.23 release, and you cannot enable optimized backups on older subclients for these file servers.

Before You Begin

The deduplication ratio for a file may be impacted when switching to or from extent-based backup. Thus, depending on the count and sizes of extent-eligible files in a subclient, the deduplication ratio for the first job after changing the property may be expected to be poor.

Procedure

You can enable optimized backups on older subclients created prior to 11.21.

On the client computer, create the bEnableFileExtentBackup additional setting to back up large files in extents as shown in the following table.

For more information on creating the additional setting, see Adding or Modifying Additional Settings from the CommCell Console.

Property

Value

Name

bEnableFileExtentBackup

Category

FileSystemAgent

Type

Integer

Value

1

You can disable the optimized backups for subclients created since 11.21 using the command line interface.

  1. To log on to the CommServe computer, run the qlogin command. For more information on the qlogin command, see QCommands - qlogin.

  2. Download the SubClientProps.xml file to the computer where you will run the command.

  3. In the xml file, enter the values for the following parameters:

    1. Set the value for extentLevelBackup parameter as false.

      If the extentLevelBackup parameter is set to true, then the subclient property Extent backup disabled is set to false. This implies that extent-based backups are enabled.

    2. Enter the appropriate subclientName, backupsetName and ClientName.

    3. Save the xml file.

  4. From software_installation_directory/Base, run the following command:

    qoperation execute -af xml_path\"SubClientProps.xml"

    If the XML file is saved in the software_installation_directory/Base directory, you can exclude the file path (xml_path in the above command).

  5. To log off the CommServe computer, run the qlogout command.

Example

To disable a subclient with the name subclient123, use the following XML:

<App_UpdateSubClientPropertiesRequest>
  <subClientProperties>
    <fsSubClientProp>
    <extentLevelBackup>false</extentLevelBackup>
    </fsSubClientProp>
  </subClientProperties>
  <association>
    <entity>
      <subclientName>subclient123</subclientName>
      <backupsetName>defaultBackupSet</backupsetName>
      <instanceName>DefaultInstanceName</instanceName>
      <appName>Windows File System</appName>
      <clientName>NewFileServer</clientName>
    </entity>
  </association>
</App_UpdateSubClientPropertiesRequest>

Loading...