| | 1 | = [wiki:GENIExperimenter/Tutorials/GENIExperimentEngine Get to Know the GENI Experiment Engine] = |
| | 2 | {{{ |
| | 3 | #!html |
| | 4 | <table border="0"> |
| | 5 | |
| | 6 | <tr> |
| | 7 | <td> |
| | 8 | <a href="http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/Template/ExerciseLayout/DesignSetup"> <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design_on.2.png?format=raw" alt="Hello GENI index" height="90" /> </a> |
| | 9 | </td> |
| | 10 | <td> |
| | 11 | <a href="http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/Template/ExerciseLayout/Execute"> <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.2.png?format=raw" alt="Hello GENI index" height="90" /> </a> |
| | 12 | </td> |
| | 13 | <td> |
| | 14 | <a href="http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/Template/ExerciseLayout/IntroToOmni/Finish"> <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.2.png?format=raw" alt="Hello GENI index" height="90" /> </a> |
| | 15 | </td> |
| | 16 | </tr> |
| | 17 | </table> |
| | 18 | }}} |
| | 19 | |
| | 20 | = STEPS FOR SETTING UP = |
| | 21 | |
| | 22 | == Get a GEE Slicelet and download GEE helper files == |
| | 23 | |
| | 24 | Visit http://gee-project.org and login. Once logged in, click on ''Get a slicelet''. Reload the dashboard every few seconds until the slice is in state ''Running'' -- this should take about 30 seconds. Then click on ''Download Slicelet File'' to download the GEE helper files. Unpack the tarball and take a look at '''README.txt'''. |
| | 25 | |
| | 26 | == Learn about GEE networking == |
| | 27 | |
| | 28 | Pick a node from your '''ssh-config''' file and log in to it with SSH. For example: |
| | 29 | |
| | 30 | {{{ |
| | 31 | $ ssh -i id_rsa -F ssh-config slice338.pcvm3-1.instageni.metrodatacenter.com |
| | 32 | }}} |
| | 33 | |
| | 34 | Type '''ifconfig'''. You should see an eth0 interface with an IP address in the 10.0.0.0/8 range, a is a ''private'' IP address. From within a slicelet, you connect to the public Internet via NAT. |
| | 35 | |
| | 36 | The nodes in your '''ssh-config''' file are Docker containers running on (virtual) hosts. These hosts have ''public'' IP addresses that are routable from the commodity Internet, that's why you can login to the Docker containers of your slicelet. A port on the public IP address (e.g., 49155) is forwarded to the SSH port (22) on the container's private IP address. The '''ssh-config''' file contains the names of the virtual hosts and the port forwarding information. |
| | 37 | |
| | 38 | When you run a server on a node in your slicelet, it will listen on the private address. By default it will only be visible to other nodes in your slicelet. Docker provides facilities for exposing ports to the public Internet, but this topic is outside the scope of this tutorial. |
| | 39 | |
| | 40 | ''To complete this lab, you must find the ''public'' IP address of the virtual host for each node in the slicelet.'' |
| | 41 | |
| | 42 | == Learn basic concepts of Ansible == |
| | 43 | |
| | 44 | == Configure the Ansible controller for your slicelet == |
| | 45 | |
| | 46 | = [wiki:GENIExperimenter/Tutorials/GENIExperimentEngine/Execute Next: Run Experiment] = |
