Changes between Version 8 and Version 9 of ReferenceGuide

Timestamp:

Oct 18, 2012 4:36:30 PM (12 years ago)

Author:

Ted Faber

Comment:

--

ReferenceGuide

@@ -110 +110 @@
 }}}
 
+== Topdl Attributes For Containers ==
+
+Several [http://fedd.deterlab.net/wiki/TopDl topdl] attributes influence how an experiment is containerized.  These can be added to nodes using the ns2 {{{tb-add-node-attribute}}} command (used throughout the [UsersGuide tutorial]) or directly to the topdl.
+
+These are all attached to nodes/Computers:
+
+ {{{containers:node_type}}}::
+  The container that will hold this node.  [NewIntro#KindsofContainers The full list] is availible.
+ {{{conatiners:partition}}}:::
+  An identifier grouping nodes together containers that will share a physical node.  Generally assigned by [ReferenceGuide#containerize.py containerize.py], but reserachers can also directly assign them.  The {{{containerize.py}}} command assigns integers, so if a researcher assigns other partition identifiers, {{{containerize.py}}} will not overwrite them.
+ {{{containers:openvz_template}}}::
+  The flavor of linux distribution to emulate on openvz.  There is a list of valid choices in [UsersGuide#SettingOpenvzParameters the Users Guide].
+ {{{containers:openvz_diskspace}}}::
+  Amount of disk space to allocate to an openvz container.  be sure to include the '''G''' (gigabyte) or '''M''' (megabyte) suffix or the size will be taken as disk blocks.
+ {{{containers:ghost}}}::
+  If this attribute is true, resources will be allocated for this node, but it will not be started when the topology is created.
+ {{{containers:maverick_url}}}::
+  A location to download the QEMU image for this container.  The name is a legacy that will disappear.  This is deprecated.
+
+There are a few other attributes that are meaningful to more applications.  Users specifying ns2 files will not need to set these directly, as the DETER ns2 interpreter does so.
+
+On Computers:
+ {{{startup}}}::
+  The start command.  {{{tb-set-node-startcmd}}} sets this.
+
+On interfaces
+ {{{ip4_address}}}::
+  The IPv4 address of this interface.  Set by the ns2 commands for fixing addresses.
+ {{{ip4_netmask}}}::
+  The IPv4 netmask.  ns2 sets this.
+ 
+
 == Configuration Files ==
 
+These files control the operation of the containers system.
+
 === Per-experiment Directory ===
 
 When an experiment is containerized, the data necessary to create it is stored in {{{/proj/}}''project''{{{/exp/}}}''experiment''{{{containers}}}.  The 
-{{{/proj/}}''project''{{{/exp/}}}''experiment'' is created by DETER when the experiment is created, and used by experimenters for a variety of things.
+{{{/proj/}}''project''{{{/exp/}}}''experiment'' is created by DETER when the experiment is created, and used by experimenters for a variety of things.  This directory is replicated on nodes under {{{/var/containers/config}}}.
 
 There are a few files in the per-experiment directory that most experimenters can use: