Simple CCNx examples for LinuxNode and PlanetlabNode
authorAlina Quereilhac <alina.quereilhac@inria.fr>
Fri, 31 Jan 2014 16:17:25 +0000 (17:17 +0100)
committerAlina Quereilhac <alina.quereilhac@inria.fr>
Fri, 31 Jan 2014 16:17:25 +0000 (17:17 +0100)
examples/linux/ccn/two_nodes_file_retrieval.py [new file with mode: 0644]
examples/planetlab/ccn/two_nodes_file_retrieval.py [moved from examples/planetlab/ccn/two_nodes_file_retrival.py with 84% similarity]

diff --git a/examples/linux/ccn/two_nodes_file_retrieval.py b/examples/linux/ccn/two_nodes_file_retrieval.py
new file mode 100644 (file)
index 0000000..8e40c3b
--- /dev/null
@@ -0,0 +1,140 @@
+#
+#    NEPI, a framework to manage network experiments
+#    Copyright (C) 2014 INRIA
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation, either version 3 of the License, or
+#    (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# Author: Alina Quereilhac <alina.quereilhac@inria.fr>
+#
+# Instructions to run this example:
+#
+# 1. First edit the script file where required (See ASSING messages)
+#
+# 2. Then, run the script:
+#
+# $ cd <path-to-nepi>
+# $ PYTHONPATH=$PYTHONPATHS:src python examples/linux/ccn/two_nodes_file_retrieval.py
+#
+
+from nepi.execution.ec import ExperimentController
+
+import os
+
+ssh_key = ####### <<< ASSING the absolute path to the private SSH key to login into the remote host >>>
+ssh_user = ####### <<< ASSING the SSH username >>>
+
+## Create the experiment controller
+ec = ExperimentController(exp_id = "demo_CCN")
+
+## Register node 1
+node1 = ec.register_resource("LinuxNode")
+# Set the hostname of the first node to use for the experiment
+hostname1 = "peeramidion.irisa.fr" ##### <<< ASSIGN the hostname of a host you have SSSH access to >>>
+ec.set(node1, "hostname", hostname1)
+# username should be your SSH user 
+ec.set(node1, "username", ssh_user)
+# Absolute path to the SSH private key
+ec.set(node1, "identity", ssh_key)
+# Clean all files, results, etc, from previous experiments wit the same exp_id
+ec.set(node1, "cleanExperiment", True)
+# Kill all running processes in the node before running the experiment
+ec.set(node1, "cleanProcesses", True)
+
+## Register node 2 
+node2 = ec.register_resource("LinuxNode")
+# Set the hostname of the first node to use for the experiment
+hostname2 = "planetlab2.upc.es" ##### <<< ASSIGN the hostname of a host you have SSSH access to >>>
+ec.set(node2, "hostname", hostname2)
+# username should be your SSH user 
+ec.set(node2, "username", ssh_user)
+# Absolute path to the SSH private key
+ec.set(node2, "identity", ssh_key)
+# Clean all files, results, etc, from previous experiments wit the same exp_id
+ec.set(node2, "cleanExperiment", True)
+# Kill all running processes in the node before running the experiment
+ec.set(node2, "cleanProcesses", True)
+
+## Register a CCN daemon in node 1
+ccnd1 = ec.register_resource("LinuxCCND")
+# Set ccnd log level to 7
+ec.set(ccnd1, "debug", 7)
+ec.register_connection(ccnd1, node1)
+
+## Register a CCN daemon in node 2
+ccnd2 = ec.register_resource("LinuxCCND")
+# Set ccnd log level to 7
+ec.set(ccnd2, "debug", 7)
+ec.register_connection(ccnd2, node2)
+
+## Register a repository in node 1
+ccnr1 = ec.register_resource("LinuxCCNR")
+ec.register_connection(ccnr1, ccnd1)
+
+## Push the file into the repository
+local_path_to_content = os.path.join(
+        os.path.dirname(os.path.realpath(__file__)),
+            "..", "..",
+            "big_buck_bunny_240p_mpeg4_lq.ts")
+
+# Register a FIB entry from node 1 to node 2
+co = ec.register_resource("LinuxCCNContent")
+ec.set(co, "contentName", "ccnx:/test/FILE1")
+# NEPI will upload the specified file to the remote node and write it
+# into the CCN repository
+ec.set(co, "content", local_path_to_content)
+ec.register_connection(co, ccnr1)
+
+# Register a FIB entry from node 1 to node 2
+entry1 = ec.register_resource("LinuxFIBEntry")
+ec.set(entry1, "host", hostname2)
+ec.register_connection(entry1, ccnd1)
+
+# Register a FIB entry from node 2 to node 1
+entry2 = ec.register_resource("LinuxFIBEntry")
+ec.set(entry2, "host", hostname1)
+ec.register_connection(entry2, ccnd2)
+
+## Retrieve the file stored in node 1 from node 2
+command = "ccncat ccnx:/test/FILE1"
+app = ec.register_resource("LinuxCCNApplication")
+ec.set(app, "command", command)
+ec.register_connection(app, ccnd2)
+
+# Register a collector to automatically collect the ccnd logs
+# to a local directory
+results_dir = "/tmp/demo_CCN_results"
+col1 = ec.register_resource("Collector")
+ec.set(col1, "traceName", "stderr")
+ec.set(col1, "storeDir", results_dir)
+ec.set(col1, "subDir", hostname1)
+ec.register_connection(col1, ccnd1)
+
+col2 = ec.register_resource("Collector")
+ec.set(col2, "traceName", "stderr")
+ec.set(col2, "storeDir", results_dir)
+ec.set(col2, "subDir", hostname2)
+ec.register_connection(col2, ccnd2)
+
+## Deploy all resources
+ec.deploy()
+
+# Wait until the ccncat is finished
+ec.wait_finished([app])
+
+## CCND logs will be collected to the results_dir upon shutdown.
+## We can aldo get the content of the logs now:
+#print "LOG2", ec.trace(ccnd1, "stderr")
+#print "LOG 1", ec.trace(ccnd2, "stderr")
+
+ec.shutdown()
 #    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 #
 # Author: Alina Quereilhac <alina.quereilhac@inria.fr>
