wiki:GEC21Agenda/ChoiceNet/access

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). (Note that you may need to chmod 600 id_geni_ssh_rsa to remove execute permissions on the file).

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

Log in to https://portal.geni.net and click Projects -> GEC21-ChoiceNet.

In the "Project Slices" section, you will see your slice. Click on the "Details" button, if there is a warning page, click on "Yes".

Scroll through the information until you find the GN0 information, you will find the hostname as noted in the following figure. In this particular example , GN0's hostname is pcvm2-2.instageni.sox.net ( this is only an example, your node name will be different )

  • Make sure you use your GENI username when logging in to the GN0 Node.
  • You can find the DNS name 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 your_username@pcvm2-2.instageni.sox.net
  • 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):

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

Last modified 5 years ago Last modified on 10/20/14 14:36:55

Attachments (2)

Download all attachments as: .zip