CVS for Eclipse for Windows for Dummies

(Is that redundant?)

I. Get PuTTY

1. Download PuTTY: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html, putty.zip
2. Unzip PuTTY
3. In control panel / system / advanced / environment variables, create environment variable CVS_RSH. Set the value to the absolute path of plink.exe in PuTTY, ie "c:\PuTTY\plink.exe"

II. PuTTY Key Pair

1. In PuTTY installation directory, open puttygen.exe.
2. At the bottom of the panel under "Parameters", click the "SSH2-DSA" radio button.
3. Click "generate".
4. Move mouse over blank area until key is generated.
5. Click "save private key".
6. When dialog asks "Are you sure you want to save this key without a passphrase to protect it?", click "Yes". You probably should protect it - see below. -- JohnTaylor 9 Oct 03
7. Give the private key a name (ie "astrogrid.ppk") and save (doesn't matter where - in your PuTTY, CVS, or Eclipse directories are sensible places).
8. Return to generate key panel and click "save public key".
9. Give key a name (ie "username_publickey" - no file extension is necessary) and save.
10. Email public key to Tim Goodwin.

III. PuTTY Saved Session

1. In PuTTY installation folder, open putty.exe.
2. In session panel, configure these options:
   • Host name: cvs.astrogrid.org
   • Port: default (22)
   • Protocol: SSH
3. Click "save" (make sure saved with session name cvs.astrogrid.org).
4. In left menu of panel, click "Connection" once.
   • Auto-login username: (your cvs username)
5. In left menu under "Connection", click "SSH" once.
   • Preferred SSH protocol version: 2
6. In left menu under "SSH", click "Auth" once.
   • Private key file for authentication: (browse to your private key .ppk file)
7. At the top of the left menu, click "Session" once.
8. Click "Save" again.
9. This session can be started now or at any time by starting putty.exe, highlighting "cvs.astrogrid.org" under saved sessions, pressing "Load", and then pressing "Open".
10. A PuTTY window will start up and log you into cvs.astrogrid.org with your username and no password.

IV. CVS

1. Download CVS: http://ccvs.cvshome.org/servlets/ProjectDownloadList, cvs-1.11.4.zip I think this step can be skipped, see below. -- JohnTaylor 8 Oct 03
2. Unzip CVS
3. In control panel / system / advanced / environment variables, edit the PATH environment variable to include the directory where the CVS executable is installed.

V. Eclipse

1. Download Eclipse: http://eclipse.ftp.heanet.ie/downloads/drops/R-2.1-200303272130/index.php
2. Unzip and install.
3. Start up eclipse.exe.
4. From top menu, select Window / Open Perspective / CVS RepositoryExploring^?.
5. From top menu, select Window / Preferences.
6. In dialog, click Team / CVS / Ext Connection Method.
   • CVS_RSH: plink
7. Click "Apply" and "Okay".
8. When dialog closes, right click in CVS Repository panel (left side) and choose New / Repository Location.
   • Host: cvs.astrogrid.org
   • Repository Path: /devel
   • User: (your cvs username)
   • Connection type: ext
   • Make sure "Use Default Port" is checked
   • Make sure "Validate Connection on Finish" is checked
9. Click "Finish"
10. Eclipse should validate CVS access. Check this by expanding "HEAD" in the CVS panel; you should see a list of modules from cvs.astrogrid.org:/devel.

-- ElizabethAuden - 15 Apr 2003

My Windows/Eclipse/CVS installation is slightly different but seems to work. It's a mix of the advice on this page and that on UsingCVS.

1. Download PuTTY and generate a key-pair as in sections I & II of this document. Do protect your private key with a pass phrase unless you want everyone with access to your harddrive to be able to pretend to be you! No need to set the CVS_RSH variable - that's done below in Eclipse.
2. Skip sections III & IV - Eclipse already contains a CVS client. [Or at least, I don't have CVS on my machine, but this method works!]
3. Section V is a bit different - this is where we mix in the stuff from UsingCVS.
   • Use pageant to load your private key into memory. You'll be prompted for the passphrase to decode it that you set earlier. The best thing to do is to put a shortcut to pageant into your startup folder so you're prompted just once for the passphrase on logon. In my case the shortcut is:

C:\ProgramFiles\PuTTY\pageant.exe C:\ProgramFiles\PuTTY\astrogrid.ppk

Wikis are fun!