starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/kubernetes/common_host_tasks/swacting-a-master-controller-using-the-cli.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8) 
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

1.2 KiB
Raw Blame History

Swact Controllers 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.