volume flexcache create

Contributors

Create a new cache relationship

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

Description

The `volume flexcache create` command is used to create a FlexCache volume. It also creates the relationship between the FlexCache volume and the specified origin volume.
Note If the vserver and origin-vserver are different, the Vservers must be in a peer relationship.

Parameters

-vserver <vserver name> - Vserver

This specifies the Vserver on which the FlexCache volume is to be created.

-volume <volume name> - Cache Volume Name

This specifies the name of the FlexCache volume that is to be created.

{ -aggr-list <aggregate name>,…​ - List of Aggregates for FlexGroup Constituents

Specifies an array of names of aggregates to be used for creating the FlexCache volume.

[-aggr-list-multiplier <integer>] - Aggregate List Repeat Count

Specifies the number of times to iterate over the aggregates listed with the -aggr-list parameter when creating a FlexGroup. The aggregate list will be repeated the specified number of times. Example:

-aggr-list aggr1,aggr2 -aggr-list-multiplier 2

will cause four constituents to be created in the order aggr1 , aggr2 , aggr1 , aggr2 .

+
The default value is 4.

| -auto-provision-as <FlexGroup> - Automatically Provision as Volume of Type }

Use this parameter to automatically select existing aggregates for provisioning the FlexCache volume.

[-size {<integer>[KB|MB|GB|TB|PB]}] - Volume Size

This optionally specifies the size of the FlexCache volume. The size is specified as a number followed by a unit designation: k (kilobytes), m (megabytes), g (gigabytes), or t (terabytes). If the unit designation is not specified, bytes are used as the unit, and the specified number is rounded up to the nearest 4 KB.

[-origin-vserver <vserver name>] - Origin Vserver Name

This specifies the name of the Vserver where the origin volume is located.

-origin-volume <volume name> - Origin Volume Name

This specifies the name of the origin volume.

[-junction-path <junction path>] - Cache Junction Path

This optionally specifies the FlexCache volume’s junction path. The junction path name is case insensitive and must be unique within a Vserver’s namespace.

[-foreground {true|false}] - Foreground Process

This specifies whether the operation runs in the foreground. The default setting is true (the operation runs in the foreground). When set to true, the command will not return until the operation completes.

Examples

The following example triggers FlexCache volume create:

cluster1::> flexcache create -vserver vs34 -volume fc1 -aggr-list aggr34,aggr43 -origin-volume origin1 -size 400m
  (volume flexcache create)
  [Job 894] Job succeeded: Successful
cluster1::> flexcache create -vserver vs34 -volume fc3 -auto-provision-as flexgroup -origin-volume origin1 -size 400m
  (volume flexcache create)
[Job 898] Job succeeded: Successful
cluster1::> flexcache create -vserver vs34 -volume fc4 -aggr-list aggr34,aggr43 -origin-volume origin1 -size 400m -junction-path /fc4
  (volume flexcache create)
[Job 903] Job succeeded: Successful