Project

General

Profile

Windows » History » Version 36

Marc Mengel, 02/03/2012 09:58 AM

1 1 Marc Mengel
h1. Windows
2 1 Marc Mengel
3 26 Marc Mengel
[ Please help debug these instructions! Send comments/corrections! ]
4 26 Marc Mengel
5 5 Marc Mengel
There are numerous graphical front ends to the various packages on Windows; regardless which
6 5 Marc Mengel
front-end you choose, you will need to configure the back-end part below.
7 5 Marc Mengel
8 5 Marc Mengel
h2. Front ends
9 5 Marc Mengel
10 5 Marc Mengel
* http://www.tortoisecvs.org/
11 5 Marc Mengel
* http://code.google.com/p/tortoisegit/
12 5 Marc Mengel
* http://tortoisesvn.tigris.org/
13 29 Marc Mengel
* http://www.eclipse.org/  [Note that Eclipse's Git backend currently ignores GIT_SSH...]
14 10 Marc Mengel
* http://www.wincvs.org/
15 10 Marc Mengel
* http://cola.tuxfamily.org/
16 5 Marc Mengel
17 5 Marc Mengel
h2. Back Ends
18 5 Marc Mengel
19 31 Marc Mengel
For write access to  repositories on cdcvs, I am currently recommending that users use Putty 0.62 (or newer)
20 31 Marc Mengel
in concert witht NetIDManager and Keberos for Windows.
21 1 Marc Mengel
22 1 Marc Mengel
Then there are a few steps to get things setup:
23 14 Marc Mengel
24 31 Marc Mengel
# Install the appropriate Putty installer (either 32 or 64 bit, at the bottom of this page).
25 31 Marc Mengel
# Startup PuTTY from that installation
26 31 Marc Mengel
# Select *Session* and set the hostname to: cdcvs.fnal.gov
27 31 Marc Mengel
# Expand *SSH* and under that expand *Auth*, and select GSSAPI
28 31 Marc Mengel
#* Check the box labelled: *Allow GSSAPI credential delegation*
29 31 Marc Mengel
#* Ensure that *MIT Kerberos GSSAPI* is first in the *Preference order for GSSAPI libraries"* box.
30 33 Marc Mengel
# Select Session again.  In the empty *Saved Sessions* box, enter *cdcvs.fnal.gov* and click  *Save*.
31 31 Marc Mengel
# Create some environment variables:
32 36 Marc Mengel
## (system) CVS_RSH = C:\PROGRA~1\PuTTY\plink.exe
33 36 Marc Mengel
## (system) GIT_SSH = C:\PROGRA~1\PuTTY\plink.exe
34 36 Marc Mengel
## (system) SVN_SSH = C:\PROGRA~1\PuTTY\plink.exe
35 32 Marc Mengel
##* Right-click My Computer, and then click Properties.
36 32 Marc Mengel
##* Click the Advanced tab.
37 32 Marc Mengel
##* Click Environment variables.
38 32 Marc Mengel
##* Click one the following options, for either a user or a system variable:
39 32 Marc Mengel
##** Click New to add a new variable name and value.
40 32 Marc Mengel
##** Click an existing variable, and then click Edit to change its name or value.
41 32 Marc Mengel
##** Click an existing variable, and then click Delete to remove it.
42 32 Marc Mengel
# Close all open windows then renew your the credentials for username@FNAL.GOV.
43 12 Marc Mengel
44 1 Marc Mengel
h2. Check if it works:
45 2 Marc Mengel
46 31 Marc Mengel
try to login on the server with  plink.exe. In a cmd.exe window:
47 16 Marc Mengel
<pre>
48 36 Marc Mengel
  %CVS_RSH% p-project@cdcvs.fnal.gov echo hi
49 16 Marc Mengel
</pre>
50 1 Marc Mengel
(where "project" is your project name). You should get 
51 36 Marc Mengel
<pre>
52 1 Marc Mengel
   Only 'lscvs' and 'cvs' commands are allowed 
53 36 Marc Mengel
</pre>
54 1 Marc Mengel
(or 
55 36 Marc Mengel
<pre>
56 1 Marc Mengel
   hi
57 36 Marc Mengel
</pre>
58 36 Marc Mengel
if you're a project admin.)  If it's the first time you've connected to this host,
59 36 Marc Mengel
you'll also get:
60 1 Marc Mengel
61 36 Marc Mengel
<pre>
62 36 Marc Mengel
The server's host key is not cached in the registry. You
63 36 Marc Mengel
have no guarantee that the server is the computer you
64 36 Marc Mengel
think it is.
65 36 Marc Mengel
The server's rsa2 key fingerprint is:
66 36 Marc Mengel
ssh-rsa 1024 01:30:15:c1:ab:4a:41:c3:62:e2:46:35:71:2e:c7:64
67 36 Marc Mengel
If you trust this host, enter "y" to add the key to
68 36 Marc Mengel
PuTTY's cache and carry on connecting.
69 36 Marc Mengel
If you want to carry on connecting just once, without
70 36 Marc Mengel
adding the key to the cache, enter "n".
71 36 Marc Mengel
If you do not trust this host, press Return to abandon the
72 36 Marc Mengel
connection.
73 36 Marc Mengel
Store key in cache? (y/n)
74 36 Marc Mengel
</pre>
75 36 Marc Mengel
76 36 Marc Mengel
Please answer 'y' for yes.
77 36 Marc Mengel
78 1 Marc Mengel
79 3 Marc Mengel
h2. CVS
80 1 Marc Mengel
81 21 Marc Mengel
The CVS_RSH environment variable should make :ext: CVSROOT's work in WinCVS, TortiseCVS, etc.
82 3 Marc Mengel
83 22 Marc Mengel
h2. GIT
84 22 Marc Mengel
85 22 Marc Mengel
The GIT_SSH environment variable should make ssh:/... repository paths work with Git tools.
86 22 Marc Mengel
87 30 Marc Mengel
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.
88 30 Marc Mengel
89 1 Marc Mengel
h2. Subversion
90 2 Marc Mengel
91 3 Marc Mengel
Configure Subversion to use plink/ssh  for “svn+ssh” uri.
92 2 Marc Mengel
93 2 Marc Mengel
    * Edit the file c:\Documents and Settings\user\Application Data\Subversion\config
94 8 Marc Mengel
      (with your username for "user")
95 2 Marc Mengel
    * Locate the section named [tunnels]
96 9 Marc Mengel
    * Add the following line :
97 3 Marc Mengel
98 34 Marc Mengel
      ssh=$SVN_SSH
99 6 Marc Mengel
100 6 Marc Mengel
h3. Related files