starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/kubernetes/common_host_tasks/swacting-a-master-controller-using-the-cli.rst
Stone 0d7d14b0c2 File structure reorg 
Changed names of kubernetes and openstack subdirs, and reorganized index files
for consistency with other docs.

Signed-off-by: Stone <ronald.stone@windriver.com>
Change-Id: I234dd88e500f12e7c68b0e8bc5b68ca6e0875aba
2021-02-22 13:04:19 -05:00

1.2 KiB
Raw Blame History

Swact a Master/Controller Using the CLI

Swacting initiates a switch of the active/standby roles between two controllers.

Swact is an abbreviated form of the term Switch Active (host). When selected, this option forces the other controller to become the active one in the HA cluster. This means that all active system services on this controller move to standby operation, and that the corresponding services on the other controller become active.

Complete this procedure when you need to lock the currently active controller, or undertake any kind of maintenance procedures; for example, when updating hardware or replacing faulty components.

  • Run the following command from the controller's command line.

    ~(keystone_admin)$ system host-swact <hostname>

    If necessary, you can use the --force option to force a swact.

    ~(keystone_admin)$ system host-swact --force <hostname>

    Caution

    The --force option bypasses semantic checks and may cause service failures.