This guide will help you install EVE-OS onto your edge hardware and onboard your hardware to your ZEDEDA enterprise.
At any time, refer to the Help Center for additional information.
Note: There are some differences compared to the standard Help Center documentation that only apply to the Developer Program.
Create an EVE-OS USB installer with a custom ZEDEDA Cloud server
EVE-OS images contain a ZEDEDA Cloud URL that EVE will use to communicate with the ZEDEDA Cloud server. An important difference between ZEDEDA production enterprises and Developer Program enterprises is that ZEDEDA Cloud URL. Therefore, when you create a USB installer image for EVE, you will need to override the default ZEDEDA Cloud URL (the “server”) with this value: zedcloud.gmwtus.zededa.net
After you create your EVE-OS image, follow the standard EVE installation instructions. Skip to the step: Flash EVE-OS Image.
MacOS and Linux
The following commands show how to configure the server value of the EVE-OS image on MacOS and Linux machines. You'll use Docker to create the image.
% cd $HOME
% mkdir eve-overrides
% echo zedcloud.gmwtus.zededa.net > $HOME/eve-overrides/server
% docker run -v $HOME/eve-overrides:/in --rm lfedge/eve:latest installer_raw > installer.raw
The following commands show how to configure the server value of the EVE-OS image on Windows OS machines. You'll use Docker to create the image.
% cd %HOMEDRIVE%\%HOMEPATH%
% mkdir eve-overrides
% echo zedcloud.gmwtus.zededa.net > %HOMEDRIVE%\%HOMEPATH%\eve-overrides\server
% docker run -v %HOMEDRIVE%\%HOMEPATH%\eve-overrides:/in --rm lfedge/eve:latest installer_raw > installer.raw
Onboarding your edge node to ZEDEDA Cloud
After EVE-OS is installed, you can onboard your device to ZEDEDA Cloud using the ZEDEDA GUI.
During the onboarding process, you need to import a valid hardware model to match your device. As shown in the following screenshot from the ZEDEDA GUI, you will be prompted to choose an available model from the side-scrolling menu at the top of the page. After you import a model, it will appear in the Models added in enterprise section. See the Import Models document for further details.
Note: You can import multiple models.
If your hardware is not one of the models available for import, send a zip file of the INVENTORY partition (or send the controller-model.json, shown below) file from the USB stick to firstname.lastname@example.org. Also, provide a link to a product page or datasheet online that corresponds to your edge hardware.
For your trial, you will be emailed an onboarding key for your edge nodes. You'll also need to input the unique soft serial number of your edge nodes (created automatically during EVE-OS installation). The soft serial number gets written to the USB stick during installation, or you can `cat soft_serial` from inside the EVE-OS /config directory. If you plug the USB stick into your laptop after installation, you'll find the serial number as the directory name in the INVENTORY partition. On MacOS, it should look something like this:
Input the Onboarding Key sent to your email and then copy and paste the value of your device's soft serial number into the Serial Number field. Next, select your device's imported Brand and Model, configure any other required elements, and finally, click the Add button to submit the page.
Alternatively, you can onboard an EVE-OS edge node by uploading the device.cert.pem file that is also found on the USB stick after installation.
Select “Edge Node Certificate” in the “Identity Type” field for this approach and then upload the certificate.