1. Introduction
Like any other application, software, or operating system, EVE-OS may be updated for better compatibility, increased security, and the availability of the latest features with different devices or applications enhanced features resulting in enhanced user experience.
2. Update EVE on single Edge Node using UI
If one of the following is true, then you don't need to update EVE-OS on the edge node(s):
Click the particular edge node you want to update in the edge node list view. Scroll down to the 'EVE-OS Images' tab in the' Status' tab. If you see this indicator (
) against the EVE-OS image version, you don't need to update EVE-OS. If not, go ahead with the following steps to update EVE-OS.
) against the EVE-OS image version, you don't need to update EVE-OS. If not, go ahead with the following steps to update EVE-OS.
Note: This indicator () shows that a particular edge node runs the latest version in the edge node list view. If you see this indicator () against the edge node in which you want to update the latest version of the EVE-OS, skip these steps.
) shows that a particular edge node runs the latest version in the edge node list view. If you see this indicator () against the edge node in which you want to update the latest version of the EVE-OS, skip these steps.
You can use the following options to 'Update EVE' on the selected edge node:
Option A: Dashboard
After you log in to the ZEDEDA platform, the home page shows a widget, 'Recommended Actions,' where you can click on the 'Update EVE' action. This will take you to the edge node list view screen. Continue with the steps in either 'Option B' or 'Option C.'
Option B: Edge Node List View
After you log in to the ZEDEDA platform, click on the 'Edge Nodes' on the left navigation, which will take you to the edge node list view screen, from where you can update the EVE-OS to have the latest version on the required Edge Node.
- Step 1 > Click the checkbox to select the edge node, requiring an EVE-OS update from the list.
- Step 2 > Click on More (
) icon on the top right corner.
- Step 3 > From the dropdown, select 'Update EVE Image'.
- Step 4 > Click the 'Update & Activate' button on the modal dialogue, which appears as below:
- Step 5 > When you click on the 'Update & Activate' button, a toast message announcing the completion of the EVE update on the edge node appears as below:
Update EVE image request to Edge Node' bg-supermicro-zc2' was successfully submitted.
Activate Image request to Edge Node' bg-supermicro-zc2' was successfully submitted.
Option C: Edge Node Detail View
Using the Home view step instructions, navigate to the edge node list view screen.
Click on a particular edge node, which requires an EVE-OS update. This will take you to a page that displays edge node details.
- Step 1 > Click on the More () icon on the top right corner.
- Step 2 > From the dropdown, select 'Update EVE Image'.
- Step 3 > Click on the 'Update & Activate' button on the modal dialogue box, which appears as below:
Warning: If the EVE-OS update does not go through, for some reason, the update process will fail over to the previously installed EVE-OS software. You can check this in the 'EVE Images' section of the 'Status' tab.
- Step 4 > When you click on the 'Update & Activate' button, a toast message announcing the completion of the EVE-OS update on the edge node appears as below:
Update EVE Image request to Edge Node' bg-supermicro-zc2' was successfully submitted.
Activate Image request to Edge Node' bg-supermicro-zc2' was successfully submitted.
The latest EVE-OS software has been updated to the selected edge node.
3. Update EVE on Multiple Edge Nodes with UI
Using the Home view step instructions, navigate to the edge node list view screen.
- Step 1 > Check the boxes against the edge nodes which require EVE-OS updates from the list.
- Step 2 > Click on More () icon on the top right corner.
- Step 3 > From the dropdown, select 'Update EVE Image'.
- Step 4 > In the modal dialogue box, you could change the 'Job Name,' which is automatically generated, for better tracking. Click on the 'Update & Activate' button on the modal dialogue box, which appears as below:
Updating the following 4 Edge Node(s) in default-project will cause loss of availability.
Target EVE Version: 0.0.0-snapshot-master-770373df--xen-amd64
- Step 5 > When you click on the 'Update & Activate' button, a toast message appears on the screen to confirm the action performed.
Update EVE request for requested Edge Nodes was successfully submitted.
- Step 6 > A job (
) indicator will appear on the left navigation indicating that the requested job is started.
-
Step 7 > Click on the Jobs (
) icon on the left navigation to go to the jobs list. Updating multiple EVE-OS images triggers a 'Job,' which you can track in the 'Jobs' () section. -
Step 8 > Click on the job created to see the details below, where EVE-OS update on individual edge node is tracked as a task listed in the table.
The latest EVE-OS software has been updated to the selected edge node(s).
4. Other actions you could perform on the Edge Nodes list:
Here are other actions you can perform in similar ways in the list view are as follows:
| Menu | Function |
| Activate | Perform this action to activate the edge node from UI. |
| Deactivate | Perform this action to deactivate the edge node from UI. |
| Reboot | Perform this action to restart the edge node from UI. |
| Delete | Perform this action to remove the edge node from UI. |
5. Update EVE-OS on Edge Node/s using CLI
Now, you can check the latest EVE-OS image by using the following command.
Note: Hardware architecture can be either 'AMD64' or 'ARM64'.
zcli> zcli image show --latest=AMD64
Image Name: 0.0.0-snapshot-6729c8d6-2020-01-01.21.56-amd64
Image Title: 0.0.0-snapshot-6729c8d6-2020-01-01.21.56-amd64
Format: QCOW2
Arch: AMD64
Status: ImageStatusReady
Datastore Name: Zededa-AWS-Image
Size: 221.8 MB
Checksum: 9AB7C5AF5A56FC629E8C329759E0F4723C8E6FAD3C7FAC3BCC3C4AB3EA86E66F
Created at: Thu Jul 18 09:12:57 2019 Last Config update: Thu Jan 2 06:12:28 2020
zcli>
You can download the latest EVE-OS image to the Edge node by using the following command:
zcli> zcli edge-node <device-name> eveimage-update --image=XXXXXXXXXX
Once the latest EVE-OS image is downloaded to the respective edge node, use the following command to activate the latest EVE-OS image.
zcli> zcli edge-node <device-name> eveimage-update --image=XXXXXXXXXX --activate
The latest EVE-OS software has been updated to the selected edge node.