Changes between Version 9 and Version 10 of User Guide/Remote Access/SSH


Ignore:
Timestamp:
Apr 29, 2020, 12:12:33 AM (5 years ago)
Author:
msherman
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • User Guide/Remote Access/SSH

    v9 v10  
    1 == Configuring SSH Keys ==
     1[[TOC(WikiStartBeta,ExperimenterInformation*,depth=4)]]
     2=== Configuring SSH Keys
    23
    34SSH access to [wiki:/Documentation/Domains COSMOS domains] requires the use of public key authentication. If you try to connect using the username and password that you use for accessing the scheduler and status pages, you will receive the following message:
     
    910You need to configure the SSH client on your computer to use a private key for connecting to COSMOS machines instead of a password. Additionally, the corresponding public key needs to be added to your COSMOS account. This page describes the procedure for generating a public/private key pair, configuring your SSH client, and uploading the necessary public key to your COSMOS account. The instructions here are for specific SSH client software, if you use a different SSH client than those referenced here, please follow the documentation provided with that SSH client and use the instructions here for reference.
    1011
    11 === Select the OS of your computer ===
     12==== Select the OS of your computer
    1213
    1314[[CollapsibleStart(Linux)]]
     
    2021}}}
    2122
    22 ==== Generating keys ====
     23===== Generating keys
    2324 Each distribution has their own location for the specific generation tools. These instructions are based on the  documentation for Ubuntu ([https://help.ubuntu.com/community/SSH/OpenSSH/Keys located here]).
    2425
     
    4142
    4243[[BR]]
    43 ==== Uploading your public key to your COSMOS account ====
     44===== Uploading your public key to your COSMOS account
    4445 To upload you public key to your cosmos account, do the following:
    4546 1. Go to [https://www.cosmos-lab.org/cPanel/controlPanel/start] and sign in with your COSMOS username and password
     
    6263
    6364[[BR]]
    64 ==== Configuring your SSH client ====
     65===== Configuring your SSH client
    6566  Under normal circumstances, as long as the private key file is located in the /home/your_username/.ssh/ folder, the command line SSH client will use the correct key when connecting.
    6667 To test your setup, open a command-line terminal and (replacing ''your_cosmos_username'' with your own COSMOS username) type:
     
    7374
    7475[[BR]]
    75 ==== Common issues and how to solve them ====
     76===== Common issues and how to solve them
    7677 * If you receive a message like the following:
    7778{{{
     
    9899These instructions assume that you are using [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html PuTTY] as your SSH client.
    99100
    100 ==== Generating keys ====
     101===== Generating keys
    101102 In PuTTY, the key generation is handled by a separate program named ''puttygen.exe''. If you installed PuTTY via the installer, there should be an icon for PuTTYgen in your Start menu, otherwise [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html download it from here].
    102103
     
    134135
    135136[[BR]]
    136 ==== Uploading your public key to you COSMOS account ====
     137===== Uploading your public key to you COSMOS account
    137138 ''NOTE: Internet Explorer is not supported for Control Panel operations (including key upload)''
    138139
     
    157158
    158159[[BR]]
    159 ==== Configuring your SSH client ====
     160===== Configuring your SSH client
    160161
    161162 1. Open PuTTY.
     
    192193
    193194[[BR]]
    194 ==== Common issues and how to solve them ====
     195===== Common issues and how to solve them
    195196 * If you receive a message like the following:
    196197 {{{
     
    215216Mac OS has a native command line ssh client that can be used to remotely log into consoles. From the Finder select Applications -> Utilities -> Terminal to open a command line terminal.
    216217
    217 ==== Generating keys ====
     218===== Generating keys
    218219Generate the public and private keys using the following command
    219220{{{
     
    248249
    249250[[BR]]
    250 ==== Uploading your public key to you COSMOS account ====
     251===== Uploading your public key to you COSMOS account
    251252 To upload you public key to your cosmos account, do the following:
    252253 1. Go to [https://www.cosmos-lab.org/cPanel/controlPanel/start] and sign in with your COSMOS username and password
     
    269270
    270271[[BR]]
    271 ==== Configuring your SSH client ====
     272===== Configuring your SSH client
    272273 Under normal circumstances, as long as the private key file is located in the /Users/your_username/.ssh/ folder, the command line SSH client will use the correct key when connecting.
    273274
     
    282283
    283284[[BR]]
    284 ==== Common issues and how to solve them ====
     285===== Common issues and how to solve them
    285286 * TODO
    286287[[CollapsibleEnd]]
     
    288289[[BR]]
    289290
    290 === SSH Tunneling ===
     291==== SSH Tunneling
    291292
    292293A common need is to connect to some resource on the testbed as if it were local. SSH provides this functionality. Go to the [wiki:tutorials/ssh_tunnel Configuring SSH Tunnels tutorial] to learn how to configure these.
    293294 
    294295
    295 === Common SSH issues ===
    296 ==== If you deleted the "@internal1" key from your profile ====
     296==== Common SSH issues
     297===== If you deleted the "@internal1" key from your profile
    297298
    298299As long as you have at least one public key configured in your profile, use your SSH client to connect to {{{gw.orbit-lab.org}}} and run the following commands there. You do not need to make a reservation in the scheduler for this.
     
    315316
    316317
    317 ==== Common ssh options for nodes ====
     318===== Common ssh options for nodes
    318319
    319320We'd like to do a few things for convenience: