Manage an Edge Node Cluster

Introduction

After you create an edge node cluster, you can manage it. This article explains how to manage edge node cluster instances using the ZEDEDA GUI, including creation, updates, and deletion commands.

Prerequisites

This is a series of articles. You will likely follow them in this order.

  1. Edge Node Cluster Overview
  2. Create an Edge Node Cluster
  3. Manage an Edge Node Cluster - You are here!
  4. Use the ZEDEDA CLI to Manage an Edge Node Cluster
  5. Edge Node Cluster App Instance Failover Behavior

View your Edge Node Clusters

After you create edge node clusters, you can view them.

  1. Select Edge Node Clusters from the left panel.
  2. Observe the list of your edge node clusters.
  3. Click an edge node cluster name to view the tabs for items such as: status, identity, edge node details, and storage.

View status

From Edge Node Clusters > CLUSTER_NAME > Status you can see the information, cluster nodes, edge app instances, and network instances.

Information

Admin status such as:

  • Unspecified
  • Active

Run state such as: 

  • Offline
  • Init
  • Online 
Cluster Nodes The list of individual edge nodes that are part of the cluster. 
  • Name - name of each edge node
  • Status - status of each edge node
    • Unknown
    • Not Ready
    • Ready
      • Ready, MemoryPressure
      • Ready, DiskPressure
      • Ready, PIDPressure
      • Ready, NetworkUnavailable
  • Age - how long ago each edge node was created
  • Internal IP - the internal IP address of each edge node
  • Drawer - quick overview or actions for each edge node, so you don’t have to go back to the Edge Node menu
Edge App Instances The list of individual edge app instances that are part of the cluster.  
  • Name - name of the edge app instance
  • Type - virtual machine, container, module
  • Edge App - name of the edge app the instance is based on 
  • Version - version of the edge app instance 
  • State - Unknown, Init, Downloading, Verifying, Loading, CreatingVolume, Booting, Online, Halted, Halting, Purging, Restarting, StartDelayed
  • CPU - percent of CPU utilization for the last hour
  • Memory - percent of memory used for the last hour
  • Storage - percent of storage utilization allocated
  • Drawer - quick overview or actions for each edge node, so you don’t have to go back to the Edge App Instance menu
Network Instances The list of individual network instances that are part of the cluster.  
  • Name - name of the network instance
  • State - Unknown, Suspect, Error, Init, and Online
  • Kind - local or switch
  • Addressing - v4 or v6

 

View identity

From Edge Node Clusters > CLUSTER_NAME > Identity 

Id Identity number of the cluster. 
Name The name of the cluster.  This can’t be changed after you name it.
Title The title of the cluster. This is a user-friendly name that can be changed at any time.
Project The project that the cluster belongs to.
Description The description to help understand the usage or the purpose (or anything) of the cluster.
Cluster Tags Tags such as env:production.
Cluster-Prefix IP/Subnet mask for the cluster network interface.

 

View edge node details

From Edge Node Clusters > CLUSTER_NAME > Edge Node Details

Id Identity number of the cluster
Name The name of the individual edge nodes
Serial Number The serial number of the individual edge nodes
EVE-OS Image Version EVE-OS image version of the individual edge nodes
Location The location of the individual edge nodes
Edge App Instances Load The load of the individual edge nodes, such as high or low
Project The project that each edge node belongs to
Network Adapters A link to expand and show the adapter details
Drawer Quick overview or actions for each edge node, so you don’t have to go back to the Edge Nodes menu

 

View storage

From Edge Node Clusters > CLUSTER_NAME > Storage 

State State of the cluster volume instances: Creating, Attached, Detached, Attaching, Detaching, Deleting
Name The name of each volume instance
Size The configured maximum size of the volume instance. 
Actual Size The current size of the volume instance. Volume instances are thin provisioned and will only consume the size required by the data stored in it. Note that deleting data in the instance will not make the volume shrink. 
Created The date it was created
Attachment State State of attached storage: Bound, Pending, Available, Released, Failed.
Drawer

Get a quick overview of the following: 

  • Id
  • Run State
  • Current Size
  • SHA256 Hash
  • Access Mode
  • Max Storage Size
  • Type
  • Volume Replicas and their statuses


Rebuilding:

 

Update an Edge Node Cluster

After you create an edge node cluster, you can update it when things change. You can only perform the update/edit operation in the identity tab. 

  1. Select Edge Node Clusters from the left navigation to list already available cluster instances. 
  2. Click any of the edge node cluster instances in the list view to show the detailed view.
  3. Click the Identity tab.
  4. Click the pencil.
  5. Make your changes to title, tags, or the description.
  6. Click Submit

Replace an Edge Node

If an edge node fails (or whatever reason the node needs to be replaced), you can replace it by

  1. From the left navigation, select Edge Node Clusters > CLUSTER_NAME > Edge Node Details.
  2. Select the checkbox for the edge node that needs to be replaced.
  3. Select the ellipsis (...).
  4. Select Replace
  5. Select another Edge Node from the list. 
  6. Select a Network Adapter for the cluster interface, such as eth2 to match your other edge node cluster interface adapters.
  7. Click Replace.
  8. Verify the cluster status at Edge Node Clusters > cluster_name > Status.

Add or Delete an Edge Node

Adding or deleting an edge node to or from the cluster is not supported. Only replace is supported. 

Delete an Edge Node Cluster

After you create an edge node cluster, you can delete it when you no longer need it. You cannot delete an edge node from a cluster if an application instance, network instance, or volume instance is running on it. 

When the edge node cluster is deleted, every node in the cluster will reboot and reconfigure itself to a single node mode. 

  1. Select Edge Node Clusters from the left navigation. 
  2. Click any of the edge node cluster instances in the list view to show the detailed view.
  3. Click the ellipsis (...) in the top right of the page.
  4. Select Delete from the dropdown.
  5. Confirm the deletion. 

Next Steps

This is a series of articles. You will likely follow them in this order. 

  1. Edge Node Cluster Overview
  2. Create an Edge Node Cluster
  3. Manage an Edge Node Cluster - You are here!
  4. Use the ZEDEDA CLI to Manage an Edge Node Cluster
  5. Edge Node Cluster App Instance Failover Behavior

After you’ve completed the series, you might be interested in the following articles. 

Was this article helpful?
0 out of 0 found this helpful