Changes between Initial Version and Version 1 of Workshops/Sig Comm2022/Signup Instructions

Timestamp:

Aug 9, 2022, 7:07:40 PM (2 years ago)

Author:

jennyshane

Comment:

—

Workshops/Sig Comm2022/Signup Instructions

@@ +1 @@
+[[Include(WikiToC)]]
+
+= Sig Comm 2022 Cosmos Testbed Tutorial =
+
+== Prerequisites ==
+If you are registered for the tutorial session and you are planning to participate in the live demos, please follow these instructions prior to the session. We will be unable to assist you with account setup during the tutorial session.
+
+=== Create an Orbit Account ===
+ 1. Register for a Cosmos / Orbit account here: [https://www.orbit-lab.org/userManagement/register]. For your organization, please select "ACM SIGCOMM 2022 TUTORIAL: COSMOS" from the drop-down menu. 
+ 2. Look for a verification email with a link. After clicking the verification link, your account will be submitted to Cosmos administrators for approval. Account approval is not immediate, so please try to do this in advance of the tutorial. Please note that your account will not be approved unless you are registered for the tutorial.
+
+=== Set up SSH keys ===
+
+Access to the Cosmos testbed is typically through SSH, which requires the use of public key authentication. You will need to generate a public-private pair of keys and upload them to the account management page so that you can use your keys to log into Cosmos machines. You will also need to verify that you have an SSH client available on your personal machine.
+
+[[CollapsibleStart(Linux)]]
+''NOTE: These instructions are NOT for Ubuntu running on Windows using Windows Subsystem for Linux (WSL).''
+
+These instructions assume you will be using a standard command-line SSH client for linux. If you have not already done so, ensure that you have it installed by running the following commands in a command-line terminal:
+{{{#!shell
+sudo apt-get update
+sudo apt-get install openssh-client
+}}}
+
+==== Generating keys
+ 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]). 
+
+ To create your public and private SSH keys, open a command-line terminal and type:
+{{{#!shell
+ssh-keygen -t rsa
+}}}
+ You will be prompted for a location to save the keys, and a passphrase for the keys which we highly recommend using. This passphrase does not have to be the same as your COSMOS account password.
+{{{#!shell-session
+Generating public/private rsa key pair.
+Enter file in which to save the key (...):
+Enter passphrase (empty for no passphrase):
+Enter same passphrase again:
+Your identification has been saved in ...
+Your public key has been saved in ...
+Your public key is now available as .ssh/id_rsa.pub in your home folder.
+}}}
+
+ This process will generate and store a private key and a public key file. The private key will be stored in the file and location you specify when prompted, and the public key file will be named the same as your private key file but with a .pub extension.
+
+[[BR]]
+==== Uploading your public key to your COSMOS account
+ To upload you public key to your cosmos account, do the following:
+ 1. Go to [https://wiki.cosmos-lab.org/cPanel/accountManagement/adminAuthKeys Profile] and sign in with your COSMOS username and password
+
+ 2. Click on "Change My Profile" option in the left side menu
+
+ 3. Click the "Choose File" button next to "Public key file"
+ 
+ 4. Navigate to where your '''public key file''' is stored (typically /home/your_username/.ssh)
+
+ 5. Select the .pub file corresponding to the key you wish to use for COSMOS access
+
+ 6. Click "Open"
+
+ 7. Click the "Update Profile" button
+
+ As a side note, expect to see a default auto generated public key in the list (ends with @internal1). This is used for SSH access between machines inside the COSMOS network. Please do NOT delete this key.
+
+ [[Image(wiki:UserGuide/RemoteAccess/SSH:ControlPanel.jpg, width=700)]]
+
+[[BR]]
+==== Configuring your SSH client
+  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.
+ To test your setup, open a command-line terminal and (replacing ''your_cosmos_username'' with your own COSMOS username) type:
+{{{#!shell-session
+ssh your_cosmos_username@gw.orbit-lab.org
+}}}
+ You should be prompted to enter your key file passphrase and be able to successfully connect.
+
+ Type {{{exit}}} and press the Enter key to end the SSH session.
+
+[[BR]]
+==== Common issues and how to solve them
+ * If you receive a message like the following:
+{{{#!shell-session
+The authenticity of host 'gw.orbit-lab.org (128.6.192.134)' can't be established.
+ECDSA key fingerprint is SHA256:iLKtq2Z8wB3ADJdEyM1CwoU85gOeqIUyB4GOJ2YloQg.
+Are you sure you want to continue connecting (yes/no)?
+}}}
+ This is a normal message that occurs when your computer connects via SSH to another that it has never connected to before or if the "fingerprint" of the other machine changed (due to replacement or reconfiguration). Simply type {{{yes}}} and connection will proceed normally.
+[[BR]]
+ * If you receive a message like the following:
+{{{#!shell-session
+Permission denied (publickey).
+}}}
+ Try connecting again but manually specifying the location where your private SSH key is stored as in the following example:
+{{{#!shell-session
+ssh -i /path_to_where_key_is_stored/private_ssh_key_name your_cosmos_username@gw.orbit-lab.org
+}}}
+
+[[CollapsibleEnd]]
+
+[[BR]]