<?xml version="1.0" ?>
<?xml-stylesheet type="text/xsl" href="/pages/xsl/xhtml.xsl.rb" ?>

<page title="Shell instructions">

  <article date="2006-01-03" time="01:44:37" author="jrayhawk">

    <p>
      First key to using Putty is having Putty. If you have it, good for you.
    </p>

    <p>
      The list of files you'll need are <a href="http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe">putty.exe</a> and <a href="http://the.earth.li/~sgtatham/putty/latest/x86/puttygen.exe">puttygen.exe</a>.
    </p>

    <p>
      And potentially you'll want <a href="http://the.earth.li/~sgtatham/putty/latest/x86/pageant.exe">pageant.exe</a>, provided you wish to log in repeatedly without having to provide a passphrase every time. This is recommended for the lazy technically inclined. Well, actually, we recommend installing Cygwin or some POSIX operating system, but I doubt I like you well enough to walk you through that.
    </p>

    <p>
      The easiest thing to do is to download and run the installer, which I ain't helpin' you with: <a href="http://the.earth.li/~sgtatham/putty/latest/x86/putty-0.58-installer.exe">putty-0.58-installer.exe</a>
    </p>

    <p>
      Or you can download and decompress the provided zip package: <a href="http://the.earth.li/~sgtatham/putty/latest/x86/putty.zip">putty.zip</a>
    </p>

    <p>
      You'll want to execute Puttygen
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard01.png" alt="COMPUTER! EXECUTE FILE!" />
    </p>

    <p>
      Make sure SSH-2 RSA is chosen, and then mash Generate. With your mouse, STUPID!
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard02.png" alt="No! The button, not this picture, STUPID!" />
    </p>

    <p>
      Move your mouse around inside the window a bit. Pretend you're Michael J. Fox.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard03.png" alt="1.2 GIGAWATTS" />
    </p>

    <p>
      Make a comment if you feel like it, and use a passphrase. Passphrases are expected to be larger than passwords, memorized, and not stored. Comments are expected to involve lots of swearing and general unpleasantness brought on as a result of having to interact with us.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard04.png" alt="No, fuck YOU!" />
    </p>

    <p>
      Save the private key someplace where nobody else can access it. It will be needed forever ever until the end of time. Or until you inevitably screw up and somebody else finds it.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard05.png" alt="gollum bites off frodo's private key and falls into mount doom at the end of the movie" />
    </p>

    <p>
      Copy the "public key for pasting into OpenSSH authorized_keys file" section by highlighting it and hitting ctrl-c. In case you're wondering, we need to paste it into an OpenSSH authorized_keys file.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard06.png" alt="We're actually going to use it to make fun of you." />
    </p>

    <p>
      We suggest pasting it somewhere. Maybe in a chat session. Maybe in an email client. Something you can get to us someday.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard07.png" alt="NOT a note attached to a brick." />
    </p>

    <p>
      Saving it to a file might be a good idea.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard08.png" alt="Because you're probably too much of an idiot to work out how to get it later." />
    </p>

    <p>
      Along with sending us this, you'll also need to give us your name. Usually we use real names abbreviated to eight characters. If you really want to stick it to the man and name yourself "buttface" or whatever, though, go right ahead.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard09.png" alt="Jules hates compound word names. That means that you REALLY want to name yourself buttface." />
    </p>

    <p>
      Next, we'll need to actually use Putty. Isn't that exciting?
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard10.png" alt="Hint: No, no it isn't." />
    </p>

    <p>
      You'll probably want to actually send us that stuff we need at some point, but feel free to go on anyway. This here is Putty.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard11.png" alt="What are all the buttons there for, anyway?" />
    </p>

    <p>
      Going down the menu to Auth, you'll get to specify your private key.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard12.png" alt="No! Don't pull those down! The AUTH MENU!" />
    </p>

    <p>
      Go ahead and dig it out from wherever you put it.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard13.png" alt="ARGH! I MEANT THE KEY! THE PRIVATE KEY!" />
    </p>

    <p>
      Then go back up to "host name" and specify your name @neuroblastoma.omgwallhack.org, and save the session to something.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard14.png" alt="Trisha thinks the concept of 'your name' is too complicated. Maybe, just maybe, you can work it out from context." />
    </p>

    <p>
      Having saved it, you can load it at any time and use it by double clicking on it.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard15.png" alt="Just like on TV!" />
    </p>

    <p>
      Having double clicked on it, you'll wind up with a fancy black screen. Unless you screwed something up. Enter the passphrase to your private key.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard16.png" alt="You forgot it? Try 'ticklebottoms'." />
    </p>

    <p>
      If you entered it right, you'll probably have this prompt. If you don't, it's probably because you didn't send us your username and that thing we needed because you're a dufus.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard17.png" alt="What? No really. You're a dufus." />
    </p>

    <p>
      This gets a little more tedious, here. Type in 'res' and hit enter. You'll probably want to do this every time you log in.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard18.png" alt="Wizards can keep your session alive." />
    </p>

    <p>
      You'll get a little grey alert at the bottom of the screen. You don't have to wait for it to go away to start up on the next part.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard19.png" alt="I hate that grey alert, personally." />
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard20.png" alt="It knows that it overstays its welcome." />
    </p>

    <p>
      Now type in 'chat.rb' and hit enter. This is the glory of Jules' coding. It might even execute properly!
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard21.png" alt="Hint: No, no it won't." />
    </p>

    <p>
      With any luck, your screen will look something like this.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard22.png" alt="A chat session with a heart of blackest coal." />
    </p>

    <p>
      Type in '/join omg' and hit enter.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard23.png" alt="These words will be your greatest literary achievement." />
    </p>

    <p>
      You'll probably see a lot of words. You should really know better than to expect them to be interesting.
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard24.png" alt="jblake/omg: blah blah blah i am so great blah blah blah" />
    </p>

    <p>
      Assuming you also feel like contributing words to the pile, prefix them with "omg "
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard25.png" alt="'omg' is the sound you make when you're eating something tasty" />
    </p>

    <p>
      Isn't this exciting? You're communicating with OTHER PEOPLE on the INTERNET!
    </p>

    <p>
      <limg src="media/img/system/putty/Clipboard26.png" alt="You, too, can meet LuVRgUrL69` in #teenchat" />
    </p>

    <p>
      Yeah, that's it. If this doesn't work, contact us and we'll swear at you a bit.
    </p>

  </article>

</page>
