Network instances

Network instances enable you to configure network connectivity and routing for your edge applications. This document describes how to manage local and switch network instances using the ZEDEDA GUI.

Prerequisites

This document assumes that you are familiar with the following:
  • The content in our Networking overview.
  • Essential networking topics, such as IP addressing, subnetworks, gateways, NTP serevers, static and connected routing, etc.
 

View your network instances

  1. Hover on the Library dropdown menu.
  2. Select Network Instances from the options.
  3. Observe both the list of your instances and the Summary drop down panel.
  4. Click on one of your instances in to see its details.
 
NOTE: The orange arrow icon (Default_indicator.png) marks a network instance as a default instance.

Create a network instance

  1. Navigate to your Network Instance list view.
  2. Click the Add icon at the top right of your page.
  3. Configure your new instance. Refer to the following subsections for information about your options.
  4. When you finish setting up your new instance, click Add. A toast message will appear.
  5. Refer to the list view to verify that your instance was successfully created.

Identity configuration

When you fill in the identity details, note that you can't change the Name value after you create your instance. Also, you can use your network instance's tags to to attach them to your projects during project creation. If you do so, your network instance will be automatically applied to all edge apps that you add to that project.

Switch instances

When you create a switch network instance, you need to select an edge node before you can select a port. After you select an edge node from the Edge Node dropdown, the Port dropdown options will populate with the ports available on the node that you selected.

If you don't care which port your edge apps use, select the Uplink option, which indicates that ZEDEDA Cloud should automatically select one of the designated edge node's ports.

Local instances

When you create a local network instance, you need to designate a port and provide various IP addresses. You also have the option to designate a new instance as default for the edge node that you select.

As with switch networks, you need to select an edge node before you select the port, and the Uplink option indicates that ZEDEDA Cloud should automatically choose an available port.

When you configure the instance's IP addresses, you have the option to let ZEDEDA Cloud do so automatically, or to provide the required addresses yourself.

Static and connected routes

You have the option to designate static and connected routes when you create a local network instance. Note that these two types of routes are not the same, nor are they interdependent. You can designate static routes without establishing a connected route, or vice versa.

We recommend that you do use either a static or a connected route if the edge apps that will use your new instance will be connected to more than one port. If you don't do so, your edge apps will use a "default route". Default routes are unreliable when an edge app connects to more than one port. If an edge app is connected to two ports, for example, without a static or connected route, roughly half of the time, the default route will lead the app's traffic to the wrong port, causing a dropped packet.

Connected routes will ensure that your app's traffic is directed to the appropriate destination within the same subnetwork as the app.

Static routes will ensure that your app's traffic is directed to the appropriate destination outside of the app's subnetwork.

Any static or connected routes that you add to your instance will be automatically propagated to all edge app instances using the network instance.

Update a network instance

  1. Navigate to your Network Instances list view and select an instance.
  2. Click on the Basic Info tab.
  3. Click on the pencil icon.
  4. Make your changes.
  5. Click Submit. A toast notification will appear.

Delete a network instance

  1. Navigate to your Network Instance list view and select an instance.
  2. From the details page of your chosen instance, click the meatballs icon in the top right of the page.
  3. Select Delete form the drop down options.
  4. Confirm the deletion. A toast message will appear.

NOTE: Network Instances cannot be deleted if attached to more than one edge app Instance.

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