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

Timestamp:

01/26/16 22:29:10 (7 years ago)

Author:

Ben Newton

Comment:

--

GENIExperimenter/Tutorials/NewToolsSetup

@@ -1 @@
-f
+{{{
+#!html
+<h3>1. GENI Portal Acco=
+unt Instructions</h3></div><blockquote style=3D"margin:0px 0px 0px 40px;bor=
+der:none;padding:0px"><div><span style=3D"font-size:12.8px">These instructi=
+ons are to test if you are able to log into the GENI Portal using the usern=
+ame and password you use at your home institution, and, in the event that f=
+ails, 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 w=
+orks, 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"ma=
+rgin-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 ch=
+ooser page, select your home institution. The text entry field will auto-co=
+mplete 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 i=
+n 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-id=
+p.geni.net/geni/request.html" target=3D"_blank">https://shib-idp.geni.net/g=
+eni/request.html</a>.</li><li style=3D"margin-left:15px">Click &quot;Contin=
+ue&quot;. You should be redirected to your home institution&#39;s login pag=
+e.</li><li style=3D"margin-left:15px">Type in your usual home institution U=
+sername 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 agreemen=
+t page.=C2=A0<br>IF this does not happen,=C2=A0<b>STOP</b>=C2=A0and fill ou=
+t this form:=C2=A0<a href=3D"https://shib-idp.geni.net/geni/request.html" t=
+arget=3D"_blank">https://shib-idp.geni.net/geni/request.html</a>.</li><li s=
+tyle=3D"margin-left:15px">On the GENI agreement page, check the two boxes t=
+hat indicate you agree to all policies and to let the portal work on your b=
+ehalf. 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<=
+/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.8=
+px"><ul style=3D"font-size:12.8px"><li style=3D"margin-left:15px">Runs a re=
+latively recent version of Mac OS X, Windows or Linux.</li><li style=3D"mar=
+gin-left:15px">2 GB of memory</li><li style=3D"margin-left:15px">A modern p=
+rocessor, 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 Int=
+ernet</li></ul></div><blockquote style=3D"margin:0px 0px 0px 40px;border:no=
+ne;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></blockq=
+uote><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px">=
+<div><i style=3D"font-size:12.8px">If you have a webcam please use it at th=
+e tutorial---web-based tutorials are much less impersonal if we can see you=
+r faces!</i></div></blockquote><div><h3>3. Install GENI Tools</h3><div><h3>=
+3.1 Install Browsers</h3></div></div><blockquote style=3D"margin:0px 0px 0p=
+x 40px;border:none;padding:0px"><div><div><div>If not already installed on =
+your machine, please install these browsers:</div></div></div></blockquote>=
+<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"c=
+olor:rgb(187,0,0);text-decoration:none;border-bottom-width:1px;border-botto=
+m-style:dotted;border-bottom-color:rgb(187,187,187)" target=3D"_blank">Goog=
+le 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-bott=
+om-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 Clie=
+nt</h3></div><span style=3D"font-size:12.8px">=C2=A0 =C2=A0 <b>Mac OS X/Lin=
+ux</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=
+-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif">M=
+ac OS X and Linux come with an ssh client you can run from a Terminal windo=
+w. You do not need to install anything. Proceed to the &quot;Test SSH with =
+keys&quot;=C2=A0</span><span style=3D"font-size:13px;color:rgb(0,0,0);font-=
+family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif">se=
+ction below.</span></div></div></blockquote><div><div><div><span style=3D"f=
+ont-size:12.8px"><br></span></div><div><span style=3D"font-size:12.8px">=C2=
+=A0 =C2=A0=C2=A0<b>Windows</b></span></div></div></div><blockquote style=3D=
+"margin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-size:13p=
+x;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,=
+Helvetica,sans-serif"><strong>Recommended -=C2=A0</strong>=C2=A0Install Put=
+ty, a free SSH client for Windows:</p></blockquote><blockquote style=3D"mar=
+gin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-size:13px;co=
+lor:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helv=
+etica,sans-serif"></p><ul><li><a href=3D"http://www.chiark.greenend.org.uk/=
+~sgtatham/putty/download.html" 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">http://www.chiark.greenend.org.uk/~sgt=
+atham/putty/download.html</a><br></li></ul><p></p></blockquote><blockquote =
+style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-=
+size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sa=
+ns&#39;,Helvetica,sans-serif">Alternative - Install FireSSH, a Firefox ssh =
+plugin:</p></blockquote><blockquote style=3D"margin:0px 0px 0px 40px;border=
+:none;padding:0px"><p style=3D"font-size:13px;color:rgb(0,0,0);font-family:=
+Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif"></p><ul><=
+li>Install the plugin from=C2=A0<a href=3D"https://addons.mozilla.org/en-US=
+/firefox/addon/firessh/" style=3D"color:rgb(187,0,0);text-decoration:none;b=
+order-bottom-width:1px;border-bottom-style:dotted;border-bottom-color:rgb(1=
+87,187,187)" target=3D"_blank">FireSSH</a>=C2=A0</li></ul></blockquote><spa=
+n style=3D"font-size:15.21px;font-weight:bold">3.3 Test SSH with keys</span=
+><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><p s=
+tyle=3D"font-size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bits=
+tream Vera Sans&#39;,Helvetica,sans-serif">Attached is a copy of an SSH pri=
+vate key. Follow the instructions below which apply to your Operating Syste=
+m/Tool. =C2=A0(PuTTY users should use the key file with=C2=A0<tt>PUTTY</tt>=
+=C2=A0in it&#39;s name)=C2=A0</p></blockquote><div><div><span style=3D"font=
+-size:12.8px">=C2=A0 =C2=A0=C2=A0<b>Mac OS X/Linux</b></span></div><blockqu=
+ote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><ol style=3D"=
+color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,He=
+lvetica,sans-serif;font-size:13px"><li>Save the NOT_PUTTY version of the pr=
+ivate key attached to this message on your computer. =C2=A0</li><li>Open a =
+terminal</li><li>Ensure that your private key has the right permissions by =
+typing :<pre style=3D"border:1px solid rgb(215,215,215);margin:1em 1.75em;p=
+adding:0.25em;overflow:auto;background:rgb(247,247,247)">chmod 700 &lt;priv=
+ate_key_file&gt;
+</pre></li><li>Run ssh by typing:</li><li><pre style=3D"border:1px solid rg=
+b(215,215,215);margin:1em 1.75em;padding:0.25em;overflow:auto;background:rg=
+b(247,247,247)">ssh -i &lt;private key location&gt; <a href=3D"mailto:sshte=
+st@pc3.geni.uchicago.edu" target=3D"_blank">sshtest@pc3.geni.uchicago.edu</=
+a> -p 32826</pre></li></ol></blockquote></div><blockquote style=3D"margin:0=
+px 0px 0px 40px;border:none;padding:0px"><blockquote style=3D"margin:0px 0p=
+x 0px 40px;border:none;padding:0px"><span style=3D"font-size:13px;color:rgb=
+(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,s=
+ans-serif">5.=C2=A0 Enter the passphrase (</span><span style=3D"color:rgb(0=
+,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,san=
+s-serif;font-size:13px">v3rify</span><span style=3D"font-size:13px;color:rg=
+b(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,=
+sans-serif">) when prompted.=C2=A0</span><strong style=3D"font-size:13px;co=
+lor:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helv=
+etica,sans-serif">Note</strong><span style=3D"font-size:13px;color:rgb(0,0,=
+0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-s=
+erif">: If you are prompted for a password then something went wrong. Make =
+sure that all the information is correct.</span></blockquote><blockquote st=
+yle=3D"margin:0px 0px 0px 40px;border:none;padding:0px"></blockquote></bloc=
+kquote><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px=
+"><span style=3D"font-size:13px;color:rgb(0,0,0);font-family:Verdana,Arial,=
+&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif"><br>If you see the prom=
+pt=C2=A0</span><tt style=3D"font-size:13px;color:rgb(0,0,0)">sshtest@test:~=
+$=C2=A0</tt><span style=3D"font-size:13px;color:rgb(0,0,0);font-family:Verd=
+ana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif">you are all s=
+et!=C2=A0</span><br></blockquote><blockquote style=3D"margin:0px 0px 0px 40=
+px;border:none;padding:0px"><blockquote style=3D"margin:0px 0px 0px 40px;bo=
+rder:none;padding:0px"><span style=3D"color:rgb(0,0,0);font-family:Verdana,=
+Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif;font-size:13px"><b=
+r></span><br></blockquote></blockquote><div><div><div><span style=3D"font-s=
+ize:12.8px">=C2=A0 =C2=A0=C2=A0<b>Windows PUTTY</b></span></div></div></div=
+><blockquote style=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><div=
+><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"><li>You will use=
+ the PUTTY version of the private key attached to this message.=C2=A0 Save =
+the key on your computer. (<i>It was converted from the standard fromat usi=
+ng the puttygen program. For more information look=C2=A0<a href=3D"https://=
+apps.state.or.us/tech/htdocs/putty/Chapter8.html#8.2.12" 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">here</a>)</i=
+></li><li>Run PuTTY. =C2=A0</li><li>On the Basic options screen, in the Hos=
+t Name field enter: =C2=A0<b><a href=3D"mailto:sshtest@pc3.geni.uchicago.ed=
+u" target=3D"_blank">sshtest@pc3.geni.uchicago.edu</a></b></li><li>In the P=
+ort field enter: <b>32826</b></li><li>Make sure Connection type is: =C2=A0<=
+b>SSH</b></li><li>Under the settings categories on the left navigate to Con=
+nection-&gt; <b>SSH -&gt;Auth</b>.=C2=A0</li><li>Next to the &quot;<b>Priva=
+te key file for authentication</b>&quot; field at the bottom, click <b>Brow=
+se...</b> and select the private key file you saved to your computer, and c=
+lick <b>Open</b>.=C2=A0</li><li>Click <b>Open</b> to establish the SSH conn=
+ection.</li><li>If prompted about whether you trust the host (key not cache=
+d in registry), click Yes. =C2=A0</li><li>When prompted for the Passphrase =
+enter: <b>v3rify</b></li></ol></div></div></div></blockquote><blockquote st=
+yle=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><p style=3D"font-si=
+ze:13px;color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans=
+&#39;,Helvetica,sans-serif">If you see the prompt=C2=A0<tt>sshtest@test:~$=
+=C2=A0</tt>you are all set!=C2=A0<br></p></blockquote><span style=3D"font-s=
+ize:12.8px">=C2=A0 =C2=A0=C2=A0</span><b style=3D"font-size:12.8px">Windows=
+ FireSSH</b><br><blockquote style=3D"margin:0px 0px 0px 40px;border:none;pa=
+dding:0px"><p style=3D"color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bits=
+tream Vera Sans&#39;,Helvetica,sans-serif;font-size:13px">After you Install=
+=C2=A0<a href=3D"https://addons.mozilla.org/en-us/firefox/addon/firessh/" s=
+tyle=3D"text-decoration:none;border-bottom-width:1px;border-bottom-style:do=
+tted;border-bottom-color:rgb(187,187,187);color:rgb(187,0,0)" target=3D"_bl=
+ank">FireSSH</a>=C2=A0:</p></blockquote><ol><ol style=3D"color:rgb(0,0,0);f=
+ont-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helvetica,sans-serif=
+;font-size:13px"><li>Save the NOT_PUTTY version of the private key attached=
+ to this message on your computer.=C2=A0<br></li><li>Load this URL into fir=
+efox: =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0<tt>ssh://<a href=3D"http://sshtest=
+@pc3.geni.uchicago.edu:32826" target=3D"_blank">sshtest@pc3.geni.uchicago.e=
+du:32826</a></tt></li><li>In the pop-up window, enter the passphrase <b>v3r=
+ify</b> in the (mislabeled) password field, and click <b>Browse...</b>=C2=
+=A0</li><li>Select the private key, and click <b>Open</b>.</li><li>Click <b=
+>OK</b>.=C2=A0</li><li>If prompted about whether you trust the host (host k=
+ey not cached in registry), click Yes. =C2=A0</li></ol></ol><blockquote sty=
+le=3D"margin:0px 0px 0px 40px;border:none;padding:0px"><span style=3D"color=
+:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39;,Helveti=
+ca,sans-serif;font-size:13px">If you see the prompt=C2=A0</span><tt style=
+=3D"color:rgb(0,0,0);font-size:13px">sshtest@test:~$=C2=A0</tt><span style=
+=3D"color:rgb(0,0,0);font-family:Verdana,Arial,&#39;Bitstream Vera Sans&#39=
+;,Helvetica,sans-serif;font-size:13px">you are all set!=C2=A0</span></block=
+quote></div>
+</div><br><div>You are now connected to a GENI virtual machine, and you kno=
+w how to establish an SSH connection using a private key, which will be nec=
+essary for the tutorial.=C2=A0 You can now close the connection. Your setup=
+ is complete.=C2=A0</div></div>
+}}}