uhyve is small hypervisor to boot the library operating systems RustyHermit, which is a unikernel operating system targeting a scalable and predictable runtime behavior for HPC and cloud environments.
An installation of the Rust toolchain is required. Please visit the Rust website and follow the installation instructions. The project can then be installed with the following command:
cargo install uhyve # Install latest published version from crates.io
To check if your system supports virtualization, you can use the following command:
if egrep -c '(vmx|svm)' /proc/cpuinfo > /dev/null; then echo "Virualization support found"; fi
On Linux, uhyve depends on the virtualization solution KVM (Kernel-based Virtual Machine). If the following command gives you some output, you are ready to go!
lsmod | grep kvm
Disclaimer: Currently, uhyve is mainly developed for Linux. The macOS version has not been tested extensively and does not support all features of the Linux version.
Apple's Command Line Tools must be installed. The following terminal command installs these tools without Apple's IDE Xcode:
xcode-select --install
Additionally, the included hypervisor bases on the Hypervisor Framework depending on OS X Yosemite (10.10) or newer. To verify if your processor is able to support this framework, run the following in your Terminal:
sysctl kern.hv_support
The output kern.hv_support: 1
indicates virtualization support.
To build from souce, simply checkout the code and use cargo build
.
git clone https://github.com/hermitcore/uhyve.git
cd uhyve
cargo build --release
Use the hypervisor to start the unikernel.
uhyve /path/to/the/unikernel/binary
uhyve can be configured via environment variables. The following variables are supported.
HERMIT_CPUS
: specifies the number of cores the virtual machine may use.HERMIT_MEM
: defines the memory size of the virtual machine. The suffixes M and G can be used to specify a value in megabytes or gigabytes, respectively.- setting
HERMIT_VERBOSE
to1
makes the hypervisor print kernel log messages to the terminal. HERMIT_GDB_PORT=port
activate a gdb server for the application running inside uhyve. See below
By default, the loader initializes a system with one core and 512 MiB RAM.
Example: the following command starts the demo application in a virtual machine, which has 4 cores and 8GiB memory:
HERMIT_CPUS=4 HERMIT_MEM=8G uhyve /path/to/the/unikernel/binary
Basic support of (single-core) applications is already integrated into uhyve.
By specifying variable HERMIT_GDB_PORT=port
, uhyve is working as gdbserver and is waiting on port port
for a connection to a gdb.
For instance, with the following command uhyve is waiting on port 6677
for a connection.
HERMIT_GDB_PORT=6677 uhyve /path_to_the_unikernel/hello_world
In principle, every gdb-capable IDE should be able to debug RustyHermit applications. (Eclipse, VSCode, ...)
The repository rusty-hermit provides example configuration files to debug a RustyHermit application with Visual Code.
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.