Before you start
This guide describes how to install an EVE-OS image onto an edge device.
You can install EVE-OS directly onto physical hardware (i.e., onto bare metal) or onto a virtual machine.
- You must have a bootable media with EVE-OS flashed onto it. If you don't have one, see our guide to getting an EVE-OS image.
- You must have physical access to your edge node.
- You must have a stable internet connection through a wired Ethernet port. If your edge node has only WiFi connectivity, contact support.
Each installation of EVE-OS will create a directory in the installer media’s INVENTORY partition. The name of this directory will be your edge node's soft serial number, and it will contain essential information about your edge node's hardware. You'll need to reference these when you onboard the edge node to ZEDEDA Cloud.
We recommend clearing your installation media's INVENTORY partition before each installation. If you use the your media for multiple installations without clearing it before each, you may find it difficult to determine which directory belongs to which node.
Install EVE-OS
- Ensure that your edge node is powered off and connected to a monitor and keyboard.
- Ensure that your edge node is connected to a wired network.
- Plug in the USB drive that you flashed your EVE-OS installer onto.
- Boot your edge node into its BIOS. To do so, immediately and repeatedly tap the BIOS access key for your machine as you power it on. If your device doesn’t boot into its BIOS, power your device down and try again.
BIOS access keysThis key varies depending on the manufacturer but is often one of the following: F2, F10, Delete, or Esc.
- If your BIOS has these settings, configure them as shown:
Intel Virtualization Technology (V-tx): Enabled
VT-d: Enabled
Security Device Support: Enabled
TPM: v2.0
Watchdog Function: Enabled (only for Supermicro Edge Nodes) - Configure your device’s boot order to boot from your installation media.
Example: UEFIUEFI is a common substitute for a BIOS. In this example, you would move UEFI USB Hard Disk, Partition1 to the top of the list.
- Save your changes and reboot your device. EVE-OS installation will begin automatically. Your edge node will power down automatically after installation.
Example: GRUB shows installerGRUB will display partitions available to boot from. Installers are generally tagged with “installer”. If you see this, your machine will boot your EVE-OS installer.Example: installation beginsYou should see this when EVE-OS begins to install. - Unplug your USB. Save this USB. You will need it when you onboard this edge node. Do not use it for another EVE-OS installation until you finish onboarding this edge node.
- Recommended: Boot your edge node into its BIOS and change the boot drive to the default bootable disk, which now contains EVE-OS.
Post-installation
After your edge node reboots, you should see in GRUB that it's booting the EVE-OS image that you just installed.
You should then see something similar to the following example, indicating that your edge node has successfully booted EVE-OS.
At this point, your edge node will try to connect to a controller to fetch its initial configuration. Before it can do so, however, you'll need to onboard it to your enterprise. For now, your edge node will enter Last Resort mode. In this mode, it will treat all Ethernet ports as DCHP clients and management ports.
NOTE: If hardware preconfiguration or an initial WiFi connection is needed on the edge device, contact support for assistance.
Next steps
Before your edge node can connect to ZEDEDA Cloud cluster, you’ll need to create an edge node object for it in your enterprise. For instructions, see our guide to onboarding edge nodes.