Changes between Version 5 and Version 6 of OldFeddAbout

Timestamp:

Dec 12, 2008 3:09:04 PM (16 years ago)

Author:

faber

Comment:

--

OldFeddAbout

@@ -209 +209 @@
 In addition, `fedd` understands the `tb-set-default-failure-action` command.  This sets the default failure action for nodes in the experiment to one of '''fatal''', '''nonfatal''', or '''ignore'''.  Those values have the same meaning as in standard Emulabs. Nodes that do not have their failure mode reset by the `tb-set-node-failure-action` command will user the explicit default.  If no default is set, '''fatal''' is used.
 
-=== Example Federated Experiment Creation ===
+=== Federated Experiment Creation ===
 
 TO give an intuition for how `fedd` works, we present a sample experiment description and show how it would be turned into a federated experiment.  The experiment description is:
@@ -260 +260 @@
 }}}
 
+That experiment file generates the following topology:
+
+[[Image(example_topology.png)]]
+
+Each of the boxes is a node and the circle is a shared network.  Considering the values of the `set-node-testbed` calls, the experiment will be split up like this:
+
+[[Image(testbeds.png)]]
+
+The assignment of nodes to testbeds implicitly creates links (or networks) that must be connected across the wide area, and one of the key jobs of `fedd` is to create these connections.  Fedd splits the experiment description into two descriptions (one for each testbed), adds extra nodes and startcmds to create the shared experiment, and swaps them in.  The sub-experiments look something like these:
+
+{{{
+set ns [new Simulator]
+source tb_compat.tcl
+
+set a [$ns node]
+tb-set-hardware $a pc
+tb-set-node-os $a FC6-STD
+tb-set-node-tarfiles $a /usr /proj/emulab-ops//tarfiles/bwfed/fedkit.tgz 
+# tb-set-node-testbed $a "deter"
+tb-set-node-startcmd $a "sudo -H /usr/local/federation/bin/make_hosts /proj/emulab-ops/exp/bwfed/tmp//hosts >& /tmp/federate \$USER"
+tb-set-node-failure-action $a "fatal"
+set b [$ns node]
+tb-set-hardware $b pc
+tb-set-node-os $b FC6-STD
+tb-set-node-tarfiles $b /usr /proj/emulab-ops//tarfiles/bwfed/fedkit.tgz 
+# tb-set-node-testbed $b "deter"
+tb-set-node-startcmd $b "sudo -H /usr/local/federation/bin/make_hosts /proj/emulab-ops/exp/bwfed/tmp//hosts >& /tmp/federate \$USER"
+set control [$ns node]
+tb-set-hardware $control pc
+tb-set-node-os $control FC6-STD
+tb-set-node-tarfiles $control /usr /proj/emulab-ops//tarfiles/bwfed/fedkit.tgz
+# tb-set-node-testbed $control "deter"
+tb-set-node-startcmd $control "sudo -H /usr/local/federation/bin/make_hosts /proj/emulab-ops/exp/bwfed/tmp//hosts >& /tmp/federate \$USER "
+tb-set-node-failure-action $control "fatal"
+# Link establishment and parameter setting
+set link0 [$ns duplex-link $a $b 100000kb 0.0ms DropTail]
+
+tb-set-ip-link $a $link0 10.1.1.2
+tb-set-ip-link $b $link0 10.1.1.3
+# federation gateway
+set ucbtunnel0 [$ns node ]
+tb-set-hardware $ucbtunnel0 pc3000_tunnel
+tb-set-node-os $ucbtunnel0 FBSD7-TVF
+tb-set-node-startcmd $ucbtunnel0 "sudo -H /usr/local/federation/bin/fed-tun.pl -f /proj/emulab-ops/exp/bwfed/tmp/`hostname`.gw.conf >& /tmp/bridge.log"
+tb-set-node-tarfiles $ucbtunnel0 /usr/ /proj/emulab-ops//tarfiles/bwfed/fedkit.tgz
+# Link establishment and parameter setting
+set link1 [$ns duplex-link $ucbtunnel0 $b 100000kb 0.0ms DropTail]
+
+tb-set-ip-link $ucbtunnel0 $link1 10.1.3.2
+tb-set-ip-link $b $link1 10.1.3.3
+
+$ns rtproto Session
+$ns run
+}}}
+
+{{{
+set ns [new Simulator]
+source tb_compat.tcl
+
+set c [$ns node]
+tb-set-hardware $c pc
+tb-set-node-os $c FC6-SMB
+tb-set-node-tarfiles $c /usr /proj/Deter//tarfiles/bwfed/fedkit.tgz
+# tb-set-node-testbed $c "ucb"
+tb-set-node-startcmd $c "sudo -H /bin/sh /usr/local/federation/bin/federate.sh >& /tmp/startup \$USER "
+tb-set-node-failure-action $c "fatal"
+set d [$ns node]
+tb-set-hardware $d pc
+tb-set-node-os $d FC6-SMB
+tb-set-node-tarfiles $d /usr /proj/Deter//tarfiles/bwfed/fedkit.tgz 
+# tb-set-node-testbed $d "ucb"
+tb-set-node-startcmd $d "sudo -H /bin/sh /usr/local/federation/bin/federate.sh >& /tmp/startup \$USER "
+tb-set-node-failure-action $d "fatal"
+set e [$ns node]
+tb-set-hardware $e pc
+tb-set-node-os $e FC6-SMB
+tb-set-node-tarfiles $e /usr /proj/Deter//tarfiles/bwfed/fedkit.tgz
+# tb-set-node-testbed $e "ucb"
+tb-set-node-startcmd $e "sudo -H /bin/sh /usr/local/federation/bin/federate.sh >& /tmp/startup \$USER"
+tb-set-node-failure-action $e "fatal"
+set f [$ns node]
+tb-set-hardware $f pc
+tb-set-node-os $f FC6-SMB
+tb-set-node-tarfiles $f /usr /proj/Deter//tarfiles/bwfed/fedkit.tgz
+# tb-set-node-testbed $f "ucb"
+tb-set-node-startcmd $f "sudo -H /bin/sh /usr/local/federation/bin/federate.sh >& /tmp/startup \$USER"
+tb-set-node-failure-action $f "fatal"
+# Create LAN
+set lan0 [$ns make-lan "$c $d $e " 100000kb 0.0ms ]
+
+# Set LAN/Node parameters
+tb-set-ip-lan $c $lan0 10.1.2.2
+tb-set-lan-simplex-params $lan0 $c 0.0ms 100000kb 0 0.0ms 100000kb 0
+
+
+# Set LAN/Node parameters
+tb-set-ip-lan $d $lan0 10.1.2.3
+tb-set-lan-simplex-params $lan0 $d 0.0ms 100000kb 0 0.0ms 100000kb 0
+
+
+# Set LAN/Node parameters
+tb-set-ip-lan $e $lan0 10.1.2.4
+tb-set-lan-simplex-params $lan0 $e 0.0ms 100000kb 0 0.0ms 100000kb 0
+
+
+# federation gateway
+set detertunnel0 [$ns node ]
+tb-set-hardware $detertunnel0 pc3000_tunnel
+tb-set-node-os $detertunnel0 FBSD7-TVF
+tb-set-node-startcmd $detertunnel0 "sudo -H /usr/local/federation/bin/fed-tun.pl -f /proj/Deter/exp/bwfed/tmp/`hostname`.gw.conf >& /tmp/bridge.log"
+tb-set-node-tarfiles $detertunnel0 /usr/ /proj/Deter//tarfiles/bwfed/fedkit.tgz
+# Link establishment and parameter setting
+set link1 [$ns duplex-link $c $detertunnel0 100000kb 0.0ms DropTail]
+
+tb-set-ip-link $c $link1 10.1.3.2
+tb-set-ip-link $detertunnel0 $link1 10.1.3.3
+
+$ns rtproto Session
+$ns run
+}}}
+
+The resulting topology across two testbeds looks like this:
+
+[[Image(federated_testbeds.png)]]
+
+The red nodes are the connector nodes inserted by `fedd`.  They both transfer experimental traffic verbatim and tunnel services, like a shared filesystem.  Exactly what gets tunneled and how the connections are made is a function of the federation kit, the topic of the next section.
+
+= The Federation Kit =
+
+The federation kit is the software used by `fedd` to connect testbeds and tunnel services from the master to the other testbeds. Currently we have a single fedkit (available from the [FeddDownload download section]) that provides SSH tunnels to connect experimental testbeds at the ethernet layer, and that tunnels the emulab event system and provides shared file service via [http://en.wikipedia.org/wiki/Server_Message_Block SMB].  That fedkit runs on any FreeBSD or Linux image that provides the SMB file system.
+
+By splitting this function out, we intend to allow different installations of `fedd` to provide different interconnection and service tunneling function.  Currently the [FeddDownload DETER fedkit] is the only federation kit in use, and `fedd` defaults its startcmd options for use with it.
+ 
 
 = Interfaces to fedd =