How to get Ethos running on your system

Ethos is an open source project, but we are not yet ready to release the source code. Here are our research plans:

Public information about the project consists of these these web pages and papers published in conferences. We are still publishing our results. Since we spent all this time building Ethos, we would like to be the first to measure it and write about it.

About the Ethos implemementation

Ethos is implemented on top of Xen, a Virtual Machine Monitor (VMM). Xen is a bare-metal VMM, which means it runs directly on the hardware. Xen is relatively small, many services (especially device drivers) needed to implement the VMM are contain in a privileged OS called Dom0. Thus it is necessary to install Dom0 (Linux), Xen, and Ethos.

You can install Xen/Dom0/Ethos on bare-metal. This may be too disruptive to your system, so the alternative is to run Xen/Dom0/Ethos within a hosted VM such as VMWare. (VMWare provides a site licence which is free to students at UIC). In such a case you'll be running two VMMs and three OSs, you should have at least 4GB of memory for this (more is better). Xen and Dom0 can be 64-bit OSs; Ethos runs as either 32-bit or 64-bit OS.

Confused? It takes a bit to get used to this. We're happy to help you get Ethos up and going. We've also built some aids to help you get started.

Once you decide how to install Ethos (bare metal or VMware), you install a linux distribution. One Ethos developer, Mike, is also a Fedora maintainer and he's built a set of scripts to set up Fedora easily so that's what we all tend to use.

Ethos is built from source code. The source code is spread over many git repositories. To make things easier, you get the ethos git repo, and then ethos will pull and build all the needed repos.


  1. Review the background necessary to be successful in the project.
  2. Join the project. Email Dr. Solworth introduce yourself, and to discuss how you can contribute to the project; send some background information such as a Resume. After this you'll
    • be added to the Ethos mailing list,
    • sign the open-source licensing agreement and
    • get access to the Ethos Git repositories.
    For the latter task, you will need to generate and submit an SSH public key.
  3. if your username is different on than your notebook, you will need to tell your notebook's ssh about your user name (UName below). Put in your notebook's file ~/.ssh/config
        User UName
  4. Use git to clone the repository at (if you are running on Windows, download and install cygwin)
    	git clone
    	cd ethos
    	bin/gt pullall
    This repository gets all our other repositories. You'll need make, git, echo, and a bourne shell to pull the repos.
  5. Read the TeXnote titled The Ethos DevelopmentManual (manualDevelopers). This will teach you how to prepare Xen and Fedora to host Ethos and how to build and install Ethos.
  6. 	cd teXnotes/developer/manualDevelopers
    and read the manual there.
    1. The manual will tell you how to do a fedora install with Xen.
    2. How to build ethos and install it in the file system
    3. How to run ethos tests
    4. How to create an instance of Ethos to run standalone (by autostarting a program) or interactively.
Information Approval Curriculum accredited by CNSS gratefully acknowledge funding by National Science Foundation

UIC Links

Security Links