Changes between Version 37 and Version 38 of GeniTmixTutorialPortal


Ignore:
Timestamp:
06/06/14 08:58:27 (5 years ago)
Author:
Ben Newton
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GeniTmixTutorialPortal

    v37 v38  
    14144.  You will be asked to enter credentials for your institution or organization.  This is likely the same username and password that you use for other services at your institution.  '''Enter your credentials''' and then '''click to continue'''. 
    1515
    16 5.  If your credentials are accepted, you will be taken to your GENI Portal home page.  Under the “My Projects” section you will find a list of projects you are a part of.  Click on the name of the project you will create your experiment in.  (If you are participating in this tutorial at a conference select the project created for the tutorial.) 
    17 
    18 6.  The GENI Project page has information on the selected project, including project members and active slices.  To create a slice of your own click on '''Create Slice''' in the Project Actions box at the top of the page. 
     165.  If your credentials are accepted, you will be taken to your GENI Portal home page.  Under the “My Projects” section you will find a list of projects you are a part of.  Click on the "Create Slice" button of the project you wish to work in.  (If you are participating in this tutorial at a conference click the "Create Slice" button for the project created for the tutorial.) 
    1917
    2018[[Image(createSlice.png, 10%)]]
    2119
    22 7.  Choose a name for your slice.  This name needs to be unique among all the slices in GENI.  To ensure uniqueness it is recommended that the slice name begin with your GENI username and be followed with a descriptive string.  For example, if your GENI username was smith, you might choose a slice name of smithTmix. ''' Enter your slice name''' and a description of the slice (optional) in the text boxes, and then click the '''Create slice''' button. 
     206.  Choose a name for your slice.  This name needs to be unique among all the slices in GENI.  To ensure uniqueness it is recommended that the slice name begin with your GENI username and be followed with a descriptive string.  For example, if your GENI username was smith, you might choose a slice name of smithTmix. ''' Enter your slice name''' and a description of the slice (optional) in the text boxes, and then click the '''Create slice''' button. 
    2321
    2422[[Image(slice.png, 30%)]]
    2523
    26 8.  Assuming the slice was successfully created, you will be taken to the slice page.  Here you can add and delete resources, access various tools, and view the status of the slice.  Click on the '''Add Resources''' button to add resources to your slice. 
     247.  Assuming the slice was successfully created, you will be taken to the slice page.  Here you can add and delete resources, access various tools, and view the status of the slice.  Click on the '''Add Resources''' button to add resources to your slice. 
    2725
    2826[[Image(slicePage.png, 50%)]]
    2927
    30 9.  If you have not already uploaded or generated and downloaded an SSH key for use with GENI you will see a red box with a message to that effect.  If you have already set up your SSH key in Portal, '''skip to step 17'''.   
     288.  If you have not already uploaded or generated and downloaded an SSH key for use with GENI you will see a red box with a message to that effect.  If you have already set up your SSH key in Portal, '''skip to step 17'''.   
    3129
    3230[[Image(NoSSH.png, 60%)]]
    3331
    34 10.  If you already have an SSH key you wish to use, '''click Upload an SSH key''', and '''continue with step 11'''.  Otherwise, click Generate and Download SSH keypair, and skip to step 13.
     329.  If you already have an SSH key you wish to use, '''click Upload an SSH key''', and '''continue with step 11'''.  Otherwise, click Generate and Download SSH keypair, and skip to step 13.
    3533
    36 11.  Click '''Choose File''', and select the public SSH key file you wish to use for GENI, and click '''Open'''.  (Your key may be stored at this default location: ~/.ssh/geni_key.pub)  Add an optional description, if you like, and then click '''Upload'''.
     3410.  Click '''Choose File''', and select the public SSH key file you wish to use for GENI, and click '''Open'''.  (Your key may be stored at this default location: ~/.ssh/geni_key.pub)  Add an optional description, if you like, and then click '''Upload'''.
    3735
    38 12.  If the key was uploaded successfully you should now see a message indicating success, and see a key in your SSH Keys list on your Profile page.  To return to the add resources page click on '''Slices''' in the upper right-hand corner, and '''click on your slice name''' in the list.  Then '''skip to step 17'''.
     3611.  If the key was uploaded successfully you should now see a message indicating success, and see a key in your SSH Keys list on your Profile page.  To return to the add resources page click on '''Slices''' in the upper right-hand corner, and '''click on your slice name''' in the list.  Then '''skip to step 17'''.
    3937
    40 13.  To generate a new SSH key pair, '''type a Passphrase''' in the text box, and '''re-type it''' in the Confirm Passphrase text box.  Click '''Generate SSH private key''' to proceed. 
     3812.  To generate a new SSH key pair, '''type a Passphrase''' in the text box, and '''re-type it''' in the Confirm Passphrase text box.  Click '''Generate SSH private key''' to proceed. 
    4139
    4240[[Image(GenerateSSH_Password.png, 50%)]]
    4341
    44 14.  If the key was generated successfully you should now see a message indicating success, and see the key pair in your SSH Keys list.  Click on '''Download Private Key''', and save the key to your machine.  It is suggested that you save the key as "~/.ssh/geni_key".  If you use a different path or filename, you will need to alter future commands which use the key, to include your chosen path and filename. 
     4213.  If the key was generated successfully you should now see a message indicating success, and see the key pair in your SSH Keys list.  Click on '''Download Private Key''', and save the key to your machine.  It is suggested that you save the key as "~/.ssh/geni_key".  If you use a different path or filename, you will need to alter future commands which use the key, to include your chosen path and filename. 
    4543
    4644[[Image(GeneratedSSH.png, 50%)]]
    4745
    48 15.  In a terminal set the local permissions on the private key file by issuing the command
     4614.  In a terminal set the local permissions on the private key file by issuing the command
    4947{{{
    5048  chmod 0600 ~/.ssh/geni_key
    5149}}}   
    5250
    53 16.  To return to the add resources page click on '''Slices''' in the upper right-hand corner, and '''click on your slice name''' in the list.
     5115.  To return to the add resources page click on '''Slices''' in the upper right-hand corner, and '''click on your slice name''' in the list.
    5452
    55 17.  On the Add resources page you can choose resources to add to your slice from a specific aggregate.  For this tutorial select the '''“Tmix 10 minute experiment 2 nodes”''' resource specification and the '''Utah ProtoGENI''' aggregate.  Click the '''Reserve Resources''' button. 
     5316.  On the Add resources page you can choose resources to add to your slice from a specific aggregate.  For this tutorial select the '''“Tmix 10 minute experiment 2 nodes”''' resource specification and the '''Utah ProtoGENI''' aggregate.  Click the '''Reserve Resources''' button. 
    5654
    5755[[Image(resource.png, 40%)]]
    5856
    59 18. The next page will indicate that it is reserving the requested resources.  It may take a few minutes.  Once the resources are allocated you will see a detailed list of the resources.
     5717. The next page will indicate that it is reserving the requested resources.  It may take a few minutes.  Once the resources are allocated you will see a detailed list of the resources.
    6058
    6159[[Image(resources.png, 30%)]]
    6260
    63 19.  Before leaving this page, note the Login line of each of the two nodes listed.  Each login line will contain the hostname of the node, for example pc339.emulab.net.  You will need the hostame of both nodes later in this tutorial.  You can write them down, or return to this details page later.    Click on the '''Slice <slicename>''' link at the top of the page to return to the Slice page.  Click on''' Resource Status''' to view the detailed status of the resources.  Likely the status page will show that the hosts are not yet ready.  The resources have been allocated, but the nodes are being imaged, and booted.  This process can take up to 10 minutes. 
     6118.  Before leaving this page, note the Login line of each of the two nodes listed.  Each login line will contain the hostname of the node, for example pc339.emulab.net.  You will need the hostame of both nodes later in this tutorial.  You can write them down, or return to this details page later.    Click on the '''Slice <slicename>''' link at the top of the page to return to the Slice page.  Click on''' Resource Status''' to view the detailed status of the resources.  Likely the status page will show that the hosts are not yet ready.  The resources have been allocated, but the nodes are being imaged, and booted.  This process can take up to 10 minutes. 
    6462
    6563[[Image(status.png, 30%)]]