mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-12-04 23:52:23 +00:00
72 lines
4.1 KiB
HTML
72 lines
4.1 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>Expo Handbook - PuTTY</title>
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
|
</head>
|
|
<body>
|
|
<h2 id="tophead">CUCC Expedition Handbook</h2>
|
|
|
|
<h1>Windows: PuTTy</h1>
|
|
|
|
<p>First you need to set up <a href="../computing/keyexchange.html">keys</a> so that you can use ssh.
|
|
Until you can do that there is no point in doing anything else. This is <i>particularly difficult</i>
|
|
on Windows which requires <a href="https://rperki.blogspot.com/2015/06/install-puttypageant-on-win-10.html">extra software to be installed and configured</a>.
|
|
Allow an afternoon at least to get this bit to work as it is poorly documented.
|
|
To get the keys set up on the server you will have to wait for an already-authenticated nerd to do it for you so this is not a quick job.
|
|
|
|
<p>First download and install the PuTTy installer <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTy</a>.
|
|
Then run puttygen, pageant and then PuTTy itself.</p>
|
|
|
|
<h2>Puttygen:</h2>
|
|
<p>Online documentation for running puttygen is on
|
|
<a href="https://the.earth.li/~sgtatham/putty/0.77/htmldoc/Chapter8.html#pubkey-puttygen">putty/0.77/htmldoc/Chapter8.html</a>.
|
|
Just use the defaults for key type and key length. After you have pressed the "Generate" button and generated your key, write your own name and date in the box
|
|
labelled "Key comment" instead of the default value (which will be something like "rsa-key-20220614"), e.g. "2022-06-14 gussie finknottle"
|
|
<p>Then press the "Save private key" button and save the .ppk file somewhere safe that you can find it again, and back it up somewhere safe too.
|
|
You will need it when you configure pageant.
|
|
|
|
<h2>pageant</h2>
|
|
<p> <em>pageaent</em> is installed along with PuTTy and is what you need to keep your Windows machine talking nicely to the expo server.
|
|
See <a href="https://rperki.blogspot.com/2015/06/install-puttypageant-on-win-10.html">pagengt config</a> for how to do this.
|
|
|
|
<p><p>Online documentation is on <a href="https://the.earth.li/~sgtatham/putty/0.77/htmldoc/Chapter9.html#pageant-start">putty/0.77/htmldoc/Chapter9.html</a>.
|
|
<p>On a Windows 10 machine, sometimes pageant forgets your key. It continuously runs in the background so you need to bring it into view (click on the
|
|
icon in the system tray) and "Add key" again.
|
|
|
|
<p>Now return to the <a href="../computing/keyexchange.html">key-pair setup instructions</a> for how to configure the key you generated on the expo server.
|
|
|
|
|
|
<h2>PuTTy:</h2>
|
|
<p>Again, for those who skipped the paragraph above, you need to set up <a href="../computing/keyexchange.html">set up the keys</a> <em>first</em> using
|
|
puttygen.
|
|
<p>Upon opening PuTTy, you'll be greeted with a screen similar to this;</p>
|
|
|
|
<div style="text-align: center">
|
|
<img src="expoputtyscreen.png" alt="PuTTy Configuration Screen" />
|
|
<p class="caption">PuTTy Configuration Screen</p></div>
|
|
|
|
<p>Type <tt>expo@expo.survex.com</tt> into the box under Host Name, and type a
|
|
name into the box under 'Saved Sessions' then click 'Save' (in the
|
|
above case called 'Expo' - this means you don't have to type in
|
|
expo@expo.survex.com each time you use PuTTy. You simply click on
|
|
'Expo' then 'Load'). Then click 'Open'.</p>
|
|
|
|
<p>Don't worry if you can't see anything happening onscreen as you type in the password,
|
|
this is what's supposed to happen; so just type in the password and press the return/enter key.</p>
|
|
|
|
<p>Done! At some point you may come across a Windows popup which asks
|
|
you to verify the address you're attempting to log into (at which
|
|
point you select 'hells-to-the-yeah', or equivalent).
|
|
|
|
<p>You have now made sure that your computer will be happy to log on to the server once you have the keys set up (be sure to use the Windows instructions for this, not the Linux of Windows WSL instructions).
|
|
To log out of PuTTy, type 'logout', then press the return/enter key.</p>
|
|
|
|
|
|
<h3>Alternative: OpenSSH</h3>
|
|
<p>There is a recent alternative: use OpenSSH which is now part of Windows 10. See <a href="../computing/winlaptop.html">WinLaptop config</a>. But you need to read that anyway.
|
|
<hr />
|
|
</body>
|
|
</html>
|