mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-12-04 23:52:23 +00:00
157 lines
10 KiB
HTML
157 lines
10 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>CUCC Expedition Handbook: Bulk Update laptop</title>
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
|
</head>
|
|
<body>
|
|
<h2 id="tophead">CUCC Expedition Handbook - Bulk Update laptop</h2>
|
|
|
|
<h1>Cave data - Bulk Update Laptop</h1>
|
|
|
|
<p>You will already have explored what your laptop can do in the
|
|
<a href="basiclaptop.html">basic Expo laptop</a> guide,
|
|
and you probably will also have installed the survey tools survex, tunnel, therion etc.
|
|
in configuring a <a href="surveylaptop.html">survey laptop</a>.
|
|
|
|
<p><code>This is an attempt at describing how to configure your laptop to do bulk file transfers to and from the server. If you are only managing one or two files at a time, you don't need this.
|
|
<p>If you want to do software development instead, go to <a href="../troggle/troglaptop.html">configuring a troggle development machine</a>.
|
|
</code></p>
|
|
|
|
<h2>Windows and Linux</h2>
|
|
<ul>
|
|
<li>You should be able to use any OS (Linux, Windows, Mac), but it's a bit simpler to get set up using Linux.
|
|
|
|
|
|
<li>Windows machines can do almost everything needed directly in Windows itself, but some useful software has no Windows version and you will
|
|
need to find your own equivalents. There are also some 'gotchas' to look out for due to filesystem differences (e.g letter case). If you have
|
|
the choice, use Linux. Windows/Linux WSL is fine.</li>
|
|
|
|
<li><a href="winlaptop.html">A Windows laptop for expo</a> - a page of more detailed instructions for those who are definitely going to be
|
|
using a Windows PC or laptop.</li>
|
|
<li>The <i>expo laptop</i> uses <a href="https://www.debian.org/intro/about">Debian</a> with the <a
|
|
href="https://en.wikipedia.org/wiki/Cinnamon_(desktop_environment)">Cinnamon</a> interface, but pretty much any Linux
|
|
system works fine.
|
|
|
|
|
|
</ul>
|
|
|
|
<h2>Chromebooks and Macs</h2>
|
|
<ul>
|
|
<li>If using a Mac or Red-Hat-based linux you'll need to work it all out for yourself.</li>
|
|
<li>You can't
|
|
yet do everything on a phone, but you can do some things. See <a href="phone.html">Android phone page</a>.</li>
|
|
<li>Chromebooks work just like a phone, but with a keyboard, so far as Expo is concerned (mostly). So without some tricky configuration you won't be able to do bulk updates. See our <a href="chromebook.html">chromebooks</a> page.
|
|
</ul>
|
|
</ul>
|
|
|
|
<h2><a name="software">Software</a></h2>
|
|
<p>You need three kinds of software
|
|
<ol>
|
|
<li><a href="keyexchange.html">Encrypted keys</a> to access the server (ssh). None of the rest works without this.
|
|
<li>Version control software (<a href="https://git-scm.com/">git</a>) for the loser survex data files, drawings (tunnel, therion) files, website and handbook (expoweb) files.
|
|
<li>File-transfer tools scp, rsync and sftp (<a href="fzconfig.html">Filezilla</a>) for the files not under version control: photos, documents, scanned logbooks, scanned
|
|
raw survey notes (surveyscans), scanned cave centre-line plots and everything else. [Never use these on the version-controlled folders.]
|
|
</ol>
|
|
|
|
<p>If you are only managing photos, GPS tracks or documents then you don't need the version control stuff.
|
|
|
|
<p>If you are only managing survey data then you probably don't need the file-transfer stuff.
|
|
|
|
<p>You need to <a href="keyexchange.html">register a key with the expo server</a> to get upload (i.e. read/write) access. Do this first, Without it none of git, scp, ftp or rsync will work.
|
|
You can do this entirely on your own if you have access to the <i>expo laptop</i> to upload and install the public key generated by your laptop.</p>
|
|
|
|
|
|
|
|
<h3>Your own Bulk Update laptop</h3>
|
|
|
|
<p>To set up your own laptop for bulk cave data maintenance you need to do this:</p>
|
|
<ol>
|
|
<li>Register an SSH key</a> with an expo nerd i.e 'get a login'. (see "Key Configuration" below)</li>
|
|
<li>Install <a href="#software">git version control software</a> to download ("clone"), view and edit caving data.</li>
|
|
<li>Clone two <a href="../computing/repos.html">expo repositories</a> <var>loser</var> and <var>drawings</var> so you have the files on your machine. (Use the <a href="qstart-git.html">git reminder</a> for how to do this, e.g. <em>git clone ssh://expo@expo.survex.com:/home/expo/expoweb</em> .</li>
|
|
<li>If you are also planning on extensive work rewriting parts of the handbook, then you will also need the <a href="../computing/repos.html">expo repository</a> <var>expoweb</var>.
|
|
</ol>
|
|
|
|
<h4>For Linux users only:</h4>
|
|
<ul>
|
|
<li><a href="https://git-scm.com/download/gui/linux">GUI for git</a> - There is a choice on Linux but many people just use the command line.
|
|
<li>Your favourite text editor. gedit is installed on the <em>expo laptop</em> and has syntax highlighting for .svx files too. This works with <a href="https://survex.com/changes.html">all GtkSourceView-based editors</a> (thanks to Phil Withnall). Download a local copy of the syntax colourizer <a download href="/site_media/survex.lang">survex.lang</a>.
|
|
</ul>
|
|
|
|
<p>Note that on a Debian or Ubuntu machine you should normally install the versions that come with the specific distro (e.g. v11 Bulleye for Debian, or Jammy Jellyfish 22.04 for Ubuntu) i.e. install using 'sudo apt install xxx', not by downloading things from the above sites. So installing everything you need should be as simple as:
|
|
<ul>
|
|
<li><tt>apt install openssh-client survex-aven tunnelx therion git sftp</tt></li>
|
|
<li><tt>ssh-keygen</tt> (to generate a key if you haven't already)</li>
|
|
<li><tt>apt install gpsprune qgis firefox-esr gedit tig gitg meld rsync</tt> (you may prefer other tools - e.g: elpa-magit is amazing but only if you know how to drive emacs)</li>
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<h4 id="win">For Windows users only:</h4>
|
|
<p></p>None of this works until you set up the key-pair setup using PuTty/Pageant.
|
|
<p><img src="https://wiki.filezilla-project.org/favicon.ico" width=64 style="float:right; margin: 10px">To install and configure Filezilla on your machine see <a href="fzconfig.html">FileZilla install instructions</a> which will set you up pointing at the correct folder automatically.
|
|
|
|
|
|
<p>Read the <a href="winlaptop.html">Detailed Windows Configuration Instructions</a> for foconfiguring a Windows Bulk Update machine.
|
|
<h4>QMs and scripts</h4>
|
|
<p>You may not need a full troggle software development machine if you are only fixing a small script. If you are, you need
|
|
<ul>
|
|
<li>python - maybe - but only if you are working on the <a href="../troggle/scriptsother.html">scripts in expoweb/noinfo/</a> such as <var>make-folklist.py</var> or some of the <a href="../troggle/scriptsqms.html">standalone QM scripts</a> - but not on troggle itself - then please use the as close to the same setup as you can to <a href="../troggle/troglaptop.html">the setup we use for troggle</a>. <img src="https://www.python.org/favicon.ico" width=64 hspace="20" align="right">
|
|
</ul>
|
|
|
|
<h3>The Expo Laptop(s)</h3>
|
|
<p>[These notes are to remind nerds when configuring or updating a replacement <var>expo laptop</var>.]
|
|
<p>The <var>expo laptop</var> is configured as a "Bulk Update" laptop (including al the "Survey laptop" tools), but has a few extras.
|
|
<ul>
|
|
<li>Create a user 'expo'
|
|
<li>Add user 'expo' to <a href="https://www.how2shout.com/linux/2-ways-to-add-users-to-sudoers-group-in-debian-11/">the sudoers list</a> or alternatively <a href="https://vitux.com/how-to-make-a-user-an-administrator-in-debian/">use the gui</a> to do the same thing.
|
|
<li>Log in as user 'expo' again (so that ~/ = /home/expo/)
|
|
<li>Set up the expo Gmail account in Firefox
|
|
<li>Install Firezilla FTP software and <a href="fzconfig.html">download zilla-uploads.xml</a> to configure it
|
|
<li>Copy ~/.ssh/* from the previous install or from the other <var>expo laptop</var>
|
|
<li>Copy ~/expofiles from from the previous install or from the other <var>expo laptop</var>
|
|
<li>Run <a href="qstart-rsync.html">rsync</a> to ensure /expofiles is correctly identical to the server
|
|
<li>Configure git as user 'expo laptop' (or 'azirophale' or 'crowley') - see below, with expo Gmail address
|
|
<li><a href="qstart-git.html">git clone</a> the four repositories
|
|
<li>Check that you have a GPS trck editor installed, e.g. GPSprune
|
|
|
|
</ul>
|
|
|
|
<h2 id="git">Configuring git</h2>
|
|
<p>On a new machine you need to configure your git identity:
|
|
<pre><code>git config --global user.email "you@example.com"
|
|
git config --global user.name "Your Name"
|
|
git config --global pull.rebase true
|
|
</pre></code>
|
|
|
|
|
|
<h3>Cheat lists and quick reminders</h3>
|
|
<ul>
|
|
<li>Quick <a href="qstart-git.html">reminders for using git</a> at the command line.
|
|
<li>Quick <a href="qstart-rsync.html">reminders for using rsync</a> at the command line.
|
|
</ul>
|
|
|
|
<h3>Complementary tools</h3>
|
|
<p>When maintaining the HTML files in the expo handbook (the :expoweb: git repository) a link-checker is useful to report bad URLs (links to external sites go bad regularly) and to find orphaned pages with no in-links. The website has <a href="https://www.klebos.net/subdomains/keldos/LinkScans/TUNNEL-wiki-link-report.html">about 2,000 internal URLs</a> in just the Tunnel wiki section alone.
|
|
<ul>
|
|
<li><a href="https://www.brokenlinkcheck.com/">Online brokenlinkcheck tool</a> - does not install on your laptop. Limited to 3,000 pages.
|
|
<li><a href="https://www.deadlinkchecker.com/website-dead-link-checker.asp">Another online brokenlinkcheck tool</a> - does not install on your laptop. Limited to 2,000 pages but breadth-first rather than depth-first, so it covers a different chunk of the expo website.
|
|
<li><a href="https://www.drlinkcheck.com/account/subscriptions/1/projects/1/overview">Yet another link-checker</a>, only 1,500 pages checked but oh-so-stylish results presentation. Very informative.
|
|
<li><a href="http://home.snafu.de/tilman/xenulink.html">Xenu Link Sleuth</a> - install on Windows to do comprehensive link check.
|
|
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-find-broken-links-on-your-website-using-wget-on-debian-7">Linkchecking with wget</a> - command line methods on Linux
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
|
<hr />
|
|
Go back to: <a href="basiclaptop.html">Basic laptop</a><br />
|
|
Go back to: <a href="surveylaptop.html">Survey laptop</a><br />
|
|
Go on to: <a href="winlaptop.html">Windows Bulk Update laptop</a><br />
|
|
|
|
<hr /></body>
|
|
</html>
|