activate
dpsctl topology activate Usage Guide
Activate a topology.
Usage
dpsctl topology activateFlags
Includes global dpsctl options.
--topology value topology name (required)
--replace-topology replace to the new topology if another topology is active (default: false)
--ping-hosts test connectivity of all hosts in topology (default: true)
--at-least-percent-hosts value at least this percent of hosts must be reachable for activation to succeed (requires ping-hosts) (default: 50)
--help, -h show helpExamples
Basic Usage
$ dpsctl topology activate --topology datacenter
{
"node_statuses": {
"node001": {
"policy": {
"Name": "Node-High",
"Limits": [
{
"ElementType": "Node",
"PowerLimit": {
"Watts": 10200
}
}
],
"Properties": {}
},
"status": {
"ok": true,
"diag_msg": "Policy applied successfully"
}
},
"node002": {
"policy": {
"Name": "Node-Medium",
"Limits": [
{
"ElementType": "Node",
"PowerLimit": {
"Watts": 8000
}
}
],
"Properties": {}
},
"status": {
"ok": true,
"diag_msg": "Policy applied successfully"
}
}
},
"status": {
"ok": true,
"diag_msg": "Topology activated successfully"
}
}Activate with Host Replacement
$ dpsctl topology activate --topology datacenter --replace-topology
{
"node_statuses": {
"node001": {
"policy": {
"Name": "Node-High",
"Limits": [
{
"ElementType": "Node",
"PowerLimit": {
"Watts": 10200
}
}
],
"Properties": {}
},
"status": {
"ok": true,
"diag_msg": "Policy applied successfully"
}
}
},
"status": {
"ok": true,
"diag_msg": "Topology activated successfully"
}
}Activate with Connection Failures
$ dpsctl topology activate --topology datacenter --ping-hosts
{
"node_statuses": {
"node001": {
"policy": {
"Name": "Node-High",
"Limits": [
{
"ElementType": "Node",
"PowerLimit": {
"Watts": 10200
}
}
],
"Properties": {}
},
"status": {
"ok": false,
"diag_msg": "Failed to connect to node: connection timeout"
}
}
},
"status": {
"ok": false,
"diag_msg": "Topology activation failed: some nodes are unreachable"
}
}Notes
- Activation validates connectivity and policy consistency
- Power policies are applied to entities with default policies
- Entities without default policies are capped at idle power if available
- Use
--ping-hoststo test connectivity of all hosts - Use
--at-least-percent-hoststo set failure tolerance for activation - Use
--replace-topologyto switch from an active topology to a new one