High Availability

connectorctl ha failover

This command initiates failover to a backup connector instance.

connectorctl ha failover

Syntax Description

This command has no keywords or arguments.

Examples

The following example shows how to initiate failover to a backup connector instance.
spacesadmin@connector ~]$ connectorctl ha failover

Executing command:ha
Command execution status:Success
-----------------------
HA failover triggered. This process will take around 30 seconds.

connectorctl ha show

To show the high availability configuration, use the connectorctl ha show command.

connectorctl ha show

Examples

The following example shows how to SSH to a connector in VIP-paired mode before failover. 

[spacesadmin@connector ~]$ connectorctl ha show            
Executing command:ha
Command execution status:Success
-----------------------
mode: VIP Paired
ha_state: ACTIVE
vip: 10.89.45.94
peer_ip: 10.89.45.92
peer_instance_id: 005056a754c8
instance_channel_status: UP
The following example shows how to SSH to the active connector instance after failover. 
[spacesadmin@connector ~]$ connectorctl ha show            
Executing command:ha
Command execution status:Success
-----------------------
HA failover triggered. This process will take around 30 seconds.
[spacesadmin@conn-sec ~]$

[spacesadmin@conn-pri ~]$ connectorctl ha show
Executing command:ha
Command execution status:Success
-----------------------
mode: VIP Paired
ha_state: ACTIVE
vip: 10.89.45.94
peer_ip: 10.89.45.93
peer_instance_id: 005056a7affa
instance_channel_status: UP
The following is a sample output of the command on the backup connector of the VIP pair. 
[spacesadmin@connector ~]$ connectorctl ha show            
Executing command:ha
Command execution status:Success
-----------------------
mode: VIP Paired
ha_state: BACKUP
vip: 10.89.45.94
peer_ip: 10.89.45.92
peer_instance_id: 005056a754c8
instance_channel_status: UP

connectorctl ha restart

To restart the Keepalived services on a connector, use the connectorctl ha restart command.

Note

Keepalived is a service that establishes the High Availability, and maintains the state of High Availability.

connectorctl ha restart

Syntax Description

This command has no keywords or arguments.

Examples

The following is a sample output of the command: 
[spacesadmin@connector ~]$ connectorctl ha restart            
Executing command:ha
Command execution status:Success
-----------------------
Keepalived service restarted successfully.
● keepalived.service - LVS and VRRP High Availability Monitor
   Loaded: loaded (/usr/lib/systemd/system/keepalived.service; enabled; vendor preset: disabled)
   Active: active (running) since Tue 2023-04-25 14:21:10 PDT; 2s ago

Note

Executing this command on an SSH session with a connector configured in VIP mode terminates the SSH session.

connectorctl ha history

To show the history of high availability status, use the connectorctl ha history command.

connectorctl ha history

Syntax Description

This command has no keywords or arguments.

Examples

The following is a sample output of the command: 
[spacesadmin@connector ~]$ connectorctl ha history            
Executing command:ha
Command execution status:Success
-----------------------
Recent HA states and corresponding timestamps are displayed below for instance with IP address: 172.19.28.90
Current state of instance: BACKUP
Apr 24 13:35:10 172 Keepalived_vrrp[1239]: (VRRP1) Entering FAULT STATE
Apr 24 13:35:20 172 Keepalived_vrrp[1239]: (VRRP1) Entering BACKUP STATE
Apr 24 17:42:51 172 Keepalived_vrrp[139964]: (VRRP1) Entering BACKUP STATE
Apr 24 17:43:21 172 Keepalived_vrrp[139964]: (VRRP1) Entering ACTIVE STATE
Apr 24 19:42:31 172 Keepalived_vrrp[176498]: (VRRP1) Entering BACKUP STATE