wiki:GeniTmixTutorialPortal

Tmix Resources Setup - Portal

This page describes how to reserve resources for the Tmix Tutorial using GENI Portal.

  1. Open a browser window and go to the GENI Portal: Click http://portal.geni.net
  1. Click on the Use GENI button.

  1. Next you will be asked which organization you are affiliated with. If your organization is listed as a suggested selection, click on the name or logo of your institution. Otherwise, begin typing the name of your school or organization in the text box. As you type, a list of matches will appear. Select your organization, then click continue.

  1. 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.
  1. 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.
  1. Hover over your name in the upper right-hand corner of the page, and then click SSH Keys.
  1. 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.
  1. 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.
  1. If the key was uploaded successfully you should now see a message indicating success. Now click the Home tab, and skip to step 14.
  1. 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. Please remember your chosen passphrase. You will need it later.

  1. If the key was generated successfully you should now see a message indicating success, and 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.

  1. Unless you are using Windows, In a terminal set the local permissions on the private key file by issuing the command:
      chmod 0600 ~/.ssh/id_geni_ssh_rsa
    
  1. Click on the Home tab to continue
  1. Click on the "+ New slice" button, and then from the drop-down list, select the name of the project in which to create the slice (If you are participating in this tutorial at a conference select the name of the project associated with the tutorial.)

  1. 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.

  1. 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.

  1. 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)
  1. On this page you can design and configure a network. For this tutorial we will use a pre-defined RSpec rather than draw the desired network. Scroll down to the "Choose RSpec" section on the Add resources page. Select the “Tmix 10 min experiment” from the "Select existing" drop-down. Now, in the network diagram above, select Site 1, and then select an Aggregate from the drop-down box on the left. If you are completing this tutorial at a conference select the aggregate you were assigned, otherwise, select any of the InstaGENI aggregates or ProtoGENI. Finally, at the bottom of the page, click the Reserve Resources button.

  1. 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 reserved resources.

  1. Now, click on the Back to Slice <slicename> link at the bottom of the page to return to the Slice page. Scroll down to the Manage Resources section. You should see a diagram of your network. Once the nodes in the diagram turn light-green, your resources are ready to be used. It may take up to 10 minutes to re-image, boot, and configure the systems, so please be patient. For detailed status, click the Details button. Likely the status page will show that the hosts are not yet ready, and that their status is "changing". This is normal. Periodically click the Refresh buttons until the overall aggregate status changes to READY.

  1. Before leaving this page, note your login line of each of the two nodes listed. Each login line will contain the hostname of the node, for example pc339.emulab.net, as well as the port number. You will need both the hostame and port of both nodes later in this tutorial. You can write them down, or return to this details page later.

You now ready to log in to your nodes and run Tmix. Please continue to the next step back at the main Tutorial page.

Last modified 8 years ago Last modified on 03/15/16 16:50:37

Attachments (34)

Download all attachments as: .zip