wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example/ObtainResources

Version 4 (modified by sedwards@bbn.com, 7 years ago) (diff)

--

Getting Started with GENI using the GENI Portal

Experiment Workflow

Obtain Resources: create a slice and reserve resources

Now that you are a member of a project, you are ready to run your first GENI experiment. For the purpose of this tutorial we are going to do a simple layer 2 experiment.

1. Create a slice

Create a GENI Slice
  1. Go to the Home tab.
  2. Press the Create Slice button for this project.
  3. As a slice name use XXportal where XX is your initials (eg on the left replace ...FIXEME...), you can leave the description empty and press Create Slice

2. Generate and Download SSH Keypair

Once the slice is created, you will be redirected to a Slice page.

Generate an SSH Key Pair
  1. From the slice page, select Add Resources.
  2. Since this if the first time you are trying to reserve resources, you should see a warning on the top about not having an SSH key in your account. Access to compute resources in GENI is provide 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.) Click on the Generate and Download SSH Keypair button.
  3. Press the Download Private Key button
  4. Open a terminal and execute ssh-add ~/Downloads/id_geni_ssh_rsa. Later in the tutorial, this will allow you to log into your nodes securely without a password.

3. Reserve Virtual Machine at First Aggregate

For this tutorial, we have manually reserved a VLAN (a layer 2 circuit) from a GENI rack in Utah to one in Massachusetts.

Reserve a virtual machine connected to the Utah end of the manually configured VLAN.

Create a GENI Project
  1. Go to the Slices tab and again press the Add Resources button. This time there should be no warning. Complete the form as shown in the picture on the left and press the Reserve Resources button. This may take awhile (in excess of 30 seconds). Do not reload the page or press the back button while waiting.
A VM that is READY
  1. Return to the Slice page. Press the Resource Status button in the slice table row for GPO InstaGENI.
  2. Periodically reload this page until it says READY with a green background as shown on the left.

4. Reserve Virtual Machine at Second Aggregate

Reserve a virtual machine connected to the Massachusetts end of the manually configured VLAN.

Create a GENI Project
  1. Go to the Slices tab and again press on the Add Resources button. Complete the form as shown in the picture on the left and press the Reserve Resources button. Again, this may take awhile. Do not reload the page or press the back button while waiting.
  2. As before, check the status of this VM until it is READY.

Next Part: Execute a Simple Layer 2 Experiment