Changes between Version 1 and Version 2 of GENIExperimenter/Tutorials/NewToolsSetup


Ignore:
Timestamp:
01/26/16 22:29:10 (7 years ago)
Author:
Ben Newton
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/Tutorials/NewToolsSetup

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