-
Language:
English
-
Language:
English
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. |