set cluster-config

In the R81.10.X releases, this command is available starting from the R81.10.15 version.

Description

Configure the cluster synchronization network to work as a Bond interface.

See:

In WebUI, this corresponds to:

  1. Click the Device view > Advanced section > High Availability page.

  2. Click Configure Cluster.

Syntax

set cluster-config

      priority

            primary

                  bond-mode {802.3ad | high-availability}

                  first-sync-interface <Name of First Subordinate Interface>

                  ha-mode {active-up | primary-up}

                  peer-sync-ipv4-addr <IPv4 Address of Bond on the Peer Cluster Member>

                  second-sync-interface <Name of Second Subordinate Interface>

                  sic-password <SIC Password>

                  sync-ipv4-addr <IPv4 Address of Bond on this Cluster Member>

                  sync-method {optimized | enabled | disabled}

                  sync-network-ipv4-addr <IPv4 Address of Sync Network>

                  sync-subnet <IPv4 Subnet of Sync Network>

            secondary

                  first-sync-interface <Name of First Subordinate Interface>

                  ha-mode {active-up | primary-up}

                  peer-sync-ipv4-addr <IPv4 Address of Bond on the Peer Cluster Member>

                  second-sync-interface <Name of Second Subordinate Interface>

                  sic-password <SIC Password>

                  sync-ipv4-addr <IPv4 Address of Bond on this Cluster Member>

                  sync-network-ipv4-addr <IPv4 Address of Sync Network>

                  sync-subnet <IPv4 Subnet of Sync Network>

      reinitialize-trust-sic-password <SIC Password>

      wait-for-secondary-minutes <1 - 4294967295>‎

Parameters

Parameter

Description

priority primary

Configures the Primary (Active) Cluster Member.

priority secondary

Configures the Secondary (Standby) Cluster Member.

Important - You must run the "set cluster-config priority secondary" command only after the "set initiate-trust-with-primary sic-password <SIC Password>" command (see set initiate-trust-with-primary).

bond-mode

Configures the bond mode for the synchronization network:

  • 802.3ad

    Configure this mode if the subordinate sync interfaces on the peer Cluster Members are connected through a switch.

    In WebUI, this mode is called "Health check".

  • high-availability

    Configure this mode if the subordinate sync interfaces on the peer Cluster Members are connected directly to each other.

    In WebUI, this mode is called "Link state".

Important - This value must be the same on both Cluster Members.

first-sync-interface

Specifies the name of the first subordinate interface in the synchronization bond interface.

This subordinate interface must be disabled (status "off").

Run the "show interfaces table" command and refer to the "status" column.

ha-mode

Configures the Cluster Member recovery method - which Cluster Member to select as Active during a cluster fallback (when the cluster returns to normal operation after a cluster failover):

  • active-up

    This is the default.

    The Cluster Member that is currently in the Active state, remains in this state.

    The other Cluster Member that returns to normal operation, remains in the Standby state.

  • primary-up

    The primary Cluster Member that has the highest priority becomes the new Active.

    The state of the previously Active Cluster Member changes to Standby.

Important - This value must be the same on both Cluster Members.

second-sync-interface

Specifies the name of the second subordinate interface in the synchronization bond interface.

This subordinate interface must be disabled (status "off").

Run the "show interfaces table" command and refer to the "status" column.

sync-method

Configures the working mode of the synchronization network:

  • optimized

    This is the default.

    This mode synchronizes most of kernel tables, to ensure smooth cluster failover.

    This mode does not synchronize large kernel tables (such as "Connections").

  • enabled

    This mode synchronizes all the kernel tables.

    Important - Depending on the number of concurrent connections and the enabled Software Blades, this mode can cause additional load on the CPU.

  • disabled

    This mode disables the synchronization.

Important - Switching the synchronization mode to "optimized-sync" or to "sync-enabled" requires a reboot.

sync-network-ipv4-addr

Configures the IPv4 address of the synchronization network.

Important - This value must be the same on both Cluster Members.

sync-subnet

Configures the IPv4 subnet of the synchronization network (in the format X.X.X.X).

Important - This value must be the same on both Cluster Members.

sync-ipv4-addr

Configures the IPv4 address of the synchronization bond interface on this Cluster Member.

peer-sync-ipv4-addr

Configures the IPv4 address of the synchronization bond interface of the peer Cluster Member.

sic-password

Configures the one-time SIC password for the synchronization network.

The required minimum is four characters.

This password may contain letters, digits, and special characters.

Important:

  • This value must be the same on both Cluster Members.

  • You must use the same SIC password that you used in the "set initiate-trust-with-primary sic-password <SIC Password>" command (see set initiate-trust-with-primary) on the Secondary (Standby) Cluster Member.

reinitialize-trust-sic-password

Configures a new one-time SIC password for the synchronization network.

Important - This value must be the same on both Cluster Members.

wait-for-secondary-minutes

Configures how long the primary Cluster Member must wait for the secondary Cluster Member to join it in the cluster.

Gaia Clish requires the secondary Cluster Member to join the cluster before you can configure cluster interfaces.

Default: 60 minutes

Range: 1 - 4,294,967,295 minutes

Example Commands

  1. On the Primary (Active) Cluster Member, run:

    set cluster-config priority primary bond-mode 802.3ad first-sync-interface LAN1 second-sync-interface LAN2 sync-network-ipv4-addr 172.16.30.0 sync-subnet 24 sync-ipv4-addr 172.16.30.1 peer-sync-ipv4-addr 172.16.30.2 sic-password MyP@asswOrd!

    check primary-cluster-state

  2. On the Secondary (Standby) Cluster Member, run:

    set initiate-trust-with-primary sic-password MyP@asswOrd!

    set cluster-config priority secondary bond-mode 802.3ad first-sync-interface LAN1 second-sync-interface LAN2 sync-network-ipv4-addr 172.16.30.0 sync-subnet 24 sync-ipv4-addr 172.16.30.1 peer-sync-ipv4-addr 172.16.30.2 sic-password MyP@asswOrd!

    check secondary-cluster-state