Clusters

  • Updated on Oct 21, 2025
  • Published on Jul 24, 2023
  • 2 minute(s) read
Prev Next

WHAT TO EXPECT

In this article, users will learn what a Cluster is and how to view, add, edit, and remove Clusters.

General

Clusters are a collection of cloudSwXtches in a given topology. Clusters enable higher throughput and scalability to the swXtch.io overlay network.  

Clusters have 2 types static or dynamic:

  • Static clusters are used pair the number of cloudSwXtches in a static configuration one to one.  For example, for High Availability, where the users want the traffic to go down both the Red and Blue path in a mirrored fashion.

  • Dynamic clusters work in a redundant manner; if one cloudSwXtch goes down, then traffic will be diverted to another cloudSwXtch within the cluster.

Navigating to the Cluster tab

The Clusters tab is located in the System Management page on wXcked Eye. To learn how to navigate there, users should review the wXcked Eye System Management article.

The Clusters tab enables the user to configure their network environment. A cluster can contain any number of cloudSwXthes. For High Availability (2022-7), each cluster that makes up each path must have the same number of cloudSwXtches in the same arrangement. At least two clusters are required in order to configure High Availability, but more can be configured if you have more than two paths.

Below is a simple example of two clusters consisting of only one cloudSwXtch, one for the red path and one for the blue path, that is used in the HA configuration.

The Cluster tab is organized into 3 functions:

Add Cluster

To Add a Cluster:

  1. Click the "Add Cluster" button. A pop-up will open.

  1. Name the Cluster configuration. In this example, the cluster is named HA_Cluster.

  2. Add any tags for the cluster.

  3. Select the Type.

    • Dynamic means one will be designated as the main swXtch, others will be used under the main one. Should the main go down, another one will dynamically take its place as the main.

    • Static means to build a static tree; the flow will statically run through the designated path. For High Availability, it is important to use static.

  4. Enter the swXtch addresses. Note that the system will automatically put in port 80 as the default. If the user has designated a different control port for his cloudSwXtch, enter the port after the cloudSwXtch IP: For example, 172.41.129.135:81.

  5. Click Save.

Example of a Dynamic Cluster:

Example of Static Cluster:

Even if the user is creating a setup for High Availability with only one cloudSwXtch per path, the cluster still has to create two clusters, one for each path. The example below shows that example two clusters with a single component:

Edit Cluster

To edit a Cluster configuration, the user will need to go to the cluster page.

  1. Click "Edit Cluster". A pop-up will open.

  1. Make any necessary changes and select “Save”.

  2. The cluster will be saved.

Delete Cluster

To delete a Cluster configuration:

  1. Click "Delete Cluster." A new prompt will appear, asking to confirm the action.

The Cluster is now destroyed.