Changes between Version 1 and Version 2 of DETERIntro


Ignore:
Timestamp:
Sep 25, 2015 1:51:23 PM (9 years ago)
Author:
cristina
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DETERIntro

    v1 v2  
    33= Student Introduction to DETER =
    44
    5 Contributors:
    6 Peter A. H. Peterson, UCLA. pahp@cs.ucla.edu
    7 David Morgan, USC. davidmor@usc.edu
     5'''Contributors:  \\
     6Peter A. H. Peterson, UCLA. pahp@cs.ucla.edu \\
     7David Morgan, USC. davidmor@usc.edu'''
    88
    99== What is DETER? ==
     
    5959=== How do I access my experiment? ===
    6060
    61 Your experiment is made up of one or more machines on the internal DETER network, which is behind a firewall. To access your experimental nodes, you'll need to first ssh to {{{users.deterlab.net}}}. If you don't know how to use SSH, see our tutorial (TBD).
     61Your experiment is made up of one or more machines on the internal DETER network, which is behind a firewall. To access your experimental nodes, you'll need to first SSH to {{{users.deterlab.net}}}. If you don't know how to use SSH, see our tutorial (TBD).
    6262
    6363{{{users.deterlab.net}}} (or {{{users}}} for short) is the "control server" for DETER. From {{{users}}} you can contact all your nodes, reboot them, connect to their serial ports, etc.
     
    6666
    6767Once your experiment has swapped in:
    68 Navigate to the experiment you just installed.
    69 If you just swapped in your experiment, the quickest way to find your node names is to click on the experiment name in the table under "Swap Control." However, you can also get there by clicking "My DETERlab" under the "Experimentation" menu. Your experiment is listed as "active" in the "State" column. Click on the experiment's name in the "EID" column.
    70 Once you can see your experiment's page, click on the "Details" tab in the main content panel. Your nodes' network names are listed under the heading "Qualified Name."
    71 For example, node1.YourExperiment.YourProject.isi.deterlab.net.
    72 You should familiarize yourself with the information available on this page, but for now we just need to know the long DNS qualified name(s) node(s) you just swapped in. If you are curious, you should also look at the "Settings" (generic info), "Visualization," and "NS File." (The topology mapplet may be disabled for some labs, so these last two may not be visible).
    73 Now that you are logged in to {{{users.deterlab.net}}}, your nodes are swapped in, and you know their network name(s), you can ssh from {{{users}}} to your experimental nodes by executing: ssh node1.YourExperiment.YourProject.isi.deterlab.net. You will not need to re-authenticate.
    74 You may need to wait a few more minutes. Once DETER is finished setting up the experiment, the nodes still need a minute or two to boot and complete their configuration. If you get a message about "server configuration" when you try to log in, wait a few minutes and try again.
    75 If a lab instructs you to create new users on your experimental nodes, you can log in as them by running ssh newuser@node1.YourExperiment.YourProject.isi.deterlab.net or ssh newuser@localhost from the experimental node.
    76 Congratulations! Your lab environment is now set up, and you can get to work at the tasks in your lab manual. Make sure you read Things to keep in mind section.
     681. Navigate to the experiment you just installed.
     69    - If you just swapped in your experiment, the quickest way to find your node names is to click on the experiment name in the table under "Swap Control." However, you      can also get there by clicking "My DeterLab". Your experiment is listed as "active" in the "State" column. Click on the experiment's name in the "EID" column.
     702. Once you can see your experiment's page, click on the "Details" tab in the main content panel. Your nodes' network names are listed under the heading "Qualified Name."
     71    - For example, {{{node1.YourExperiment.YourProject.isi.deterlab.net}}}.
     72    - You should familiarize yourself with the information available on this page, but for now we just need to know the long DNS qualified name(s) node(s) you just swapped in. If you are curious, you should also look at the "Settings" (generic info), "Visualization," and "NS File." (The topology mapplet may be disabled for some labs, so these last two may not be visible).
     733. Now that you are logged in to {{{users.deterlab.net}}}, your nodes are swapped in, and you know their network name(s), you can SSH from {{{users}}} to your experimental nodes by executing: {{{ssh node1.YourExperiment.YourProject.isi.deterlab.net}}}. You will not need to re-authenticate.
     74   - You may need to wait a few more minutes. Once DeterLab is finished setting up the experiment, the nodes still need a minute or two to boot and complete their configuration. If you get a message about "server configuration" when you try to log in, wait a few minutes and try again.
     75   - If a lab instructs you to create new users on your experimental nodes, you can log in as them by running {{{ssh newuser@node1.YourExperiment.YourProject.isi.deterlab.net}}} or {{{ssh newuser@localhost}}} from the experimental node.
     76
     77Congratulations! Your lab environment is now set up, and you can get to work at the tasks in your lab manual. Make sure you read the "Things to keep in mind" section below!
    7778
    7879 Some labs benefit from Port Forwarding. Port Forwarding is a technique that can allow you to access your experimental nodes directly from your desktop computer. This is especially useful for accessing web applications running on your experimental nodes. See our ssh tutorial for more information.
     
    8081Finally, when you are done working with your nodes, you should save your work and swap out the experiment so that someone else can use the physical machines.
    8182
    82 
    83 Things to keep in mind
     83== Things to keep in mind ==
    8484
    8585Carefully read the evolving version of this document.