CUCC Expedition Handbook - Git Quick

Quick Reminder - Git

Version Control Software Reminders

This is NOT a tutorial. This is a set of reminders for people who already know all this stuff.

Since 2019 all use of version control software requires that you have key-pair setup already set up before any of this will work on your own machine.

NOT CHECKED _ TO BE EDITED BY A git NERD TO MAKE IT WORK. DO NOT DO THIS UNTIL THAT HAS BEEN DONE - check that you can get ssh working before trying to run git too

If you can get to the expo laptop try these commands on that first as the key exchange has already been done.

expoweb (The data management system)
git clone ssh://expo@expo.survex.com/expoweb (read/write)
git clone http://expo.survex.com/repositories/home/expo/expoweb/ (read-only checkout)
troggle (The data management system backend)
git clone ssh://expo@expo.survex.com/troggle (read/write)
git clone http://expo.survex.com/repositories/home/expo/troggle/ (read-only checkout)
loser (The survey data)
git clone ssh://expo@expo.survex.com/loser (read/write)
git clone http://expo.survex.com/repositories/home/expo/loser/ (read-only)
drawings
git clone ssh://expo@expo.survex.com/drawings (read/write)
git clone http://expo.survex.com/repositories/home/expo/drawings/ (read-only)

Using git in Windows

Once you've downloaded and installed a git client, the first step is to create what is called a checkout of the data management system. This creates a copy on your machine which you can edit to your heart's content. The command to initially check out ('clone') the entire expo data management system is:

git clone ssh://expo@expo.survex.com/expoweb

for subsequent updates

git update

will generally do the trick.

ssh://expo@expo.survex.com/expoweb

After you've made a change, commit it to you local copy with:

git commit (you can specify filenames to be specific)

The first time you do this on a Windows machineit will probably not work as it does not recognise the server. Fix this by running putty (downloading it from https://www.chiark.greenend.org.uk/~sgtatham/putty/), and connecting to the server 'expo@expo.survex.com' (on port 22). Confirm that this is the right server. If you succeed in getting a shell prompt then ssh connection are working and git should be able to clone the repo, and send changes back.