wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example/ObtainResources

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

--

Getting Started with GENI using the GENI Portal

Design/Setup
Execute
Finish

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 the slice name on your worksheet (the slice name should be of the form portal##), 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 is 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 chmod 600 ~/Downloads/id_geni_ssh_rsa and then 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 Machines at Two Aggregates

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

Now reserve a virtual machine (VM) connected to each end of the manually configured VLAN.

First, reserve a VM on the Utah end of the 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.

Second, 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.

4. Check Whether Virtual Machines are Ready to be Used

A VM that is READY
  1. Return to the Slice page. Press the Resource Status button in the slice table row for InstaGENI GPO.
  2. Periodically reload this page until it says READY with a green background as shown on the left.
  3. Repeat previous two steps at InstaGENI Utah.
  1. Return to the Slice page. Press the Get All button in the aggregate table.
Status at both aggregates Status at both aggregates
  1. The rows for InstaGENI GPO and InstaGENI Utah should say READY against a green background and look as shown on the left.
  2. If one of the rows do not say READY, press the Get Status button on the row that needs updating until it does.

Next Part: Execute a Simple Layer 2 Experiment