Skip to main content

EmberRTOS MicroVM

EmberRTOS MicroVM logo

A full EmberRTOS node, running as a virtual machine on your cluster.

Category: EmberRTOS

The EmberRTOS MicroVM installs an EmberRTOS node as a virtual machine. It has its own kernel and its own setup, and your cluster places it the way it places any other app. Install it from the App Store, and remove it from the App Store when you are done.

For the full story of what a MicroVM is and where it fits, read the white paper, MicroVMs on EmberNet.

Editions​

The App Store lists two MicroVM apps. Both are headless, which means they run with no screen attached and you reach them over the network.

AppKernelUse it for
EmberRTOS MicroVM (Headless)General-purposeA virtual edge node, staging and test nodes, a workload that needs its own kernel
EmberRTOS MicroVM RT (Headless RT)Real-time, with isolated cores, tunedWork with a hard deadline that must run inside an existing cluster

Both are built by the EmberRTOS release process, and the App Store pulls the current image for you. The kernels and tuning behind each edition are described on EmberRTOS Headless and EmberRTOS Headless RT.

Install from the App Store​

  1. Open App Store in EmberCORE and find EmberRTOS MicroVM or EmberRTOS MicroVM RT under EmberRTOS.
  2. Fill in the install form. Set the options below, or leave the defaults.
  3. Install it.

The VM starts on its own. Each install is its own virtual machine.

Install options​

Switches​

Three switches are set at install time per VM. They hold across reboots, so a switch that is off stays off and one that is on comes up again.

SwitchWhat it does
FluxOn: the VM enrolls itself in Flux with a credential the App Store issues for it, and uninstalling deregisters it. Off: the VM stays off Flux.
Local clusterOn: the VM runs its own small cluster, local to the VM and never registered with Clusters. Off: no cluster runs in the VM.
Plasma firewallOff in this version, and the install form says so.

Real-time options​

  • On a node set aside for real-time work, the RT VM gets dedicated CPUs and memory, which is what its real-time guarantees depend on.
  • On any other node, the App Store picks values that let the VM run, and the install form lets you override them. Without a real-time node the VM runs, but you should not count on the full real-time guarantees.

What the VM keeps​

The VM keeps its identity, including its Flux enrollment. A restart brings it back as the same node and does not need a new credential.

Uninstall​

Uninstalling removes the VM, its enrollment credential, and its stored state. If Flux was on, the VM is also deregistered from Flux.

Requirements​

  • Virtual machine support on the cluster.
  • A node with hardware virtualization.
  • An amd64 node. The images are amd64 today.
  • For the full real-time guarantees, a node set aside for real-time work.

Limits in this version​

  • The Plasma firewall is off in this version.
  • amd64 only. arm64 follows as its own release.
  • A MicroVM's local cluster is local to that VM. It does not join a cluster you manage in Clusters.