Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/TrainTheTA-Fall2014/SliceAccessTutorial


Ignore:
Timestamp:
09/17/14 18:30:04 (8 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/Tutorials/TrainTheTA-Fall2014/SliceAccessTutorial

    v1 v1  
     1[[PageOutline]]
     2
     3= Accessing Resources in Slices Created by your Students =
     4
     5== Portal Reservation ==
     6When the students reserve resources through the portal, then the project lead and the project admins get accounts in the compute resources as well.
     7
     8Let's try that:
     9  1. Login to the portal and load the ''Slices'' Tab
     10  2. Choose the slice called `sliceaccess-portal`
     11  3. Check the status for all the aggregates in the slice by pressing the ''Get All'' button. Where does this slice have resources?
     12  4. Press the ''Details''  button for that specific aggregate and wait until all the information is loaded.
     13  5. Login to the node using your own account
     14'''''Action: Send an email to tutorials@geni.net with the keys installed for user `vthomas`'''''
     15
     16{{{
     17#!html
     18<table id="Table_03" border="0" cellpadding="5" cellspacing="0">
     19        <tr>
     20                <td>
     21                        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="30" height="30" alt="Tip"/>
     22               </td>
     23               <td>
     24                   The installed keys are located in a text file under the .ssh directory of the user.
     25               </td>
     26        </tr>
     27</table>
     28<table id="Table_03" border="0" cellpadding="5" cellspacing="0">
     29        <tr>
     30                <td>
     31                        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="30" height="30" alt="Tip"/>
     32               </td>
     33               <td>
     34                    You will need to use <code>sudo</code> to access the directory of another user
     35               </td>
     36        </tr>
     37</table>
     38}}}
     39
     40
     41== Reservation with other tools ==
     42When students are reserving resource with other tools then only their key is loaded onto the nodes. To help your students debug in this case you should ask your students to load a common public SSH key into their account on the Portal.
     43
     44{{{
     45#!html
     46
     47<table id="Table_01" border="0" cellpadding="5" cellspacing="0">
     48        <tr>
     49                <td>
     50                        <img src="http://trac.gpolab.bbn.com/gcf/raw-attachment/wiki/Graphics/4NotesIcon_512x512.png" width="30" height="30" alt="Note">
     51               </td>
     52<td>We are working to have all tools support multi-user slices directly which will eliminate the need for this workaround. Check back periodically to see which tools support this.
     53</td>
     54        </tr>
     55</table>
     56}}}
     57
     58The process of loading a common public SSH key has two steps...
     59=== A. Generate SSH Keypairs ===
     60To generate an SSH Key pair use [http://en.wikipedia.org/wiki/Ssh-keygen keygen].
     61  1. In a terminal run
     62  {{{
     63  ssh-keygen
     64  }}}
     65  2. Follow the instructions:
     66    * You can name your key anything you like, for this exercise name it `common-key`
     67    *  Make sure to remember the passphrase you set.
     68  3. Run `ls` to see the contents of your directory. There should be two files generated from the previous command:
     69    * `common-key`: This is the private key. You keep this to your self and maybe share it with the professor of the class and other admins of the project.
     70    * `common-key.pub`: This is the public key. This is the key you give to the students to load to their profile.[[BR]]
     71{{{
     72#!html
     73<table id="Table_03" border="0" cellpadding="5" cellspacing="0">
     74        <tr>
     75                <td>
     76                        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="30" height="30" alt="Tip"/>
     77               </td>
     78               <td>
     79If you have too many files, try to filter the output to make it easier to find your keys. Try:
     80    <pre>
     81       ls comm*
     82    </pre>
     83               </td>
     84        </tr>
     85</table>
     86}}}
     87
     88'''''Action: Send an email to tutorials@geni.net with the public key you generated.'''''
     89
     90The next step in your classroom would be to send this public key to your students to load it in their profile; [wiki:HowTo/LoadPubKeyToPortal Instructions about how to do that].
     91 
     92=== B. Access nodes ===
     93Let's try this and see how this approach works and how you would login in using this common key. For the purpose of this exercise we have generated a common public key that you can download from: http://tinyurl.com/TACommonKey (actual URL: http://www.gpolab.bbn.com/experiment-support/TrainTheTA/common-key )
     94{{{
     95#!html
     96<table id="Table_03" border="0" cellpadding="5" cellspacing="0">
     97        <tr>
     98                <td>
     99                        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="30" height="30" alt="Tip"/>
     100               </td>
     101               <td>
     102                   If you load it in the browser then just save the file using your browser's menus.
     103               </td>
     104        </tr>
     105</table>
     106}}}
     107
     108The first steps are exactly the same as before:
     109  1. Login to the portal and load the ''Slices'' Tab
     110  2. Choose the slice called `sliceaccess-flack`
     111  3. Check the status for all the aggregates in the slice by pressing the ''Get All'' button. Where does this slice have resources?
     112  4. Press the ''Details'' button for that specific aggregate and wait until all the information is loaded.
     113  5. Notice that there is only one account created.
     114   
     115{{{
     116#!html
     117
     118<table id="Table_01" border="0" cellpadding="5" cellspacing="0">
     119        <tr>
     120                <td>
     121                        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/warning-icon-hi.png?format=raw" width="30" height="30" alt="Warning">
     122               </td>
     123<td>You will need to change the permissions so this file is only accessible to you. In a terminal do:
     124<pre>
     125      chmod 600 &lt;location_of_downloaded_key&gt;
     126</pre>
     127</td>
     128        </tr>
     129</table>
     130}}}
     131
     132
     133  6. Use this key to login to the nodes:
     134      i. Copy the ssh command from the portal
     135      ii. Paste it in the terminal
     136      iii. Add at the end: `-i <location_of_downloaded_key>`
     137
     138 '''''Action: Send an email to tutorials@geni.net with the contents of the file `done.txt` '''''
     139