Link to the quickstart page.

[wiki.git] / doc / screen.mdwn

diff --git a/doc/screen.mdwn b/doc/screen.mdwn
index b2cd3904c5bdf9cde20cc25798ddc4bf2679c429..b340fa2b94bb3625ef880d69aa8dc006c2974b37 100644 (file)
--- a/doc/screen.mdwn
+++ b/doc/screen.mdwn
@@ -14,8 +14,8 @@ from multiple places.
 
 ## Getting Started
 
- 1.  Pick a machine to run your screen session on.  If you don't know of any options, linux.mit.edu (Linerva) is a good choice.
- 2.  ssh to that machine.
+ 1.  Pick a machine to run your screen session on.  If you don't know of any options and you're just starting out, you can ssh into athena.dialup.mit.edu (Athena Dialup). This will pick a machine by round-robin; you should be greeted by a prompt that says something like yourkerberos@foobarbaz.mit.edu. foobarbaz.mit.edu will be the machine that you'll host your session on.
+ 2.  ssh to the machine you chose in step 1. Remember it for future reference. If you want a shorter name for foobarbaz.mit.edu you can type `stella foobarbaz` at an Athena prompt; one or several shorter aliases should be listed, such as, hypothetically, `fbb`. On the MIT network, you don't even have to type `.mit.edu`, so you can just `ssh yourkerberos@fbb`.
  3.  run `screen`
  4.  Do stuff.
 
@@ -49,15 +49,23 @@ to share context between different screens, or even different people,
 but doing it when you're not sure where else your screen might be
 attached has privacy implications.
 
-##Switching Between Screen Sessions
-C-a C-a allows you to switch between screen sessions incrementally. If you have created 3 screen sessions and find your self at the 0th one, then C-a C-a will put you in the 1st screen session, then C-a C-a again will put you in the 2nd one. You can also move around in the screen session by using C-a [index number]. Such that C-a[1] would accomplish the same thing as C-a C-a when you were on the 0th window. 
-
-
 ## For More Information
 
 `screen` can do lots of stuff.  If you have a while to burn, run
 `man screen` at the shell prompt.  It may be helpful to do this
 inside of `screen` so you can put it down and come back to it later.
 
-## TODO
-clean up, explain the "C-a C-a" notation better. 
+Some people (including the author of this sentence) use `tmux` instead of
+`screen`; it can do all of the same things `screen` can, and may be easier to
+customize.
+
+Also, instead of normal `ssh`, you can use `mosh` (the mobile shell) to connect
+to the Athena machine; it will be able to reconnect automatically if you lose
+your Internet connection momentarily. An example alias:
+
+    alias athmosh='mosh --server="athrun mosh_project mosh-server" --ssh="ssh -K"'
+
+`ssh -K` will pass along Kerberos tickets from your own machine, so if you
+first run `kinit yourkerberos@ATHENA.MIT.EDU` and type your password on your
+computer, you won't need to re-authenticate when running this command. You can
+invoke this as `athmosh yourkerberos@fbb`.