Skip to main content

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.

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".