activate

dpsctl topology activate Usage Guide

Activate a topology.

Usage

dpsctl topology activate

Flags

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 help

Examples

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-hosts to test connectivity of all hosts
  • Use --at-least-percent-hosts to set failure tolerance for activation
  • Use --replace-topology to switch from an active topology to a new one