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:

    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.

Note

There are no controls for MSP admins to create, modify or delete a cluster network’s nodes.

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

Caution

Removing a route can immediately stop traffic to the destination network. Services that depend on that route can become unreachable.

Before deleting a route:

  • Verify the destination network is no longer required.

  • Confirm that another valid route exists, if needed.

  • Assess the impact on connected applications and VIPs.

  • Schedule the change during a maintenance window if production workloads coulbd be affected.

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.

      Note

      Currently, for cluster networks, MSP admins can select only Network as the application type.

  3. Select Create to save the application.

Deleting an application

Deleting an application removes the service from the cluster network.

Caution

Considerations Before Deleting

Review the following before proceeding:

  • Service Availability

    Deleting the application immediately stops theassociated service. Clients could lose connectivity.

  • VIP Dependencies

    If the application is associated with a virtual IP, traffic directed to that VIP could fail.

  • IP Address Allocation

    The application might own allocated IP addresses. Confirm whether those IPs should be released or reassigned.

  • Route Dependencies

    The application could rely on specific static routes.

    Removing the application does not remove routes.

  • Change Management

    Perform deletion during a maintenance window if production workloads could be affected.

After deletion, verify that:

  • Required services are still reachable.

  • No unintended IP allocations remain.

  • Monitoring systems reflect the change.

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.

Caution

Considerations Before Deleting

Modifying a VIP can affect traffic immediately.

  • Disabling the VIP stops traffic to the IP address.

  • Changing the direction can alter traffic behavior.

  • Changing the associated service can redirect traffic.

After saving changes, verify that:

  • The VIP responds as expected.

  • Dependent services remain reachable.

  • Monitoring reflects the updated state.

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.

Note

Considerations

  • The IP address must belong to the cluster network subnet.

  • The IP address must not already be allocated.

  • Avoid adding addresses that overlap with existing ranges.

After adding addresses, verify that the new entries appear in the IP Addresses table.

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.

Caution

Considerations for deleting IP Addresses

Deleting an IP address removes it from the cluster network address pool.

Review the following before deleting:

  • Allocated Addresses

    Do not delete an IP address that is currently allocated to a node, application, or VIP.

  • Service Impact

    If a resource depends on the IP address, deleting it can interrupt connectivity.

  • Address Pool Capacity

    Deleting address ranges reduces the number of IP addresses available for allocation.

After deletion, verify that:

  • The address no longer appears in the IP Addresses table.

  • Dependent services continue to function correctly.

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.

  • 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.