+#
+# Instructions to run this example:
+#
+# 1. First edit the script file where required (See ASSING messages)
+#
+# 2. Then, run the script:
+#
+# $ cd <path-to-nepi>
+# $ PYTHONPATH=$PYTHONPATHS:src python examples/linux/ccn/two_nodes_file_retrieval.py
+#
 
-
-from nepi.execution.resource import ResourceState, ResourceAction
 from nepi.execution.ec import ExperimentController
 
 import os
 
 pl_user = ######### <<< ASSIGN the username used to login to the PlanetLab website >>>
 pl_pass = ######## <<< ASSIGN the password used to login to the PlanetLab website >>>
-pl_ssh_key = ####### ASSING the absolute path to the private SSH key used for Planetlab >>>
+pl_ssh_key = ####### <<< ASSING the absolute path to the private SSH key used for Planetlab >>>
 slicename = ####### <<< ASSING the PlanetLab slicename >>>
 
 ## Create the experiment controller
@@ -45,12 +53,9 @@ ec.set(node1, "plpassword", pl_pass)
 ec.set(node1, "username", slicename)
 # Absolute path to the SSH private key for PlanetLab
 ec.set(node1, "identity", pl_ssh_key)
-# Clean all files, results, etc, from previous experiments wit the same
-# exp_id
+# Clean all files, results, etc, from previous experiments wit the same exp_id
 ec.set(node1, "cleanExperiment", True)
-ec.set(node1, "cleanHome", True)
-# Kill all running processes in the PlanetLab node before 
-# running the experiment
+# Kill all running processes in the PlanetLab node before running the experiment
 ec.set(node1, "cleanProcesses", True)
 
 ## Register node 2 
@@ -67,12 +72,9 @@ ec.set(node2, "plpassword", pl_pass)
 ec.set(node2, "username", slicename)
 # Absolute path to the SSH private key for PlanetLab
 ec.set(node1, "identity", pl_ssh_key)
-# Clean all files, results, etc, from previous experiments wit the same
-# exp_id
+# Clean all files, results, etc, from previous experiments wit the same exp_id
 ec.set(node2, "cleanExperiment", True)
-ec.set(node2, "cleanHome", True)
-# Kill all running processes in the PlanetLab node before 
-# running the experiment
+# Kill all running processes in the PlanetLab node before running the experiment
 ec.set(node2, "cleanProcesses", True)
 
 ## Register a CCN daemon in node 1
@@ -92,7 +94,10 @@ ccnr1 = ec.register_resource("LinuxCCNR")
 ec.register_connection(ccnr1, ccnd1)
 
 ## Push the file into the repository
-local_path_to_content = ######### <<< ASSIGN the absolute path to a local file >>>
+local_path_to_content = os.path.join(
+        os.path.dirname(os.path.realpath(__file__)),
+            "..", "..",
+            "big_buck_bunny_240p_mpeg4_lq.ts")
 
 co = ec.register_resource("LinuxCCNContent")
 ec.set(co, "contentName", "ccnx:/test/FILE1")
@@ -104,7 +109,8 @@ ec.register_connection(co, ccnr1)
 ## Deploy all resources
 ec.deploy()
 
-## Wait until node 1 and 2 are deployed
+## Wait until node 1 and 2 are deployed, so we can retrieve the hostnames
+## of the nodes automatically allocated in planetlab
 ec.wait_deployed([node1, node2])
 
 ## Get the hostnames of the two PlanetLab nodes
@@ -113,10 +119,12 @@ print "hostname 1: ", hostname1
 hostname2 = ec.get(node2, "hostname")
 print "hostname 2: ", hostname2
 
+# Register a FIB entry from node 1 to node 2
 entry1 = ec.register_resource("LinuxFIBEntry")
 ec.set(entry1, "host", hostname2)
 ec.register_connection(entry1, ccnd1)
 
+# Register a FIB entry from node 1 to node 2
 entry2 = ec.register_resource("LinuxFIBEntry")
 ec.set(entry2, "host", hostname1)
 ec.register_connection(entry2, ccnd2)