Changes between Version 22 and Version 23 of UsersGuide

Timestamp:

Oct 24, 2012 4:34:38 PM (12 years ago)

Author:

Ted Faber

Comment:

--

UsersGuide

@@ -381 +381 @@
 
 
-for { set i 1} { $i < 4 } { incr i} {
+for { set i 0} { $i < 3 } { incr i} {
     set lanlist $center
     for { set j 0 } { $j < 20} { incr j } {
         set idx [expr $i * 20 + $j]
         set n($idx) [$ns node]
-        tb-add-node-attribute $n($idx) "containers:PartitionPass" $i
+        tb-add-node-attribute $n($idx) "containers:PartitionPass" [expr $i + 1]
         lappend lanlist $n($idx)
     }
-    $ns make-lan [join $lanlist " "] 100Mb 0
+    set lan($i) [$ns make-lan [join $lanlist " "] 100Mb 0]
 }
 
@@ -403 +403 @@
 Each node in the topology is assigned a {{{containers::PackingPass}}} attribute that groups them into subsets.  The {{{conatiners:PackingPass}}} attribute must be assigned an integer value.  The nodes in each packing pass are considered together when packing.  Each pass can be assigned different parameters.  The passes are carried out in order, though that is rarely important.
 
-Our topology assigns 
+Our topology assigns {{{center}}} to pass 0, the nodes on {{{lan-0}}} (the tcl variable lan(0)) to pass 1, those on {{{lan-1}}} to pass 2 and those on {{{lan-2}}} to pass 3.  We will use the {{{--pass-pack}}} parameter to specify the packing factor for each pass.  Each packing factor specification looks like ''pass'':''factor'' where pass and factor are both integers.  We can specify more than one, separated by commas, or specify {{{--pass-pack}}} more than once.
+
+For example, we can pack the experiment using the following factors:
+
+|| __Pass__ || __Packing Factor__ ||
+|| 0 || 1||
+|| 1 || 20 ||
+|| 2 || 10 ||
+|| 3 || 5 ||
+
+By issuing:
+
+{{{
+users:~$ /share/containers/containerize.py --pass-pack 0:1,1:20,2:10,3:5 --nodes-only DeterTest example6 ~/example6.tcl 
+Containerized experiment DeterTest/example6 successfully created!
+Access it via http://www.isi.deterlab.net//showexp.php3?pid=DeterTest&eid=example6
+}}}
+
+We can view the packing by using {{{container_image.py}}} to generate a visualization that includes the partitions:
+
+{{{
+users:~$ /share/containers/container_image.py --experiment DeterTest/example6 --partitions --out ~/example6.png
+}}}
+
+The output shows the topology with boxes drawn around the containers that share a physical node:
+
+
 
 == Further Reading ==