dialup machine picking; stella aliases; mention tmux, mosh
authorBrian Chen <bpchen@mit.edu>
Tue, 20 Oct 2015 03:13:27 +0000 (23:13 -0400)
committersipb-www <sipb-www@pancake-bunny.mit.edu>
Tue, 20 Oct 2015 03:13:27 +0000 (23:13 -0400)
doc/screen.mdwn

index 2b710e9ecb3a53ddf9db7cf44cb69fd10431d0cf..b340fa2b94bb3625ef880d69aa8dc006c2974b37 100644 (file)
@@ -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, athena.dialup.mit.edu (Athena Dialup) 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.
 
@@ -54,3 +54,18 @@ attached has privacy implications.
 `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.
+
+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`.