# Cluster Networks

A cluster network defines Layer 2 and Layer 3 connectivity
within a switch domain.

You use a cluster network to control VLAN tagging, IP
addressing, MTU, and routing for cluster traffic.

Cluster networks are scoped to a single switch domain. This
ensures traffic isolation and clear operational boundaries.

## Cluster Networks Management

### View Cluster Networks

The Cluster Networks page displays all defined cluster
networks.

To view cluster networks:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.

The list view includes the following columns:

* **Name**

  The unique name of the cluster network.
* **VLAN ID**

  The VLAN tag associated with the network.
* **MTU**

  The maximum transmission unit in bytes.
* **Subnet CIDR**

  The IPv4 subnet in CIDR notation.
* **Connected Nodes**

  The number of nodes attached to the network.
* **Switch Domain**

  The switch domain that owns the network.

Select a cluster network name to open its details page.

#### View a Cluster Network’s details

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select a cluster network name to open its details page.

Each cluster network is associated with:

* **Name**

  A descriptive identifier of the cluster network.
  This value is defined during creation and is displayed in list and
  detail views.
* **VLAN ID**

  The VLAN tag assigned to the cluster network.
  This value identifies the Layer 2 broadcast domain used for traffic
  isolation.
* **MTU**

  The maximum transmission unit, in bytes.
  This value defines the largest packet size allowed on the network.
* **Connected Nodes**

  The number of nodes currently attached to the cluster network.
  This value indicates active participation in the network.
* **Nameservers**

  DNS server entries assigned to the cluster network.
  These values define how hosts in the network resolve domain names to
  IP addresses.
  Each entry can be an IPv4 address or a DNS hostname.
* **Switch Domain**
  The switch domain that contains the cluster network.
  This value determines the logical networking boundary.
* **ID**

  The unique identifier of the cluster network.
  This value is defined during creation and is displayed in list and
  detail views.
* **Subnet CIDR**

  The IPv4 subnet in CIDR notation. This value defines the
  address space available for IP allocations.

A cluster network can also include associated components, displayed in the
following tabs:

* **Nodes** tab

  Displays nodes connected to the cluster network, including
  their IP address, Node ID, admin state, and operational
  state.
* **Routes** tab

  Displays configured static routes for the cluster network,
  including destination networks and next-hop addresses.
* **Applications** tab

  Displays applications associated with the cluster network,
  including application type, switch domain, and linked
  cluster network.
* **VIPs** tab

  Displays virtual IP resources attached to the cluster
  network, including direction and sharing status.
* **IP Addresses** tab

  Displays individual IPv4 addresses and address ranges
  defined for the cluster network, including allocation
  status and ownership details.

### Create a Cluster Network

Creating a cluster network defines connectivity parameters
for a specific switch domain.

To create a cluster network:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select **Create**.
4. Complete the wizard steps.

#### Info Step

The Info step defines core network properties.

Fields:

* **Name**
  Enter a unique name for the cluster network.
* **Switch Domain**
  Select the switch domain that will contain the network.
  Only one switch domain can be selected.
* **VLAN**
  Select an existing VLAN.
  You can also create a new VLAN from this field.
* **Subnet CIDR**
  Enter the IPv4 subnet in CIDR format
  (for example, 10.16.24.0/21).
* **MTU**
  Enter a value between 1500 and 9216.
  The value is typically aligned with the switch domain.

#### IP Ranges Step

Define IP allocation ranges for the subnet.

You can:

* Create individual IP addresses
* Create IP address ranges

Create IP Address Range dialog fields:

* **Start IP**
  The first IPv4 address in the range.
* **End IP**
  The last IPv4 address in the range.

Create IP Address dialog fields:

* **IP Address**
  A single IPv4 address inside the subnet.

#### Routes Step

Define static routes for the cluster network.

Create Route dialog fields:

* **Destination**
  The destination network in CIDR format
  (for example, 0.0.0.0/0).
* **Next Hop**
  The IPv4 address of the next-hop gateway.
* **Policy Routing Table**
  The routing table identifier.
  The default value is 0.

#### Nameservers Step

Define DNS servers for the cluster network.

Fields:

* **Nameserver**
  Enter an IPv4 address or DNS name.

After completing all steps, submit the wizard to create the
cluster network.

### Update a Cluster Network

Updating a cluster network modifies its configuration.

To update a cluster network:

