volume flexcache prepopulate start

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
This specifies the Vserver that has the FlexCache volume to be prepopulated.
-cache-volume <volume name> - Cache Volume Name
This specifies the FlexCache volume which needs to be prepopulated.
-path-list <text>, ... - List of Paths
This specifies an array of directory names that need to be prepopulated in the FlexCache volume.
[-isRecursion {true|false}] - Recursively populate
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
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".