Changes between Version 5 and Version 6 of Workshops/Sig Comm2022/Signup Instructions

Timestamp:

Aug 9, 2022, 8:51:13 PM (2 years ago)

Author:

jennyshane

Comment:

—

Workshops/Sig Comm2022/Signup Instructions

@@ -12 +12 @@
 === 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.
+Access to the Cosmos testbed is typically through [https://en.wikipedia.org/wiki/Ssh 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)]]
@@ -289 +289 @@
 }}}
 [[CollapsibleEnd]]
+
+=== Choose a method for running graphical applications remotely ===
+Because SSH is a text-based interface, we need additional tools to run graphical applications such as gnuradio companion or mininet on the machines in the testbed. There are several options available: X forwarding, chrome remote desktop, and vnc over an ssh tunnel (we will not discuss this option here, but anyone who is familiar with this method should feel free to use it).
+
+==== X Forwarding ====
+X11 is the default windowing system on linux systems. Graphical applications on linux are X11 clients which communicate with the X server software, which is what renders the clients onto the screen and handles requests from the clients for user input. The communication between client applications and an X server can be forwarded over an ssh session, which is how [https://en.wikipedia.org/wiki/X_Window_System#Remote_desktop X forwarding] displays remote applications-- the application runs on the remote machine, but uses the ssh session to communicate with an X server on your local machine. 
+
+[[BR]]
+
+[[CollapsibleStart(Linux)]]
+If you are using linux, you shouldn't need to install anything to use X forwarding, because you're already running an X server on your local machine. You simply have to run your ssh session using the -Y flag on the command line:
+{{{#!shell-session
+ssh -Y cosmos-user@sb.cosmos-lab.org
+}}}
+Keep in mind that you will have to use the flag for each ssh command you use, so if you ssh to a console and then from the console to the node, you will have to use the flag in both ssh commands in order to forward the applications all the way back to your local machine. 
+
+[[CollapsibleEnd]]