Important

This page is deprecated. Please use our new platform and accompanying documentation.

Containers Quickstart

This page describes basic information about DETERLab Containers and provides an overview of how to use it. More details are available in the Containers Guide.

What are Containers?

The Containers system enables experimenters to create large-scale DETERLab topologies that support differing degrees of fidelity in individual elements. In order to create an experiment larger than the 400+ computers available in DETERLab Core, experimenters must use virtualization, simulation, or some other abstraction to represent their topology. The Containers system automates creation of virtual nodes to achieve desired scale.

The Containers system is built on top of the resource allocation that underlies the DETERLab testbed, extending it to provide multiple implementations of virtual nodes. Most DETERLab tools that run on physical experiments may be used directly on virtualized nodes. Experimenters find working in a containerized experiment very similar to working in physical DETERLab experiments.

How does it work?

The Containers system lays out the virtual computers into a physical layout of computers and uses the resource allocation system to allocate that physical layout. Then the system installs and configures the appropriate virtualization technologies in that environment to create the virtual environment.

Model of a DETERLab Container

As in physical DETERLab experiments, the experiment's topology is written in an extended version of DETERLab's ns2 syntax, or in topdl, a topology description language.

Currently experimenters specify the type of container they want to use in their topology description.

Kinds of Containers

The Containers system gives us a way to create interconnections of containers (in our sense) holding different experiment elements. A containerized topology might include a physical machine, a qemu virtual machine and an openvz container that can all communicate transparently.

The Containers system framework supports multiple kinds of containers, but at this point researchers may request these:

Container Type Fidelity Scalability
Physical Machine Complete fidelity 1 per physical machine
Qemu virtual Machine Virtual hardware 10's of containers per physical machine
Openvz container Partitioned resources in one Linux kernel 100's of contatiners per physical machine

How Do I Use Containers?

In general, once you have a DETERLab account, you follow these steps. The DETERLab Containers Guide will walk you through a basic tutorial of these steps.

1. Design the topology

Create your NS file describing your large topology. Transfer the file to the "users.deterlab.net".

2. Run containerized experiment with the containerize.py command

The Containers system will build the containerized experiment on top of an existing DETERLab physical experiment by running the containerize.py command from the shell on users.deterlab.net, as in the following example:

 $ /share/containers/containerize.py DeterTest example1 ~/example1.tcl 

where ''DeterTest'' and ''example1'' are the project and experiment name, respectively, of the physical DETERLab experiment and ''example.tcl'' is the topology file.

With these default parameters, containerize.py will put each node into an Openvz container with at most 10 containers per physical node.

3. View results by accessing nodes, modify the experiment as needed.

In a containerized experiment, you can access the virtual nodes with the same directories mounted as in a physical DETERLab experiment. You can load and run software and conduct experiments as you would in a physical experiment.

4. Save your work and swap out your experiment (release the resources)

As with all DETERLab experiment, when you are ready to stop working on an experiment but know you want to work on it again, save your files in specific protected directories and swap-out (via web interface or commandline) to release resources back to the testbed. This helps ensure there are enough resources for all DETERLab users.

More Information

For more detailed information about Containers, read the following:

  • Containers Guide - This guide walks you through a basic example of using Containers and includes some advanced topics.
  • Containers Reference - This reference includes Containers commands, configuration details and information about different types of containers.