Create a Network

Add a Network

You must assign each port of an edge node to a network object, unless the port is disabled or directly attached to an application. You can configure primary and fallback management network ports for an edge node. For example, you could configure a node to use wireless connectivity only when its ethernet connection goes down, or vice versa.

1. Hover on Library in the side nav on the left of the page.
2. Click on Networks.
3. Click the Add icon at the top right of your page.
4. Continue on to the configuration sections as needed, such as configure the network identity.
5. Click Add when finished.

Configure the Network Identity

1. Enter the network Name.
   This is unique across the enterprise and cannot be changed.
2. Enter the network Title.
   This value is not used by the ZEDEDA Cloud system. It’s offered to give you more flexibility in organizing your enterprise. It can be changed after you create the object. 
3. Select the network Project.
   For your first-time setup the project is created for you, and you just select it here. 
4. Enter a Description to help other admins understand the purpose of the network or any important details.
5. Select the Default Enterprise Network if you want this network to be the default for your entire enterprise. This can save you some time in the future if you have a network that you always want assigned to the ethernet or wi-fi ports of any new edge node that you create. 
6. Enter the Maximum Transmission Unit (MTU).
   MTU is the largest IP packet that the underlying link can carry, in bytes.
   
   • Default values (if you don’t specify a value):
     • 1500 for Ethernet and Wi-Fi.
     • Determined by network provider for cellular modems.
   • Minimum value:
     
     • 1280 (the minimum link MTU needed to carry an IPv6 packet).

7. Continue on to configure the network details.

Configure the Network Details

1. After you configure the network identity, configure the details by selecting the IP address Kind.
   You can choose from IPv4 or IPv6.
2. Select the IP assignment type in the DHCP field.
   • Manual: Allows a device to have a static IP address assigned manually.
   • Passthrough: EVE-OS will not run a DHCP client and will not receive an IP address. But if used with a switch NI, applications connected to it can run DHCP clients and receive IP addresses from the external DHCP server. 
   • Client: Automatically obtain an IP address and other network configuration settings from a DHCP server. When the client connects to the network, it sends a request to the DHCP server, which assigns an IP address from its available pool. This setup is common for most consumer devices like laptops and smartphones.
3. Continue on to add a wireless network configuration or add a proxy as needed.

Add a Wireless Network Configuration

You can choose to add a wireless configuration to your network when you create it. You might do this in a scenario where you expect that a wired connection will not always be available between your edge nodes and ZEDEDA Cloud. Your choices are wi-fi or cellular. 

Configure wi-fi

1. After you configure network details, add a wireless configuration by selecting Add Wireless Config.
2. Select Wi-Fi. 
3. Enter the wi-fi SSID.
   The name of your wireless local area network (WLAN).
4. Enter the Key Management Scheme based on what your wi-fi uses.
   • WPA-PSK: Uses pre-shared key
   • WPA-Enterprise: Uses IEEE 802.1X to provide unique credentials for each user on the network
5. Enter the Username for your wi-fi network, if it has one.
6. Enter the Password for your wi-fi network. 
7. Enter the Priority for your wi-fi network.
   Ranging from 0 to 7. The default value is 0, indicating no priority is set. A higher value indicates a higher priority. If you have two wi-fi networks with different priorities assigned to a node, where both have the same cost, that's when you need a priority.

Configure cellular

1. Select Add Wireless Config.
2. Select Cellular. 
3. Enter the APN.
   The cellular modem's carrier uses a mobile phone set to connect to the gateway between the carrier's network and the internet.
4. Select an Authentication Protocol.
   • Password Authentication Protocol
   • Challenge Handshake Authentication Protocol
   • Both PAP and CHAP
5. Select a Radio Access Technology.
   • 5G (Only)
   • 5G (Preferred), 4G, 3G
   • 4G (Only)
   • 4G (Preferred), 3G
   • 3G (Only)
6. Enter a Preferred Network.
   This field is optional. In most cases, you will leave this unset and let the modem select the most appropriate carrier at the given location. If you choose to set a preferred network, this field referrs to the cellular carrier (such as AT&T, Verizon, T-Mobile) that your device should attempt to connect to first, when it has the choice of multiple networks. Enter the PLMN code of the preferred network provider (see https://en.wikipedia.org/wiki/Public_land_mobile_network).
7. Toggle to Enable Roaming.
   If you expect that your edge node might be out of range. 
8. Select Connectivity Probing if you want to automatically check for reachability on a regular basis. 
   • Select a Probing Method of ICP Ping or TCP Handshake. 
   • Enter a Custom Probing Address (IP) for the device that you want to reach. 
   • Enter the TCP port if you have chosen TCP Handshake as the probing method.
   • Toggle to Send GPS Data. 

Add a Proxy

You can add a proxy server to the network if there is a proxy server in your environment and the edge node is behind it.

1. Select Add Proxy.
2. Select a Type.

• • Auto Proxy Discovery: allows the edge device to automatically discover the proxy settings.
  • Manual: allows you to manually specify the proxy server details.
  • PAC File: settings will be determined by a Proxy Auto-Config file.
  • Transparent: you can provide one or more certificates.
  • URL: allows you to specify the URL of the proxy configuration. 

3. Enter your Network Proxy URL or upload your Certificates. 

Next Steps

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

1. Network Overview
2. Create a Network  - You are here!
3. Manage a Network
4. Use the ZEDEDA CLI to Manage a Network