X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/956093639196f92f3ad4b9e0795bcc7e30520e0d..c592425e9ce54bee52f825c1ec1d2caa665ba308:/doc/user/getting_started/ssh-access.html.textile.liquid diff --git a/doc/user/getting_started/ssh-access.html.textile.liquid b/doc/user/getting_started/ssh-access.html.textile.liquid index 74ecde2b5e..e4a2b9c8b9 100644 --- a/doc/user/getting_started/ssh-access.html.textile.liquid +++ b/doc/user/getting_started/ssh-access.html.textile.liquid @@ -1,13 +1,9 @@ --- layout: default navsection: userguide -navmenu: Getting Started title: Accessing an Arvados VM over ssh - ... -h1. Accessing an Arvados Virtual Machine over ssh - Arvados requires a public @ssh@ key in order to securely log in to an Arvados VM instance, or to access an Arvados @git@ repository. This document is divided up into three sections. @@ -55,7 +51,7 @@ ssh-rsa AAAAB3NzaC1ycEDoNotUseExampleKeyDoNotUseExampleKeyDoNotUseExampleKeyDoNo Now you can set up @ssh-agent@ (next) or proceed to "adding your key to the Arvados Workbench.":#workbench -h3. Setting up ssh-agent (optional) +h3. Setting up ssh-agent (recommended) If you find you are entering your passphrase frequently, you can use @ssh-agent@ to manage your credentials. Use @ssh-add -l@ to test if you already have ssh-agent running: @@ -133,23 +129,23 @@ h1(#workbench). Adding your key to Arvados Workbench h3. From the workbench dashboard -Open the Workbench dashboard (in this guide, this is "https://workbench.{{ site.arvados_api_host }}/":https://workbench.{{ site.arvados_api_host }}/ ) and look at the right hand column. If you have no @ssh@ keys registered, there should be a notification box asking you to provide your @ssh@ public key. Paste your public key into the text area and click on the check button to submit the key. You are now ready to "log into an Arvados VM":#login. +If you have no @ssh@ keys registered, there should be a notification asking you to provide your @ssh@ public key. On the Workbench dashboard (in this guide, this is "https://{{ site.arvados_workbench_host }}/":https://{{ site.arvados_workbench_host }}/ ), look for the envelope icon 1 in upper right corner (the number indicates there are new notifications). Click on this icon and a dropdown menu should appear with a message asking you to add your public key. Paste your public key into the text area provided and click on the check button to submit the key. You are now ready to "log into an Arvados VM":#login. h3. Alternate way to add ssh keys -If you want to add additional @ssh@ keys, use the menu item _Access %(rarr)→% Keys_ to add an authorized ssh key to your account. +If you want to add additional @ssh@ keys, click on the user icon in the upper right corner to access the user settings menu, and click on the menu item _Manage ssh keys_ to go to the Authorized keys page. -Click on the button Add a new authorized key. +On _Authorized keys_ page, the click on the button Add a new authorized key in the upper right corner. -This will reload the page, and should now show a row of information. Under the *public_key* column heading, click on the cell _none_ . This should open up an editing popup as shown in this screenshot: +The page will reload with a new row of information. Under the *public_key* column heading, click on the cell +none+ . This will open an editing popup as shown in this screenshot: !{{ site.baseurl }}/images/ssh-adding-public-key.png! -Paste the public key that you copied to the clipboard in the previous section into the popup text box and click on the check mark to save it. This should refresh the page with the public key that you just added now listed under the *public_key* column. You are now ready to "log into an Arvados VM":#login. +Paste the public key from the previous section into the popup text box and click on the check mark to save it. This should refresh the page with the public key that you just added now listed under the *public_key* column. You are now ready to "log into an Arvados VM":#login. h1(#login). Using ssh to log into an Arvados VM -To determine the name and login information of the VM instance that you will connect to, go to the Arvados workbench and click on "Virtual machines" under *Configuration* or use the menu item _Access %(rarr)→% VMs_ to see a list of virtual machines that you have access to. The *hostname* columns lists the name of each available VM. The *logins* column will have a value in the form of @["you"]@. Skip the square brackets and quotes to get your login name. In this guide the hostname will be _shell_ and the login will be _you_. Replace these with your hostname and login as appropriate. +To see a list of virtual machines that you have access to and determine the name and login information, click on Compute %(rarr)→% Virtual machines. Once on the "virtual machines" page, The *hostname* columns lists the name of each available VM. The *logins* column will have a value in the form of @["you"]@. Ignore the square brackets and quotes to get your login name. In this guide the hostname will be _shell_ and the login will be _you_. Replace these with your hostname and login as appropriate. This section consists of two sets of instructions, depending on whether you will be logging in using a "Unix":#unixvm (Linux, OS X, Cygwin) or "Windows":#windowsvm client. @@ -177,13 +173,14 @@ The VMs typically have addresses that are not globally routable, so you cannot l You should now be able to log into the Arvados VM and "check your environment.":check-environment.html -h3. Configuration (optional) +h3. Configuration (recommended) Since the above command line is cumbersome, it can be greatly simplfied by adding the following section your @~/.ssh/config@ file: 
Host *.arvados
   ProxyCommand ssh -a -x -p2222 turnout@switchyard.{{ site.arvados_api_host }} $SSH_PROXY_FLAGS %h
+  User you
   ForwardAgent yes
   ForwardX11 no
@@ -191,7 +188,7 @@ Since the above command line is cumbersome, it can be greatly simplfied by addin This will recognize any host ending in ".arvados" and automatically apply the proxy, user and forwarding settings from the configuration file, allowing you to log in with a much simpler command: -notextile. 
$ ssh you@shell.arvados
+notextile. 
$ ssh shell.arvados
h2(#windowsvm). Logging in using PuTTY (Windows)