Manage an Edge Node

After you create an edge node, you can manage it or reconfigure it when things change. This article covers viewing, updating, and deleting your data store.

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

1. Edge Node Overview  
2. Onboard an Edge Node
3. Manage an Edge Node  - You are here!
4. Use the ZEDEDA CLI to Manage an Edge Node 

Prerequisites

• You must have either the SysManager or SysAdmin role in your ZEDEDA Cloud enterprise.

View Edge Nodes

After you add edge nodes you can view the edge nodes. 

1. From the left panel, go to Edge Nodes.
2. Expand the Summary drop-down to see the Run State Distribution, Edge App Instances Load, and the EVE-OS distribution of Edge Nodes.
3. Observe the list of your edge nodes.
4. Click one of your edge nodes in the list to see its details.

Update an Edge Node

After you add an edge node, you can update it whenever things change.

1. From the left panel, go to Edge Nodes.
2. Click one of your edge nodes in the list to see its details.
3. Click the pencil at the top right of the page.
4. Click the Basic Info tab to update the title or description.
5. Click the Adapters tab to update the network adapters.
6. Click Save. 

Activate an Edge Node

After you add an edge node, it changes to admin status of active by default when it’s online (if you select the Activate Edge Node checkbox during onboarding). If you don’t select the checkbox during onboarding or if you deactivate the edge node, you need to activate the edge node when you’re ready to put it back into operational state. 

1. From the left panel, go to Edge Nodes.
2. Click the checkboxes next to one or more edge nodes that you want to activate.
3. Click the ellipsis (...) at the top right of the page.
4. Select Activate from the drop-down.
5. Confirm the action.

Activating the edge node shows Admin Status as 'Registered' and eventually turns the Run state to 'Online.'

Deactivate an Edge Node

After you activate an edge node, you can deactivate it if you need to stop all the application instances running in the cluster. For example, one reason to deactivate it might be to stop resource consumption, but you might have any reason. 

1. From the left panel, go to Edge Nodes.
2. Click the checkboxes next to one or more edge nodes that you want to deactivate.
3. Click the ellipsis (...) at the top right of the page.
4. Select Deactivate from the drop-down.
5. Confirm the action.

Deactivating the edge node shows Admin Status as 'Inactive' and Run state as 'Unprovisioned.'

Reboot an Edge Node

You can reboot the active edge node to apply changes or recover from issues. 

1. From the left panel, go to Edge Nodes.
2. Click the checkboxes next to one or more edge nodes that you want to reboot.
3. Click the ellipsis (...) at the top right of the page.
4. Select Reboot from the drop-down.
5. Confirm the action.

Rebooting the edge node must show Admin Status as 'Active,' and the Run state will eventually become 'Online.'

Update EVE-OS Image

Before you update the EVE-OS image, you first need to Add a rootfs EVE-OS image to your ZEDEDA Cloud Enterprise. Then you can Mark the EVE-OS image as latest. See the Long Term Support policy to see which versions are supported. 

To update the EVE-OS image: 

1. From the left panel, go to Edge Nodes.
2. Scroll through the list of edge nodes to see if the EVE-OS Image Version column is displaying older versions that you want to update. If you see the “latest” indicator (), then you don't need to update EVE-OS on your Edge Node. 
3. Click the checkboxes next to one or more edge nodes that you want to update.
4. Click the ellipsis (...) at the top right of the page.
5. Select Update EVE-OS Image from the drop-down.
6. Confirm the action.

Prepare Power Off an Edge Node

After you activate an edge node, you can prepare to power off when you need to gracefully shut down the applications running on EVE-OS.

1. From the left panel, go to Edge Nodes.
2. Click the checkboxes next to one or more edge nodes that you want to power off.
3. Click the ellipsis (...) at the top right of the page.
4. Select Prepare Power Off from the drop-down.
5. Confirm the action.

Edge app instances that are halted due to this command will resume their previous state after the edge node is powered back on.

Off-board an Edge Node

You can migrate the edge node across the enterprise retaining the volume instances intact. 

Note: Other than the edge node default network instance and the user-created volume instances, everything else (edge application instances, manually created network instances, etc.) needs to be deleted before offboarding.

For example, suppose the edge node has to be shipped to the low bandwidth customer location. In that case, there will be a delay in downloading the required software (volume instances) and onboarding the edge node into the ZEDEDA platform. In such an instance, all the required software is downloaded to the Edge Node and onboarded to a particular enterprise (for example, a manufacturing facility), where bandwidth connectivity is not an issue. This Edge Node is offboarded from the manufacturing facility enterprise and re-onboarded to either the same or another enterprise (with low bandwidth issues).

When a device is offboarded, the identity is NOT lost/wiped. The device is "archived” and does not belong to any enterprise/tenant while it is archived. When re-onboarded in a new enterprise, the device will register without any extra touch points. However, the device will be onboarded as a "new device"; this means it will lose all the previous configurations. 

The re-onboarding workflow is the same as the initial onboarding. The device serial number of the Edge Node must match while re-onboarding. This is the recommended method.

You can also use the soft serial key to re-onboard. However, this method has its limitations in that the USB stick with the soft serial key may not be available.

1. From the left panel, go to Edge Nodes.
2. Click the checkboxes next to one or more edge nodes that you want to off-board.
3. Click the ellipsis (...) at the top right of the page.
4. Select Off-board from the drop-down.
5. Confirm the action.

Delete an Edge Node

After you add an edge node you can delete it if you no longer need it. After a device is deleted, its identity is completely wiped from the cloud. If the device needs to be re-onboarded, the identity on the device must be reset. The easiest way to achieve that is by re-imaging it and resetting the TPM.

1. From the left panel, go to Edge Nodes.
2. Click the checkboxes next to one or more edge nodes that you want to delete.
3. Click the ellipsis (...) at the top right of the page.
4. Select Delete from the drop-down.
5. Confirm the action.

Download Edge Sync Config

You need to set up Edge Sync before you can download the config. The download instructions are included in that article. 

Next Steps

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

1. Edge Node Overview  
2. Onboard an Edge Node
3. Manage an Edge Node  - You are here!
4. Use the ZEDEDA CLI to Manage an Edge Node 

After you complete the series, you might be interested in the following articles: 

• Add edge applications from the Marketplace, which represents the Metadata manifest of the software application.
  • Add Storage if you’re adding your own app to the local marketplace.
  • Configure inbound and outbound firewall rules for network traffic. For example, see inbound and outbound rules in Add a Container as an Edge App Type or Add a Virtual Machine as an Edge App Type.
• Configure a network instance to enable network connectivity for your edge apps, including enabling edge apps on the same edge node to communicate with one another.
• Deploy the edge application on the edge node.