WinCVS with SSH setup�

Author

Satyadev Nandakumar
satyadev AT cs DOT iastate DOT edu
July 27, 2003

Disclaimer

The procedure described here has been tested and found to be successful on the machine on which it was tested, which is a Windows 2000 (5.00.2195) box. It has not been tested across other Windows platforms, therefore the procedure is not failsafe. I would be grateful to anyone who tries it out on other configurations and mails me regarding the tweaks (s)he has had to make. These will be incorporated into the document.

Table of Contents

• Author
• Disclaimer

• I. Requirements
• II. Setup
  • II.1 WinCVS
  • II.2 Cygwin with SSH
• III. WinCVS with SSH
  • III.1 Creating and Uploading SSH Keys
  • III.2 Setting up WinCVS for using SSH
  • III.3 Checking Out a Module

I. Requirements

The software that you would need are:

1. A Windows 98, Windows NT/2000 box ( *)
2. WinCVS, released under GPL
3. Cygwin with OpenSSH

The optional components that you may want to download are:

1. TCL, for the optional macros in WinCVS

[Table of Contents]

II. Setup

The setup is divided into three sections:

II.1 WinCVS

• Download WinCVS 1.3b Client+Local+Binaries (Look for WinCVS13b8.zip)
• Extract it to a temporary directory (pic)
• Go to the folder containing the extracted files and run setup.exe (pic)
• Choose a folder where the programme will be installed. (pic)
• Choose typical installation(pic)
• Choose a programme group for the Start Menu->Programs menu (pic)
• Sit back and enjoy!

[Table of Contents]

II. Setup

II.2 Cygwin with SSH

• Download the cygwin installer.
• Choose the option "Install from the Internet". (pic)
• Choose a local directory where cygwin will be installed. (pic)
• Choose a local directory where the packages will be dowloaded. (pic).
• Choose the appropriate connection mode. (pic).
• Choose a mirror from where to download. I find the University of Florida (ftp://ftp.cise.ufl.edu) mirror eminently reliable. Avoid the first in the list! (pic)
• Choose the packages to install -
  • For a slow connection, try the minimal installation listed here. This is still 11 MB. It should take around 30 minutes on a dial-up.
  • For a broadband connection, try the default options. Include [Net] -> [openSSH]. It is not enabled by default.
• Wait for the installation process to complete!

[Table of Contents]

III. WinCVS with SSH

III.1 Creating and Uploading SSH Keys

First, create a ssh key:

• Start the cygwin programme.
• Run

  ssh-keygen

  to generate the keys. The public key will be in

  .ssh/id_rsa.pub

  file by default.
• Create and upload ssh keys as described here.

[Table of Contents]

III.2 Setting up WinCVS for using SSH

Now, we are ready to run WinCVS with SSH.

• Start WinCVS. It will most probably open a menu with values to be entered. If it does not, open the [Admin]->[Preferences] menu. It will open the [General] options tab. Enter:

  [Admin]->[Preferences]->[General]
  Authentication: ssh
  Path:           /cvsroot/<project_name>
  Host Address:   cvs.<project_name>.sarovar.org
  User Name:      <user_name>
  CVSROOT:        <user_name>@cvs.<project_name>.sarovar.org:/cvsroot/<project_name>
  

  For instance,

  [Admin]->[Preferences]->[General]
  Authentication: ssh
  Path:           /cvsroot/smc
  Host Address:   cvs.smc.sarovar.org
  User Name:      satyadev
  CVSROOT:        satyadev@cvs.smc.sarovar.org:/cvsroot/smc
  

  (pic)
• Now, in the Authentication Settings, add the path name of the openssh that you installed with the cygwin software.

  [Admin]->[Preferences]->[General]->[Authentication Settings]
  RSA public identity file (unchecked)
  If SSH is not in the path(checked): <cygwinpath>\bin\ssh.exe
  Additional SSH options   (unchecked)
  

  For instance,

  [Admin]->[Preferences]->[General]->[Authentication Settings]
  RSA public identity file (unchecked)
  If SSH is not in the path(checked): C:\cygwin\bin\ssh.exe
  Additional SSH options   (unchecked)
  

  (pic)
• In the WinCvs tab, enter:

  [Admin]->[Preferences]->[WinCvs]
  External diff program (checked): <cygwinpath>\bin\diff.exe
  Default Viewer to be used: Notepad
  Use on double-click(checked)
  

  For instance,

  [Admin]->[Preferences]->[WinCvs]
  External diff program (checked): <cygwinpath>\bin\diff.exe
  Default Viewer to be used: Notepad
  Use on double-click(checked)
  

  (pic)
• Now, in the Global Tab, enter the following values:

  [Admin]->[Preferences]->[Global]
  Checkout read-only                  (unchecked)
  Supply Control when Adding Files      (checked)
  Quiet  Mode                         (unchecked)
  TCP/IP Compression                            3
  Dirty Files Support	              (checked)
  Prune empty directories               (checked)
  Disable Splash Screen               (unchecked)
  Logout automatically after _        (unchecked)
  Checkout textfiles with the Unix LF   (checked)
  

[Table of Contents]

III.1 Checking out a Module

• Take the [Create]->[Checkout Module] dialogue box
• Select your local home folder (pic)
• Enter the module name to check out in the [Create]->[Checkout Module] ->[Checkout Settings] tab. Also enter the local folder. (pic)
• Force the current CVSROOT in the [Create]->[Checkout Module] ->[Checkout Options] box (pic)
• Checkout (Press OK).
• With luck, a command shell will have come up which will ask you the password. (pic)
• You can check the progress, wait till it succeeds
• Celebrate.