st_volume_enlarge
This job will enlarge each segment of the volume by at least the given number of blocks, provided that there is enough free space left.
Since a volume is always equally distributed over all nodes and devices, the resulting size may be bigger than requested (but never smaller). The new space is instantly available, but the existing data is not rearranged. This means that all addresses have to be adjusted by a (node-dependent) offset.
Mandatory parameters
| Parameter name | Data type | Description |
|---|---|---|
| vid | integer | ID of an existing volume |
| blocks_per_node | integer | Number of blocks by which each segment of a volume should be enlarged |
Optional parameters
| Parameter name | Data type | Description |
|---|---|---|
| vname | string | Name of an existing volume |
Substitute parameters
The following table describes what parameters can be substituted for another parameter.
| Parameter name | Substitute parameter |
|---|---|
| vid | vname |
| vname | vid |
Allowed users
The following users are allowed to run this job:
- root
Allowed groups
The following groups are allowed to run this job:
- root
- exastoradm
- exaadm
Examples
The following examples show how to run this job in a Python program using XML-RPC or on the command line using confd_client.
Python using XML-RPC