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).

# 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 Sessino again.  In the empty *Saved Sessions* box, enter *cdcvs.fnal.gov* and click  *Save*.

# Create some environment variables:

## (system) CVS_RSH = C:\Program Files\PuTTY\plink.exe

## (system) GIT_SSH = C:\Program Files\PuTTY\plink.exe

## (system) SVN_SSH = C:\Program Files\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 

   Only 'lscvs' and 'cvs' commands are allowed (or "hi" if you're a project admin).

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=c:/path/to/ssh.exe

h3. Related files