sdpctl Reference Guide

sdpctl appliance force-disable-controller

Force disable misbehaving Controllers using this command. USE WITH CAUTION!

Synopsis

Force disable Controllers that are misbehaving in any way. This will send a disable command to the primary Controller, which will notify the remaining Controllers of the change. The command will accept one or more hostnames or ID:s of Controllers that will be disabled as an argument. You can get the hostnames by running ‘sdpctl appliance stats’.

sdpctl appliance force-disable-controller [hostname|ID...] [flags]

Examples

  # force disable a Controller with the hostname 'failedcontroller.example.com'
  > sdpctl appliance force-disable-controller failedcontroller.example.com

  # force disable multiple controllers
  > sdpctl appliance force-disable-controller failed1.example.com failed2.example.com

  # force disable using ID:s
  > sdpctl appliance force-disable-controller f905ff0b-91a6-4d12-afbe-f9a9506f02da

  # using the command without arguments will prompt for which controllers to disable
  > sdpctl appliance force-disable-controller
  ? Select Controllers to force disable  [Use arrows to move, space to select, <right> to all, <left> to none, type to filter]
  [ ] failed-controller-1 (failed1.example.com)
  [ ] failed-controller-2 (failed2.example.com)
  [ ] offline-controller (offline.example.com) [OFFLINE]

Options

      --actual-hostname string   If the actual hostname is different from that which you are connecting to the appliance admin API, this flag can be used for setting the actual hostname
  -h, --help                     help for force-disable-controller

Options inherited from parent commands

      --api-version int          Peer API version override
      --ci-mode                  Log to stderr instead of file and disable progress-bars
      --debug                    Enable debug logging
      --descending               Change the direction of sort order when using the '--order-by' flag. Using this will reverse the sort order for all keywords specified in the '--order-by' flag.
      --events-path string       send logs to unix domain socket path
  -e, --exclude stringToString   Filter appliances using a comma separated list of key-value pairs. Regex syntax is used for matching strings. Example: '--exclude name=controller,site=<site-id> etc.'.
                                 Available keywords to filter on are: name, id, tags|tag, version, hostname|host, active|activated, site|site-id, function (default [])
  -i, --include stringToString   Include appliances. Adheres to the same syntax and key-value pairs as '--exclude' (default [])
      --no-interactive           Suppress interactive prompt with auto accept
      --no-verify                Don't verify TLS on for the given command, overriding settings from config file
      --order-by strings         Order appliance lists by keywords, i.e. 'name', 'id' etc. Accepts a comma seperated list of keywords, where first mentioned has priority. Applies to the 'appliance list' and 'appliance stats' commands. (default [name])
  -p, --profile string           Profile configuration to use

SEE ALSO

• sdpctl appliance - Manage the appliances and perform tasks such as backups, upgrades, metrics etc