Changes between Version 3 and Version 4 of GENIExperimenter/Tutorials/NewToolsSetup


Ignore:
Timestamp:
01/26/16 22:40:12 (9 years ago)
Author:
Ben Newton
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/NewToolsSetup

    v3 v4  
    1 {{{
    2 #!html
    3 <h3>1. GENI Portal Account Instructions</h3></div><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><div><span style=3D"font-size:12.8px">These instructions are to test if you are able to log into the GENI Portal using the username and password you use at your home institution, and, in the event that fails, to help you request a GENI account.=C2=A0 (Note: GENI never sees your home institution username and password. For more information on how this works, see=C2=A0</span><a href=3D"http://www.incommon.org/federation/basics.html" style=3D"font-size:12.8px"target=3D"_blank">http://www.incommon.org/federation/basics.html</a><span style=3D"font-size:12.8px">.)</span></div></blockquote><div><blockquote style=3D"font-size:12.8px"><ol><li style=3D"margin-left:15px">Go to=C2=A0<a href=3D"https://portal.geni.net/" target=3D"_blank">https://portal.geni.net</a>=C2=A0and click the big orange &quot;Use GENI&quot; button.</li><li style=3D"margin-left:15px">On the institution chooser page, select your home institution. The text entry field will auto-complete institutions if you type in a few characters. Or you can choose the &quot;Show a list of organizations&quot; option and find your institution in the drop down box.=C2=A0<br>IF your institution does not appear here,=C2=A0<b>STOP</b>=C2=A0and fill out this form:=C2=A0<a href=3D"https://shib-idp.geni.net/geni/request.html" target=3D"_blank">https://shib-idp.geni.net/geni/request.html</a>.</li><li style=3D"margin-left:15px">Click &quot;Continue&quot;. You should be redirected to your home institution&#39;s login page.</li><li style=3D"margin-left:15px">Type in your usual home institution Username and Password. Again, note this information is not sent to GENI.</li><li style=3D"margin-left:15px">You should be redirected to a GENI agreement page.=C2=A0<br>IF this does not happen,=C2=A0<b>STOP</b>=C2=A0and fill out this form:=C2=A0<a href=3D"https://shib-idp.geni.net/geni/request.html" t
    4 arget=3D"_blank">https://shib-idp.geni.net/geni/request.html</a>.</li><li style=3D"margin-left:15px">On the GENI agreement page, check the two boxes that indicate you agree to all policies and to let the portal work on your behalf. Then &quot;submit&quot; the page.=C2=A0 Congratulations, you&#39;re done!=C2=A0 You should now be at the portal home page and you are ready for the GENI tutorial.<br></li></ol></blockquote><h3>2. Computer Requirements<
    5 /h3><span style=3D"font-size:12.8px">=C2=A0=C2=A0=C2=A0 Verify your laptop/desktop meets these minimum requirements:</span><br style=3D"font-size:12.8px"><ul style=3D"font-size:12.8px"><li style=3D"margin-left:15px">Runs a relatively recent version of Mac OS X, Windows or Linux.</li><li style=3D"margin-left:15px">2 GB of memory</li><li style=3D"margin-left:15px">A modern processor, at least dual core and &gt;1.5 GHz, (no Intel Atom, no netbooks, no tablets)</li><li style=3D"margin-left:15px">A good connection to the Internet</li></ul></div><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><div><span style=3D"font-size:12.8px">If you have a choice, MacOS/Linux machines are preferred as they have built-in ssh tools.=C2=A0</span></div><div><span style=3D"font-size:12.8px"><br></span></div></blockquote><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px">
    6 <div><i style=3D"font-size:12.8px">If you have a webcam please use it at the tutorial---web-based tutorials are much less impersonal if we can see your faces!</i></div></blockquote><div><h3>3. Install GENI Tools</h3><div><h3>
    7 3.1 Install Browsers</h3></div></div><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><div><div><div>If not already installed on your machine, please install these browsers:</div></div></div></blockquote>
    8 <div><div><ol style=3D"font-size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif"><ol><li>Chrome:=C2=A0<a href=3D"https://www.google.com/intl/en/chrome/browser/" style=3D"color:rgb(187,0,0);text-decoration:none;border-bottom-width:1px;border-bottom-style:dotted;border-bottom-color:rgb(187,187,187)" target=3D"_blank">Google Chrome</a></li><li>Firefox:=C2=A0<a href=3D"http://www.mozilla.org/en-US/firefox/new/" style=3D"color:rgb(187,0,0);text-decoration:none;border-bottom-width:1px;border-bottom-style:dotted;border-bottom-color:rgb(187,187,187)" target=3D"_blank">Firefox</a>.</li></ol></ol></div><div><h3>3.2 SSH Client</h3></div><span style=3D"font-size:12.8px">=C2=A0 =C2=A0 <b>Mac OS X/Linux</b></span></div><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><div><div><span style=3D"font-size:13px;color:rgb(0,0,0);font
    9 -family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif">M
    10 ac OS X and Linux come with an ssh client you can run from a Terminal windo
    11 w. You do not need to install anything. Proceed to the &quot;Test SSH with
    12 keys&quot;=C2=A0</span><span style=3D"font-size:13px;color:rgb(0,0,0);font-
    13 family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif">se
    14 ction below.</span></div></div></blockquote><div><div><div><span style=3D"f
    15 ont-size:12.8px"><br></span></div><div><span style=3D"font-size:12.8px">=C2
    16 =A0 =C2=A0=C2=A0<b>Windows</b></span></div></div></div><blockquote style=3D
    17 "margin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-size:13p
    18 x;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,
    19 Helvetica,sans-serif"><strong>Recommended -=C2=A0</strong>=C2=A0Install Put
    20 ty, a free SSH client for Windows:</p></blockquote><blockquote style=3D"mar
    21 gin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-size:13px;co
    22 lor:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helv
    23 etica,sans-serif"></p><ul><li><a href=3D"http://www.chiark.greenend.org.uk/
    24 ~sgtatham/putty/download.html" style=3D"color:rgb(187,0,0);text-decoration:
    25 none;border-bottom-width:1px;border-bottom-style:dotted;border-bottom-color
    26 :rgb(187,187,187)" target=3D"_blank">http://www.chiark.greenend.org.uk/~sgt
    27 atham/putty/download.html</a><br></li></ul><p></p></blockquote><blockquote
    28 style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-
    29 size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sa
    30 ns&#39;,Helvetica,sans-serif">Alternative - Install FireSSH, a Firefox ssh
    31 plugin:</p></blockquote><blockquote style=3D"margin:0px 0px 0px 40px;border
    32 :none;padding:0px"><p style=3D"font-size:13px;color:rgb(0,0,0);font-family:
    33 Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif"></p><ul><
    34 li>Install the plugin from=C2=A0<a href=3D"https://addons.mozilla.org/en-US
    35 /firefox/addon/firessh/" style=3D"color:rgb(187,0,0);text-decoration:none;b
    36 order-bottom-width:1px;border-bottom-style:dotted;border-bottom-color:rgb(1
    37 87,187,187)" target=3D"_blank">FireSSH</a>=C2=A0</li></ul></blockquote><spa
    38 n style=3D"font-size:15.21px;font-weight:bold">3.3 Test SSH with keys</span
    39 ><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><p s
    40 tyle=3D"font-size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bits
    41 tream Vera Sans&#39;,Helvetica,sans-serif">Attached is a copy of an SSH pri
    42 vate key. Follow the instructions below which apply to your Operating Syste
    43 m/Tool. =C2=A0(PuTTY users should use the key file with=C2=A0<tt>PUTTY</tt>
    44 =C2=A0in it&#39;s name)=C2=A0</p></blockquote><div><div><span style=3D"font
    45 -size:12.8px">=C2=A0 =C2=A0=C2=A0<b>Mac OS X/Linux</b></span></div><blockqu
    46 ote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><ol style=3D"
    47 color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,He
    48 lvetica,sans-serif;font-size:13px"><li>Save the NOT_PUTTY version of the pr
    49 ivate key attached to this message on your computer. =C2=A0</li><li>Open a
    50 terminal</li><li>Ensure that your private key has the right permissions by
    51 typing :<pre style=3D"border:1px solid rgb(215,215,215);margin:1em 1.75em;p
    52 adding:0.25em;overflow:auto;background:rgb(247,247,247)">chmod 700 &lt;priv
    53 ate_key_file&gt;
    54 </pre></li><li>Run ssh by typing:</li><li><pre style=3D"border:1px solid rg
    55 b(215,215,215);margin:1em 1.75em;padding:0.25em;overflow:auto;background:rg
    56 b(247,247,247)">ssh -i &lt;private key location&gt; <a href=3D"mailto:sshte
    57 st@pc3.geni.uchicago.edu" target=3D"_blank">sshtest@pc3.geni.uchicago.edu</
    58 a> -p 32826</pre></li></ol></blockquote></div><blockquote style=3D"margin:0
    59 px 0px 0px 40px;border:none;padding:0px"><blockquote style=3D"margin:0px 0p
    60 x 0px 40px;border:none;padding:0px"><span style=3D"font-size:13px;color:rgb
    61 (0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,s
    62 ans-serif">5.=C2=A0 Enter the passphrase (</span><span style=3D"color:rgb(0
    63 ,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,san
    64 s-serif;font-size:13px">v3rify</span><span style=3D"font-size:13px;color:rg
    65 b(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,
    66 sans-serif">) when prompted.=C2=A0</span><strong style=3D"font-size:13px;co
    67 lor:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helv
    68 etica,sans-serif">Note</strong><span style=3D"font-size:13px;color:rgb(0,0,
    69 0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-s
    70 erif">: If you are prompted for a password then something went wrong. Make
    71 sure that all the information is correct.</span></blockquote><blockquote st
    72 yle=3D"margin:0px 0px 0px 40px;border:none;padding:0px"></blockquote></bloc
    73 kquote><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px
    74 "><span style=3D"font-size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,
    75 &#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif"><br>If you see the prom
    76 pt=C2=A0</span><tt style=3D"font-size:13px;color:rgb(0,0,0)">sshtest@test:~
    77 $=C2=A0</tt><span style=3D"font-size:13px;color:rgb(0,0,0);font-family:Verd
    78 ana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif">you are all s
    79 et!=C2=A0</span><br></blockquote><blockquote style=3D"margin:0px 0px 0px 40
    80 px;border:none;padding:0px"><blockquote style=3D"margin:0px 0px 0px 40px;bo
    81 rder:none;padding:0px"><span style=3D"color:rgb(0,0,0);font-family:Verdana,
    82 Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif;font-size:13px"><b
    83 r></span><br></blockquote></blockquote><div><div><div><span style=3D"font-s
    84 ize:12.8px">=C2=A0 =C2=A0=C2=A0<b>Windows PUTTY</b></span></div></div></div
    85 ><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><div
    86 ><div><div><ol style=3D"font-size:13px;color:rgb(0,0,0);font-family:Verdana
    87 ,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif"><li>You will use
    88  the PUTTY version of the private key attached to this message.=C2=A0 Save
    89 the key on your computer. (<i>It was converted from the standard fromat usi
    90 ng the puttygen program. For more information look=C2=A0<a href=3D"https://
    91 apps.state.or.us/tech/htdocs/putty/Chapter8.html#8.2.12" style=3D"color:rgb
    92 (187,0,0);text-decoration:none;border-bottom-width:1px;border-bottom-style:
    93 dotted;border-bottom-color:rgb(187,187,187)" target=3D"_blank">here</a>)</i
    94 ></li><li>Run PuTTY. =C2=A0</li><li>On the Basic options screen, in the Hos
    95 t Name field enter: =C2=A0<b><a href=3D"mailto:sshtest@pc3.geni.uchicago.ed
    96 u" target=3D"_blank">sshtest@pc3.geni.uchicago.edu</a></b></li><li>In the P
    97 ort field enter: <b>32826</b></li><li>Make sure Connection type is: =C2=A0<
    98 b>SSH</b></li><li>Under the settings categories on the left navigate to Con
    99 nection-&gt; <b>SSH -&gt;Auth</b>.=C2=A0</li><li>Next to the &quot;<b>Priva
    100 te key file for authentication</b>&quot; field at the bottom, click <b>Brow
    101 se...</b> and select the private key file you saved to your computer, and c
    102 lick <b>Open</b>.=C2=A0</li><li>Click <b>Open</b> to establish the SSH conn
    103 ection.</li><li>If prompted about whether you trust the host (key not cache
    104 d in registry), click Yes. =C2=A0</li><li>When prompted for the Passphrase
    105 enter: <b>v3rify</b></li></ol></div></div></div></blockquote><blockquote st
    106 yle=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-si
    107 ze:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans
    108 &#39;,Helvetica,sans-serif">If you see the prompt=C2=A0<tt>sshtest@test:~$
    109 =C2=A0</tt>you are all set!=C2=A0<br></p></blockquote><span style=3D"font-s
    110 ize:12.8px">=C2=A0 =C2=A0=C2=A0</span><b style=3D"font-size:12.8px">Windows
    111  FireSSH</b><br><blockquote style=3D"margin:0px 0px 0px 40px;border:none;pa
    112 dding:0px"><p style=3D"color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bits
    113 tream Vera Sans&#39;,Helvetica,sans-serif;font-size:13px">After you Install
    114 =C2=A0<a href=3D"https://addons.mozilla.org/en-us/firefox/addon/firessh/" s
    115 tyle=3D"text-decoration:none;border-bottom-width:1px;border-bottom-style:do
    116 tted;border-bottom-color:rgb(187,187,187);color:rgb(187,0,0)" target=3D"_bl
    117 ank">FireSSH</a>=C2=A0:</p></blockquote><ol><ol style=3D"color:rgb(0,0,0);f
    118 ont-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif
    119 ;font-size:13px"><li>Save the NOT_PUTTY version of the private key attached
    120  to this message on your computer.=C2=A0<br></li><li>Load this URL into fir
    121 efox: =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0<tt>ssh://<a href=3D"http://sshtest
    122 @pc3.geni.uchicago.edu:32826" target=3D"_blank">sshtest@pc3.geni.uchicago.e
    123 du:32826</a></tt></li><li>In the pop-up window, enter the passphrase <b>v3r
    124 ify</b> in the (mislabeled) password field, and click <b>Browse...</b>=C2
    125 =A0</li><li>Select the private key, and click <b>Open</b>.</li><li>Click <b
    126 >OK</b>.=C2=A0</li><li>If prompted about whether you trust the host (host k
    127 ey not cached in registry), click Yes. =C2=A0</li></ol></ol><blockquote sty
    128 le=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><span style=3D"color
    129 :rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helveti
    130 ca,sans-serif;font-size:13px">If you see the prompt=C2=A0</span><tt style
    131 =3D"color:rgb(0,0,0);font-size:13px">sshtest@test:~$=C2=A0</tt><span style
    132 =3D"color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39
    133 ;,Helvetica,sans-serif;font-size:13px">you are all set!=C2=A0</span></block
    134 quote></div>
    135 </div><br><div>You are now connected to a GENI virtual machine, and you kno
    136 w how to establish an SSH connection using a private key, which will be nec
    137 essary for the tutorial.=C2=A0 You can now close the connection. Your setup
    138  is complete.=C2=A0</div></div>
    139 }}}
     11. GENI Portal Account Instructions
     2
     3These instructions are to test if you are able to log into the GENI Portal using the username and password you use at your home institution, and, in the event that fails, to help you request a GENI account.  (Note: GENI never sees your home institution username and password. For more information on how this works, see http://www.incommon.org/federation/basics.html.)
     4Go to https://portal.geni.net and click the big orange "Use GENI" button.
     5On the institution chooser page, select your home institution. The text entry field will auto-complete institutions if you type in a few characters. Or you can choose the "Show a list of organizations" option and find your institution in the drop down box.
     6IF your institution does not appear here, STOP and fill out this form: https://shib-idp.geni.net/geni/request.html.
     7Click "Continue". You should be redirected to your home institution's login page.
     8Type in your usual home institution Username and Password. Again, note this information is not sent to GENI.
     9You should be redirected to a GENI agreement page.
     10IF this does not happen, STOP and fill out this form: https://shib-idp.geni.net/geni/request.html.
     11On the GENI agreement page, check the two boxes that indicate you agree to all policies and to let the portal work on your behalf. Then "submit" the page.  Congratulations, you're done!  You should now be at the portal home page and you are ready for the GENI tutorial.
     122. Computer Requirements
     13
     14    Verify your laptop/desktop meets these minimum requirements:
     15Runs a relatively recent version of Mac OS X, Windows or Linux.
     162 GB of memory
     17A modern processor, at least dual core and >1.5 GHz, (no Intel Atom, no netbooks, no tablets)
     18A good connection to the Internet
     19If you have a choice, MacOS/Linux machines are preferred as they have built-in ssh tools.
     20
     21If you have a webcam please use it at the tutorial---web-based tutorials are much less impersonal if we can see your faces!
     223. Install GENI Tools
     23
     243.1 Install Browsers
     25
     26If not already installed on your machine, please install these browsers:
     27Chrome: Google Chrome
     28Firefox: Firefox.
     293.2 SSH Client
     30
     31    Mac OS X/Linux
     32Mac OS X and Linux come with an ssh client you can run from a Terminal window. You do not need to install anything. Proceed to the "Test SSH with keys" section below.
     33
     34    Windows
     35Recommended -  Install Putty, a free SSH client for Windows:
     36
     37http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
     38Alternative - Install FireSSH, a Firefox ssh plugin:
     39
     40Install the plugin from FireSSH
     413.3 Test SSH with keys
     42Attached is a copy of an SSH private key. Follow the instructions below which apply to your Operating System/Tool.  (PuTTY users should use the key file with PUTTY in it's name)
     43
     44    Mac OS X/Linux
     45Save the NOT_PUTTY version of the private key attached to this message on your computer. 
     46Open a terminal
     47Ensure that your private key has the right permissions by typing :
     48chmod 700 <private_key_file>
     49Run ssh by typing:
     50ssh -i <private key location> sshtest@pc3.geni.uchicago.edu -p 32826
     515.  Enter the passphrase (v3rify) when prompted. Note: If you are prompted for a password then something went wrong. Make sure that all the information is correct.
     52
     53If you see the prompt sshtest@test:~$ you are all set!
     54
     55
     56    Windows PUTTY
     57You will use the PUTTY version of the private key attached to this message.  Save the key on your computer. (It was converted from the standard fromat using the puttygen program. For more information look here)
     58Run PuTTY. 
     59On the Basic options screen, in the Host Name field enter:  sshtest@pc3.geni.uchicago.edu
     60In the Port field enter: 32826
     61Make sure Connection type is:  SSH
     62Under the settings categories on the left navigate to Connection-> SSH ->Auth.
     63Next to the "Private key file for authentication" field at the bottom, click Browse... and select the private key file you saved to your computer, and click Open.
     64Click Open to establish the SSH connection.
     65If prompted about whether you trust the host (key not cached in registry), click Yes. 
     66When prompted for the Passphrase enter: v3rify
     67If you see the prompt sshtest@test:~$ you are all set!
     68
     69    Windows FireSSH
     70After you Install FireSSH :
     71
     72Save the NOT_PUTTY version of the private key attached to this message on your computer.
     73Load this URL into firefox:          ssh://sshtest@pc3.geni.uchicago.edu:32826
     74In the pop-up window, enter the passphrase v3rify in the (mislabeled) password field, and click Browse...
     75Select the private key, and click Open.
     76Click OK.
     77If prompted about whether you trust the host (host key not cached in registry), click Yes. 
     78If you see the prompt sshtest@test:~$ you are all set!
     79
     80You are now connected to a GENI virtual machine, and you know how to establish an SSH connection using a private key, which will be necessary for the tutorial.  You can now close the connection. Your setup is complete.