| Please read the following important notice before looking for tools for your home environment. Like most other computer science courses at ANU, this course is designed on the assumption that you will use the laboratory environment provided at ANU. The laboratory environment is supported by ANU technical staff and I have done my best to ensure that that environment works well in every respect. For your convenience, I have tried hard to facilitate you working from a home environment --- by using freely available tools that run on most major platforms and providing you with basic installation instructions. Please understand that your home environment, should you choose to use it, is not supported by the ANU. If you wish to use your own environment, please follow these steps:
The ANU and myself cannot support your home environment because each environment may differ in ways that are entirely outside of our control. |
Getting SSH Working With Keys On Windows 7
Notes kindly provided by 2012 COMP1110 students and tutors. For MacOSX and Unix, see these notes.- First, ensure that you can ssh to partch from one of the lab computers. Completing this step will ensure that you have basically functional ssh setup within the lab environment. Do not go ahead with the following until you've first done that.
- Download and install PuTTY. The easiest way to do this is to select the windows installer, putty-0.62-installer.exe (which installs everything except PuTTYtel, which you do not need).
- Launch puttykeygen. Generate a public/private key pair. Save both. It is important to generate a single pair, saving both public and private from a single execution (don't generate the private key and subsequently generate a public key).
Make sure to include the file name when saving it. So save it as <name>.pub and <name>.ppk respectively. Otherwise when you save the second key it will try to overwrite the first one, and the instructions that say <name>.pub/.ppk will not work.
It is not necessary to use a passphrase.
- Use the command prompt and navigate to where you installed PuTTY. For example:
cd C:\Program Files (x86)\PuTTY
- In the command window type: pscp C:\...\<name>.pub <uid>@partch.anu.edu.au:.ssh. This will use PSCP to copy your public key from your home computer to the host at ANU.
- Launch PuTTY. In the Host Name box type: <uid>@partch.anu.edu.au Then press open. It will ask you for your password because you have not yet finished setting up keys.
- You will now have a window that is executing a shell on a server at ANU. In the new window type
ssh-keygen -i -f ~/<name>.pub >> ~/.ssh/home.pub cat ~/.ssh/home.pub >> ~/.ssh/authorized_keys
, which will convert the key you generated on your home machine (~/<name>.pub) into OpenSSH format. The second command will append it to your authorized_keys file. - Add a new shortcut for pageant.exe by right clicking and selecting
properties. You can set your shortcut up so that it takes your private key as a command line argument. (If you're not sure how to set arguments on a windows shortcut, read this.) You should change Target: to
"C:/<location>/PuTTY/pageant.exe" "C:/<location>/<private key name>.ppk"
You should now be able to log into partch without being prompted for your password. If this is not true, you'll need to check the steps above.
If you have already installed Mercurial and MercurialEclipse you are now ready to use them to connect to an ANU repository and complete tasks such as cloning the lecture code.
Now either create or edit the Mercurial.ini file in C:\Users\<Your windows account>, so that it reads:
[ui] username=<Your Name> <<uid>@anu.edu.au> ssh = "C:\Program Files (x86)\PuTTY\plink.exe" -i "C:/<location>/<private key name>.ppk"
- You should now be able to start eclipse and clone the repository with the lecture code, as per these instructions.
