wiki:GeniTmixTutorialPortal

Version 19 (modified by Ben Newton, 6 years ago) (diff)

--

Tmix Resources Setup

  1. Open a browser window and go to the GENI Portal: https://panther.gpolab.bbn.com/
  1. Click on the Use GENI button.

Welcome Page Image

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

Partner Entry Image

  1. You will be asked to enter credentials for your institution or organization. This is likely the same username and password that you user 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. 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.)
  1. 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.

Create Slice Image

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

Slice Image

  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.

Slice Page Image

  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. If you have already set up your SSH key in Portal, skip to step 18.

No SSH Keys Message

  1. 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.
  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/geni_key.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, 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 18.
  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.

Generate Passphrase

  1. 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 in your ~/.ssh directory.

Generated SSH Key

  1. In a terminal set the local permissions on the private key file by issuing the command
      chmod 0600 [path-to-SSH-private-key]
    
  1. 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.
  1. On the Add resources page you can choose resources to add to your slice from a specific aggregate. For this tutorial select the “Tmix - Two nodes, one link” resource specification and the ProtoGENI Utah aggregate. Click the Reserve Resources button.

Resource Image

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

Resources Image

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

Unknown Status Image

Once the nodes are ready you should see the status change to READY.

Status Ready Image

You now ready to log in to your nodes and run Tmix. Please continue on the main Tutorial page.

Attachments (34)

Download all attachments as: .zip