update uuids for pgp data example

[arvados.git] / doc / user / ssh-access.md

diff --git a/doc/user/ssh-access.md b/doc/user/ssh-access.md
index 949253783191b252950cac3d2a82aa210e3bd76a..03d762fb6e15a76b2b980850ae1df1e75dcdb1a9 100644 (file)
--- a/doc/user/ssh-access.md
+++ b/doc/user/ssh-access.md
@@ -23,26 +23,29 @@ tutorial](https://www.google.com/search?q=github+ssh+key+help)
 
 ### Associate your SSH public key with your Arvados Workbench account
 
-Go to the `Keys` tab in Arvados Workbench and click the
+Go to the `Keys` page in Arvados Workbench (under the `Access` tab) and click the
 
-  `Add a new authorized key`
+<p style="margin-left: 4em"><span class="btn btn-primary">Add a new authorized key</span></p>
 
 button. Then click on 'none' in the public_key column, and copy and paste your public key:
 
-  ![Screen shot of the ssh public key box]({{ site.baseurl }}/images/ssh-adding-public-key.png)
+![Screen shot of the ssh public key box]({{ site.baseurl }}/images/ssh-adding-public-key.png)
 
 Click on the checkmark button to save your public key.
 
-### Unix-like systems: set up an ~/.ssh/config snippet for quick ssh access
+### Set up your ssh client (Unix-like systems only)
 
-**Please make sure to replace 9ujm1.arvadosapi.com with your arvados hostname in the examples below.**
+{% include notebox-begin.html %}
+
+If you are using an Arvados site other than {{ site.arvados_api_host }}, replace "{{ site.arvados_api_host }}" with the appropriate Arvados API hostname in these examples.
+
+{% include notebox-end.html %}
 
 On your workstation, add the following section to your `~/.ssh/config`
 file:
 
     Host *.arvados
-      ProxyCommand ssh turnout@switchyard.9ujm1.arvadosapi.com %h %p %u
-      Port 2222
+      ProxyCommand ssh -p2222 turnout@switchyard.{{ site.arvados_api_host }} -x -a $SSH_PROXY_FLAGS %h
 
 If you have access to an account `foo` on a VM called `blurfl` then
 you can log in like this:
@@ -54,16 +57,16 @@ If you want to shorten this and you always/usually have access to the
 `~/.ssh/config`:
 
     Host *.a
-      ProxyCommand ssh turnout@switchyard.9ujm1.arvadosapi.com %hrvados %p %u
-      Port 2222
+      ProxyCommand ssh -p2222 turnout@switchyard.{{ site.arvados_api_host }} -x -a $SSH_PROXY_FLAGS %h
       User foo
 
 Then you can log in to the `blurfl` VM as `foo` like this:
 
     ssh blurfl.a
 
-(Arvados Workbench will show you a list of VMs you have access to and
-what your account name is for each one.)
+Arvados Workbench will show you a list of VMs you have access to and
+what your account name is for each one: click "VMs" in the "Access"
+menu.
 
 ### Windows: Setup instructions for PuTTY