| 1 | Navigation: [wiki:GEC21Agenda/ChoiceNet/start Up] |
| 2 | |
| 3 | = Login and Pre-setup = |
| 4 | In this section you will |
| 5 | 1. Login to your slice, and |
| 6 | 1. Load the GENI Experimenter Tool (getool) software into your slice. |
| 7 | In the next section, you will run the getool program to install the !ChoiceNet software into your slice. |
| 8 | The getool is a program that runs on Linux-based systems. |
| 9 | It takes as input the RSPEC for your slice and then automatically ssh's into the nodes in your slice, |
| 10 | loading the !ChoiceNet software into each node. The getool is also used to configure and launch the !ChoiceNet services in your slice. |
| 11 | |
| 12 | 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 |
| 13 | use one of the nodes in your slice as the linux-based machine to run the getool from. |
| 14 | 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 |
| 15 | the global node and then run it from there. |
| 16 | |
| 17 | = Login to your slice = |
| 18 | |
| 19 | ==== Which slice should I use? ==== |
| 20 | We 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]. |
| 22 | You have been assigned one of these pre-created slices. You will be given information about your slice at the beginning |
| 23 | of the tutorial. |
| 24 | |
| 25 | ==== Do I need ssh keys to login? ==== |
| 26 | 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 |
| 27 | 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. |
| 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 | |
| 36 | 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). |
| 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 | |
| 45 | 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 |
| 46 | 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 |
| 47 | on your global node (GN0): |
| 48 | |
| 49 | |
| 50 | {{{ |
| 51 | #!sh |
| 52 | wget http://choicenet.netlab.uky.edu/choicenet_prework.tgz |
| 53 | tar 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.''' |