4.5. Changing Volume Parameters

4.5.1. vinfra service backup volume-params show

Display volume parameters:

usage: vinfra service backup volume-params show

Example:

# vinfra service backup volume-params show
+----------------+-------------+
| Field          | Value       |
+----------------+-------------+
| failure_domain | host        |
| redundancy     | m: 1        |
|                | n: 2        |
|                | type: raid6 |
| tier           | 0           |
+----------------+-------------+

This command shows the volume parameters of the backup cluster: failure domain, redundancy scheme, and tier.

4.5.2. vinfra service backup volume-params change

Important

Changing redundancy scheme is not recommended, because it may decrease cluster performance. The reason is that re-encoding demands a significant amount of cluster resources for a long period of time. If you still want to change the redundancy scheme, please contact the technical support.

Modify volume parameters:

usage: vinfra service backup volume-params change [--tier {0,1,2,3}] [--encoding <M>+<N>]
                                                  [--failure-domain {disk,host,rack,
                                                  row,room}]
--tier {0,1,2,3}
Storage tier
--encoding <M>+<N>

Storage erasure coding mapping in the format:

  • M: the number of data blocks
  • N: the number of parity blocks
--failure-domain {disk,host,rack,row,room}
Storage failure domain

Example:

# vinfra service backup volume-params change --tier 1 --encoding 1+0 \
--failure-domain host
+---------+--------------------------------------+
| Field   | Value                                |
+---------+--------------------------------------+
| task_id | 28ae19dc-51c9-49bf-bd93-51a763fa181b |
+---------+--------------------------------------+

This command creates a task to change volume parameters of the backup cluster as follows:

  • storage tier to 1
  • erasure coding scheme to 1+0
  • failure domain to host

Task outcome:

# vinfra task show 28ae19dc-51c9-49bf-bd93-51a763fa181b
+---------+--------------------------------------------------------+
| Field   | Value                                                  |
+---------+--------------------------------------------------------+
| details |                                                        |
| name    | backend.presentation.abgw.tasks.ChangeVolumeParamsTask |
| result  |                                                        |
| state   | success                                                |
| task_id | 28ae19dc-51c9-49bf-bd93-51a763fa181b                   |
+---------+--------------------------------------------------------+