Changes between Version 62 and Version 63 of GeniTmixTutorialPortal


Ignore:
Timestamp:
06/11/14 16:12:32 (7 years ago)
Author:
Ben Newton
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GeniTmixTutorialPortal

    v62 v63  
    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.  Geni utilizes SSH keys to grant access to the network nodes.  If you have already generated and shared SSH keys with Geni Portal, skip to step 16, otherwise continue with step 6. 
     165.  If your credentials are accepted, you will be taken to your GENI Portal home page.  Geni utilizes SSH keys to grant access to the network nodes.  If you have already generated and shared SSH keys with Geni Portal, skip to step 14, otherwise continue with step 6. 
    1717
    18186.  Click on the '''Profile''' tab near the top of the page, and then click on the '''SSH Keys''' tab. 
    1919
    20 7.  If you already have an SSH key you wish to use (not recommended), click "upload an SSH public key", and continue with step 10.  Otherwise, click '''generate and download an SSH keypair''', and skip to step 12.
     207.  If you already have an SSH key you wish to use (not recommended), click "upload an SSH public key", and continue with step 8.  Otherwise, click '''generate and download an SSH keypair''', and skip to step 10.
    2121
    22 10.  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/id_geni_ssh_rsa.pub)  Add an optional description, if you like, and then click '''Upload'''.
     228.  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/id_geni_ssh_rsa.pub)  Add an optional description, if you like, and then click '''Upload'''.
    2323
    24 11.  If the key was uploaded successfully you should now see a message indicating success.  Now click the '''Home''' tab, and '''skip to step 16'''.
     249.  If the key was uploaded successfully you should now see a message indicating success.  Now click the '''Home''' tab, and '''skip to step 14'''.
    2525
    26 12.  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. 
     2610.  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. 
    2727
    2828[[Image(GenerateKeys.png, 50%)]]
    2929
    30 13.  If the key was generated successfully you should now see a message indicating success.  Click on the '''SSH Keys tab'''.  You should now see the key pair in your SSH Keys list.  We recommend you download the private key to your machine so you can use an SSH client to connect to the nodes.  To do so, Click on '''Download Private Key''', and save the key to your machine.  Save or move the key to the "~/.ssh/" directory if using Linux.  If you use a different path or change the filename, you will need to alter future commands which use the key, to include your chosen path and filename. 
     3011.  If the key was generated successfully you should now see a message indicating success.  Click on the '''SSH Keys tab'''.  You should now see the key pair in your SSH Keys list.  We recommend you download the private key to your machine so you can use an SSH client to connect to the nodes.  To do so, Click on '''Download Private Key''', and save the key to your machine.  Save or move the key to the "~/.ssh/" directory if using Linux.  If you use a different path or change the filename, you will need to alter future commands which use the key, to include your chosen path and filename. 
    3131
    3232[[Image(DownloadKeys.png, 50%)]]
    3333
    34 14.  In a terminal set the local permissions on the private key file by issuing the command
     3412.  In a terminal set the local permissions on the private key file by issuing the command
    3535{{{
    3636  chmod 0600 ~/.ssh/id_geni_ssh_rsa
    3737}}}   
    3838
    39 15.  Click on the '''Home tab''' to continue
     3913.  Click on the '''Home tab''' to continue
    4040
    41 16.  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.) 
     4114.  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.) 
    4242
    4343[[Image(createSlice.3.png, 10%)]]
    4444
    45 17.  Choose a name for your slice.  This name will be public, and needs to be unique among all the slices in your project.  To ensure uniqueness it is recommended that the slice name begin with your username (used above to log in) and be followed with a descriptive string.  For example, if your 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. 
     4515.  Choose a name for your slice.  This name will be public, and needs to be unique among all the slices in your project.  To ensure uniqueness it is recommended that the slice name begin with your username (used above to log in) and be followed with a descriptive string.  For example, if your 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. 
    4646
    4747[[Image(CreateNewSlice.png, 30%)]]
    4848
    49 18.  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. 
     4916.  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. 
    5050
    5151[[Image(SliceCreated.png, 50%)]]
    5252
    53 19.  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. (see steps 6 through 15)
     5317.  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. (see steps 6 through 13)
    5454
    55 20.  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 min experiment”''' resource specification and the '''Utah ProtoGENI''' aggregate.  Click the '''Reserve Resources''' button. 
     5518.  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 min experiment”''' resource specification and the '''Utah ProtoGENI''' aggregate.  Click the '''Reserve Resources''' button. 
    5656
    5757[[Image(AddResources.png, 40%)]]
    5858
    59 21. 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.
     5919. 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.
    6060
    6161[[Image(Resources.png, 30%)]]
    6262
    63 22.  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.  Scroll down to the Manage Resources section, and click the '''Resource Status''' button 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. 
     6320.  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.  Scroll down to the Manage Resources section, and click the '''Resource Status''' button 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. 
    6464
    6565[[Image(StatusNegative.png, 30%)]]