Loading...

Filter Guidelines

Use the following guidelines while entering the filters:

  • Use filters only if absolutely necessary. Filters can decrease the performance of backup operations.
  • When a backup is performed on a subclient, any child paths from other subclients are automatically filtered.

    Caution: For NetApp file servers, data can be lost when a subclient contains a directory and the parent folder of that directory is also in the contents of a different subclient. For example, if a subclient backup contains /vol/myvol and another subclient has a content path /vol/myvol/dir1, then all files and directories named dir1 will be automatically filtered from the subclient that contains /vol/myvol.

  • To filter a specific path, add the complete path to the filter tab. The path filter must match a backup path on the subclient.

    For example, when a subclient contains /myfs/myserver/, to filter a subfolder named tempdata, enter the filter as /myfs/myserver/tempdata.

  • The following table contains vendor-specific filter guidelines:

    Hitachi NAS (BlueArc)

    • You can specify an unlimited number of filters for each subclient.
    • Full path filters are supported.

      The wildcard character is supported at the end of a path filter. For example, /_VOLUME_/myvol/dir1/tmp* will filter all files and folders in the path that start with "tmp".

    • File and directory name filters are supported. Do not include the slash / in any name filters.

      The * wildcard is supported at the front or end of a name filter. For example, tem* will filter all files and folders with names that start with "tem".

    Dell

    • You can specify a maximum of 32 filters for a subclient. The 32 filter maximum includes any automatically added filters.
    • Full path filters are not supported for Dell FluidFS versions below 1.5.0. For example, the filter /myfs/data/dir is not valid for these versions
    • Dell FluidFS versions 1.5.0 and above support full path filters for directories or files. If the path is a directory, then all files and folders in that directory will be excluded from the backup. You can also add a wildcard character at the beginning or the end of the last element in a full path filter.
    • You can specify a maximum of 32 paths filters for supported versions, in addition to the maximum 32 file or directory name filters.

    Dell EMC VNX / Celerra/VNX/VNXe/Unity

    • Full path filters are supported.
    • By default, you can specify a maximum of 5 directory filters and 5 file filters. The number of filters can be increased to 50 for each filter type by using the PAX.filter.numDirFilter or PAX.filter.numFileFilter parameters. Please consult the vendor documentation for information on configuring these parameters.
    • Filters are supported for DART OS 5.5 or higher.
    • Filters are not supported for volume-based backups (VBB). For information about volume-based backups (VBBs), see Volume Based Backup.

    Dell EMC Isilon

    • Filters are supported only for Dell EMC Isilon version 6.5.4 and later.
    • Full path filters are supported.
    • The following wildcards are supported
      • Multiple character wildcard: *
      • Single character wildcard: ?
      • Character range wildcard: [a-z]

        For example, the filter file[a-z] will match files named filea, fileb, filec, and so on.

      • Choice range wildcard: [abc]

        For example, the filter file[123] will match files named file1, file2, and file3.

    • Refer to vendor documentation for additional information.

    IBM Sonas, IBM Storwize

    • You can specify a maximum of 32 filters for a subclient. The 32 filter maximum includes any automatically added filters.
    • Full path filters are not supported. For example, the filter /myfs/data/dir is not valid.

    NetApp

    • You can specify a maximum of 32 filters for a subclient. The 32 filter maximum includes any automatically added filters.
    • Full path filters are not supported.

      For example, the filter /vol/myvol/dir1 will either filter nothing or might filter all files and directories named dir1.

    • When you specify a file or directory name and there are multiple files (and/or directories) with the same name in different locations, all of them will be excluded from the backup.

      For example, the filter dir1 will exclude all files and directories named dir1 from the backup.

    • The .snapshot directory is automatically filtered for NDMP Agent backups.
    • The asterisk * wildcard character is only supported at the beginning or the end of a filter.

    Stratus

    Full path filters are not supported. For example, the filter /myfs/data/dir is not valid.

Last modified: 3/1/2019 2:59:49 AM