This article was originally written by Satyadev Nandakumar
(satyadev AT cs.iastate.edu) on July 27, 2003.
We'll divide the setup into three logical steps:
- Installing WinCVS
- Installing Cygwin and OpenSSH
- Using WinCVS with OpenSSH
top
Requirements
- Windows 98/NT/2000 oeprating system
- Free software release of WinCVS
- Cygwin layer with OpenSSH
- TCL (for the optional WinCVS macros)
top
WinCVS
- Download WinCVS client, local and binaries
- Extract it to a temporary directory
(pic)
- Go to the folder containing the extracted files and run setup.exe
(pic)
- Choose a destination folder
(pic)
- Choose typical installation
(pic)
- Choose the program group under Start -> Programs
(pic)
top
Cygwin + OpenSSH
- Download the Cygwin
installer
- Choose the Install from the Internet option
(pic)
- Choose the installer destination directory
(pic)
- Choose a local directory where the installer will download the packages
(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 reliable
(pic)
- Choose the packages to install -
- For a slow connection, try the minimal installation. This is still
11 MB. It should take around 30 minutes on a 56kbit dial-up.
- For a broadband connection, try the default options. Include
[Net] -> [openSSH]. It is not enabled by default.
top
WinCVS with SSH
Setting up WinCVS for using 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/PN
Host Address: cvs.PN.sarovar.org
User Name: UN
CVSROOT: UN@cvs.PN.sarovar.org:/cvsroot/PN
Where UN and PN are you user and project names respectively.
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)
top
Checking out a Module
- Take the [Create]->[Checkout Module] dialog 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! ;-)
