add

`dpsctl resource-group add` Usage Guide

Add resources (entities & policy) a resource group.

Resources can be added to both inactive and active resource groups:

Inactive resource groups: Adding resources is a database-only operation. Policies are stored but not applied until the resource group is activated.
Active resource groups: Policies are applied immediately to the hardware and power is reallocated as needed.

Note: Adding resources to a resource group that is currently activating or deactivating will be rejected. Wait for the operation to complete before adding resources.

Usage

dpsctl resource-group add

Flags

Includes global dpsctl options.

  --resource-group string  resource group name
  --entities string        resource entity names (comma-separated list)
  --policy string          resource entity policy name (optional)
  --strict-policy          if requested power policy is not possible, fail instead of switching to a lower policy (only applies when resource group is active)
  --allow-reprovision      allow power policy reprovisioning of other resource groups if there is not enough power (only applies when resource group is active; default: true)
  --help, -h               show help

Examples

Add entities to a resource group

$ dpsctl resource-group add --resource-group example1 --entities node001,node002
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Add entities to a resource group with a default policy

This policy will be applied to only the specified entities. If there are additional entities/nodes in the resource group, the default resource group policy specified on resource group creation will be used for these nodes.

Policies can be updated using dpsctl resource-group update.

$ dpsctl resource-group add --resource-group example1 --entities node003 --policy Node-High
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Add entities to an active resource group with strict policy enforcement

When adding resources to an active resource group, use --strict-policy to ensure the requested policy is applied exactly as specified. If the policy cannot be satisfied due to power constraints, the operation will fail rather than automatically downgrading to a lower policy.

$ dpsctl resource-group add --resource-group example1 --entities node004 --policy Node-High --strict-policy
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Add entities without allowing power reprovisioning

By default, when adding resources to an active resource group, power may be redistributed from other resource groups if needed (power stealing). Use --allow-reprovision=false to prevent this behavior.

$ dpsctl resource-group add --resource-group example1 --entities node005 --allow-reprovision=false
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

add

dpsctl resource-group add Usage Guide