st_volume_append_node

With this resizing method, the blocks on the new nodes are appended
to the current address space of the volume. The new space is instantly
available without performance decrease, but the size and redundancy of the
new nodes must be identical to the existing ones. Therefore, the number
of new nodes must be at least as big as the redundancy of the volume.

The number of nodes specified in the node list must be a multiple of the
given number of master nodes. This means that the nodes for a redundancy level
have to be either completely specified, or not at all.
All remaining levels of redundancy are distributed throughout the nodes
of the last specified level of redundancy.

Mandatory Parameters

Parameter Name Data Type Description
vid integer id of an existing volume
node_num integer Number of nodes
node_ids list List of node IDs

Optional Parameters

Parameter Name Data Type Description
vname string Volume name

Substitute Parameters

The below 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 code snippets show how to use this job using both Python (via XML-RPC) and on the command-line using confd_client.

conn.job_exec('st_volume_append_node', {'params': {'vid': 0, 'node_num': 1, 'node_ids': [12]}})
confd_client st_volume_append_node vid: 0 node_num: 1 node_ids: '[12]'