GitSetupWindows

Chair for Computer Aided Medical Procedures & Augmented Reality
Lehrstuhl für Informatikanwendungen in der Medizin & Augmented Reality

Get UbiTrack with Git

Depending on your operating system, please use the correct instructions

General first Steps

* Get an account at our Git-Server: https://arlabnavab1.informatik.tu-muenchen.de/
* Login to the Git server
* Go to Dashboard -> Manage SSH Keys
* Klick on "Add SSH Key"

Leave the webpage open so you can paste the SSH key in here that you will create in the next steps. The following is OS dependent.

Windows

Download and install "Git for Windows" from http://msysgit.github.com/
Download and install "TortoiseGit" from http://code.google.com/p/tortoisegit/wiki/Download

Go to TortoiseGit -> Settings -> General: make sure the "Git.exe" from "Git for Windows" is set in the "MSysGit" settings (e.g. "C:\Program Files (x86)\Git\bin")

(Alternative to TortoiseGit : Download and install SourceTree from: http://www.sourcetreeapp.com/ )

There are two ways to configure the ssh access:

Integrated ssh client:

* Go to "TortoiseGit" -> Settings -> Network: make sure the "ssh.exe" from "Git for Windows" is set in the "SSH" settings (e.g. "C:\Program Files (x86)\Git\bin\ssh.exe")

* Start "Git GUI", go to Help -> Show ssh-key
* Generate Key if you haven't done so already
* Copy Key into clipboard

* Paste the SSH key into the text field of the Git server webpage from above (General first steps)
* The key should look like this: "ssh-rsa XXXXX...XXXXX yourname@yourmachinename" * Klick on "Save"

Putty ssh client:

* Go to "TortoiseGit" -> Settings -> Network: make sure the "TortoisePLink.exe" from the "TortoiseGit" bin directory in the "SSH" settings (e.g. "C:\Program Files\TortoiseGit\bin\TortoisePLink.exe")

* Start "Puttygen", klick on Generate, (optional: set a key passphrase), save the private and public key to your harddrive.
* Copy the public key from the text field to the clipboard.

* Paste the SSH key into the text field of the Git server webpage from above (General first steps)
* (Remove the comment at the end of the key)
* The key should look like this: "ssh-rsa XXXXX...XXXXX yourname@yourmachinename"
* Klick on "Save"

Clone the repository to your local harddrive

* Clone Repositories using the url: "git+ssh://git@"IP":"PORT"/"Project"/"repo".git"
* e.g. git+ssh://git@arlabnavab1.informatik.tu-muenchen.de:3000/ubitrack/buildenvironment.git
* (note: you need access to the project in addition to the access rights of the repository)

* Open your Windows-Explorer and navigate to the directory where you like to checkout UbiTrack
* Rightklick somewhere on a free space and select "Git Clone..." from the context menu
* Paste the URL from above "git+ssh://git@arlabnavab1.informatik.tu-muenchen.de:3000/ubitrack/buildenvironment.git" in the corresponding text field
* When you clone the repository and you use the putty ssh, check "Load Putty Key" and select your private keyfile that you created before (see above)

For Ubitrack only:

* Open Git Bash and change to your newly cloned UbiTrack directory
* In this directory start "./misc/setup/windows/addStandardModules.bat" to also get the submodules

Linux

* Install Git
* create a SSH key-pair if you haven't already done so "ssh-keygen"
* Copy the content of the public ssh key file ".ssh/id_rsa.pub"

* Paste the SSH key into the text field of the Git server webpage from above (General first steps)
* The key should look like this: "ssh-rsa XXXXX...XXXXX yourname@yourmachinename"
* Klick on "Save"

* Change to the directory where you like to cone Ubitrack to
* execute "git clone git+ssh://git@arlabnavab1.informatik.tu-muenchen.de:3000/ubitrack/buildenvironment.git UbiTrack"
* execute "sh misc/setup/windows/addStandardModules.bat" to also get the submodules


Edit | Attach | Refresh | Diffs | More | Revision r1.11 - 10 Apr 2014 - 14:02 - AndreasDippon

Lehrstuhl für Computer Aided Medical Procedures & Augmented Reality    rss.gif