expoweb/handbook/tortoise/tortoise-win.htm

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Cambridge University Caving Club Expedition Handbook.</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>

<body>
<h1>Windows: TortoiseHg and PuTTy</h1>

<p>Struggling to get TortoiseHg to work on Windows (v10)? Here’s a quick guide which I hope explains how to sort it all
out.</p>

<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 both <a href="http://tortoisehg.bitbucket.io/">TortoiseHg</a> 
and <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTy</a>. Then run PuTTy;</p>

<h2>PuTTy:</h2>
<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 using TortoiseHg. 
To log out of PuTTy, type 'logout', then press the return/enter key.</p>

<p><b>Note that when connecting in the potato hut in Austria</b>, you now use exactly the same procedure.


<h2>TortoiseHg:</h2>

<p>To open up TortoiseHg, simply open a folder somewhere on your desktop (you can make a new folder if you want, to keep things neat), and right click in the folder and select “Hg Workbench”</p>
<div style="text-align: center">
<img src="expoWorkbenchopen.png" alt="Accessing the Workbench" />
<p class="caption">Accessing the Hg Workbench</p></div>

<p>Once this opens up, go to File>Clone Repository, and you should get the following;</p>

<div style="text-align: center">
<img src="expoRepositoryScreen.png" width="75%" height="50%" alt="Hg Workbench" />
<p class="caption">Hg Workbench</p></div>

<p>At which point type <tt>ssh://expo@expo.survex.com/loser</tt> into
the 'Source' box (in this case I have specified a particular folder on
the server; 'loser', I suggest you do the same for now). You may also
choose where you want the repository to be created by clicking
'Browse' next to the 'Destination' box. As far as I recall, you don't
need to edit anything in the box where it says 'Hg command'. Click 'Clone'!</p>


<p>Voila! If you're now looking at the following screen or similar,</p>

<div style="text-align: center">
<img src="expoRepositoryScreen2.png" width="75%" height="50%" alt="Hg Workbench Linked" />
<p class="caption">Hg Workbench Linked</p></div>

<p>That will have cloned the /loser/ repository to your laptop. 
<p>
If you want to update the handbook or other parts of the website you will also need to clone the /expoweb/ repository. 
You can scan what's in the repositories (read only) using your web browser:

<ul>
 <li><a href="/repositories/home/expo/loser/graph/">loser</a> - the survex cave survey data (hg)</li>
 <li><a href="/cgit/drawings/.git/log">drawings</a> - the tunnel and therion cave data and drawings (git)</li>
 <li><a href="/repositories/home/expo/expoweb/graph">expoweb</a> - the website pages, handbook, generation scripts (hg)</li>
 <li><a href="/cgit/troggle/.git/log">troggle</a> - the database/software part of the survey data management system - see <a href="computing/troggle-ish.html">notes on troggle</a> for further explanation (git)</li>
</ul>>


<p>If anything seems unclear, please email me at elmo2058@gmail.com, and I will reinstall things 
on my own machine to see where things get confusing. 
</p>


<hr />
</body>
</html>
-												working on the mess that is several unfinished bit of computing manual




											
										
										
											2019-12-27 20:35:00 +00:00
+								<!DOCTYPE html>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
+								<html>
 								<head>
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
+								<title>Cambridge University Caving Club Expedition Handbook.</title>
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
+								</head>
 								<body>
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<h2 id="tophead">CUCC Expedition Handbook</h2>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<body>
 								<h1>Windows: TortoiseHg and PuTTy</h1>
-												Documentation fixes for ssh key needs




											
										
										
											2019-07-17 15:07:52 +01:00
+								<p>Struggling to get TortoiseHg to work on Windows (v10)? Here’s a quick guide which I hope explains how to sort it all
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
+								out.</p>
-												Documentation fixes for ssh key needs




											
										
										
											2019-07-17 15:07:52 +01:00
+								<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.
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<p>First download and install both <a href="http://tortoisehg.bitbucket.io/">TortoiseHg</a>
 								and <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTy</a>. Then run PuTTy;</p>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<h2>PuTTy:</h2>
 								<p>Upon opening PuTTy, you’ll be greeted with a screen similar to this;</p>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
 								<div style="text-align: center">
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<img src="expoputtyscreen.png" alt="PuTTy Configuration Screen" />
 								<p class="caption">PuTTy Configuration Screen</p></div>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
 								<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
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								expo@expo.survex.com each time you use PuTTy. You simply click on
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
+								'Expo' then 'Load'). Then click 'Open'.</p>
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<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>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<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).
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<p>You have now made sure that your computer will be happy to log on using TortoiseHg.
 								To log out of PuTTy, type 'logout', then press the return/enter key.</p>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<p><b>Note that when connecting in the potato hut in Austria</b>, you now use exactly the same procedure.
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
 								<h2>TortoiseHg:</h2>
 								<p>To open up TortoiseHg, simply open a folder somewhere on your desktop (you can make a new folder if you want, to keep things neat), and right click in the folder and select “Hg Workbench”</p>
 								<div style="text-align: center">
 								<img src="expoWorkbenchopen.png" alt="Accessing the Workbench" />
 								<p class="caption">Accessing the Hg Workbench</p></div>
 								<p>Once this opens up, go to File>Clone Repository, and you should get the following;</p>
 								<div style="text-align: center">
 								<img src="expoRepositoryScreen.png" width="75%" height="50%" alt="Hg Workbench" />
 								<p class="caption">Hg Workbench</p></div>
 								<p>At which point type <tt>ssh://expo@expo.survex.com/loser</tt> into
 								the 'Source' box (in this case I have specified a particular folder on
 								the server; 'loser', I suggest you do the same for now). You may also
 								choose where you want the repository to be created by clicking
 								'Browse' next to the 'Destination' box. As far as I recall, you don't
 								need to edit anything in the box where it says 'Hg command'. Click 'Clone'!</p>
 								<p>Voila! If you're now looking at the following screen or similar,</p>
 								<div style="text-align: center">
 								<img src="expoRepositoryScreen2.png" width="75%" height="50%" alt="Hg Workbench Linked" />
 								<p class="caption">Hg Workbench Linked</p></div>
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<p>That will have cloned the /loser/ repository to your laptop.
 								<p>
 								If you want to update the handbook or other parts of the website you will also need to clone the /expoweb/ repository.
 								You can scan what's in the repositories (read only) using your web browser:
 								<ul>
-												working on the mess that is several unfinished bit of computing manual




											
										
										
											2019-12-27 20:35:00 +00:00
+								 <li><a href="/repositories/home/expo/loser/graph/">loser</a> - the survex cave survey data (hg)</li>
 								 <li><a href="/cgit/drawings/.git/log">drawings</a> - the tunnel and therion cave data and drawings (git)</li>
 								 <li><a href="/repositories/home/expo/expoweb/graph">expoweb</a> - the website pages, handbook, generation scripts (hg)</li>
 								 <li><a href="/cgit/troggle/.git/log">troggle</a> - the database/software part of the survey data management system - see <a href="computing/troggle-ish.html">notes on troggle</a> for further explanation (git)</li>
 								</ul>>
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
-												updating tortoise instructions




											
										
										
											2018-07-25 11:37:11 +01:00
+								<p>If anything seems unclear, please email me at elmo2058@gmail.com, and I will reinstall things
 								on my own machine to see where things get confusing.
 								</p>
-												Restoring file deleted by bad "Edit this page" operation.




											
										
										
											2017-08-19 00:23:23 +01:00
 								<hr />
 								</body>
 								</html>