4.6. glustervolume
The
glustervolume resource type groups all Gluster storage volume resources in a Red Hat Virtualization environment.
| Name | Type | Description | Required | User Creatable | User Updatable |
|---|---|---|---|---|---|
--name
|
string
|
The name of the Gluster volume.
|
Yes
|
Yes
|
No
|
--volume_type
|
string
|
Defines the Gluster volume type. Choose from
DISTRIBUTE, REPLICATE, DISTRIBUTED_REPLICATE, STRIPE or DISTRIBUTED_STRIPE.
|
Yes
|
Yes
|
No
|
--bricks-brick
|
collection
|
A new Gluster volume requires a set of Gluster bricks to add and manage. This parameter references a collection of brick details. Specify at least one brick but list multiple
bricks-brick parameters for multiple bricks. See below for collection details.
|
Yes
|
Yes
|
No
|
--transport_types
|
collection
|
A reference to available transport methods for the Gluster volume. See below for collection details.
|
No
|
Yes
|
No
|
--replica_count
|
integer
|
Defines the file replication count for a replicated volume.
|
No
|
Yes
|
No
|
--stripe_count
|
Integer
|
Defines the stripe count for a striped volume
|
No
|
Yes
|
No
|
--options-option
|
collection
|
A reference to options for the Gluster volume. See below for collection details.
|
No
|
Yes
|
No
|
The
--bricks-brick parameter is a collection that uses the sub-parameters in the following table.
| Name | Type | Description |
|---|---|---|
brick.server_id
|
string
|
The address of the Gluster server.
|
brick.brick_dir
|
string
|
The brick's directory on the Gluster server.
|
The
--transport_types parameter is a collection that uses the sub-parameters in the following table.
| Name | Type | Description |
|---|---|---|
transport_type
|
string
|
Defines a transport type to use. Specify multiple
transport_type parameters for more than one type. Choose from TCP and RDMA.
|
The
--options-option parameter is a collection that uses the sub-parameters in the following table.
| Name | Type | Description |
|---|---|---|
option.name
|
string
|
The Gluster option name.
|
option.value
|
string
|
The Gluster option value.
|
The following table lists additional
glustervolume options for resource-based commands.
| Option | Description |
|---|---|
--cluster-identifier | Adds the Gluster volume to a cluster as a sub-resource. |
Example 4.14. Creating a Gluster volume with two bricks
[RHEVM shell (connected)]# add glustervolume --cluster-identifier Default --name GlusterVol1 --volume-type DISTRIBUTE --bricks-brick "brick.server_id=UUID,brick.brick_dir=filepath"--bricks-brick "brick.server_id=UUID,brick.brick_dir=filepath"
Example 4.15. Deleting a Gluster volume
[RHEVM shell (connected)]# remove glustervolume --cluster-identifier Default --name GlusterVol1
The following table lists actions for a Gluster volume resource.
| Action | Description |
|---|---|
start | Makes a Gluster volume available for use. |
stop | Deactivates a Gluster volume. |
setOption | Sets a Gluster volume option. |
resetOption | Resets a Gluster volume option to the default. |
resetAllOptions | Resets all Gluster volume options to defaults. |
