Cluster-related CLI Commands

Use the asc ha commands to manage High Availability (HA) on CloudControl.

Syntax

asc ha [options]

Option	Description
-d or --disband	Disconnect from the HA cluster. This can only be run from a secondary node.
-h or --help	Displays usage text.
-i or --interval <minutes>	Sets the file synchronization period between nodes in minutes. Arguments must be in one or more minutes. Use 0 to turn off synchronization. By default, files are synced from the primary to the secondary node(s) every 1 minute.
--form <virtual-IP-address> --virtname <virtual-node-name> --mode primary	Form a one-node cluster from a node that was previously set up as standalone. This node will become the primary of the new cluster. Requires the virtual IP address and virtual node name for the cluster.
-j or --join <virtual-IP> --password <password> --mode secondary	Join an existing cluster as a secondary node, with the given virtual IP address and the given htadmin password.
-o or --mode {primary\|secondary}	Changes the current mode of the selected node to the new mode and triggers a failover event. If you run `asc ha --mode secondary` from the primary node, it will become the new secondary. If you run `asc ha --mode primary`from the secondary node, it will become the new primary.
--remove <nodename>	Remove the specified node from the HA cluster.
--sshkeyrotate	Rotate the SSH keys used to exchange messages between nodes.
-t or --status	View the current configuration and operational state of the HA cluster.
-s or --sync	Forces an immediate synchronization of data between the HA nodes.
--virtual-ip {show\|<new-virtual-IP>}	Show or change the virtual IP address.
--virtname {show\|<new-virtual-name>}	Show or change the virtual name.

Examples

Form a one-node cluster with this node as primary with the given virtual IP address.

asc ha --form 192.0.2.134 --mode primary

Create an HA cluster by adding a secondary CloudControl node with the given IP and the htadmin password:

asc ha --join 192.0.2.134 --password PrimaryS3crEt! --mode secondary

Trigger a failover event from the secondary node:

asc ha --mode primary

Synchronize and then trigger a failover event from the primary node:

asc ha --sync --mode secondary

View the HA configuration and status:

asc ha --status

Remove the current node (where the command is being run) from the HA cluster:

asc ha --disband

Remove node3 from the HA cluster:

asc ha --remove node3