Changes between Initial Version and Version 1 of GEC21Agenda/ChoiceNet/terminalsetup


Ignore:
Timestamp:
10/18/14 19:15:48 (6 years ago)
Author:
griff@netlab.uky.edu
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GEC21Agenda/ChoiceNet/terminalsetup

    v1 v1  
     1Navigation: [wiki:GEC21Agenda/ChoiceNet/start Up]
     2
     3= Login and Pre-setup =
     4In this section you will
     5 1. Login to your slice, and
     6 1. Load the GENI Experimenter Tool (getool) software into your slice.
     7In the next section, you will run the getool program to install the !ChoiceNet software into your slice.
     8The getool is a program that runs on Linux-based systems. 
     9It takes as input the RSPEC for your slice and then automatically ssh's into the nodes in your slice,
     10loading the !ChoiceNet software into each node.  The getool is also used to configure and launch the !ChoiceNet services in your slice.
     11
     12Normally, 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
     13use one of the nodes in your slice as the linux-based machine to run the getool from.
     14The 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
     15the global node and then run it from there.
     16
     17= Login to your slice =
     18
     19==== Which slice should I use? ====
     20We have pre-created a set of slices to be used for this tutorial.  Each of them has been created with the
     21[http://groups.geni.net/geni/wiki/GEC21Agenda/ChoiceNet/topology GEC21 ChoiceNet RSPEC]. 
     22You have been assigned one of these pre-created slices.   You will be given information about your slice at the beginning
     23of the tutorial.
     24
     25==== Do I need ssh keys to login? ====
     26Yes, 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
     27already installed your private key on your laptop.  In that case, you can skip the instructions to get a copy of your private ssh key.
     28
     29==== How do I get a copy of my private ssh key? ====
     30   1. Visit [https://portal.geni.net Login to the portal]
     31   2. Go the to ''Profile'' tab
     32   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 [wiki:/HowTo/LoginToNodes#Loggingin this page]). ('''Note''' that you may need to ''chmod 600 id_geni_ssh_rsa'' to remove execute permissions on the file).
     33
     34==== How do I login to my global node? ====
     35
     36After 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).
     37
     38 - Make sure you use your GENI username when logging in to the GN0 Node.
     39 - You can find the DNS name of your global node on the piece of paper handed to you at the beginning of the tutorial.
     40 - 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''')
     41 - For !BitVise, FireSSH, Git !Bash/Putty, see [wiki:/HowTo/LoginToNodes#Loggingin this page] for instructions.
     42
     43= Where do I get a copy of the GENI Experimenter Tool (getool)? =
     44
     45Using 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
     46also 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
     47on your global node (GN0):
     48
     49
     50{{{
     51#!sh
     52wget http://choicenet.netlab.uky.edu/choicenet_prework.tgz
     53tar xzf choicenet_prework.tgz
     54./choicenet_prework.sh
     55}}}
     56
     57
     58'''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.'''