Red Hat Training

A Red Hat training course is available for Red Hat Gluster Storage

4.2. glustervolume

Important

The information in this section is provided as a technical preview only.
The glustervolume resource type groups all Red Hat Storage storage volume resources in the Red Hat Storage Console Application.

Table 4.3. 

Name Type Description Required User Creatable User Updatable
--name string The name of the Red Hat Storage volume. Yes Yes No
--replica_count int Defines the file replication count for a replicated volume. No Yes No
--stripe_count int Defines the stripe count for a striped volume. No Yes No
--transport_types collection A reference to available transport methods for the Red Hat Storage volume. See below for collection details. No Yes No
--options-option collection A reference to options for the Red Hat Storage volume. See below for collection details No Yes No
--bricks-brick collection A new Red Hat Storage volume requires a set of Red Hat Storage 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
--volume_type string Defines the Red Hat Storage volume type. Choose from DISTRIBUTE, REPLICATE, DISTRIBUTED_REPLICATE, STRIPE or DISTRIBUTED_STRIPE. Yes Yes No
The --bricks-brick parameter is a collection that uses the sub-parameters in the following table.

Table 4.4. bricks-brick parameters

Name Type Description
brick.server_id string The address of the Red Hat Storage server.
brick.brick_dir string The brick's directory on the Red Hat Storage server.
The --transport_types parameter is a collection that uses the sub-parameters in the following table.

Table 4.5. transport_types parameters

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.

Table 4.6. options-option parameters

Name Type Desciption
option.name string The Red Hat Storage option name.
option.value string The Red Hat Storage option value.
The following table lists additional glustervolume options for resource-based commands.

Table 4.7. Additional command options

Option Description
--cluster-identifier Adds the Red Hat Storage volume to a cluster as a sub-resource.

Example 4.3.  Creating a Red Hat Storage volume with two bricks

[RHSC 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.4. Deleting a Red Hat Storage volume

[RHSC shell (connected)]# remove glustervolume Vol1 --cluster-identifier Cluster_bigbend
The following table lists actions for a Red Hat Storage volume resource.

Table 4.8. Red Hat Storage volume actions

Action Description
start Makes a Red Hat Storage volume available for use.
stop Deactivates a Red Hat Storage volume.
setOption Sets a Red Hat Storage volume option.
resetOption Resets a Red Hat Storage volume option to the default.
resetAllOptions Resets all Red Hat Storage volume options to defaults.
rebalance moves the data across the brick upon shrinking or expanding a volume.
stopRebalance Stops the currently executing rebalance process.
migrate Pertains to starting a remove-brick operation.
stopMigrate Pertains to stopping a remove-brick operation.
activate Pertains to committing the data migration operation.