Changes between Version 6 and Version 7 of UsersGuide

Timestamp:

Oct 15, 2012 5:15:34 PM (12 years ago)

Author:

Ted Faber

Comment:

--

UsersGuide

@@ +1 @@
+[[TOC]]
+
 = Users Guide / Tutorial =
 
 This document describes the workflow and commands to create an use a containerized experiment.  We work through a couple examples showing the major features of the containers system.  Detailed descriptions of the commands and configuration files are in the [wiki:Reference reference section].
 
-== A Conatinerized Experiment ==
+== A Containerized Experiment ==
 
 This example will walk through creating an experimental topology starting with how to describe a topology through building and using the containerized experiment.
@@ -172 +174 @@
 Making that script the start command of all nodes will put the time that each local container came up in the the {{{startup}}} directory under the per-experiment directories.  For example, {{{n-0.example1.DeterTest}}} will create {{{/proj/DeterTest/exp/example1/startup/n-0}}}.  An experimenter can monitor that directory on {{{users}}} and know which nodes are up.
 
+=== Releasing Resources ===
+
+As with a physical DETER experiment, you release resources by swapping the experiment out using the web interface or the {{{swapexp}}} command.  If you are using the [UsersGuide#StartCommands startcommand workaround] to detect startup, clear the startup directory when you swap the experiment out.
+
+== Advanced Usage ==
+
+The previous section showed how to create an experiment using only openvz containers packed 10 (or so) to a machine.  This section shows how to change those parameters.
+
+=== Using Other Container Types ===
+
+To change the container type that {{{containerize.py}}} assigns to nodes, use the {{{--default-container}}} option.  Valid choices follow the [NewIntro#KindsofContainers kinds of containers] DETER suports.  Specifically:
+
+|| __Parameter__ || __Container__ ||
+|| {{{embedded_pnode}}} || Physical Node ||
+|| {{{qemu}}} || Qemu VM ||
+|| {{{openvz}}} || Openvz Container ||
+|| {{{process}}} || ViewOS process ||
+
+We can try this on our [attachment:example1.tcl example topology]:
+
+{{{
+users:~$ /share/containers/containerize.py --default-container qemu DeterTest example2 ~/example1.tcl 
+
+Requested a QEMU node with more than 7 experimental interfaces.  Qemu nodes
+can only support 7 experimental interfaces.
+
+
+}}}
+
+The good news is that the container system is using qemu containers to build our experiment.  Unfortunately qemu containers only support 7 experimental interfaces, an internal limit on the number of interfaces the virtual hardware supports.  A