X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/a325b04603deacebc07d322e691d7cc4e38b2f24..8a6bd5b851e0e947b74710c4c2dd1ea59dce606a:/doc/_includes/_ssh_addkey.liquid?ds=sidebyside
diff --git a/doc/_includes/_ssh_addkey.liquid b/doc/_includes/_ssh_addkey.liquid
index 3770635777..f2c4fe55c1 100644
--- a/doc/_includes/_ssh_addkey.liquid
+++ b/doc/_includes/_ssh_addkey.liquid
@@ -1,26 +1,28 @@
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
-You may now proceed to "adding your key to the Arvados Workbench.":#workbench
-
-h1(#workbench). Adding your key to Arvados Workbench
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
-h3. From the Workbench dashboard
-If you have no SSH keys registered, there should be a notification asking you to provide your SSH public key. In the Workbench top navigation menu, look for a dropdown menu with your email address in upper right corner. It will have an icon such as 1 (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.
+You may now proceed to "adding your key to the Arvados Workbench.":#workbench
-h3. Alternate way to add SSH keys
+h1(#workbench). Adding your key to Arvados Workbench
-Click on the link with your _email address_ in the upper right corner to access the user settings menu, and click on the menu item *Manage account* to go to the account management page.
+In the Workbench top navigation menu, click on the dropdown menu icon to access the Account Management menu. Then, click on the menu item *Ssh keys* to go to the *SSH keys* page. Click on the + ADD NEW SSH KEY button in the upper-right on that page. You will see a popup as shown in this screenshot:
-On the *Manage account* page, click on the button *+* Add new SSH key button in the upper right corner of the page in the SSH Keys panel.
+!{width: 100%;}{{ site.baseurl }}/images/ssh-adding-public-key.png!
-This will open a popup as shown in this screenshot:
+Paste your _public_ key into the text area labeled *Public Key*, and click on the ADD NEW SSH KEY button in lower-right. You are now ready to "log into an Arvados VM":#login.
-!{{ site.baseurl }}/images/ssh-adding-public-key.png!
+h1(#login). Using SSH to log into an Arvados VM
-Paste the public key that you copied to the cliboard in the previous section into the popup text box labeled *Public Key* and click on the Submit button to save it. This should refresh the Manage account page with the fingerprint of the public key that you just added in the SSH Keys panel. You are now ready to "log into an Arvados VM":#login.
+To see a list of virtual machines that you have access to, click on the dropdown menu icon in the upper right corner of the top navigation menu to access the Account Management menu. Then, click on the menu item *Virtual Machines*.
-h1(#login). Using SSH to log into an Arvados VM
+You will then see a page that lists the virtual machines you can access. The *Host name* column lists the name of each available VM. The *Login name* column lists your login name on that VM. The *Command line* column provides a sample @ssh@ command.
-To see a list of virtual machines that you have access to and determine the name and login information, click on the link with your _email address_ in the upper right corner and click on the menu item *Manage account* to go to the account management page. On this page, you will see a *Virtual Machines* panel, which lists the virtual machines you can access. The *hostname* column lists the name of each available VM. The *logins* column will have a list of comma separated values of the form @you@. In this guide the hostname will be *_shell_* and the login will be *_you_*. Replace these with your hostname and login name as appropriate.
+!{width: 100%;}{{ site.baseurl }}/images/vm-access-with-webshell.png!
+At the bottom of the page there may be additional instructions for connecting your specific Arvados instance. If so, follow your site-specific instructions. If there are no site-specific instructions, you can probably connect directly with @ssh@.
+The following are generic instructions. In these examples, the login name will be *_you_* and the host domain will be *_ClusterID.example.com_*. Replace these with your login name and hostname as appropriate.