Getting able to push

Note: Picture guide at: ' http://www.howtoforge.com/ssh_key_based_logins_putty'

To be able to push you'll need a working ssh client, a public and private key and thats about it. First of all, get putty (our windows ssh client), then make some keys, then upload the public key to daimi, and then your good to go!

Getting putty

As said, to be able to push to openengine repos, you're gonna need an ssh client, in this case, we're gonna focus around putty. So head over to  http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html and download the most reason release. At time of writing this is: 'beta 0.60'. Go ahead and download 'pagent.exe', 'puttygen.exe', 'plink.exe', 'sftp.exe', and 'pscp.exe', and make a folder for these, and add this folder to your path variables just as with darcs. Once this is done make sure to rename; 'plink.exe' to 'ssh.exe' and 'pscp.exe' to 'scp.exe', this will ease use with darcs later.

Making keys

Note: Picture guide at: ' http://www.howtoforge.com/ssh_key_based_logins_putty_p2' step 5

If you succeed in downloading putty and getting it as path variable, this should be somewhat easy. First of all, open up 'puttygen.exe' this is a tool for generating keys; once this is open: make sure you select SSH-2 RSA under Type of key to generate and specify 1024 as the Number of bits in a generated key. Then click on Generate. Then puttygen will want some random input, simply drag your mouse all over the place, till the bar fills. Once this is done fill you mail in under 'Key comment', and a password if you like. Then go ahead and save your public and private keys wherever you like.

Pushing keys to daimi

Note: Picture guide at: ' http://www.howtoforge.com/ssh_key_based_logins_putty_p2' step 6

Now open up a ssh connection to fh.daimi.au.dk, and login; Once this is done its time to push the key onto daimi. Once logged into daimi and all, call the following:

mkdir ~/.ssh
chmod 700 ~/.ssh

This will make the folder for you ssh, and set the access you need. - Then open up vi/vim/whatever with the following command (for vim):

vim ~/.ssh/authorized_keys2

Then add your public key into this window and save the changes. - Then simply do a:

chmod 600 ~/.ssh/authorized_keys2

To ensure that your the only one that will access this file.

Starting the Putty Agent

If you've gotten this far, its just about configuring the putty agent to help you access whatever ssh you need to, using your private key.

There are two ways of doing this: Console auto way, or the gui way.

The console way

Make a shortcut within Start in MSStart (this will automatically get run once you turn on your pc then). This shortcut should be something alike 'PATH-TO-ANT/pageant.exe PATH-TO-THE-PRIVATE-KEY', if theres spaces on the path to your private key insure that you put '""'around it. If this works out, you'll get a neat little putty agent logo in your systems tray, and once you open it, there will be one key. Note: This might not work with protected keys.

The GUI Way

Open 'pageant.exe' and click the add key to navigate to your private key, enter the password if needed.

Using it

Once you got this far, its just about calling something alike this:

dist.py commit

This will ask for your daimi username once, and then save it for further pushes. In case you make a typo or whatever, to reset just delete the 'daimi.username.txt' file.