1. Go to **Cluster Networks**.
2. Select the required cluster network.

   The details screen opens.

   Some of the cluster network tabs permit updating associated components,
   as follows:
   <style> .green {color:#008000; font-weight:bold; font-size:20px} </style>
   <style> .red {color:#EE4B2B; font-weight:bold; font-size:20px} </style>

   | Tab          | Update existing   | Add new   | Delete existing   |
   |--------------|-------------------|-----------|-------------------|
   | Nodes        | ✗                 |           |                   |
   | Routes       | ✗                 | ✓         | ✓                 |
   | Applications | ✗                 | ✓         | ✓                 |
   | VIPs         | ✓                 |           |                   |
   | IP Addresses | ✗                 | ✓         | ✓                 |

#### View Nodes

The **Nodes** tab displays all nodes connected to the cluster network.

To view the Nodes tab:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **Nodes** tab.

The table lists the following details for each associated node:

* **Node Name**
  The display name of the connected node.
  This value identifies the node in the environment.
* **IP Address**
  The IPv4 address assigned to the node within the cluster network.
* **Node ID**
  The unique identifier of the connected node.
* **Admin State**
  The administrative state of the node interface,
  such as enabled or disabled.
* **Operational State**
  The runtime state of the node interface, such as up or down.

#### View or Manage Routes

The **Routes** tab displays all routes configured for the selected cluster
network.

Each entry represents a routing rule that directs traffic to a specific
destination network.

The Routes tab allows you to review existing routing rules
and verify traffic forwarding behavior for the cluster
network.

To view the Routes tab:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **Routes** tab.

The table lists the following details for each associated route:

* **Destination**
  The target network in CIDR format.
  This defines the address range that the route applies to.
* **Next Hop**
  The IPv4 address of the gateway used to reach the destination network.

##### Creating a new route

To create a new route for the selected cluster network:

1. From the **Routes** tab’s toolbar, select **+ Create**.

   The **Create Route** dialog opens.
2. Enter the required fields.
   * **Destination**

     Enter the destination network in CIDR format (for example, 0.0.0.0/0).
     This defines the network that the route will match.
   * **Next Hop**

     Enter the IPv4 address of the gateway.
     This is the address used to forward traffic to the destination.
   * **Policy Routing Table**

     Enter the routing table identifier.
     This value determines which routing table processes the route.

     The default value is 0.
3. Select **Create** to save the route.

##### Deleting a route

To delete an existing route configured for the selected cluster network:

1. In the selected cluster network’s **Routes** tab, select the route
   to delete.
2. From the **Routes** tab’s toolbar, select **Delete**.

   The **Delete Route** dialog opens, displaying the selected route’s ID.
3. Select **Delete** to confirm deleting the route.

   The route no longer appears in the **Routes** tab list.

#### View or Manage Applications

The **Applications** tab displays all applications that are
attached to the selected cluster network.

Each entry represents a network-based service that uses the
cluster network for connectivity.

Use this tab to review which services depend on the cluster
network before making configuration changes, such as route
modifications or deletion.

To view the Applications tab:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **Applications** tab.

The table lists the following details for each associated application:

* **Name**

  The application name.
  This identifies the service in the environment.
* **Type**

  The application type, such as `network` or `virtual_ip`.
  This indicates the function of the application.
* **Switch Domain**

  The switch domain associated with the application.
  This confirms the logical networking boundary.
* **Cluster Network**

  The cluster network to which the application is attached.
  This shows the connectivity context for the service.

##### Creating a new application

To create a new application for the selected cluster network:

1. From the **Applications** tab’s toolbar, select **+ Create**.

   The **Create Application** dialog opens.
2. Enter the required fields.
   * **Name**

     Enter a unique name for the application.
   * **Application Type**

     The application type determines the behavior of the application.

     Select the application type.
3. Select **Create** to save the application.

##### Deleting an application

Deleting an application removes the service from the cluster network.

To delete an existing application configured for the selected cluster
network:

1. In the selected cluster network’s **Applications** tab, select the
   application to delete.
2. From the **Applications** tab’s toolbar, select **Delete**.

   The **Delete Application** dialog opens, displaying the selected
   application’s name.
3. Select **Delete** to confirm deleting the application.

   The application no longer appears in the **Applications** tab list.

#### View or Manage VIPs

From the cluster network details page, select **VIPs** to view virtual IP
resources.

VIPs table columns include:

* **Name**
  The VIP name.
* **Switch Domain**
  The associated switch domain.
* **Cluster Network**
  The linked cluster network.
* **Direction**
  Traffic direction, such as inbound or outbound.
* **Shared**
  Indicates whether the VIP is shared.

The **VIPs** tab displays all virtual IP resources that are
attached to the selected cluster network.

Each entry represents a logical IP address that can be used
to expose or receive traffic for a service.

The table includes:

* **Name**

  The name of the virtual IP resource.
  This identifies the VIP in the environment.
* **Switch Domain**

  The switch domain that contains the VIP.
  This confirms the networking boundary.
* **Cluster Network**

  The cluster network to which the VIP is attached.
  This defines the subnet and VLAN context used by the VIP.
* **Direction**

  The traffic direction associated with the VIP, such as inbound or
  outbound.
  This defines how the VIP handles traffic flow.
* **Shared**

  Indicates whether the VIP is shared across multiple services or
  dedicated to a single service.

Use the VIPs tab to review external exposure and service
entry points before modifying routes, IP ranges, or deleting
the cluster network.

##### Modifying a Virtual IP (VIP)

You can modify a virtual IP from the cluster network details screen.

To modify a VIP:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **VIPs** tab.
5. Select the required VIP.
6. Select **Modify**.

   The **Modify VIP** dialog opens.

   Some of the VIP fields can be modified:
   * **Name**

     The display name of the virtual IP.
     Update this value to change how the VIP appears in the system.
   * **Cluster Network**  (Display only, cannot be modified)

     Displays the cluster network to which the VIP is attached.
     This value is read-only.
   * **IP Address**

     The IPv4 address assigned to the VIP.
     This value identifies the logical service endpoint.
     Update this value to assign a different IP address to the VIP.
   * **Enable**
     * **Select** to enable the VIP.
     * **Clear** to disable the VIP.

     Disabling a VIP stops traffic without deleting it.
   * **Direction**

     Defines how traffic is handled.

     Select the traffic direction:
     * **Inbound**
     * **Outbound**
   * **Service**

     This value links the VIP to a specific service.

     Enter or select the associated service.
   * **Shared**
     * **Select** to allow the VIP to be shared.
     * **Clear** to dedicate the VIP to a single service.
7. Select **Finish** to apply the changes.

#### View or Manage IP Addresses

The **IP Addresses** tab displays all IPv4 addresses defined
for the cluster network.

This includes both allocated addresses and addresses that
are available for allocation.

Each entry represents an IP resource within the subnet
defined for the cluster network.

To view the cluster network’s IP Addresses:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **IP Addresses** tab.

   The table of IP Addresses displays all IPv4 addresses defined
   for the cluster network.

   This includes both allocated addresses and addresses that
   are available for allocation.

   Use this tab to review address usage, verify allocations,
   and confirm that sufficient IP capacity remains available
   within the subnet.

   Each entry in the table represents an IP resource within the subnet
   defined for the cluster network:
   * **IPv4 Address**

     The IP address assigned within the cluster network subnet.
   * **Node ID**

     The identifier of the node associated with the IP address, if the
     address is allocated.
   * **Status**

     The allocation state of the IP address, such as **allocated** or
     **free**.
   * **Owner ID**

     The identifier of the resource that owns the IP address.
   * **Owner Type**

     The type of resource that owns the IP address, such as an application or
     network interface.

##### Creating new IP Addresses

You can add individual IP addresses or IP address ranges to
a cluster network from the **IP Addresses** tab.

To add IP addresses:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **IP Addresses** tab.
5. Select one of:
   * **+ Create** to add a single IP address.

     The **Create IP Address** dialog opens.
     * **IP Address**

     Enter a single IPv4 address within the subnet defined for the
     cluster network.
     The address must be unique and must belong to the subnet CIDR of the
     network.
   * **+ Create Range** to add a range of addresses.

     The **Create IP Address Range** dialog opens.
     * **Start IP**

       Enter the first IPv4 address in the range.
       This value defines the beginning of the address block.
     * **End IP**

       Enter the last IPv4 address in the range.
       This value defines the end of the address block.
6. Select **Create** to add the address or address range.

##### Deleting an IP Address

You can delete individual IP addresses from a cluster network.

To delete an IP address from a cluster network:

1. Go to **Region Networking**.
2. Select **Cluster Networks**.
3. Select the required cluster network name.
4. Select the **IP Addresses** tab.
5. Select the IP address to remove.
6. Select **Delete**.

   The **Delete IP Address** dialog opens, displaying the IP address and
   its ID.
7. Select **Ok** to confirm deleting the IP address.

### Delete a Cluster Network

Deleting a cluster network removes it from the switch domain.

Before deletion, ensure no dependent resources remain attached to it.

Dependencies can include:

* Nodes
* Routes
* Applications
* VIPs
* IP allocations

To delete a cluster network:

1. Go to **Cluster Networks**.
2. Select the required network.
3. Select **Delete**.
4. Confirm the action.

## Recommended Best Practices

* Use clear, descriptive names for cluster networks.
* Separate environments by using different switch domains.
* Avoid overlapping subnet CIDRs across cluster networks.
* Align MTU values with the physical network design.
* Define IP ranges before deploying applications.
* Review static routes carefully before applying them.
* Remove unused cluster networks to reduce complexity.

## Troubleshooting Cluster Networks

### Cluster Network Not Visible

* Verify you are in the correct region.
* Confirm the correct switch domain is selected.
* Check user permissions.

### IP Allocation Fails

* Ensure the IP is inside the defined subnet CIDR.
* Confirm the IP is not already allocated.
* Verify the defined IP ranges include the address.

### Route Does Not Work

* Validate the destination CIDR format.
* Confirm the next-hop IP is reachable.
* Check for conflicting routes.

### Connectivity Issues

* Verify VLAN ID configuration.
* Confirm MTU consistency across nodes.
* Review nameserver entries.
* Check switch domain boundaries.

Use the cluster network overview page to verify:

* VLAN ID
* Subnet CIDR
* MTU

Correct configuration mismatches and retest connectivity.