Skip to main content

volume flexcache prepopulate start

Contributors
Suggest changes

Prepopulate flexcache volume

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

The `volume flexcache prepopulate start` command is used to prepopulate a FlexCache volume with the data of given directory path(s) from the origin volume.
Note The FlexCache prepopulate job fails when the directories listed with the -path-list have one or more non-existing paths.

Parameters

-cache-vserver <vserver name> - Cache Vserver Name (privilege: advanced)

This specifies the Vserver that has the FlexCache volume to be prepopulated.

-cache-volume <volume name> - Cache Volume Name (privilege: advanced)

This specifies the FlexCache volume which needs to be prepopulated.

-path-list <text>,…​ - List of Paths (privilege: advanced)

This specifies an array of directory names that need to be prepopulated in the FlexCache volume.

[-isRecursion {true|false}] - Recursively populate (privilege: advanced)

This specifies that the directories listed with the -path-list need to be recursively prepopulated in the -cache-volume FlexCache volume.

The default value is true.

[-exclude-path-list <text>,…​] - Exclude List of Paths (privilege: advanced)

This specifies an array of directory names that need not be populated.

Note The path provided should be absolute path. If same path provided is for include and exclude path list then include-path will take the preference

Examples

The following example triggers FlexCache volume prepopulate:

cluster1::> flexcache prepopulate start -cache-volume vol_cache2_vs3_c2_vol_origin1_vs1_c1 -cache-vserver vs3_c2 -path-list /dir1 -isRecursion false
  (volume flexcache prepopulate start)
[JobId 164]: FlexCache prepopulate job queued.
cluster1::> flexcache prepopulate start -cache-volume vol_cache2_vs3_c2_vol_origin1_vs1_c1 -cache-vserver vs3_c2 -path-list /dir1
  (volume flexcache prepopulate start)
[JobId 188]: FlexCache prepopulate job queued.
cluster1::> flexcache prepopulate start -cache-volume vol_cache2_vs3_c2_vol_origin1_vs1_c1 -cache-vserver vs3_c2 -path-list /dir1, dir5, dir6
  (volume flexcache prepopulate start)

Error: command failed: Path(s) "dir5, dir6" does not exist in origin volume
       "vol_origin1_vs1_c1" in Vserver "vs1_c1".