1. Windows Users
2. Linux Users
3. OS/2 Users

Puttydir> plink cvs.yourProjectsName.sourceforge.net

You get all the stuff about adding the fingerprint to the cache and answer yes. After doing this you should be able to use Tortoise for all of your project's CVS commands without incident.

1. Download Tortoise from here:  http://www.tortoisecvs.org/ .

2. Download the Putty(a handy and very good ssh package) suite from here:
   http://www.chiark.greenend.org.uk/~sgtatham/putty/ .

3. Install them.

4. This next section is cribbed from the Sourceforge WinCVS configuration page. It tells you how to set up Putty:
   1. Using Start->Run, execute 'C:\PUTTY\PUTTY.EXE'.
   2. Enter 'cvs.sourceforge.net' as the host name you wish to connect to, and select 'SSH' as the desired Protocol. For clarity, select the 'Never' radio button within the 'Close window on exit' option, then click 'Ok'.
   3. The connection to cvs.sourceforge.net will be initiated and you will be prompted to verify the host fingerprint for the cvs.sourceforge.net host.
   4. Access the SSH Host Key Fingerprints listing using your web browser.
   5. Verify that the host fingerprint in the PuTTY window matches the specified fingerprint for this host, as found in our Site Documentation. Once you are satisfied that the fingerprint matches the expected value, click 'Yes' within the PuTTY window.
   6. PuTTY will prompt you to enter your SourceForge.net user account username and password.
   7. Upon successful authentication, cvs.sourceforge.net will create your home directory, then log you out automatically. This is normal; there is no other reason to interactively sign-in to cvs.sourceforge.net than to have your home directory created.

5. Generate a public/private key pair to upload to Sourceforge. This will allow you to be known by the cvs server at Sourceforge. Again this is plagiarized from Sourceforge:
   1. Make use of Start->Run to execute 'C:\PUTTY\PUTTYGEN.EXE'
   2. Set the 'Number of bits in a generated key' to 1024, then click on the 'Generate' button.
   3. Move your mouse within the provided window as to help PuTTY to generate random bits for use in key creation. When sufficient random bits have been collected, your key generation will proceed.
   4. Enter ' yourSourceforgeUserName @users.sourceforge.net' within the Key comment field.
   5. Enter a secure (unique) password in the Key passphrase and Confirm passphrase fields. If this password is lost, there will be no means to recover it (you will need to create a new key pair). The use of a passphrase helps to prevent the possibility of someone stealing your identity; they need both the private key file and your password to prove identity.
   6. Click on the 'Save' button. Save your new (private) key to 'C:\PUTTY\SOURCEFORGE.NET.KEY'
   7. You have completed the generation of your SSH public key pair. Please leave the PUTTYGEN application running, then proceed to the next step.

6. Upload the public key to Sourceforge. More plagiarism follows:
   1. Access the Edit Keys page from the User Account Maintenance page.
   2. Within the PUTTYGEN window (left open from the previous step of these instructions), highlight all of the text within the 'Public key for pasting into authorized_keys file' field.
   3. Press the Control and C key combination to copy this data to the clipboard.
   4. Within your web browser, paste the data in to the provided text box, then click the 'Update' button.
   5. Returning to the 'Account Options' page, you will note that your 'CVS/SSH Shared Authorized Keys' count is now 1.
   6. Key data will be synchronized from the SourceForge.net web site to the project shell and project CVS servers every six hours. Please wait six hours, then proceed to the next step of this installation.

7. Configure Pageant. You should have gotten this in the Putty package you downloaded. Again, from Sourceforge:
   1. Make use of Start->Run to execute 'C:\PUTTY\PAGEANT.EXE'
   2. Double-click on the Pageant (computer with hat) icon in your system tray.
   3. Click on the 'Add Key' button.
   4. Select the key file we saved during the key generation process (C:\PUTTY\SOURCEFORGE.NET.KEY).
   5. When prompted, enter the password you specified during the key generation process, then click 'Ok'.
   6. The key in question will now appear within Pageant's active key list. While Pageant is running, Pageant will respond to any requests from other PuTTY applications (such as PuTTY.EXE and PLINK.EXE) that you enter your SSH key password.

8. At this point you will have to check to see if your key is recognized by the Sourceforge server. Back to the Sourceforge doc:
   1. Open a Command Prompt.
   2. At the command prompt, enter: c:\putty\plink.exe yourSourceforgeUserName @shell.sourceforge.net echo "SSH public key is in place."
   3. Upon executing this command, we should receive a line back, stating: SSH public key is in place.
   4. At the command prompt, enter: c:\putty\plink.exe yourSourceforgeUserName @cvs.sourceforge.net echo "SSH public key is in place."
   5. Upon executing this command, we should receive a line back, stating: welcome to sourceforge
   6. If both of these commands worked correctly, without prompting you for your password, and without error, you have successfully posted your SSH key data and have properly configured Pageant.

9. Now you can checkout from your project. Make sure you are running Pageant at the time with your private key loaded (see step 7). Otherwise you will be asked for your password. If you don't mind that then forget Pageant.
   1. Open Windows Explorer.

   2. Right click anywhere in your hard drive (if you click on a folder the module will download into that folder; if you click on blank space a new folder will be created for the checked out module) and a menu will appear.
   3. Select CVS checkout. A dialog box will appear. Fill it in like this:

      CVSROOT: :ext:yourSourceforgeUserName@cvs.project.sourceforge.net:/cvsroot/project
      Protocol:   choose Secure Shell from the drop down menu
      Server:  cvs.project.sourceforge.net
      Repository directory:   /cvsroot/project
      User name:   yourSourceforgeUserName
      Module:  projectModule (usually, but not always, the project name)
      

Anonymous Checkout

Please issue the following commands :

cvs -d:pserver:anonymous@cvs.egothor.sourceforge.net:/cvsroot/egothor login

When prompted for the password, please press enter.

cvs -z3 -d:pserver:anonymous@cvs.egothor.sourceforge.net:/cvsroot/egothor co egothor

Developers

Developer access allows you to check in your changes to the repository. Please issue the following commands (remember to substitute your developer name). You should be registered as a developer to be able to do this. If you wish to join the project as a developer, please join the appropriate developer mailing list and post a brief resume requesting for inclusion.

export CVS_RSH=ssh

then

cvs -z3 -d:ext:developername@cvs.egothor.sourceforge.net:/cvsroot/egothor co egothor

Anonymous Checkout

Please issue the following commands :

cvs -d:pserver:anonymous@cvs.egothor.sourceforge.net:/cvsroot/egothor login

When prompted for the password, please press enter.

cvs -z3 -d:pserver:anonymous@cvs.egothor.sourceforge.net:/cvsroot/egothor co egothor

Developers

Developer access allows you to check in your changes to the repository. You should be registered as a developer to be able to do this. If you wish to join the project as a developer, please join the appropriate developer mailing list and post a brief resume requesting for inclusion.

First, add the two following lines to your CONFIG.SYS and reboot. If you don't have CVS installed in D:\SW\CVS, change the first line appropriately. If OpenSSH is not installed in D:\SW\OpenSSH, change the second line.

SET CVS_RSH=D:\SW\CVS\bin\CallSSHRight.CMD
SET PATHTOSSH=D:\SW\OpenSSH\ssh.exe

Then, create the file D:\SW\CVS\bin\CallSSHRight.CMD with the following content:

@echo off
%PATHTOSSH% %1 %3 %4 %5

And now you can proceed as you would normally do:

cvs -z3 -d:ext:developername@cvs.egothor.sourceforge.net:/cvsroot/egothor co egothor