| 1 | = [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/jFed/GettingStarted_PartI/Procedure Lab Zero: A First Experiment Using GENI] = |
| 2 | {{{ |
| 3 | #!html |
| 4 | |
| 5 | |
| 6 | <div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;"> |
| 7 | <img id="Image-Maps_5201305222028436" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Setup.jpg?format=raw" usemap="#Image-Maps_5201305222028436" border="0" width="495" height="138" alt="" /> |
| 8 | <map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436"> |
| 9 | <area shape="rect" coords="18,18,135,110" href="./DesignSetup" alt="" title="" /> |
| 10 | <area shape="rect" coords="180,18,297,111" href="./Execute" alt="" title="" /> |
| 11 | <area shape="rect" coords="344,17,460,110" href="./Finish" alt="" title="" /> |
| 12 | <area shape="rect" coords="493,136,495,138" href="http://www.image-maps.com/index.php?aff=mapped_users_5201305222028436" alt="Image Map" title="Image Map" /> |
| 13 | </map> |
| 14 | <!-- Image map text links - End - --> |
| 15 | |
| 16 | </div> |
| 17 | }}} |
| 18 | |
| 19 | == 2. Establish the Environment == |
| 20 | |
| 21 | |
| 22 | |
| 23 | === 2.1 Pre-work: Create a GENI account === |
| 24 | {{{ |
| 25 | #!html |
| 26 | <table border="0"> |
| 27 | |
| 28 | <tr> |
| 29 | |
| 30 | <td > |
| 31 | <ol type='a'> |
| 32 | <li> Launch a <b> Firefox </b> browser. Go to <a href="https://portal.geni.net"> https://portal.geni.net </a> and press the <b> Use GENI </b> button</li> |
| 33 | <li> From the Drop Down menu select your institution. If you got an account through the GENI Identity Provider, please select <b>GENI Project Office</b>. |
| 34 | <br/> |
| 35 | |
| 36 | <table id="Table_03" border="0" cellpadding="5" cellspacing="0"> |
| 37 | <tr> |
| 38 | <td> |
| 39 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="50" height="50" alt="Tip"> |
| 40 | </td> |
| 41 | <td> |
| 42 | Start typing the name of your institution and see the list become smaller. |
| 43 | </tr> |
| 44 | </table> |
| 45 | </li> |
| 46 | <li> You will be transferred to the Login Page of your institution. Fill in your username and password. </li> |
| 47 | <li> <FONT COLOR="black">Complete the form that appears after you have successfully logged in and press <b>Continue</b>.</font></li> |
| 48 | <li> <FONT COLOR="black">You will be transferred to an <b>Activation Page</b>. Make sure both checkboxes are checked and then press <b>Activate</b></font>. </li> |
| 49 | </ol> |
| 50 | </td> |
| 51 | <td> |
| 52 | |
| 53 | <a href="https://portal.geni.net"> |
| 54 | <!--img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/login.png?format=raw" alt="Login to GENI" height="120" title="Use GENI" /> </a> |
| 55 | |
| 56 | <br/--><img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/portal_login.png?format=raw" alt="Use GENI" width="375" title="Login to GENI" /> </a> |
| 57 | <br /> |
| 58 | <b>Figure 2-1</b> <i>Logging into the GENI Experimenter Portal.</i> |
| 59 | </td> |
| 60 | </tr> |
| 61 | </table> |
| 62 | }}} |
| 63 | |
| 64 | Congratulations, you have successfully created a GENI account. |
| 65 | |
| 66 | |
| 67 | === 2.2 Pre-work: Project lead adds you to a project === |
| 68 | In order to use the portal to reserve resources, you must join a project. We have created a project for this tutorial. |
| 69 | |
| 70 | {{{ |
| 71 | #!html |
| 72 | <table border="0"> |
| 73 | |
| 74 | <tr> |
| 75 | <td > |
| 76 | <ol type='a'> |
| 77 | <li> The tutorial organizers should have added you to the project for this tutorial. On the home page, you should see that you are a member of at least one project. |
| 78 | <table id="Table_03" border="0" cellpadding="5" cellspacing="0"> |
| 79 | <tr> |
| 80 | <td> |
| 81 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="50" height="50" alt="Tip"> |
| 82 | </td> |
| 83 | <td> |
| 84 | If you are not doing this exercise as part of an in-person tutorial please sign up for a <a target="_blank" href="http://groups.geni.net/geni/wiki/SignMeUp">GENI account</a> and join a project. |
| 85 | </td> |
| 86 | </tr> |
| 87 | </table> |
| 88 | |
| 89 | |
| 90 | </li> |
| 91 | </ol> |
| 92 | </td> |
| 93 | |
| 94 | </tr> |
| 95 | </table> |
| 96 | }}} |
| 97 | |
| 98 | |
| 99 | |
| 100 | === 2.3 Generate and Download SSH Keypair === |
| 101 | |
| 102 | Access to compute resources in GENI is provided through ssh key pairs and thus the portal needs a public key to upload to compute resources. For the purposes of the tutorial we will have the portal create an SSH key pair for you. (However, if you prefer to use your personal public key you can choose to upload it.) |
| 103 | |
| 104 | {{{ |
| 105 | #!html |
| 106 | <table border="0"> |
| 107 | <tr> |
| 108 | <td > |
| 109 | <ol type='a'> |
| 110 | <li>Once you are logged in, click on the <i>Profile</i> page.</li> |
| 111 | <li>On the <i>Profile</i> page in the <i>SSH Keys</i> section, select <b>generate and download an SSH keypair</b> button.</li> |
| 112 | |
| 113 | </ol> |
| 114 | </td> |
| 115 | <td> |
| 116 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/profile_sshkeys_3_v4.png?format=raw" alt="Generate an SSH Key Pair" width="400" title="Generate an SSH Key Pair" /> </a> |
| 117 | <br/> |
| 118 | <b>Figure 2-2</b> <i>On the </i>Profile<i> page, select the "generate and download an SSH keypair" button.</i> |
| 119 | </td> |
| 120 | </tr> |
| 121 | <tr> |
| 122 | <td > |
| 123 | <ol type='a' start='3'> |
| 124 | <li>Enter the same passphrase twice, then press <b>Generate SSH private key</b>.</li> |
| 125 | </ol> |
| 126 | </td> |
| 127 | <td> |
| 128 | <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/generate_sshkeys_1_v2.png?format=raw" alt="Generate an SSH Key Pair" width="400" title="Generate an SSH Key Pair" /> </a> |
| 129 | <br/> |
| 130 | <b>Figure 2-3</b> <i>Enter passphrase twice, then generate SSH private key.</i> |
| 131 | </td> |
| 132 | </tr> |
| 133 | <tr> |
| 134 | <td > |
| 135 | <ol type='a' start='4'> |
| 136 | <li>Now, press the <b>Download Private Key</b> button</li> |
| 137 | <li><b>If you are using a command line based ssh client</b>, open a terminal and execute: |
| 138 | <pre> |
| 139 | $ mv ~/Downloads/id_geni_ssh_rsa ~/.ssh/. |
| 140 | $ chmod 0600 ~/.ssh/id_geni_ssh_rsa |
| 141 | $ ssh-add ~/.ssh/id_geni_ssh_rsa |
| 142 | </pre> |
| 143 | Later in the tutorial, this will allow you to log into your nodes securely without a password. </li> |
| 144 | |
| 145 | </ol> |
| 146 | </td> |
| 147 | <td> |
| 148 | <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/download_sshkeys_1_v2.png?format=raw" alt="Download an SSH Key Pair" width="400" title="Download an SSH Key Pair" /> </a> |
| 149 | <br/> |
| 150 | <b>Figure 2-4</b> <i>Download an SSH Key Pair.</i> |
| 151 | </td> |
| 152 | |
| 153 | </tr> |
| 154 | </table> |
| 155 | }}} |
| 156 | |
| 157 | |
| 158 | |
| 159 | |
| 160 | |
| 161 | ---- |
| 162 | = [wiki:GENIExperimenter/Tutorials/jFed/GettingStarted_PartI/Procedure Introduction] = |
| 163 | = [wiki:GENIExperimenter/Tutorials/jFed/GettingStarted_PartI/Procedure/Execute Next: Execute] = |