Changes between Version 8 and Version 9 of UsingContainers

Timestamp:

Oct 2, 2012 4:05:55 PM (12 years ago)

Author:

Ted Faber

Comment:

--

UsingContainers

@@ -20 +20 @@
 
 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.
+
+== Containerizing Your Experiment ==
+
+The {{{containerize.py}}} program creates a DETER experiment made up of containers.  There will generally be more containers than there are DETER nodes in your new experiment.  The {{{containerize.py}}} program is available from {{{/share/containers/containerize.py}}} on {{{users.isi.deterlab.net}}}.  A sample invocation is:
+
+{{{
+$ /share/containers/containerize.py MyProject MyExperiment ~/mytopology.tcl
+}}}
+
+It will create a new experiment in {{{MyProject}}} called {{{MyExperiment}}} containing the experiment topology in {{{mytopology.tcl}}}.  All the topology creation commands supported by DETER are supported by the conatainerization system, but systems like program agents are not.  Start commands '''are''' supported.
+
+Either an ns2 file or a topdl experiment is supported.  Ns2 descriptions must end with {{{.tcl}}} or {{{.ns}}}.  Other files are assumed to be topdl descriptions.
+
+
+By default, {{{containerize.py}}} program will partition the topology into openvz containers, packed 10 containers per physical computer.  If the topology is already partitioned - at least one element has a {{{partition}}} atttribute - {{{containerize.py}}} will not partition it.  Similarly, if container types have been assigned to nodes, {{{containerize.py}}} will respect them.
+
+It takes several parameters that can change its behavior:
+
+ {{{--default-container}}}=''kind''::
+  Containerize nodes without a container type into ''kind''.  If no nodes have been assigned containers, this puts all them into ''kind'' containers.
+ {{{--force-partition}}}::
+  Partition the experiment whether or not it has been paritioned already
+ {{{--packing=}}}''int''::
+  Attempt to put ''int'' containers into each physical node.  The default {{{--packing}}} is 10.
+ {{{--config=}}}''filename''::
+  Read configuration variables from ''filename'' the configuration values are discussed below.
+ {{{--debug}}}::
+  Print additional diagnostics
+
+This invocation:
+
+{{{
+$ ./containerize.py --packing 25 --default-container=qemu --force-partition DeterTest faber-packem ~/experiment.xml
+}}}
+
+takes the topology in {{{~/experiment.xml}}} (which must be topdl), packs it into 25 qemu containers per physical node, and creates an experiment called DeterTest/faber-packem that can be swapped in.  If {{{experiment.xml}}} were already partitioned, it will be re-partitioned.  If some nodes in that topology were assigned to openvz nodes already, those nodes will be still be in openvz containers.
+
+The result of a successful {{containerize.py}}} run is a DETER experiment that can be swapped in.
+
+
 
 === OpenVZ-only and qemu-only auto-partitioned experiments ===