Fermi Redmine

h1. Windows

[ Please help debug these instructions! Send comments/corrections! ]

There are numerous graphical front ends to the various packages on Windows; regardless which

front-end you choose, you will need to configure the back-end part below.

h2. Front ends

* http://www.tortoisecvs.org/

* http://code.google.com/p/tortoisegit/

* http://tortoisesvn.tigris.org/

* http://www.eclipse.org/  [Note that Eclipse's Git backend currently ignores GIT_SSH...]

* http://www.wincvs.org/

* http://cola.tuxfamily.org/

h2. Back Ends

For write access to  repositories on cdcvs, I am currently recommending that users use Putty 0.62 (or newer)

in concert witht NetIDManager and Keberos for Windows.

Then there are a few steps to get things setup:

# Install the appropriate Putty installer (either 32 or 64 bit, at the bottom of this page).

To find out if your computer is running 32-bit or 64-bit Windows, do the following:

#* Open System by clicking the Start button Picture of the Start button, clicking Control Panel, clicking System and Maintenance, and then clicking System.

#* Under System, you can view the system type.

# Startup PuTTY from that installation

# Select *Session* and set the hostname to: cdcvs.fnal.gov

# Expand *SSH* and under that expand *Auth*, and select GSSAPI

#* Check the box labelled: *Allow GSSAPI credential delegation*

#* Ensure that *MIT Kerberos GSSAPI* is first in the *Preference order for GSSAPI libraries"* box.

# Select Session again.  In the empty *Saved Sessions* box, enter *cdcvs.fnal.gov* and click  *Save*.

# Create some environment variables:

## (system) CVS_RSH = C:\PROGRA~1\PuTTY\plink.exe

## (system) GIT_SSH = C:\PROGRA~1\PuTTY\plink.exe

## (system) SVN_SSH = C:\PROGRA~1\PuTTY\plink.exe

##* Right-click My Computer, and then click Properties.

##* Click the Advanced tab.

##* Click Environment variables.

##* Click one the following options, for either a user or a system variable:

##** Click New to add a new variable name and value.

##** Click an existing variable, and then click Edit to change its name or value.

##** Click an existing variable, and then click Delete to remove it.

# Close all open windows then renew your the credentials for username@FNAL.GOV.

h2. Check if it works:

try to login on the server with  plink.exe. In a cmd.exe window:

<pre>

  %CVS_RSH% p-project@cdcvs.fnal.gov echo hi

</pre>

(where "project" is your project name). You should get 

<pre>

   Only 'lscvs' and 'cvs' commands are allowed 

</pre>

(or 

<pre>

   hi

</pre>

if you're a project admin.)  If it's the first time you've connected to this host,

you'll also get:

<pre>

The server's host key is not cached in the registry. You

have no guarantee that the server is the computer you

think it is.

The server's rsa2 key fingerprint is:

ssh-rsa 1024 01:30:15:c1:ab:4a:41:c3:62:e2:46:35:71:2e:c7:64

If you trust this host, enter "y" to add the key to

PuTTY's cache and carry on connecting.

If you want to carry on connecting just once, without

adding the key to the cache, enter "n".

If you do not trust this host, press Return to abandon the

connection.

Store key in cache? (y/n)

</pre>

Please answer 'y' for yes.

h2. CVS

The CVS_RSH environment variable should make :ext: CVSROOT's work in WinCVS, TortiseCVS, etc.

h2. GIT

The GIT_SSH environment variable should make ssh:/... repository paths work with Git tools.

The only exception known at the moment is Eclipse's Git backend, which ignores GIT_SSH.  If you're using Git from Eclipse, we can setup ssh public key access for you.  We also have a bug report in with the Eclipse Git backend asking that they fix this.

h2. Subversion

Configure Subversion to use plink/ssh  for “svn+ssh” uri.

    * Edit the file c:\Documents and Settings\user\Application Data\Subversion\config

      (with your username for "user")

    * Locate the section named [tunnels]

    * Add the following line :

      ssh=$SVN_SSH

h3. Related files