Changes between Version 5 and Version 6 of UsingBenito

Timestamp:

Jul 29, 2011 2:40:10 PM (13 years ago)

Author:

mikeryan

Comment:

qemu-only vs mixed mode

UsingBenito

@@ -4 +4 @@
 
 Benito is a containerized virtualization system which currently runs on the DETER testbed.
+
+We support two types of experiments: qemu-only and mixed mode. Nodes in a qemu-only experiment are all realized as qemu virtual machines and are automatically packed into physical nodes based on a packing parameter. Nodes in a mixed mode experiment may either be qemu virtual nodes or full-fledged physical machines. Currently they must be embedded manually.
 
 == Disclaimer ==
@@ -25 +27 @@
 Before running your experiment you should determine the DETER PID and EID under which you'll run the experiment. The EID should not refer to an existing experiment.
 
+=== qemu-only experiments ===
+
 You will need to specify a parameter called "packing". This parameter describes how many qemu virtual nodes will be embedded on each physical node. The host machines have four cores each, so for compute-bound tasks this value should not be higher than 4. For less CPU-intensive tasks, this number can in theory be as high as 10 or 20 (perhaps higher).
-
-=== Creating the experiment ===
 
 Once you have determined the parameters described above, you may start an experiment by logging in to {{{users.isi.deterlab.net}}} and running these commands:
@@ -36 +38 @@
 }}}
 
+=== Mixed mode experiments ===
+
+Mixed mode experiments may only be specified using a TopDL file. Each node must be specially annotated to incdicate its embedding. This is done by specifying an attribute on the node called {{{partition}}}.
+
+The {{{partition}}} attribute specifies the physical node on which a qemu virtual node is realized. This value must be numeric, though there are no restrictions on what numbers are used.
+
+If a node ''lacks'' the {{{partition}}} attribute, it is assumed to be a physical node.
+
+You can use the {{{shopdl.py}}} tool in the {{{util}}} subdirectory of the tree in order to ease manipulation of your TopDL file.
+
+Once you have annotated your TopDL file, you may start an experiment by logging in to {{{users.isi.deterlab.net}}} and running these commands:
+
+{{{
+$ cd /share/benito
+$ ./mixed_experiment.py <PID> <EID> <topdl-file>
+}}}
+
+=== Creation ===
+
 Upon successful creation, you will be presented with a URL for accessing your experiment via the web interface.
 
 It takes 1-2 minutes for DETER to create the experiment. The creation process has successfully completed once DETER reports "Status: swapped".
+
+== Swapping ==
 
 === Swapping in ===