activate#

`dpsctl topology activate` Usage Guide#

Activate a topology. Deactivate the current topology before you activate a different topology.

Usage#

dpsctl topology activate

Flags#

Includes global dpsctl options.

   --topology value                    topology name (required)
   --replace-topology                  request active-topology replacement (currently rejected; deactivate first) (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#

Before activation, inspect dpsctl topology list and confirm that the topology has the intended policy_bundle.

dpsctl topology activate --topology datacenter

Activation applies the effective typed policies from the selected bundle. A legacy per-entity Policy value can remain in topology data for compatibility, but it does not select a bundle or create an activation binding.

Verify the result without relying on a fixed response example:

dpsctl topology list --active
dpsctl check status --nodes node001,node002

The topology list confirms the active topology and its selected bundle. check status reports each node’s allocated policy identity and access state.

`--replace-topology` Compatibility#

Released 0.9 retains --replace-topology for command compatibility, but rejects switching while another topology is active. Deactivate the active topology before activating a different one.

Notes#

Activation applies the effective policies composed from the topology’s selected policy bundle.
Use --ping-hosts to test connectivity of all hosts
Use --at-least-percent-hosts to set failure tolerance for activation
Deactivate the active topology before activating another topology.
The --replace-topology flag is retained for compatibility, but active topology replacement is currently rejected.