CUCC Expedition Handbook - Minimal laptop

Setting up a minimal Expo laptop

Overview

If you are new to expo please use the expo laptop first. You don't need to use your own laptop - which takes most of a day to do it properly.

To set up your own laptop you need to do this:

  1. Register an SSH key with an expo nerd i.e 'get a login'. (see "Key Configuration" below)
  2. Install git version control software to download ("clone"), view and edit caving data.
  3. Clone three expo repositories so you have the files on your machine.
  4. Install survex, and therion or tunnel for editing cave data.

Once you have got this working, and if it doesn't do what you want or you don't understand how to use it, look at the full laptop configuration for everything else. And please write some documentation for the next person in your situation.

Cheat lists and quick reminders

Software

If you are just typing up logbook entries then you don't need any other software. If you are working with survey data download this software (short list):

Configuration

Follow this link to register a key with the expo server to get upload (i.e. read/write) access. Do this first, Without it none of git, mercurial, scp, ftp or rsync will work.

On a Windows machine you will need to configure pageant (the putty authentication agent) to run at startup to load your key. Note that you are loading your private key, the .ppk file, into pageant and that this key never leaves your laptop.

When using Windows please, please be excessively careful when naming files and survex names and be exceptionally careful when using rsync.

Learning how to use this software