Using CVS on Microsoft Windows Systems
Using TortoiseCVS for Kenai based CVS repositories
Tortoise CVS is a tool that integrates CVS into Windows. This describes how to configure and use it with Kenai at java.net. This procedure requires the separate installation of , a SSH client for Windows. Although TortoiseCVS ships with a PuTTY component, that version does not support the SSH flavors allowed by java.net.
Your SSH keys
CVS access is only available using SSH with public key authentication. You will need to add your public key to your account profile. Instructions for doing this can be found here.
See Generating and Using an SSH Key on a Microsoft Windows Machine for more information about using PuTTY on Windows.
Creating a PuTTY session for use with java.net
Start PuTTY. This should open the session settings panel. Use defaults, with the following exceptions:
- Category Session
- Set hostname to java.net
- For testing purposes, set Close window on exit to Never. This will allow you to confirm the SSH output visually.
- Category Connection
- Sub-category Data
- Set Auto-login username to your java.net username, if you don't want to be prompted while you're testing the connection.
- Sub-category Proxy
- If you are behind a firewall which does not allow SSH connections configure the proxy settings here.
- Sub-category SSH
- Select the private key counterpart of the public key you added to your java.net profile.
Now go back to the Connection top level category, choose a name for the session configuration, and save it.
Now you can test the configuration by clicking "Open".
- Open the TortoiseCVS Preferences panel (right click in the directory and choose CVS->Preferences). This opens the TortoiseCVS - Preferences [Global] setting form.
- Select the Tools tab.
- Select the new Putty Plink application (choose browse and navigate to the new plink), e.g.
C:\Program Files (x86)\PuTTY\plink.exe
(Do not pick the plink that is installed with TortoiseCVS)
- In SSH parameters, change the options to -load %h
- Click Ok.
- In your browser, navigate to your project's sources page (e.g. http://java.net/projects/bluebird/sources).
- Copy the suggested CVSROOT, e.g.:
- Back in Windows Explorer, navigate to the local folder that you want to check files out into.
- Right click and choose CVS Checkout. This opens the Checkout Module option.
- Set protocol to Secure Shell :ext:
- For Server, enter the Session Name that you previously saved from the PuTTY config. panel. e.g. java.net-session
- For CVS repository folder, enter the repository folder you found, on the sources page of your project, e.g. /cvs/bluebird~original-cvs
- The CVSROOT will look something like :ext:java.net-session/cvs/bluebird~original-cvs .
- Click Fetch List to find the module(s) you want to check out.
If everything is configured correctly, you'll get the list of available modules for your CVS archive. Checkin and out should now work as you expect. TortoiseCVS will remember your CVSROOTs for you.
In case of difficulty
If you get an error message stating
User <userid> not authorized to read repository bluebird~cvs-repo' from cvs server
your project administrator has not given sufficient access for you to checkout the source files from this repository.
If you get an error dialog:
Couldn't agree to a client-to-server cipher (available: aes12-ctr,aes192-ctr,aes256-crt,arcfour128,arcfour256,arcfour)
You are using the old version of plink, Upgrade to a newer version of PuTTY.