Version 43 (modified by, 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. 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 get a copy of your private ssh 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 save it in the appropriate place for ssh (~/.ssh/id_geni_ssh_rsa), or, for BitVise, FireSSH, Git Bash/Putty (look at this page).

How do I login to my global node?

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, BitVise, FireSSH, Git Bash/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 (this is only an example, your GNO name will be different)
  • For BitVise, FireSSH, Git Bash/Putty, see this page for instructions.

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

Using the wget command below, you can download a script that, when run on your global node GN0, will download the GENI Experimenter Tool (getool) software. The script will also setup ssh keys on the GN0 that will allow the getool to ssh into the other nodes in your slice. To get a copy of the script and run it, type the following commands on your global node (GN0):

tar xzf choicenet_prework.tgz

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, and your GENI ssh private key as a param to the getool.

Attachments (2)

Download all attachments as: .zip