[[PageOutline]] This page describes how to login to hosts that you have reserved through the GENI AM API. = Login to GENI hosts = When you reserve nodes through the [ http://groups.geni.net/geni/wiki/GeniApi GENI AM API], you can login to your nodes using [http://en.wikipedia.org/wiki/Secure_Shell `ssh`]. You get access to reserved hosts only through [https://wiki.archlinux.org/index.php/SSH_Keys ssh keys]. This page will give you some useful tips about how to login to your nodes. In order to login to your nodes you need the following things: 1. an '''ssh client''' 2. your '''login name''' 3. your '''ssh key''' == SSH Client == Depending on which OS you are using there are different ssh client options. ==== Linux/Mac OS ==== All linux and Mac distributions come with a built-in ssh client, just open a Terminal and type ssh, you should get the usage for the ssh command. ==== Windows OS ==== There are multiple windows ssh clients. A list of some popular ones can be found [http://en.wikipedia.org/wiki/Comparison_of_SSH_clients here]. Some commonly used options are: * [http://www.cygwin.com/ Cygwin]: a complete Linux-type environment that also includes an ssh client. If you have already installed cygwin on your host then you should just run it and follow the instructions for Linux for the rest of the instructions * [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty]: a lightweight free ssh client. '''Note:''' If you are using Putty you will also need to download puttygen to convert your private key to putty's format. == Get your Login name == In order to figure out your login name the best way is to use the [wiki:GAPI_AM_API_V3#Status status command] of the GENI AM API. Depending of which tool you used to reserve the resources you can get this information in different ways. ==== Using Flack ==== If you are using Flack for building your experiment then in order to get the login name you need to load your slice in Flack and press on the (i) icon that is next to the node. [[Image(pc-info.png)]] ==== Using Omni ==== ==== Other tools ==== == Get a copy of your ssh key == == Omni Reserved Hosts == If you have reserved your nodes using [http://trac.gpolab.bbn.com/gcf/wiki/Omni Omni], you can use command-line ssh to login to your hosts. Omni comes with a script that will give you the exact ssh command you need to use to login to your nodes. To do this you need to be at the host that you used Omni to reserve your hosts and follow these steps: * '''add omni to your PYTHONPATH''' * ''' run the script''' == Flack Reserved Hosts == == Using other tools == = Troubleshoot/Useful tips =