[Fhsst-authors] Using CVS under windows

[Mark Horner]

this is not, by far, the only way to use CVS under windows but its
easy and free.

download from:

http://www.putty.nl/download.html

puttygen
plink
pageant

download from:

http://sourceforge.net/projects/cvsgui

wincvs 1.3+ and install it.

Key Generation:

use puttygen to generate a key of type rsa1 or 2 depending on any
specific requirements your server may have

savannah.gnu.org : rsa1
sourceforge.net : rsa1 or 2
hep.phy.uct.ac.za : rsa1 or 2

then you save the key public and private keys in a folder of your
choice - remember your key phrase that goes with the private key.

Savannah users: register your public key on your account configuration
page and wait at least an hour before attempting to access CVS.

Sourceforge users: register your public key on your account configuration
page and wait up to 6 hours before accessing CVS will be successful.

Hep users: plink into hep (just like normal ssh) and enter the
directory .ssh
here either append your public key to the file "authorized_keys" or
create this file with your only your pbulic key in it.

Once you have generated and saved your keys you can run pageant to
manage the keys. Pageant will run in the toolbar - click on the icon
and Add Key - then load your private key file. It will prompt for
your pass phrase. Make sure this is running when you run wincvs.

Then you can run wincvs.

To configure wincvs:

Savannah:
    Click on Admin
    Click on Preferences
    Set the following:
        Authentication type: ssh
        CVSROOT: :ext:<your_username>@subversions.gnu.org:/cvsroot/fhsst
    Click on Authentication Settings
    Set the following:
        ssh client: <path>\plink.exe
        Additional ssh options: -ssh

Sourceforge:
    Click on Admin
    Click on Preferences
    Set the following:
        Authentication type: ssh
        CVSROOT:
:ext:<your_username>@cvs.sourceforge.net:/cvsroot/theosproject
    Click on Authentication Settings
    Set the following:
        ssh client: <path>\plink.exe
        Additional ssh options: -ssh


HEP:
    Click on Admin
    Click on Preferences
    Set the following:
        Authentication type: ssh
        CVSROOT: :ext:<your_username>@hep.phy.uct.ac.za:/home/cvsadmin/cvs
    Click on Authentication Settings
    Set the following:
        ssh client: <path>\plink.exe
        Additional ssh options: -ssh

Now if you have waited long enough for the keys to propagate in the
cases of savannah and sourceforge you can access CVS. You need to
choose a working directory in wincvs.

To checkout a module to a folder click on Remote -> checkout module
then fill in the following:

Savannah:

Module name: fhsst

Sourceforge: winux

Hep: take your pick.

Then fill in the folder you want to make the module directory in and
go for it.

Thats the basic checkout - there is documentation for the rest - and
you can do commits etc. by right-clicking on the file in the list to
get a menu of options.

I ahven't setup TortoiseCVS but it works directly with Explorer. Looks
quite simple as well.

Cheers,

Mark

Mark Horner

Physics Department
University of Cape Town
Rondebosch
7700
South Africa

Phone: +27 21 650 3366 (office)
Phone: +27 83 564 6272 (cellular)
Fax:   +27 21 650 3342

Homepage:
http://hep.phy.uct.ac.za/~horner

Co-author:
http://savannah.gnu.org/projects/fhsst

"It went well. There are no problems, and, as a bonus, it showed that I
have a brain!"
- Stormers and Springbok backrower CORNE KRIGE speaking after undergoing a
precautionary brain scan after a clash of heads during a Super 12 match.