wiki:GEC21Agenda/ChoiceNet/access

Version 28 (modified by griff@netlab.uky.edu, 9 years ago) (diff)

--

Navigation: Up

Login and Pre-setup

In this section you will

  1. login to your slice, and
  2. load the GENI Experimenter Tool (getool) software into your slice.

In the next section, you will run the getool program to install the ChoiceNet software into your slice.

Login to your slice

Which slice should I use?

We have pre-created a set of slices to be used for this tutorial. Each of them has been created with the GEC21 ChoiceNet RSPEC. You have been assigned one of these pre-created slices. You will be given information about your slice at the beginning of the tutorial.

Setting up the ChoiceNet software in your slice

Loading ChoiceNet software into your slice can be done using the GENI Experimenter Tool (getool). The getool is a program that runs on Linux-based systems. It takes as input the RSPEC for your slice and then automatically ssh's into the nodes in your slice, loading the ChoiceNet software into each node. The getool is also used to configure and launch the ChoiceNet services in your slice.

You will need to run the getool from a Linux-based host. For the purposes of this tutorial, we would like you to run the getool from the global node labelled "GN0" in your slice. You will need to login to the GN0 using ssh or putty from your laptop computer. This means that you must have your private ssh keys installed on your laptop. If you don't already have a copy of your private ssh key on your laptop, you can download your private ssh key from the GENI portal by:

  1. Visit Login to the portal
  2. Go the to Profile tab
  3. Under the SSH Keys section you will find a button to download your Private key. When you click it the downloaded file will probably be named :id_geni_ssh_rsa. You will need to install it in the appropriate place for either ssh (~/.ssh/id_geni_ssh_rsa) or putty (?????).

(NOTE : You can find additional information about ssh keys at this page).

After your private ssh keys have been installed on your laptop, login to your global node.

Logging in to the GN0 and getting a copy of the GENI Experimenter Tool

  1. SSH using your preferred ssh client into the GN0 Node (e.g., ssh or putty). Make sure you use your GENI username when logging in to the GN0 Node.
  1. For this tutorial you need the ChoiceNet tool called GET Tool to run and setup your ChoiceNet Framework, the GET Tool needs to ssh into all of routers and endhost machines in your slice and setup the necessary software. In order to facilitate this, we need to use an SSH-Key pair that has been setup for you just for this tutorial. We will also need to download your Slice Manifest rspec. For all this to happen please first download the pre-qprk script and then run using the commands below on the GN0 node.
wget http://choicenet.netlab.uky.edu/choicenet_prework.tgz
tar xzf choicenet_prework.tgz
./choicenet_prework.sh

NOTE: If you plan to use ChoiceNET at a later date from a linux workstation, using the GN0 node is not a requirement. The same can be done from your linux workstation. All you would need is the manifest rspec for your slice. Your GENI SSH Keypair as a param to the GET TOOL.

Attachments (2)

Download all attachments as: .zip