Changes between Version 27 and Version 28 of HowTo/LoginToNodes

Timestamp:

08/15/12 17:13:43 (12 years ago)

Author:

nriga@bbn.com

Comment:

--

HowTo/LoginToNodes

@@ -16 +16 @@
 <ol>
  <li> an <b> ssh client </b> </li>
- <li> your <b>login name</b>, and the <b>hostname </b> </li>
+ <li> your <b>login name</b>, <b>hostname </b> and <b> port </b></li>
  <li> your <b> ssh key </b></li>
 </ol>
@@ -37 +37 @@
  * [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 and Host names ==
+== Get your Login, Host names and ports ==
 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 [http://www.protogeni.net/flack 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)]]. On the top of the information window it has a field that says `Username`, and `Hostname`. 
+[[Image(pc-info.png)]]. On the top of the information window it has a field that says `Username`, and `Hostname`. In the end of the host name there will be  `:<port number>', e.g. 'pcwf171.emulab.net:22'. 
+This is the port number you should use. 
+ 
 '''Note:''' If you are on a Mac computer then you can directly use the 'SSH' button that is on the top on the information pane for the host. 
 
@@ -74 +76 @@
 Any tool that uses the GENI AM API to reserve resources, provides the public keys to the AM to be installed on the compute resources. If you can't figure out which keys the tool you used installed on the hosts, please send an email to [mailto:help@geni.net] telling us which tool you used and we will be happy to help. 
 
+
+== Logging in ==
+Now that you have gathered all the different elements you are ready to login to your nodes. 
+
+====  Linux/Mac OS/Windows Cygwin ====
+In a Linux or a Mac host do the following :
+  1. Open a terminal
+  2. Ensure that your private key has the right permissions. Type :
+    {{{
+       chmod 700 <private_key_file>
+    }}}
+  3. Run ssh  and enter your passphrase when prompted. '''Note''': If you are prompted for a password then something went wrong. Make sure that all the information is correct. 
+   {{{
+       ssh -i <private key location> <username>@hostname -p <port>
+   }}}
+
+==== Windows Putty ====
+If you are using putty on a windows machine then follow these steps:
+   1. Convert your private key to the format that putty is expecting to. To do this use the puttygen program. For more information look [https://apps.state.or.us/tech/htdocs/putty/Chapter8.html#8.2.12 here]
+   2. Create a new session that uses the username, hostname and port that you have gathered. Also under the authentication menu make sure you point the key field to the key that you generated in putty format. 
+
 == Omni !ReadyToLogin Script == 
+If you are trying to login to the hosts from the machine where you have Omni installed, then you can use the readyToLogin.py script that comes with Omni to give you the exact command you need to run. To do this follow these steps:
+  1. Modify your PYTHONPATH to include the omni src directory
+     {{{
+         export PYTHONPATH=$PYTHONPATH:<path_to_gcf_directory>/src
+     }}}
+  2. The readyToLogin.py script uses the same arguments as Omni. You will need to provide the script the same input as the input you would provide to the sliverstatus command.  While at the gcf directory run:
+       {{{
+          readyToLogin -a <AM_URL> <slicename>
+       }}}
+      In the end of the output there should be information about the ssh commands:
+      {{{
+           nriga@pella:~/gcf$ ./examples/readyToLogin.py websrv -a pg-utah
+           <MISSING OUTPUT>
+================================================================================
+Aggregate [https://www.emulab.net/protogeni/xmlrpc/am] has a ProtoGENI sliver.
 
+
+pc522.emulab.net's geni_status is: changing
+Login using:
+        xterm -e ssh -i /home/nriga/.ssh/geni_key inki@pc522.emulab.net -p 32570 &
+
+pcwf171.emulab.net's geni_status is: ready
+Login using:
+        xterm -e ssh -i /home/nriga/.ssh/geni_key inki@pcwf171.emulab.net &
+
+================================================================================
+      }}}
+You can directly copy and paste the commands to your terminal and execute them. If you don't want the ssh to be opened in a new 
+window you can omit the 'xterm -e' part. 
 
 == Managing SSH keys on Linux, Mac hosts ==