wiki:GEC21Agenda/ChoiceNet/access

Version 29 (modified by griff@netlab.uky.edu, 5 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. 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.

Normally, a user would run the getool from their linux-based laptop or desktop machine. Because some attendees may not have a linux-based laptop, we will use one of the nodes in your slice as the linux-based machine to run the getool from. The following instructions show you how to login to the global node in your slice (GN0) which is a linux-based node. You will install the getool on the global node and then run it from there.

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.

Do I need ssh keys to login?

Yes, you will need a copy of your private ssh key on your laptop. If you participated in a GENI tutorial yesterday or today, you most likely already installed your private key on your laptop. In that case, you can skip the instructions to load your private key.

How do I get a copy of my private ssh key?

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

Logging in to your global node (GN0)

After your private ssh keys have been installed on your laptop, ssh into your global node (GN0) the using your preferred ssh client (e.g., ssh or putty).

  • Make sure you use your GENI username when logging in to the GN0 Node.
  • You can find the DNS names of your global node on the piece of paper handed to you at the beginning of the tutorial.
  • For ssh users the command will be something like ssh -i ~/.ssh/id_geni_ssh_rsa pcvm4-1.instageni.clemson.edu (this is only an example, your GNO name will be different)
  • For putty users, please see

Where do I get a copy of the GENI Experimenter Tool (getool)

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